KW 29 – 2023

Windows-Client Update auf Version 1.8.2

Mit dem Update des Windows-Clients werden zahlreiche neue Möglichkeiten zur Verfügung stehen, die Einstellungen des Clients über Einträge in der Registry festzulegen.

Registry-Keys unter: „HKEY_CURRENT_USER\SOFTWARE\CenterDevice“

Inhaltsverzeichnis

Speichervariablen

Überschreibungseinstellungen

Einstellungen sperren

Umgebungseinstellungen

Ignorieren von Dateien und Ordnern

Speichervariablen

Speichervariablen können verwendet werden, um den Speicherort von persistenten Client-Daten zu ändern, z. B. die Datenbank oder den Dateispeicher.

• DataDirPath
  Key: DataDirPath
  Value: Directory path e.g.: C:\data\CenterDeviceRaw
  UNC-Pfade werden derzeit nicht unterstützt. Pfad, in dem die CenterDevice-Rohdaten gespeichert sind. Die in diesem Verzeichnis enthaltenen Dateien und Ordner sind mit dem mit BaseDirPath angegebenen Verzeichnis oder Verzeichnis verknüpft. Die Größe dieses Verzeichnisses hängt von der Anzahl der Dateien und Ordner ab, die vom Mandanten synchronisiert werden.
• DbDirPath
  Key: DbDirPath
  Value: Directory path e.g. C:\data\CenterDeviceRaw\Db
  UNC-Pfade werden derzeit nicht unterstützt. Pfad, in dem die centerdevice.sqlite-Datenbank gespeichert ist. Normalerweise ist diese Datei nicht sehr groß (zweistellige MB-Werte). Sie kann jedoch sehr groß werden, je nach Anzahl der Dokumente, Ordner oder Sammlungen im Mandanten.
• BaseDirPath
  Key: BaseDirPath
  Value: Directory path or drive letter as string e.g.: T: or C:\CenterDeviceFiles\
  Wenn ein Laufwerksbuchstabe angegeben wird, erstellt der Client ein neues virtuelles Laufwerk mit dem angegebenen Laufwerksbuchstaben und bindet die Dateien ein. Wenn ein Pfad angegeben wird, erstellt der Client ein Synchronisationsverzeichnis unter dem angegebenen Pfad.

Überschreibungseinstellungen

Alle Überschreibungseinstellungen deaktivieren die Einstellungen, auf die sie sich beziehen, für den Benutzer und fügen einen Tooltip zu den Einstellungen hinzu, dass die Einstellung von einem Administrator vordefiniert wurde und nicht geändert werden kann. Die Einstellung wird für den Wert gesperrt, der als Registrierungswert angegeben wurde. Wenn nur der Schlüssel vorhanden ist und kein Wert, wird der Wert als Standard festgelegt.

• BaseDirPath
  Key: OverrideBaseDirPath
  Value: [path] default: null
  Legt den Pfad zum Basisverzeichnis fest und sperrt die entsprechenden Einstellungen im Einstellungsfenster des Clients. Kann entweder ein Pfad im Dateisystem sein, z. B. "C:\Users\Test\Desktop\MyCDSync" oder ein Laufwerksbuchstabe, z. B. "D:". Der Pfad oder Laufwerksbuchstabe wird beim Start des Clients überprüft, und etwaige Probleme werden in die Protokolldatei geschrieben. Vergewissern Sie sich, dass es sich bei dem von Ihnen angegebenen Pfad um ein Verzeichnis handelt, auf das Sie über das NTFS-Dateisystem Zugriff haben, oder, falls Sie einen Laufwerksbuchstaben angeben, stellen Sie sicher, dass der Laufwerksbuchstabe nicht bereits von einem anderen Laufwerk belegt ist. Im Gegensatz zur Einstellung „BaseDirPath“ im Absatz „Speichervariablen“ wird bei dieser Einstellung nicht nur das Basisverzeichnis festgelegt, sondern auch alle Benutzerkontrollen in den Client-Einstellungen gesperrt, um zu verhindern, dass Benutzer die Einstellung ändern. Wenn Sie nur einen Standardwert festlegen möchten, aber den Benutzern trotzdem erlauben wollen, den Basispfad in den Client-Einstellungen zu ändern, verwenden Sie stattdessen „BaseDirPath“ im Absatz „Speichervariablen“.
