SharePoint API

Diese Schnittstelle bietet die Möglichkeit bidirektional mit dem SharePoint System zu interagieren.  
 Kompatibilität 
 
 SharePoint Online 
 SharePoint On-Premises (2013-2019) 
 
 Konfiguration 
 Um ein SharePoint System per REST/OData anzusprechen und Aktionen auszuführen, muss an der Squeeze Dokumentenklasse ein Export definiert werden: 
 Authentifizierung 
 Bei der Authentifizierung kann zwischen drei verschiedenen Mechanismen gewählt werden: 
 
 User - Anmeldung am SharePoint mit Benutzer 
 App 
 NTLM 
 
 Authentifizierung als User 
 Um eine Benutzter-basierte Authentifizierung zu nutzen, ist im Feld Authentication Type der Wert User auszuwählen. Anschließend muss in die Felder Username sowie Password ein Benutzer, der dem SharePoint System bekannt ist, hinterlegt werden. 
 
 Authentifizierung als App 
 Um eine App-basierte Authentifizierung zu nutzen, ist im Feld Authentication Type der Wert App auszuwählen. Anschließend muss in die Felder Client Id  sowie Client Secret eine Registrierte App Kennung hinterlegt werden, die dem SharePoint System bekannt ist. 
 Die Passwortfelder (Passwort und ClientSecret) sind nach dem Speichern nicht mehr einsehbar. 
 Entität 
 Um in das System zu exportieren, muss zunächst die Entität bestimmt werden, in welche exportiert werden soll: 
 
 Dokumentenbibliothek 
 Liste 
 
 Nachdem dies ausgewählt wurde, kann im Feld "Entity ID" die entsprechende Liste oder Dokumentenbibliothek angegeben werden in der letztendlich der Export stattfindet. Für Dokumentenbibliotheken muss der technische Name angegeben werden, bei Listen der Anzeigename. 
 
 Dokumentenbibliothek 
 Für die Dokumentenbibliotheken gibt es noch zwei weitere Einstellungen.  
 Export Folder Structure gibt den Pfad in der Dokumentenbibliothek an, in den exportiert werden soll. Dieser kann dynamisch aus Feldwerten der Felder der jeweiligen Dokumentenklasse angegeben werden. Hierzu in dem Feld den Pfad von links nach rechts mit Feldern der Dokumentenklasse auswählen: 
 
 Die letzte Einstellungsmöglichkeit gibt an, ob SQUEEZE den Export-Pfad erstellen soll, falls dieser nicht vorhanden ist. Ist der Pfad nicht vorhanden und SQUEEZE soll diesen nicht erstellen, wird ein Fehler beim Export eines Vorgangs durch den SharePoint zurückgegeben. 
 Feldwerte exportieren 
 Mit den Namen im Zielsystem (externe Feldnamen) können die Spalten eines Listeneintrages bzw. weitere Spalten/Details eines Eintrags einer Dokumentenbibliothek angegeben werden. 
 
 Diese können in der Dokumentenklasse bei den Feldern angegeben werden. 
 Positionen exportieren 
 Jedes "Table"-Feld (in dem Beispiel die "LineItems") kann als JSON exportiert werden, wenn ein Zielname definiert wurde. Dabei muss das Zielfeld mehrzeilig sein. 
 Reservierte Zielnamen 
 
 
 Der reservierte Zielname " ContentTypeId " gibt das SQUEEZE Feld an, welches den Inhaltstyp des exportierten Vorgangs angibt. Hier reicht es, den Namen anzugeben, SQUEEZE holt sich die ID selbst vom SharePoint.  
 
 
 Hierbei handelt es sich um die globalen Inhaltstypen (Root) des SharePoints.