Das SharepointToDB Add-In exportiert Elemente einer Sharepoint Liste oder Dokumentenbibliothek in eine SQL Datenbank. Im Falle einer Dokumentenbibliothek kann das Dokument in ein binäres Datenbankfeld gespeichert werden.
| Merkmale | |
| Add-In Type | Logic |
| Schnittstellen | Sharepoint |
| Transaktionen | 1 wenn erfolgreich |
| Ereignisse | <Instanz>.Done |
| Parameter | |
| spWebUrl | Sharepoint Web URL. |
| spListName | Name der Sharepoint-Liste oder -Bibliothek. |
| spViewName | (Optional) Name der Sharepoint-View welche die zu exportierenden Felder enthält. Wenn leer wird die Default-View verwendet. |
| spUser | (Optional) Benutzername zur Authentifizierung auf Sharepoint. |
| spPassword | (Optional) Passwort zur Authentifizierung auf Sharepoint. |
| entriesToExport | Legt fest, ob alle oder nur die seit der letzten Ausführung geänderten Einträge exportiert werden. |
| connectionString | Verbindungszeichenfolge zur Datenbank. |
| useDbTransaction | Wenn aktiv, wird eine Datenbank-Transaktion verwendet und bei einem Fehler ein Rollback durchgeführt. |
| preCommand | Optional ein SQL Befehl der vor dem Abgleich ausgeführt wird. |
| postCommand | Optional ein SQL Befehl der nach dem Abgleich ausgeführt wird. |
| tableName | Name der Datenbanktabelle. |
| primaryKeyColumn | (Optional) Name der Primärschlüssel-Spalte. Existierende Zeilen mit passendem Primärschlüssel werden gelöscht und neu eingefügt. |
| fileColumn | (Optional) Name der binären Datenbankspalte in welche die Datei geschrieben wird wenn es sich um eine Sharepoint Bibliothek handelt. |
| columnMapping | (Optional) Zuordnung von Sharepoint Feldern zu Datanbank Spalten. Beispiel: spField1:dbColumn1,spField2:dbColumn2 |
| endpoint | Name des Endpunktes der in der Transaktion verwendet wird (Optional, Default = “”) |
Standardmässig werden SharePoint-Felder in Datenbank-Spalten geschrieben die gleich heissen. Mittels des columnMapping Parameters kann dieses Verhalten beeinflusst werden. Folgendes Beispiel mappt ein SharePoint Feld “Account Type” auf die Datenbank-Spalte “AccountType”:
Account_x0020_Type:AccountType
Möchte man verhindern dass ein SharePoint-Feld auf eine Datenbank-Spalte gemappt wird, z.B. beim Feld “ID” welches bei jedem SharePoint Element vorhanden ist, kann dieses auf eine “leere” DB Spalte gemappt werden:
ID:
Im columnMapping Parameter können mehrere Mappings durch Kommas getrennt angegeben werden.
Handelt es sich bei der im Parameter spListName angegebenen Liste um eine Dokumentenbibliothek, kann das Dokument des Elements in eine binäre Datenbank-Spalte geschrieben werden. Die Datenbank-Spalte muss dazu vom Typ varbinary oder image sein und ihr Name muss im Parameter fileColumn angegeben werden.
Wird der Parameter entriesToExport auf CHANGED gesetzt, werden nur diejenigen Elemente synchronisiert, die seit der letzten Ausführung geändert haben. Dazu wird das Last modified Datum des SharePoint Elements mit dem Datum der letzten Ausführung der Add-In Instanz verglichen. Das Datum der letzten Ausführung wird als Instanz-Parameter im Verzeichnis %programdata%\Sevitec\OneConnexx\AddInData gespeichert.