• AutoUploadChanges
  Key: OverrideAutoUploadChanges
  Value: [true/false/0/1] default: false
  Sperrt und setzt die Einstellung zum automatischen Hochladen von Änderungen in das Backend.
• ShowDesktopIcon
  Key: OverrideShowDesktopIcon
  Value: [true/false/0/1] default: false
  Sperrt und setzt die Einstellung zur Erstellung eines Desktop-Symbols für das Sync-Verzeichnis des Clients. Wenn true, wird das Desktop-Symbol immer erstellt. Wenn false, wird das Desktop-Symbol nie erstellt. 
• DeleteDocumentsInBackend
  Key: OverrideDeleteDocumentsInBackend
  Value: [true/false/0/1] default: false
  Sperrt und setzt die Einstellung, Dokumente im Backend zu löschen, wenn sie lokal gelöscht werden. Bei true werden lokal gelöschte Dokumente aus dem Backend gelöscht, wenn der Benutzer Eigentümer des Dokuments ist. Bei false werden Dokumente aus der Sammlung entfernt, wenn sie lokal gelöscht werden, sind aber weiterhin remote verfügbar. 
• AutomaticallyCheckForUpdates
  Key: OverrideAutomaticallyCheckForUpdates
  Value: [true/false/0/1] default: false
  Sperrt und setzt die Einstellung, automatisch nach Client-Updates zu suchen.
• ShowDownloadsNotification
  Key: OverrideShowDownloadsNotification
  Value: [true/false/0/1] default: false
  Sperrt und setzt die Einstellung, dass Benachrichtigungen angezeigt werden, wenn neue Dateien heruntergeladen werden.
• DriveType
  Key: OverrideDriveType
  Value: [network/fixedDrive/removableDrive] default: network
  Sperrt und setzt die Einstellung des Laufwerktyps. Einer der drei angegebenen Werte ist möglich. Erwartet einen String-Wert. Wird kein/ein ungültiger Wert angegeben, wird der Wert "network" als Standardwert verwendet.
• MinimalSpaceLeftOnDeviceInMB
  Key: OverrideMinimalSpaceLeftOnDeviceInMB
  Value: [integer number] default: 20
  Sperrt und setzt die Einstellung, die angibt, wie viele MB auf dem Laufwerk erhalten bleiben, auf dem sich das Sync-Verzeichnis befindet. Kann entweder ein String-Wert oder ein DWORD/QWORD sein. Wird kein/ein ungültiger/negativer Wert angegeben, wird als Standardwert der in der App.config angegebene "spaceToLeaveFreeMinimalThresholdInMB" verwendet (Stand: 12.05.2023 ist dieser 20).
• UseDefaultProxy
  Key: OverrideUseDefaultProxy
  Value: [true/false/0/1] default: false
  Sperrt und setzt die Einstellung, die angibt, ob der Standard-System-Proxy bei der Verbindung mit dem CenterDevice-Backend verwendet werden soll.
• ProxyUserName
  Key: OverrideProxyUserName
  Value: [string] default: ""
  Sperrt und setzt die Einstellung, die den Benutzernamen angibt, der bei der Authentifizierung mit einem Proxyserver zu verwenden ist.
• ProxyPassword
  Key: OverrideProxyPassword
  Value: [string] default: ""
  Sperrt und setzt die Einstellung, die das Kennwort angibt, das bei der Authentifizierung mit einem Proxyserver zu verwenden ist. Beachten Sie, dass dieser Wert durch eine verschlüsselte Version "OverrideProxyPasswordProt" ersetzt wird, sobald die Anwendung nach Hinzufügen dieses Wertes gestartet wird. Stellen Sie sicher, dass Sie die Anwendung mindestens einmal nach dem Hinzufügen eines Kennworts starten, damit es sicher verschlüsselt wird.
• DownloadRateLimit
  Key: OverrideDownloadRateLimit
  Value: [integer number] default: 0
  Sperrt und setzt die Einstellung für die Download-Rate. Wenn kein/ein ungültiger/negativer Wert angegeben wird, wird er auf 0 gesetzt.
• UploadRateLimit
  Key: OverrideUploadRateLimit
  Value: [integer number] default: 0
  Sperrt und setzt die Einstellung für die Upload-Rate. Wenn kein/ein ungültiger/negativer Wert angegeben wird, wird er auf 0 gesetzt.
