Microsoft SharePoint Server Verbindung

Einführung

Eine Microsoft SharePoint Server Verbindung, die mit dem Microsoft SharePoint Server Connector erstellt wurde, richtet den Zugriff auf Microsoft SharePoint Server ein. Nachdem eine Verbindung konfiguriert wurde, können Sie Instanzen von Microsoft SharePoint Server-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Erstellen oder Bearbeiten einer Microsoft SharePoint Server Verbindung

Eine neue Microsoft SharePoint Server Verbindung wird mithilfe des Microsoft SharePoint Server Connectors von einem der folgenden Standorte aus erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).

Eine bestehende Microsoft SharePoint Server Verbindung kann von diesen Orten aus bearbeitet werden:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).

Konfigurieren einer Microsoft SharePoint Server Verbindung

Nachfolgend werden die einzelnen Benutzeroberflächenelemente des Verbindungskonfigurationsbildschirms für Microsoft SharePoint Server beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Microsoft SharePoint Server-Verbindung eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:) Dieser Name wird auch verwendet, um den Microsoft SharePoint Server Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• URL: Geben Sie die URL ein.

• Share Point Edition: Wählen Sie die SharePoint-Edition aus, eine der folgenden:

  • SharePoint Online

    • Authentifizierungsschema: Wählen Sie das Autorisierungsschema aus:

      • AzureAD

      • AzurePassword

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

        • Azure Mandant: Geben Sie den Azure Mandanten ein.

      • OAuthJWT

        • Azure Mandant: Geben Sie den Azure Mandanten ein.

        • OAuth JWT-Aussteller: Geben Sie den OAuth JWT-Aussteller ein.

        • OAuth JWT-Zertifikat: Geben Sie das OAuth JWT-Zertifikat ein.

        • OAuth JWT-Zertifikatstyp: Wählen Sie den OAuth JWT-Zertifikatstyp, einen der folgenden:

          • BENUTZER

          • MASCHINE

          • PFXDATEI

          • PFXBLOB

          • JKSFILE

          • JKSBLOB

          • PEMKEY_FILE

          • PEMKEY_BLOB

          • ÖFFENTLICHE_SCHLÜSSELDATEI

          • PUBLIC_KEY_BLOB

          • SSHPUBLIC_KEY_FILE

          • SSHPUBLIC_KEY_BLOB

          • P7BFILE

          • PPKDATEI

          • XMLDATEI

          • XMLBLOB

      • AzureMSI

      • PingFederate

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

        • SSO-Domäne: Geben Sie die SSO-Domäne ein.

      • ADFS

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

        • SSO-Domäne: Geben Sie die SSO-Domäne ein.

      • OneLogin

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

        • SSO-Domäne: Geben Sie die SSO-Domäne ein.

      • Okta

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

        • SSO-Domäne: Geben Sie die SSO-Domäne ein.

      • OAuth

      • SharePointOAuth

        • OAuth initiieren: Wählen Sie eine der folgenden OAuth-Einstellungen:

          • AUS

            • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

          • GETANDREFRESH

          • AKTUALISIEREN

            • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

        • OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

        • OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.

        • OAuth-Grant-Typ: Wählen Sie den OAuth-Grant-Typ aus, einen der folgenden:

          • CODE

          • PASSWORT

          • SAML_1

          • KUNDE

        • OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.

      • NTLM

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

      • Grundlegend

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

  • SharePoint vor Ort

    • Authentifizierungsschema: Wählen Sie das Autorisierungsschema aus:

      • NTLM

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

      • Verhandeln

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

      • Keine

      • Grundlegend

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

      • ADFS

        • Benutzer: Geben Sie den Benutzer ein.

        • Passwort: Geben Sie das Passwort ein.

        • SSO-Domäne: Geben Sie die SSO-Domäne ein.

• Schema: Wählen Sie das Schema aus, eines der folgenden:

  • SOAP

  • REST

• Proxy-Einstellungen verwenden: Wählen Sie diese Option aus, um private Agent-Proxy-Einstellungen zu verwenden.

• Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Erweiterte Konfigurationseigenschaften angezeigt, die zum Hinzufügen zusätzlicher Konfigurationseigenschaften verwendet wird als Key-Value Paare.

  Klicken Sie auf das Symbol „Hinzufügen“ , um der folgenden Tabelle eine Zeile hinzuzufügen, und geben Sie für jede Zeile ein Key-Value Paar ein.

  Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol in der Spalte ganz rechts.

  Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und verwenden Sie das Bearbeitungssymbol oder Löschsymbol .

  Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.

  Wichtig

  Felder in der Tabelle Erweiterte Konfigurationen zeigen das variable Symbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein.

• Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Konfigurieren von OAuth-Verbindungen

Dieser Connector unterstützt eine Verbindung über OAuth durch die Verwendung bestimmter Konfigurationseigenschaften. Nachdem Sie ein Authentifizierungsschema ausgewählt haben, das OAuth initiieren enthält, können Sie die Konfiguration in den angezeigten Feldern angeben.

Für diesen Connector werden zwei Szenarien unterstützt. In beiden Szenarien müssen Sie ein Drittpartei verwenden (z. B. Postman oder ein ähnliches Tool), um das oder die erforderlichen Zugriffstoken vom betreffenden Endpoint abzurufen. Beide Szenarien funktionieren nur für Einzelagentengruppen. Dabei handelt es sich um Agentengruppen, die aus einem einzelnen Agenten bestehen.

• Szenario 1: Verwenden eines OAuth-Zugriffstokens, das nach einer festgelegten Zeit abläuft.

  Mit dieser Konfiguration geben Sie ein OAuth-Zugriffstoken an, das für einen festgelegten Zeitraum gültig ist, der vom jeweiligen Endpoint bestimmt wird. Der Connector verwendet das Token, um die Verbindung herzustellen. Die Verbindung funktioniert jedoch nicht mehr, sobald das Zugriffstoken abläuft. Sie konfigurieren den Connector für die Verwendung des Tokens, indem Sie diese Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  OAuth initiieren	OFF
  OAuth-Zugriffstoken	Auf den Wert des vom Endpoint erhaltenen OAuth-Zugriffstokens eingestellt

• Szenario 2: Verwenden eines OAuth-Zugriffstokens in Kombination mit einem OAuth-Aktualisierungstoken, um die automatische Aktualisierung des Zugriffs zu ermöglichen.

  Mit dieser Konfiguration verwendet der Connector ein Aktualisierungstoken, um ein neues Zugriffstoken zu erhalten, sobald das aktuelle Zugriffstoken abgelaufen ist. Dies ist im Allgemeinen die beste Methode zum Konfigurieren von OAuth.

  Sie geben ein OAuth-Zugriffstoken und ein OAuth-Aktualisierungstoken an, je nach dem jeweiligen Endpoint. Sie konfigurieren den Connector für die Verwendung dieser Token, indem Sie die folgenden Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  OAuth initiieren	REFRESH
  OAuth-Zugriffstoken	Auf den Wert des vom Endpoint erhaltenen OAuth-Zugriffstokens eingestellt
  OAuth-Aktualisierungstoken	Auf den Wert des vom Endpoint erhaltenen OAuth-Aktualisierungstokens eingestellt

Nächste Schritte

Nachdem eine Microsoft SharePoint Server Connector-Verbindung hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verwenden von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Abfrage: Ruft Datensätze aus einer Tabelle auf einem Microsoft SharePoint Server ab und ist zur Verwendung als Quelle in einer Operation vorgesehen.

• Erstellen: Fügt einen Datensatz in eine Tabelle auf einem Microsoft SharePoint Server ein und soll als Ziel in einer Operation verwendet werden.

• Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle auf einem Microsoft SharePoint Server und soll als Ziel in einer Operation verwendet werden.

• Löschen: Löscht einen Datensatz aus einer Tabelle auf einem Microsoft SharePoint Server und ist als Ziel in einer Operation vorgesehen.

• Ausführen: Führt eine Prozedur auf einem Microsoft SharePoint Server aus und ist zur Verwendung als Ziel in einer Operation vorgesehen.