Voraussetzungen
Für die Einrichtung des Intrexx Connector für SharePoint Server/Online sollten Ihnen die folgenden Informationen vorliegen:
Microsoft Azure
-
Verzeichnis-ID (Mandant); TenantID
-
AnwendungsID (Client)
-
Geheimer Clientschlüssel (Wert!)
Microsoft SharePoint
-
Name der SharePoint Seite
-
Name der SharePoint Liste
-
Name der SharePoint Dokumenten-Bibliothek
-
Tenant Name
Zudem benötigen Sie folgende Informationen:
-
Root URI( z.B.: https://login.microsoftonline.com)
Für das Anlegen einer Datengruppe benötigen Sie folgende Informationen aus SharePoint:
-
(Interne/technische) Feldbezeichnungen und Datentypen der Felder, auf die Sie zugreifen möchten.
Schritt-für-Schritt
Um den Intrexx Connector für SharePoint Server/Online anzulegen, gehen Sie wie folgt vor:
-
Starten Sie das Modul "Integration".
-
Wählen Sie unter "Daten konsumieren" den Eintrag "Connector für Connector API" aus.
-
Führen Sie einen Rechtsklick aus.
-
Wählen Sie "+ Neue Datenquelle" aus.
Das Dialogfenster "Allgemein" wird angezeigt.
Allgemeine Angaben
Name
Tragen Sie hier den Namen der Verbindung ein. Der Name darf nur die Buchstaben [a-zA-Z] und Zahlen [0-9] enthalten, sowie Unterstrich und Bindestrich.
Zeigt die ID des Connectors bzw. der Verbindung an. Diese wird automatisch aus dem Connector Template und dem Namen des Connectors, verbunden mit einem Unterstrich, zusammengesetzt.
Beschreibung
Hier können Sie eine Beschreibung des Connectors eintragen.
Connector Template
Wählen Sie hier "mssharepoint" aus.
Timeout
Hier kann die Anzahl der Millisekunden, Sekunden, Minuten oder Stunden für den Timeout eingetragen werden. Wählen Sie die Zeiteinheit in der Auswahlliste rechts neben dem Timeout-Feld aus.
Aktiv
Wenn Sie diese Einstellung setzen, sind die Timeout-Einstellungen aktiviert.
-
Klicken Sie auf "Weiter".
Sie gelangen in den Dialog "Datengruppen".
Datengruppen
Die Datengruppen "SharepointFiles" und "SharepointList" sind bereits angelegt. Sie dienen als Vorlage bzw. Beispiele. Sie enthalten Angaben, die Sie beim Erstellen einer eigenen bzw. von weiteren Datengruppen benötigen.
Sie können zu diesem Zeitpunkt auf die Anlage einer Datengruppe verzichten und dies nach dem Anlegen des Connector für SharePoint Server/Online durchführen.
Detaillierte Informationen zum Anlegen einer Datengruppe finden Sie in Abschnitt Datengruppe im Connector für SharePoint Server/Online anlegen.
-
Klicken Sie auf "Weiter".
Sie gelangen in den Dialog "Authentifizierung".
-
Wählen Sie bei "Authentifizierungs-Typ" den Wert "OAUTH2" aus.
Die Felder mit den erforderlichen Angaben zu "OAUTH2" werden angezeigt.
Authentifizierung
Authentifizierungs-Typ
Wählen Sie hier "OAUTH2" aus.
Grant-Type
Wählen Sie hier "AUTHORIZATION_CODE " aus.
Authorization URI
Erfassen Sie hier die Authorization URI.
Die Authorization URI setzt sich folgendermaßen zusammen:
<https://login.microsoftonline.com>/[TenantID]/oauth2/v2.0/authorize
Beispiel
https://login.microsoftonline.com/1234e7e16-b7ee-41a3-ffff-76d9716789/oauth2/v2.0/authorize
Token URI
Erfassen Sie hier die Token URI.
Die Token URI setzt sich folgendermaßen zusammen:
<https://login.microsoftonline.com>/[TenantID]/oauth2/v2.0/token
Beispiel
https://login.microsoftonline.com/12345-e16-b7ee-ffff-ak05-76d971-6789/oauth2/v2.0/token
Redirect URI (Umleitungs-URI)
Hier wird die Redirect URI automatisch von Intrexx eingestellt.
Die Redirect URI setzt sich folgendermaßen zusammen:
<BasisURL>/oauth2/token/<GUID des Sharepoint Connectors>
Beispiel:
https://exampleportal.com/service/oauth2/token/123450DEA65FFFFB087EFC539FA010BBD8B6789
Basis-URL Die Basis-URL finden Sie im Hauptmenü unter "Portal > Portaleigenschaften > Frontend Webserver ".
GUID des Connector für SharePoint Server/Online Bei Bedarf können Sie die GUID des Connector für SharePoint Server/Online selbst ermitteln. Eine ausführliche Beschreibung hierzu finden Sie in Abschnitt Connector für SharePoint Server/Online GUID ermitteln (optional).
Die Redirect URI (Rückmeldungs-URL) müssen Sie in Azure in der IntrexxPortal-App hinterlegen. Eine Beschreibung hierzu finden Sie in Abschnitt Redirect URI in Microsoft Azure hinterlegen.
Client ID
Statisch Hinterlegen Sie hier die AnwendungsID aus der IntrexxPortalApp, die Sie in Microsoft Azure registriert haben.
Client Secret
Statisch Hinterlegen Sie hier den Wert (!) des Geheimen Clientschlüssels aus der IntrexxPortalApp, die Sie in Microsoft Azure registriert haben.
Scope
Hier legen Sie die Berechtigungen fest, mit denen Intrexx-Benutzer bzw. Intrexx-Dienstkonten auf SharePoint zugreifen sollen.
Statisch Sie können hier einen Default-Wert hinterlegen. Dann greifen die Intrexx-Benutzer bzw. Intrexx-Dienstkonten mit den Berechtigungen auf SharePoint zu, die Sie in Microsoft Azure erteilt haben.
Wenn Sie den Default-Wert nutzen möchten, müssen Sie Folgendes hinterlegen:
https://<TenantName>.sharepoint.com/.default
Beispiel
https://examplecompany.sharepoint.com/.default
Sie können auch die Berechtigungen, die Sie in Microsoft Azure erteilt haben, einzeln hinterlegen. Die einzelnen Berechtigungen sind dabei durch ein Leerzeichen zu trennen.
Weitere Informationen zu den Berechtigungen im Zusammenhang mit dem Connector für SharePoint Server/Online finden Sie in Abschnitt API-Berechtigungen für Intrexx Connector für SharePoint Server/Online festlegen
-
Klicken Sie auf "Weiter".
Sie gelangen in den Dialog "Service Benutzer".
Service Benutzer
Service Benutzer bieten die Möglichkeit, sich an SharePoint anzumelden, ohne dass dabei ein persönlicher Benutzer zum Einsatz kommt. Ein Service Benutzer bietet sich beispielsweise dann an, wenn beim Ausführen von Prozessen eine automatisierte Anmeldung an SharePoint erfolgen soll. Es besteht auch die Möglichkeit, eine Fremddatengruppe so einzurichten, dass die Anmeldung an SharePoint über einen Service Benutzer erfolgt.
Detaillierte Informationen zum Anlegen und Einsatz von Service Benutzern finden Sie in folgenden Abschnitten:
-
Klicken Sie auf "Weiter".
Sie gelangen in den Dialog "Expert-Settings".
Expert-Settings
Hier finden Sie die folgenden Angaben:
Attribut Wert connector.auth.type OAUTH2 oauth2.accessTokenUri https://login.microsoftonline.com/12345e16-b7ee-41a3-ffff-76d971cc6789/oauth2/v2.0/token oauth2.authenticationScheme header oauth2.clientAuthenticationScheme client_secret_basic oauth2.clientId 1234d5b1-9654-4275-ffff-34ec7ec06789 oauth2.clientId.source STATIC oauth2.clientSecret 1234~xVQ40j8VZV_ffff_pH2uR.aHtt56789 oauth2.clientSecret.source STATIC oauth2.grantType authorization_code oauth2.redirectUri https://exampleportal.com/service/oauth2/token/123435B47B25411A82E7ADA2D6C620FDDD56789 oauth2.scope https://intrexx.sharepoint.com/.default oauth2.scope.source STATIC oauth2.userAuthorizationUri https://login.microsoftonline.com/12345e16-b7ee-ffff-ad05-76d971c6789/oauth2/v2.0/authorize serviceTimeout 0 Nach dem Fertigstellen des Connectors werden weitere Attribute angezeigt.
-
Klicken Sie auf "Fertigstellen".
Der Connector wird angezeigt.
-
Öffnen Sie den Connector.
Weitere Expert-Settings werden angezeigt.
-
Erfassen Sie für das Attribut "serviceRootURI" den entsprechenden Wert.
Attribut Wert serviceRootURI https://[TenantName].sharepoint.com
Das Attribut "serviceRootURI" muss die vollständige URL der SharePoint Website beinhalten.
useSSL true
Ihre nächsten Schritte
Datengruppe im Connector für SharePoint Server/Online anlegen (falls nicht bereits durchgeführt)
Senden Sie uns eine E-Mail