• AutoLogoutMode
  Key: AutoLogoutMode
  Value: [true/false/0/1] default: true
  Sperrt und setzt die Einstellung, den Benutzer automatisch abzumelden und alle lokal gespeicherten Daten zu löschen, bevor der Client geschlossen wird. Wenn kein/ein ungültiger/negativer Wert angegeben wird, wird er standardmäßig auf true gesetzt.
• UseCloudView
  Key: OverrideUseCloudView
  Value: [true/false/0/1] default: false
  Sperrt und setzt die Einstellung zur automatischen Aktivierung der Cloud-Ansicht, wenn der Client gestartet wird. Wenn Sie diese Einstellung sperren, stellen Sie sicher, dass Sie auch einen Laufwerksbuchstaben mit dem Schlüssel „OverrideBaseDirPath“ festlegen. Falls im Schlüssel „OverrideBaseDirPath“ kein Laufwerksbuchstabe angegeben ist, wird diese Einstellung ignoriert.
• CloudViewCleanupDelay
  Key: OverrideCloudViewCleanupDelay
  Value: [-1/1/24/168/720] default: -1
  Sperrt und setzt die Einstellung zum automatischen Löschen lokaler Dokumente nach der angegebenen Zeit in Stunden bei Verwendung der Cloud-Ansicht. Verwenden Sie -1, um die Löschung von Dokumenten aus dem lokalen Cache zu deaktivieren.

Einstellungen sperren

• DisableDataPathChange
  Key: DisableDataPathChange
  Wenn dieser Schlüssel in der Registrierung gefunden wird (unabhängig von seinem Wert), kann der Benutzer das Basisverzeichnis nicht über die Client-Einstellungen ändern. Die Benutzeroberfläche für die Einstellungen des Basisverzeichnisses wird ausgeblendet. Verwenden Sie diese Option, wenn Sie nicht möchten, dass Ihre Benutzer die Einstellungen des Basisverzeichnisses ändern können.

Umgebungseinstellungen

• DisableUpdates
  Key: DisableUpdates
  Wenn dieser Schlüssel in der Registrierung gefunden wird (unabhängig von seinem Wert), wird der Benutzer nicht automatisch benachrichtigt, wenn eine Aktualisierung verfügbar ist. Auch der Menüeintrag zur manuellen Aktualisierung des Clients wird ausgeblendet.
• ExpertMode
  Key: ExpertMode
  Wenn dieser Schlüssel in der Registrierung gefunden wird (unabhängig von seinem Wert), enthält die Registerkarte Allgemeine Einstellungen ein zusätzliches Feld, in dem der Benutzer den „DataDirPath“ festlegen kann.
• ForceRemoveTopLevelFolder
  Key: ForceRemoveTopLevelFolder
  Wenn dieser Schlüssel in der Registrierung gefunden wird (unabhängig von seinem Wert), wird der Eintrag für den obersten Ordner des Explorers entfernt (die Ordnerverknüpfung in der Navigationsleiste im linken Bereich des Windows-Dateiexplorers). Die Verknüpfung wird jedes Mal gelöscht, wenn der Client heruntergefahren wird, wird aber neu erstellt, wenn der Client gestartet wird. Ohne diese Markierung bleibt der oberste Ordner erhalten, ist aber nicht zugänglich, wenn der Client nicht läuft.
• NoSyncMode
  Key: NoSyncMode
  Wenn dieser Schlüssel in der Registrierung gefunden wird (unabhängig von seinem Wert), startet der Client in einem speziellen Cloud-View-Modus, der keine Synchronisationen für alle Sammlungen und Ordner erzwingt. Der Benutzer kann nur die reine Cloud-Ansicht verwenden, ohne bestimmte Ordner oder Sammlungen explizit synchronisieren zu können. Während des NoSyncMode enthält das Einstellungsmenü keine Sync-Einstellungen und die Optionen zum Aktivieren der Synchronisierung von Ordnern oder Sammlungen sind im Kontextmenü nicht verfügbar. 
• NoSyncCleanupDelay
  Key: NoSyncCleanupDelay
  Eine spezifische Verzögerung für die Bereinigung der Cloud-Ansicht, die nur verwendet wird, wenn „NoSyncMode“ aktiv ist. Wirkt wie CloudViewCleanupDelay, wird aber nur im NoSyncMode verwendet.
