Einstellungen

Mithilfe von Einstellungen können bestimmte Globale Eigenschaften, aber auch Attribute und Verhalten von Syncjobs konfiguriert werden. Es gibt sowohl globale Einstellungen, z.B. für die Bestimmung der Zugriffsberechtigungen einzelner Benutzer, als auch für Syncjobs, um bspw. bestimmte Werte wie Freigabenlimits zu definieren.

Bei der Erstellung/Angabe einer Einstellung muss immer mindestens der Name der Einstellung (name), der Wert (value) sowie die Ebene, auf der die Einstellung gilt (hierarchyContext) angegeben werden.

Nachfolgendes Beispiel zeigt eine Einstellung im JSON-Format, wie sie bei einer Anfrage übergeben werden kann:

{
    "name":"ShOnlineMetadataExportType",
    "value":"AsJson",
    "hierarchyContext":"SyncJob"
}

Bestimmte Einstellungen können dabei nur von Administratoren gesetzt oder bearbeitet werden, während andere Einstellungen auch von normalen Benutzern gesetzt oder bearbeitet werden können.

Die Einstellungen können dabei einen der folgenden Berechtigungen besitzen:

• None: Kein Zugriff auf die Einstellung
• Read: Nur lesenden Zugriff auf die Einstellung
• Write: Kann die Einstellung aktualisieren/schreiben. Lesezugriff inbegriffen
• Delete: Einstellung kann gelöscht werden. Lese- und Schreibzugriff inbegriffen
• Admin: nur Administrator hat Vollzugriff

Bei Einstellungen, welche sowohl auf Benutzerebene als auch auf Syncjobebene gelten, wird dabei die Syncjobeinstellung priorisiert. Wenn keine spezifische Einstellung auf einem Syncjob definiert ist, dann wird die nächsthöhere Benutzer- oder Gruppeneinstellung verwendet, sofern vorhanden.

Folgende Einstellungen stehen dabei zur Verfügung:

MaxSyncDocumentSize

Diese Einstellung gibt an, bis zu welcher Dateigröße Dokumente synchronisiert werden sollen. Wird die Dateigröße überschritten, dann wird für das Dokument eine Freigabe angelegt.

• Berechtigung: Write
• Gültigkeit: UserOrGroup/SyncJob
• Erlaubte Werte: Eine positive Ganzzahl als String kodiert.

MaxSyncableDocuments

Diese Einstellung gibt an, wieviele Dokumente in einem Syncjob synchronisiert werden sollen. Wird die Anzahl überschritten, dann wird für den Job eine Freigabe angelegt.

• Berechtigung: Write
• Gültigkeit: UserOrGroup/SyncJob
• Erlaubte Werte: Eine positive Ganzzahl als String kodiert.

AllowedAccessByUsersOrGroups

Diese Einstellung bestimmt die Benutzer, die sich an ELO Sync anmelden können. Sie kann nur von Administratoren geändert werden.

• Berechtigung: Admin
• Gültigkeit: Global
• Erlaubte Werte: Benutzerid als Ganzzahl, String kodiert.

GroupPermissions

Diese Einstellung gibt an, welche Berechtigung eine Gruppe oder ein Benutzer haben, z.B. auf welches System sie zugreifen können oder welche Arten von Jobs sie verwenden können.

• Berechtigung: Admin

• Gültigkeit: Global

• Erlaubte Werte: Array von Kombinationen aus dem Drittsystem und dem Jobtyp, z.B. ["OneDrive.Archive","OneDrive.TwoWay","SharePoint.Archive"].

  Diese Einstellung sollte am besten über den Endpunkt SetUserPermissions gesetzt werden.

ShMetadataMappings

Diese Einstellung beinhaltet die Metadatenzuordnung zwischen Sharepointspalten und ELO Maskenfeldern.

• Berechtigung: Write

• Gültigkeit: UserOrGroup/SyncJob

• Erlaubte Werte: Json-String eines Objektes, welches eine Eigenschaft 'eloField' mit dem Pfad zum ELO Maskenfeld sowie eine Eigenschaft 'thirdSystemField' mit dem Pfad zur Spalte in SharePoint besitzt, z.B.:

  {\"eloField\":\"Ordner\\\\ELOINDEX\",\"thirdSystemField\":\"3\\\\Shared Documents\\\\Title\"}"

ShOnlineArchivedEntriesReplacementMode

Diese Einstellung gibt an, ob das Originaldokument bei Archivierungsjobs behalten, gelöscht oder durch eine URL-Datei mit dem Link zu dem Dokument in ELO ersetzt werden soll.

• Berechtigung: Write
• Gültigkeit: SyncJob
• Erlaubte Werte: Einer der folgenden Werte: "None", "ReplaceByUrlFile" oder "DeleteEntry"

ShOnlineMetadataExportType

Diese Einstellung gibt an, ob und wenn ja in welchem Format die Metadaten exportiert werden sollen. Ist die Einstellung gesetzt, dann wird eine entsprechende Datei neben dem Dokument mit den Metadaten abgelegt.

• Berechtigung: Write
• Gültigkeit: SyncJob
• Erlaubte Werte: Einer der folgenden Werte: "None", "AsJson" oder "AsXlsx"

OneDriveArchivedEntriesReplacementMode

Diese Einstellung gibt an, ob das Originaldokument bei Archivierungsjobs behalten, gelöscht oder durch eine URL-Datei mit dem Link zu dem Dokument in ELO ersetzt werden soll.

• Berechtigung: Write
• Gültigkeit: SyncJob
• Erlaubte Werte: Einer der folgenden Werte: "None", "ReplaceByUrlFile" oder "DeleteEntry"

ReplaceWithGroupSettings

Diese Einstellung gibt an, ob die Benutzereinstellungen durch Gruppeneinstellungen überschrieben werden sollen.

• Berechtigung: Read
• Gültigkeit: Global
• Erlaubte Werte: "true" oder "false"

EloSyncEulaAgreed

Diese Einstellung gibt an, ob der EULA bereits zugestimmt wurde. Wenn dieser Wert auf false ist, stehen bestimmte Aktionen nicht zur Verfügung.

• Berechtigung: Admin
• Gültigkeit: Global
• Erlaubte Werte: "true" oder "false"

DashboardSetting

Diese Einstellung beinhaltet das Dashboardlayout mit den angeordneten Widgets.

• Berechtigung: Write
• Gültigkeit: UserOrGroup
• Erlaubte Werte: Das Dashboardlayout als JSON-String kodiert. Wird hier nicht näher beschrieben, da das Dashboard bei der Verwendung über die REST-API nicht benötigt wird.

MaxFolderReferencesDepthPublish

Diese Einstellung gibt an, bis zu welcher Tiefe Ordnerreferenzen beachtet werden sollen.

• Berechtigung: Write
• Gültigkeit: UserOrGroup/SyncJob
• Erlaubte Werte: Eine positive Ganzzahl als String kodiert.

SyncConflictResolutionStrategy

Diese Einstellung gibt an, ob Konflikte automatisch gelöst werden sollen, und wenn ja mit welcher Version.

• Berechtigung: Write
• Gültigkeit: SyncJob
• Erlaubte Werte: "0" (Manually), "1" (UseEloVersion) oder "2" (UseThirdSystemVersion)