• IgnoredFolders
  Key: IgnoredFolders
  Value: A list of folder name patterns string separated by "|". E.g. "Temp|Temporary*|~Tmp|"
  Kann eine Liste von Ordnernamensmustern angeben, die vom Client ignoriert werden sollen. Jedes Muster sollte durch eine Pipe ("|") getrennt werden. Sie können "*" in Mustern verwenden, um eine beliebige Anzahl von Zeichen anzugeben, und "?" für ein einzelnes Zeichen. Wenn der Wert leer ist oder nicht angegeben wird, werden die Standardmuster verwendet (.* ; ~$* ; ~*).
• IgnoredFiles
  Key: IgnoredFiles
  Value: A list of file name patterns string separated by "|". E.g.: "test.*|*.tmp|ignoreMe.txt"
  Kann eine Liste von Dateinamensmustern angeben, die vom Client ignoriert werden sollen. Jedes Muster sollte durch eine Pipe ("|") getrennt werden. Sie können "*" in Mustern verwenden, um eine beliebige Anzahl von Zeichen anzugeben, und "?" für ein einzelnes Zeichen. Wenn der Wert leer ist oder nicht angegeben wird, werden die Standardmuster verwendet (.* ; Thumbs.db ; desktop.ini ; ~$* ; ~~$* ; ~.tmp).

Ignorieren von Dateien und Ordnern

Manchmal kann es notwendig sein, lokale Dateien und Ordner zu ignorieren, die nicht in die CenterDevice Cloud hochgeladen werden sollen. Um festzustellen, welche Dateien ignoriert werden sollen, verwendet der Client eine Reihe von Standardbenennungsmustern und bietet die Möglichkeit, benutzerdefinierte Muster über die Registrierung anzugeben. Ignorierte Dateien und Ordner werden im Dateiexplorer als versteckt markiert und nicht mehr in das Backend hochgeladen. Alle Dateien unter einem ignorierten Ordner werden ebenfalls ignoriert.

Dateien und Ordner werden immer nur lokal ignoriert, werden aber trotzdem von der Cloud aus synchronisiert, wenn sie einem Ignoriermuster entsprechen. Normalerweise muss der Benutzer sicherstellen, dass ignorierte Dateien nicht aus der Ferne existieren, um Probleme oder Konflikte zu vermeiden. Falls der Benutzer bestimmte Ordner selektiv synchronisieren/herunterladen möchte, sollten die regulären Synchronisierungseinstellungen verwendet werden.

Auch wenn dieses Verhalten aus Sicht der Software sinnvoll ist, kann es zu verwirrenden Situationen führen. Stellen Sie sich das folgende Szenario vor: Ein Benutzer erstellt im Web-Client einen Ordner namens "~Temp". Dieser Ordner entspricht dem Standardbenennungsmuster für ignorierte Ordner. Ordner aus der Cloud werden jedoch nie ignoriert, so dass der Ordner synchronisiert wird. Sobald er synchronisiert ist, wird er im Explorer ausgeblendet, und alle lokal hinzugefügten Dateien werden nicht hochgeladen, da sie sich in einem ignorierten Ordner befinden.

Mandanten und Sammlungen können nicht ignoriert werden und werden bei der Bestimmung von ignorierten Dateien oder Ordnern nicht berücksichtigt.

• Ignore patterns
  Zu ignorierende Muster geben ein Benennungsschema an, das mit dem vollständigen Dateinamen abgeglichen wird, um festzustellen, ob eine Datei oder ein Ordner ignoriert werden soll. Sie können "*" in Mustern verwenden, um eine beliebige Anzahl von Zeichen anzugeben, und "?" für ein einzelnes Zeichen.
  Der Dateiname "foo.txt" wird mit den folgenden Mustern abgeglichen:
  • *.txt
  • foo.*
  • ?oo.tx? 
• Default ignored files
  Wenn der Benutzer keine benutzerdefinierten Muster in der Registrierung angegeben hat, ignoriert der Client standardmäßig Dateien, die den folgenden Namensmustern entsprechen:
  • .*
  • Thumbs.db
  • desktop.ini
  • ~$*
  • ~~$*
  • ~.tmp

• Default ignored folders
  Wenn der Benutzer keine benutzerdefinierten Muster in der Registrierung angegeben hat, ignoriert der Client standardmäßig Ordner, die den folgenden Namensmustern entsprechen:
  • .*
  • ~$*
  • ~*