SharePoint

Mit dem SharePoint-Connector können Sie Dateien, Ordner und Anhänge in SharePoint verwalten.

Unterstützte Versionen

Dieser Connector unterstützt Windows SharePoint Services 3.0, Microsoft Office SharePoint Server 2007 und höher sowie SharePoint Online.

Hinweise

Führen Sie in Ihrem Google Cloud-Projekt die folgenden Aufgaben aus:

  • Prüfen Sie, ob eine Netzwerkverbindung eingerichtet ist. Weitere Informationen finden Sie unter Netzwerkverbindung.
  • Weisen Sie dem Nutzer, der den Connector konfiguriert, die IAM-Rolle roles/connectors.admin zu.
  • Weisen Sie dem Dienstkonto, das Sie für den Connector verwenden möchten, die IAM-Rollen roles/secretmanager.viewer und roles/secretmanager.secretAccessor zu:
  • Aktivieren Sie secretmanager.googleapis.com (Secret Manager API) und connectors.googleapis.com (Connectors API). Weitere Informationen finden Sie unter Dienste aktivieren.

SharePoint-Verbindung erstellen

Eine Verbindung ist für eine Datenquelle spezifisch. Wenn Sie also viele Datenquellen haben, müssen Sie für jede Datenquelle eine separate Verbindung erstellen. So erstellen Sie eine Verbindung:

  1. Rufen Sie in der Cloud Console die Seite Integration Connectors > Verbindungen auf und wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Seite „Verbindungen“

  2. Klicken Sie auf + NEU ERSTELLEN, um die Seite Verbindung erstellen zu öffnen.
  3. Wählen Sie im Bereich Standort einen Standort aus der Liste Region aus und klicken Sie dann auf Weiter.

    Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

  4. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
    1. Wählen Sie SharePoint aus der Connector-Liste aus.
    2. Wählen Sie eine Connector-Version aus der Liste Connector-Version aus. Der SharePoint-Connector ist in zwei Versionen verfügbar: V1 und V2.
    3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein. Der Verbindungsname darf Kleinbuchstaben, Zahlen oder Bindestriche enthalten. Der Name muss mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden und darf nicht länger als 49 Zeichen sein.
    4. Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
    5. Optional können Sie Cloud Logging aktivieren und dann eine Logebene auswählen. Die Logebene ist standardmäßig auf Error festgelegt.
    6. Wählen Sie im Feld Dienstkonto ein Konto mit den erforderlichen Rollen aus.
    7. Konfigurieren Sie optional die Verbindungsknoteneinstellungen:

      • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
      • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

      Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.

    8. Optional: Wählen Sie im Abschnitt Erweiterte Einstellungen das Kästchen Proxy verwenden aus, um einen Proxyserver für die Verbindung zu konfigurieren, und konfigurieren Sie die folgenden Werte:
      • Proxy-Authentifizierungsschema: Wählen Sie den Authentifizierungstyp für die Authentifizierung beim Proxyserver aus. Die folgenden Authentifizierungstypen werden unterstützt:
        • Standard: Basis-HTTP-Authentifizierung.
        • Digest: Digest-HTTP-Authentifizierung.
      • Proxy-Nutzer: Ein Nutzername, der für die Authentifizierung beim Proxyserver verwendet werden soll.
      • Proxy-Passwort: Das Secret Manager-Secret des Nutzerpassworts.
      • Proxy-SSL-Typ: Der SSL-Typ, der beim Herstellen einer Verbindung zum Proxyserver verwendet werden soll. Die folgenden Authentifizierungstypen werden unterstützt:
        • Automatisch: Standardeinstellung. Wenn die URL eine HTTPS-URL ist, wird die Option „Tunnel“ verwendet. Wenn die URL eine HTTP-URL ist, wird die Option „NIE“ verwendet.
        • Immer: Die Verbindung ist immer SSL-aktiviert.
        • Nie: Die Verbindung ist nicht SSL-fähig.
        • Tunnel: Die Verbindung erfolgt über einen Tunneling-Proxy. Der Proxyserver öffnet eine Verbindung zum Remotehost und der Traffic fließt über den Proxy hin und her.
      • Geben Sie im Abschnitt Proxyserver die Details des Proxyservers ein.
        1. Klicken Sie auf + Ziel hinzufügen.
        2. Wählen Sie einen Zieltyp aus.
          • Hostadresse: Geben Sie den Hostnamen oder die IP-Adresse des Ziels an.

            Wenn Sie eine private Verbindung zu Ihrem Backend-System herstellen möchten, gehen Sie so vor:

            • Erstellen Sie einen PSC-Dienstanhang.
            • Erstellen Sie einen Endpunktanhang und geben Sie dann die Details des Endpunktanhangs in das Feld Hostadresse ein.
    9. Klicken Sie optional auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
    10. Klicken Sie auf Weiter.
  5. Geben Sie im Bereich Ziele die Details zum Remote-Host (Backend-System) ein, zu dem Sie eine Verbindung herstellen möchten, und klicken Sie auf Weiter.

    6. Wählen Sie im Feld Zieltyp einen Zieltyp aus. Die Hostadresse ist beispielsweise https://<SITE_NAME>.sharepoint.com.

    • Wenn Sie den Zielhostnamen oder die Ziel-IP-Adresse angeben möchten, wählen Sie Hostadresse aus und geben Sie die Adresse in das Feld Host 1 ein.
    • Wenn Sie eine private Verbindung herstellen möchten, wählen Sie Endpunktanhang aus und wählen Sie den erforderlichen Anhang aus der Liste Endpunktanhang aus.

    Wenn Sie eine öffentliche Verbindung zu Ihren Back-End-Systemen mit zusätzlicher Sicherheit herstellen möchten, können Sie statische ausgehende IP-Adressen für Ihre Verbindungen konfigurieren und dann Ihre Firewallregeln konfigurieren, um nur bestimmte statische IP-Adressen zuzulassen.

    Wenn Sie weitere Ziele eingeben möchten, klicken Sie auf + Ziel hinzufügen.

  6. Geben Sie im Abschnitt Authentifizierung die Authentifizierungsdetails ein.
    1. Wählen Sie einen Authentifizierungstyp aus und geben Sie die relevanten Details ein.

      Die folgenden Authentifizierungstypen werden von der SharePoint-Verbindung unterstützt:

      • Windows-Anmeldedaten Wählen Sie diese Option aus, wenn Sie die lokale Version von SharePoint verwenden.
      • AzureAD. Wählen Sie diese Option aus, wenn Sie die Onlineversion von SharePoint verwenden.
      • OAuth 2.0-Clientanmeldedaten mit JWT-Inhaber. Wählen Sie diese Option aus, wenn Sie OAuth 2.0-Clientanmeldedaten mit JWT-Inhaber zur Authentifizierung verwenden.
      • OAuth 2.0-Clientanmeldedaten mit Clientschlüssel Wählen Sie diese Option aus, wenn Sie OAuth 2.0-Clientanmeldedaten mit Clientschlüssel für die Authentifizierung verwenden.

      2. Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

    2. Klicken Sie auf Weiter.
  7. Prüfen Sie im Abschnitt Überprüfen Ihre Verbindungs- und Authentifizierungsdetails.
  8. Klicken Sie auf Erstellen.

Authentifizierung konfigurieren

Der SharePoint-Connector unterstützt die folgenden Authentifizierungstypen:

Authentifizierungstyp für Windows-Anmeldedaten

Führen Sie die folgenden Schritte aus, um den Authentifizierungstyp „Windows-Anmeldedaten“ zu aktivieren:

  1. PSC konfigurieren und Endpunktanhang erstellen
  2. Geben Sie die Anmeldedaten in Google Cloudan.

PSC konfigurieren und Endpunktanhang erstellen

  1. Erstellen Sie eine Instanzgruppe mit der IP-Adresse, auf der SharePoint gehostet wird.
  2. Erstellen Sie einen internen Passthrough-Network-Load-Balancer und verwenden Sie die von Ihnen erstellte Instanzgruppe als Backend. Für den internen TCP-Load-Balancer muss der globale Zugriff aktiviert sein.
  3. Veröffentlichen Sie den Load Balancer in Private Service Connect. Ein Dienstanhang wird generiert, nachdem der Load Balancer veröffentlicht wurde.
  4. Veröffentlichen Sie den Dienst und geben Sie den von Ihnen erstellten Load-Balancer an.
  5. Verwenden Sie den Dienstanhang, um einen Endpunktanhang zu erstellen.
  6. Nachdem Sie den Endpunktanhang erstellt haben, erstellen Sie eine SharePoint-Verbindung mit der IP-Adresse des Endpunktanhangs.

    7. Weitere Informationen zum Erstellen einer Endpunkt-Anhängung finden Sie unter Endpunkt-Anhängung erstellen.

Windows-Anmeldedaten in Google Cloudangeben

Wenn Sie die Verbindung in Integration Connectors erstellen , müssen Sie die folgenden Details angeben:

Wählen Sie im Bereich Authentifizierung die Option Windows-Anmeldedaten als Authentifizierungstyp aus und geben Sie dann die folgenden Details ein:

  • Nutzername: Geben Sie den Nutzernamen ein.
  • Passwort: Wählen Sie das Passwort aus.
  • Secret-Version: Geben Sie die Secret-Version ein.

Verbindungstyp „Windows-Anmeldedaten“

In der folgenden Tabelle sind die Beispielkonfigurationswerte für den Verbindungstyp „Windows-Anmeldedaten“ aufgeführt.

Feldname Details
Region us-central1
Connector SharePoint
Connector-Version 1
Verbindungsname sharepoint-staging-psc
Dienstkonto SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Mindestanzahl von Knoten 2
Maximale Anzahl von Knoten 50
Zieltyp Hostadresse
Host 1 http://192.0.2.0
Port 1 24
Authentifizierung Anmeldedaten für Windows
Nutzername USER_NAME
Passwort PASSWORT
Secret-Version 1

Azure AD-Authentifizierungstyp

So aktivieren Sie den Azure AD-Authentifizierungstyp:

  1. Registrieren Sie Ihre App und rufen Sie die OAuthClientId und OAuthClientSecret ab.
  2. Geben Sie die Anmeldedaten in Google Cloudan.
  3. Autorisieren Sie die Verbindung in Google Cloud.
  4. Fügen Sie die Weiterleitungs-URL zu Ihrer App hinzu.

App registrieren und OAuthClientId und OAuthClientSecret abrufen

So registrieren Sie Ihre App und rufen die OAuthClientId und OAuthClientSecret für Ihre App ab:

  1. Melden Sie sich im Azure-Portal an.
  2. Wählen Sie unter Azure-Dienste die Option App-Registrierungen und dann Neue Registrierung aus.
  3. Geben Sie einen Anwendungsnamen ein und wählen Sie Beliebiger Microsoft Entra ID-Mandant – Multitenant aus.
  4. Klicken Sie auf Registrieren.
  5. Rufen Sie nach dem Erstellen der App die Seite Zertifikate und Secrets auf.
  6. Erstellen Sie einen Clientschlüssel für die Anwendung und speichern Sie den Wert des Clientschlüssels.
  7. Rufen Sie die Seite API-Berechtigungen auf.
  8. Klicken Sie auf Berechtigung hinzufügen.
  9. Wählen Sie im Dialogfeld API-Berechtigungen anfordern die API, den Typ und die Berechtigungen aus der folgenden Tabelle aus, um Vorgänge in der Anwendung auszuführen.

    10. Damit die Verbindung aktiv ist, müssen Sie die Berechtigung Sites.Read.All für die Microsoft Graph API erteilen.

    API Name der Berechtigung Typ
    Microsoft Graph ConsentRequest.Read.All Application/ Delegated
    Microsoft Graph ConsentRequest.ReadWrite.All Application/ Delegated
    Microsoft Graph DelegatedAdminRelationship.Read.All Application/ Delegated
    Microsoft Graph DelegatedAdminRelationship.ReadWrite.All Application/ Delegated
    Microsoft Graph DelegatedPermissionGrant.Read.All Application/ Delegated
    Microsoft Graph DelegatedPermissionGrant.ReadWrite.All Application/ Delegated
    Microsoft Graph Files.Read.All Application/ Delegated
    Microsoft Graph Files.ReadWrite.All Application/ Delegated
    Microsoft Graph Sites.FullControl.All Application/ Delegated
    Microsoft Graph Sites.Manage.All Application/ Delegated
    Microsoft Graph Sites.Read.All Application/ Delegated
    Microsoft Graph Sites.ReadWrite.All Application/ Delegated
    Microsoft Graph Sites.Selected Application/ Delegated
    Microsoft Graph TermStore.Read.All Application/ Delegated
    Microsoft Graph TermStore.ReadWrite.All Application/ Delegated
    Microsoft Graph User.Export.All Application/ Delegated
    Microsoft Graph User.Read Delegated
    Microsoft Graph User.Read.All Application/ Delegated
    Microsoft Graph User.ReadWrite.All Application/ Delegated
    SharePoint EnterpriseResource.Read Delegated
    SharePoint EnterpriseResource.Write Delegated
    SharePoint Project.Read Delegated
    SharePoint Project.Write Delegated
    SharePoint ProjectWebApp.FullControl Delegated
    SharePoint ProjectWebAppReporting.Read Delegated
    SharePoint TaskStatus.Submit Delegated
  10. Speichern Sie die Änderungen.
  11. Wenn Sie Berechtigungen ausgewählt haben, für die eine Administratoreinwilligung erforderlich ist, können Sie diese im aktuellen Mandanten auf der Seite API-Berechtigungen erteilen.
  12. Wenn Sie den Bereich hinzufügen möchten, rufen Sie den Abschnitt API verfügbar machen auf, fügen Sie AllSites.Manage, Sites.FullControl.All-Bereiche hinzu und wählen Sie aus, wer die Steuerung übernehmen kann (Administratoren und Nutzer).
  13. Klicken Sie auf Speichern.

Anmeldedaten in Google Cloudangeben

Wenn Sie die Verbindung in Integration Connectors erstellen , müssen Sie die folgenden Details angeben:

Wählen Sie im Bereich Authentifizierung den Authentifizierungstyp AzureAD aus und geben Sie die folgenden Details ein:

  • Client-ID: Geben Sie die Client-ID ein, die zum Anfordern von Zugriffstokens verwendet wird.
  • Bereiche: Geben Sie eine durch Kommas getrennte Liste der gewünschten Bereiche ein. Beispiel: Sites.FullControl.All.
  • Clientschlüssel: Geben Sie das Secret ein, das den Clientschlüssel für die verbundene App enthält, die Sie erstellt haben.
  • Secret-Version: Secret-Version für das oben ausgewählte Secret.
  • Autorisierungs-URL: Die Autorisierungs-URL, die Sie beim Erstellen eines OAuth-Clients generieren. Geben Sie die URL im folgenden Format ein: https://login.microsoftonline.com/TENANT_IDENTIFIER/oauth2/v2.0/authorize?prompt=consent. Beispiel: https://login.microsoftonline.com/9byyyyyyyyy8112/oauth2/v2.0/authorize?prompt=consent

Verbindung in Google Cloudautorisieren

  1. Suchen Sie auf der Seite „Verbindungen“ nach der neu erstellten Verbindung.

    Der Status für den neuen Connector ist Autorisierung erforderlich.

  2. Klicken Sie auf Autorisierung erforderlich.

    Der Bereich Autorisierung bearbeiten wird angezeigt.

  3. Kopieren Sie den Wert unter Weiterleitungs-URI in Ihre externe Anwendung. Weitere Informationen finden Sie unter Weiterleitungs-URL zur App hinzufügen.
  4. Überprüfen Sie die Autorisierungsdetails.
  5. Klicken Sie auf Autorisieren.

    Wenn die Autorisierung erfolgreich ist, wird der Verbindungsstatus auf der Seite Verbindungen auf Aktiv gesetzt.

Weiterleitungs-URL zur App hinzufügen

  1. Klicken Sie im Azure-Portal auf Azure-Dienste > App-Registrierungen.
  2. Klicken Sie auf den Namen Ihrer App.
  3. Klicken Sie auf „Weiterleitungs-URI hinzufügen“.
  4. Klicken Sie auf Plattform hinzufügen.
  5. Fügen Sie im Dialogfeld Web den Weiterleitungs-URI ein, den Sie beim Autorisieren der Verbindung in Google Cloudkopiert haben.

Azure AD-Verbindungstyp

In der folgenden Tabelle sind die Beispielkonfigurationswerte für den Verbindungstyp „Azure AD“ aufgeführt:

Feldname Details
Region us-central1
Connector SharePoint
Connector-Version 1
Verbindungsname sharepoint-google-cloud-con
Dienstkonto SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Mindestanzahl von Knoten 2
Maximale Anzahl von Knoten 50
Zieltyp Hostadresse
Host 1 http://z8**.sharepoint.com
Authentifizierung AzureAD
Client-ID CLIENT_ID
Bereiche Sites.FullControl.All
Clientschlüssel CLIENT_SECRET
Secret-Version 1
Autorisierungs-URL https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize?prompt=consent

OAuth 2.0 – Clientanmeldedaten mit JWT-Inhaber-Authentifizierungstyp

So aktivieren Sie den Authentifizierungstyp „OAuth 2.0 – Clientanmeldedaten mit JWT-Inhaber“:

  1. Zertifikat erstellen
  2. Zertifikat in das Azure-Portal hochladen
  3. Privaten Schlüssel abrufen
  4. Einrichtung abschließen
  5. Geben Sie die OAuth 2.0-JWT-Inhaber-Anmeldedaten in Google Cloud an.

Zertifikat erstellen

  1. Erstellen Sie auf Ihrem Computer einen leeren Ordner.
  2. Erstellen Sie eine Textdatei im Ordner.
  3. Kopieren Sie das PowerShell-Skript von der Seite Zugriff über Azure AD-App-Only gewähren und fügen Sie es in die Textdatei ein.
  4. Benennen Sie die Textdatei in Create-SelfSignedCertificate.ps1 um.
  5. Führen Sie Windows PowerShell im Ordner aus.
  6. Wechseln Sie zu dem Verzeichnis, das die Textdatei enthält.
  7. Kopieren Sie den folgenden Befehl: .\Create-SelfSignedCertificate.ps1 -CommonName "CERTIFICATE_NAME" -StartDate 2022-09-25 -EndDate 2023-10-25

    Geben Sie einen eindeutigen Namen für CERTIFICATE_NAME ein. Ändern Sie „StartDate“ in das aktuelle Datum und „EndDate“ in ein beliebiges Datum.

  8. Fügen Sie den kopierten Befehl mit Ihren Änderungen in Windows PowerShell ein und drücken Sie die Eingabetaste.

    In Windows PowerShell werden Sie aufgefordert, das Passwort zum Schutz des privaten Schlüssels einzugeben. Speichern Sie das Passwort für die spätere Verwendung.

    Windows PowerShell erstellt zwei Dateien: MyCertificate.pfx und MyCertificate.cer.

Zertifikat in das Azure-Portal hochladen

  1. Melden Sie sich im Azure-Portal an und registrieren Sie eine neue Anwendung, indem Sie die folgenden Details angeben:
    • Name: Geben Sie einen Namen für die Anwendung ein.
    • Wählen Sie unter Unterstützte Kontotypen die Option Nur Konten in diesem Organisationsverzeichnis (nur Kontoname – Single Tenant) aus.
  2. Klicken Sie auf API-Berechtigungen > Berechtigung hinzufügen > API-Berechtigungen anfordern > SharePoint.
  3. Wählen Sie Anwendungsberechtigungen aus und fügen Sie dann die erforderlichen Berechtigungen hinzu.
  4. Wählen Sie Administratoreinwilligung erteilen und dann Ja aus.
  5. Rufen Sie nach dem Erstellen der App den Bereich Zertifikate und Secrets auf.
  6. Wählen Sie Zertifikat hochladen aus und laden Sie dann das CER-Zertifikat von Ihrem Computer hoch. Wählen Sie nach Abschluss des Uploads Hinzufügen aus.

    Fügen Sie keine Clientschlüssel in die App ein, da dies den zertifikatbasierten Authentifizierungsablauf beeinträchtigt.

  7. Rufen Sie das Manifest auf, suchen Sie nach „KeyCredentials“ und kopieren Sie dann „customKeyIdentifier“ als Fingerabdruck. Sie benötigen ihn später. Sie haben die App jetzt registriert und das Zertifikat verknüpft.

Privaten Schlüssel abrufen

Sie können einen privaten Schlüssel abrufen, indem Sie die PFX-Datei mit OpenSSL in eine PEM-Datei konvertieren.

  1. Rufen Sie in der Eingabeaufforderung den Ordner mit Ihrer PFX-Datei auf und führen Sie den folgenden Befehl aus: openssl pkcs12 -in MyCertificate.pfx -out MyCertificate.pem -nodes
  2. Geben Sie das PFX-Passwort ein, das Sie beim Erstellen des Zertifikats verwendet haben.
  3. Öffnen Sie die PEM-Datei in einem Texteditor und kopieren Sie den gesamten Text. Das ist Ihr privater Schlüssel.

Einrichtung abschließen

  1. Kopieren Sie die Client-ID und die Mandanten-ID aus der neu registrierten App im Azure-Portal.
  2. Melden Sie sich mit der SharePoint-List-Dienstprinzipalauthentifizierung mit den folgenden Anmeldedaten an:
    • Client-ID
    • Mandanten-ID
    • Privater Schlüssel
    • Fingerabdruck (Passwort für den privaten Schlüssel)

OAuth 2.0-JWT-Inhaber-Anmeldedaten in Google Cloud angeben

Wenn Sie die Verbindung in Integration Connectors erstellen , müssen Sie die folgenden Details angeben:

Wählen Sie im Bereich Authentifizierung die Option OAuth 2.0-Clientanmeldedaten mit JWT-Inhaber als Authentifizierungstyp aus und geben Sie dann die folgenden Details ein:

  • Geben Sie im Feld Client-ID die Client-ID ein, die zum Anfordern von Zugriffstokens verwendet wird. Dies ist der Consumerschlüssel, der bei der Registrierung der App im Azure-Portal generiert wurde.
  • Wählen Sie im Feld Privater Schlüssel das Secret Manager-Secret mit dem Inhalt der privaten Schlüsseldatei im PEM-Format aus. Der private Schlüssel sollte mit dem Public-Key-Zertifikat übereinstimmen, das für Connector bereitgestellt wird.
  • Wählen Sie im Feld Secret-Version die Version für das oben ausgewählte Secret aus.
  • Wählen Sie im Feld Passwort für privaten Schlüssel das Secret Manager-Secret mit dem Passwort (Paraphrase) der privaten Schlüsseldatei aus. Verwenden Sie dasselbe Passwort, das Sie beim Erstellen des Zertifikats zum Schutz des privaten Schlüssels festgelegt haben.
  • Wählen Sie im Feld Secret-Version die Version für das oben ausgewählte Secret aus.
  • Geben Sie im Feld Azure-Mandant den Microsoft Online-Mandanten ein, der für den Datenzugriff verwendet wird.

Verbindungstyp für JWT-Inhaberzertifikat

In der folgenden Tabelle sind die Beispielkonfigurationswerte für den Verbindungstyp „OAuth 2.0-JWT-Inhaberzertifikat“ aufgeführt.

Feldname Details
Region europe-west1
Connector SharePoint
Connector-Version 1
Verbindungsname sharepoint-jwt-certificate
Dienstkonto SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Mindestanzahl von Knoten 2
Maximale Anzahl von Knoten 50
Zieltyp Hostadresse
Host 1 http://z8**.sharepoint.com
Port 1 ****
Authentifizierung OAuth 2.0-Clientanmeldedaten mit JWT-Inhaber
OAuth-Client-ID CLIENT_ID
Privater Schlüssel SCHLÜSSEL
Secret-Version 1
Passwort für den privaten Schlüssel PASSWORT
Secret-Version 1
Azure-Mandant AZURE_TENANT_ID

OAuth 2.0 – Verbindungstyp „Clientschlüssel“

Wenn Sie den Verbindungstyp „OAuth 2.0-Clientschlüssel“ aktivieren möchten, müssen Sie die folgenden Schritte ausführen:

  1. Add-in registrieren
  2. Berechtigungen für das Add-on erteilen
  3. OAuth 2.0-Clientanmeldedaten in Google Cloud angeben
  4. Erneute Autorisierung für Autorisierungscode

Add‑in registrieren

  1. Rufen Sie die Seite Add-in registrieren über die folgende URL auf: https://<SITE_NAME>.SharePoint.com/_layouts/15/appregnew.aspx.
  2. Generieren Sie im Abschnitt App-Informationen die Client-ID und den Clientschlüssel.
  3. Geben Sie Werte für „Titel“, „App-Domain“ und „Weiterleitungs-URI“ an.
  4. Klicken Sie auf Erstellen.Das Add-in wird registriert und in der SharePoint-App werden die erstellten Informationen angezeigt.

Add-in Berechtigungen erteilen

  1. Rufen Sie die SharePoint-Website über die folgende URL auf: https://<SITE_NAME>-admin.sharepoint.com/_layouts/15/appinv.aspx. Sie werden zur Seite Berechtigung erteilen weitergeleitet.
  2. Geben Sie im Feld App-ID die Client-ID ein, die Sie zuvor generiert haben, und klicken Sie auf Suchen. Die Werte für „Titel“, „App-Domain“ und „Weiterleitungs-URL“ werden automatisch ausgefüllt.
  3. Geben Sie die folgende Berechtigungsanfrage im XML-Format ein: 
          <AppPermissionRequests AllowAppOnlyPolicy="true">
      <AppPermissionRequest Scope="http://sharepoint.com/content/tenant" Right="FullControl"/>
      </AppPermissionRequests>
  4. Klicken Sie auf Erstellen. In der SharePoint-App wird ein Dialogfeld für die Einwilligung in die Berechtigungen angezeigt.
  5. Klicken Sie auf Vertrauen.

OAuth 2.0-Clientanmeldedaten in Google Cloud angeben

Wenn Sie die Verbindung in Integration Connectors erstellen, müssen Sie die folgenden Details angeben:

Wählen Sie im Bereich Authentifizierung als Authentifizierungstyp OAuth 2.0-Clientanmeldedaten mit Clientschlüssel aus und geben Sie dann die folgenden Details ein:

  • Geben Sie im Feld Client-ID die Client-ID ein, die vom Connector für die von Ihnen erstellte App bereitgestellt wird.
  • Wählen Sie im Feld Clientschlüssel das Secret Manager-Secret mit dem Clientschlüssel für die verbundene App aus, die Sie erstellt haben.
  • Wählen Sie im Feld Secret-Version die Version des Clientschlüssels aus.

Erneute Autorisierung für Autorisierungscode

Wenn Sie den Authentifizierungstyp Authorization code verwenden und Änderungen an der Konfiguration in Ihrer SharePoint-Anwendung vorgenommen haben, müssen Sie Ihre SharePoint-Verbindung noch einmal autorisieren. So autorisieren Sie eine Verbindung neu:

  1. Klicken Sie auf der Seite Verbindungen auf die gewünschte Verbindung.

    Dadurch wird die Seite mit den Verbindungsdetails geöffnet.

  2. Klicken Sie auf Bearbeiten, um die Verbindungsdetails zu bearbeiten.
  3. Prüfen Sie im Abschnitt Authentifizierung die Details zu OAuth 2.0-Autorisierungscode.

    Nehmen Sie bei Bedarf die erforderlichen Änderungen vor.

  4. Klicken Sie auf Speichern. Sie werden zur Seite mit den Verbindungsdetails weitergeleitet.
  5. Klicken Sie im Abschnitt Authentifizierung auf Autorisierung bearbeiten. Dadurch wird der Bereich Autorisieren angezeigt.
  6. Klicken Sie auf Autorisieren.

    Wenn die Autorisierung erfolgreich ist, wird der Verbindungsstatus auf der Seite Verbindungen auf Aktiv gesetzt.

Verbindungstyp für Clientanmeldedaten

In der folgenden Tabelle sind die Beispielkonfigurationswerte für den Verbindungstyp „OAuth 2.0-Clientanmeldedaten“ aufgeführt.

Feldname Details
Region europe-west1
Connector SharePoint
Connector-Version 1
Verbindungsname sharepoint-client-credentials
Dienstkonto SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Mindestanzahl von Knoten 2
Maximale Anzahl von Knoten 50
Zieltyp Hostadresse
Host 1 http://z8**.sharepoint.com
Port 1 ****
Authentifizierung OAuth 2.0-Clientanmeldedaten mit Clientschlüssel
Client-ID CLIENT_ID
Clientschlüssel CLIENT_SECRET
Secret-Version 1

SharePoint-Verbindung in einer Integration verwenden

Nachdem Sie die Verbindung erstellt haben, ist sie sowohl in Apigee Integration als auch in Application Integration verfügbar. Sie können die Verbindung in einer Integration über die Aufgabe „Connectors“ verwenden.

Aktionen

In diesem Abschnitt werden einige der vom Connector unterstützten Aktionen aufgeführt. Informationen zum Konfigurieren der Aktionen finden Sie unter Beispiele für Aktionen.

Version 1

In Version 1 unterstützte Aktionen

AddAttachments, CheckInDocument, CheckOutDocument, CopyDocument, CreateFolder, DeleteAttachment, DiscardCheckOutDocument, DownloadAttachments, DownloadDocument, MoveAttachmentOrDocument und UploadDocument.

Version 2

In Version 2 unterstützte Aktionen

AddAttachments, AddLists, CheckInDocument, CheckInFile, CheckPermission, CheckOutDocument, CopyDocument, CreateFolder, DeleteAttachment, DeleteDocument, DeleteLists, DiscardCheckOutDocument, DownloadAttachments, DownloadDocument, MoveAttachmentOrDocument und UploadDocument.

DeleteAttachment-Aktion

Durch diese Aktion wird ein Anhang gelöscht.

Eingabeparameter der Aktion „DeleteAttachment“

Parametername Datentyp Erforderlich Beschreibung
ListTitle String Ja Der Titel des Listeneintrags.
ItemId String Ja Die ID des Listenelements.
FileName String Ja Der Name der Datei, die in der Dokumentbibliothek gelöscht werden soll.

Ein Beispiel für die Konfiguration der Aktion DeleteAttachment finden Sie unter Beispiele.

„AddLists“-Aktion

Dadurch wird der Dokumentbibliothek eine Liste hinzugefügt.

Eingabeparameter der Aktion „AddLists“

Parametername Datentyp Erforderlich Beschreibung
Vorlage String Nein Der Name der verwendeten Vorlage.
Beschreibung String Nein Eine Beschreibung der Liste.
Name String Nein Der Name der Liste, die der Dokumentbibliothek hinzugefügt werden soll.

Ein Beispiel für die Konfiguration der Aktion AddLists finden Sie unter Beispiele.

DeleteDocument-Aktion

Dadurch wird das Dokument aus der Bibliothek gelöscht.

Eingabeparameter der Aktion „DeleteDocument“

Parametername Datentyp Erforderlich Beschreibung
Bibliothek String Ja Der Name der Dokumentbibliothek, in der die Datei gespeichert ist.
Pfad String Ja Der relative Pfad des Dokuments.

Ein Beispiel für die Konfiguration der Aktion DeleteDocument finden Sie unter Beispiele.

„CheckPermission“-Aktion

Mit dieser Aktion werden die Berechtigungen eines Nutzers oder einer Gruppe für eine Liste oder ein Listenelement geprüft.

Eingabeparameter der CheckPermission-Aktion

Parametername Datentyp Erforderlich Beschreibung
ListName String Nein Der Titel der Liste.
Hauptkonto String Nein Der Anmeldename des Nutzers
ItemId String Nein Die ID des Listenelements.

Ein Beispiel für die Konfiguration der Aktion CheckPermission finden Sie unter Beispiele.

DeleteLists-Aktion

Mit dieser Aktion wird eine Liste in der Dokumentbibliothek gelöscht.

Eingabeparameter der Aktion „DeleteLists“

Parametername Datentyp Erforderlich Beschreibung
Name String Nein Der Name der Liste, die in der Dokumentbibliothek gelöscht werden soll.

Ein Beispiel für die Konfiguration der Aktion DeleteLists finden Sie unter Beispiele.

CheckInFile-Aktion

Mit dieser Aktion wird die Datei oder das Dokument eingecheckt.

Eingabeparameter der Aktion „CheckInFile“

Parametername Datentyp Erforderlich Beschreibung
RelativeURL String Ja Die relative URL des Ordners.
DocumentName String Ja Der Name der Datei.
Kommentar String Ja Ein Kommentar zum Check-in.

Ein Beispiel für die Konfiguration der Aktion CheckInFile finden Sie unter Beispiele.

Aktion „CheckOutDocument“

Mit dieser Aktion wird die Datei oder das Dokument ausgecheckt.

Eingabeparameter der CheckOutDocument-Aktion

Parametername Datentyp Erforderlich Beschreibung
RelativeURL String Ja Die relative URL des Ordners.
DocumentName String Ja Der Name der Datei.

Ein Beispiel für die Konfiguration der Aktion CheckOutDocument finden Sie unter Beispiele.

Aktion „CheckInDocument“

Mit dieser Aktion können Sie in einem Dokument nachsehen.

Eingabeparameter der Aktion „CheckInDocument“

Parametername Datentyp Erforderlich Beschreibung
RelativeURL String Ja Die relative URL des Ordners.
DocumentName String Ja Der Name der Datei.
Kommentar String Nein Ein Kommentar zum Check-in.

Ein Beispiel für die Konfiguration der Aktion CheckInDocument finden Sie unter Beispiele.

DiscardCheckOutDocument-Aktion

Mit dieser Aktion können Sie das Auschecken einer Datei rückgängig machen.

Eingabeparameter der Aktion „DiscardCheckOutDocument“

Parametername Datentyp Erforderlich Beschreibung
RelativeURL String Ja Die relative URL des Ordners.
DocumentName String Ja Der Name der Datei.

Ein Beispiel für die Konfiguration der Aktion DiscardCheckOutDocument finden Sie unter Beispiele.

Aktion „CopyDocument“

Mit dieser Aktion können Sie eine Datei von einem Speicherort an einen anderen kopieren.

Eingabeparameter der Aktion „CopyDocument“

Parametername Datentyp Erforderlich Beschreibung
SourceFileRelativeUrl String Ja Die relative URL der Quelldatei.
DestFileRelativeUrl String Ja Die relative URL der Zieldatei.

Ein Beispiel für die Konfiguration der Aktion CopyDocument finden Sie unter Beispiele.

Aktion „UploadDocument“

Mit dieser Aktion können Sie eine Datei hochladen.

Eingabeparameter der Aktion „UploadDocument“

Parametername Datentyp Erforderlich Beschreibung
FileName String Ja Name der Datei, die hochgeladen werden soll.
RelativeUrl String Ja Die relative URL des Ordners.
Inhalt String Nein Inhalte, die als Datei hochgeladen werden sollen.
ContentBytes String Nein Base64-codierter Inhalt der Datei. Damit können Sie binäre Daten hochladen.
HasBytes Boolesch Nein Mit diesem Parameter wird angegeben, ob der hochzuladende Inhalt binär ist. Der Standardwert ist false.

Ein Beispiel für die Konfiguration der Aktion UploadDocument finden Sie unter Beispiele.

Aktion „DownloadDocument“

Mit dieser Aktion können Sie eine Datei herunterladen.

Eingabeparameter der Aktion „DownloadDocument“

Parametername Datentyp Erforderlich Beschreibung
RemoteFile String Ja Die URL des Dokuments. Das kann entweder eine vollständige oder eine relative URL sein.
Bibliothek String Ja Der Name der Bibliothek.
HasBytes Boolesch Nein Mit diesem Parameter wird angegeben, ob der Inhalt als Byte heruntergeladen werden soll. Der Standardwert ist false.

Ein Beispiel für die Konfiguration der Aktion DownloadDocument finden Sie unter Beispiele.

MoveAttachmentOrDocument-Aktion

Mit dieser Aktion können Sie eine Datei von einem Ordner in einen anderen verschieben.

Eingabeparameter der Aktion „MoveAttachmentOrDocument“

Parametername Datentyp Erforderlich Beschreibung
SourceFileURL String Ja Die URL der zu verschiebenden Quelldatei.
DestinationFolderURL String Ja Die URL des Zielordners.

Ein Beispiel für die Konfiguration der Aktion MoveAttachmentOrDocument finden Sie unter Beispiele.

Aktion „CreateFolder“

Mit dieser Aktion können Sie einen Ordner erstellen.

Eingabeparameter der Aktion „CreateFolder“

Parametername Datentyp Erforderlich Beschreibung
RelativeURL String Ja Die relative URL des Ordners.
FolderName String Ja Der Name des Ordners, der erstellt werden soll.

Ein Beispiel für die Konfiguration der Aktion CreateFolder finden Sie unter Beispiele.

AddAttachments-Aktion

Mit dieser Aktion können Sie einen Anhang hinzufügen.

Eingabeparameter der Aktion „AddAttachments“

Parametername Datentyp Erforderlich Beschreibung
ListTitle String Ja Der Name der Liste der Anhänge.
FileName String Ja Der Name der angehängten Datei.
ItemId String Ja Die ID des hinzuzufügenden Anhangs.
Inhalt String Ja Inhalt des Anhangs.
ContentBytes String Nein Base64-codierter Inhalt der Datei. Damit können Sie binäre Daten hochladen.
HasBytes Boolesch Nein Mit diesem Parameter wird angegeben, ob der hochzuladende Inhalt binär ist. Der Standardwert ist false.

Ein Beispiel für die Konfiguration der Aktion AddAttachments finden Sie unter Beispiele.

Aktion „DownloadAttachments“

Mit dieser Aktion können Sie Anhänge herunterladen.

Eingabeparameter der Aktion „DownloadAttachments“

Parametername Datentyp Erforderlich Beschreibung
RemoteFile String Ja Die URL der Datei.
HasBytes Boolesch Nein Mit diesem Parameter wird angegeben, ob der herunterzuladende Inhalt binär ist. Der Standardwert ist false.

Ein Beispiel für die Konfiguration der Aktion DownloadAttachments finden Sie unter Beispiele.

Beispiele für Aktionen

In diesem Abschnitt wird beschrieben, wie Sie einige der Aktionen in diesem Connector ausführen.

Beispiel: Anhang löschen

In diesem Beispiel wird die angegebene Datei gelöscht.

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DeleteAttachment aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"ListTitle": "My lists",
"ItemId": "1",
"FileName": "sitepages.txt"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DeleteAttachment-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel: Datei einchecken

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CheckInFile aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
  "RelativeURL": "/Shared Documents/TestFolder",
  "DocumentName": "Document.docx",
  "Comment": "Comment test with more than 1 word"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CheckInFile-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel: Liste einer Mediathek hinzufügen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion AddLists aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
  "Template": "DocumentLibrary",
  "Description": "testdata_from_gcpcloud",
  "Name": "TestList1757601118898"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des AddLists-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel – Dokument löschen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DeleteDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
  "Library": "Shared Documents",
  "Path": "/Shared Documents/TestFolder/Document.docx"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DeleteDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel: Berechtigungen für eine Liste prüfen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CheckPermission aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
  "ListName": "TestList",
  "ItemId": "1",
  "Principal": "ACLSITE1 Owners"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CheckPermission-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel: Liste löschen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DeleteLists aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
  "Name": "TestList1757601118898"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DeleteLists-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel – Check in einem Dokument

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CheckInDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.txt",
"Comment": "Comment test"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CheckInDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel: Datei auschecken

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CheckOutDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.txt"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CheckOutDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel: Check-out verwerfen

In diesem Beispiel wird das Auschecken einer Datei rückgängig gemacht.

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DiscardCheckOutDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.docx"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DiscardCheckOutDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel: Datei an einen anderen Speicherort kopieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CopyDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"SourceFileRelativeUrl": "/Shared Documents/Document.docx",
"DestFileRelativeUrl": "/Shared Documents/TestFolder/Document123.docx"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CopyDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel: Textdatei an einen bestimmten Speicherort hochladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion UploadDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"FileName": "test.txt",
"RelativeUrl": "/Shared Documents/TestFolder",
"Content": "abcd"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UploadDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel: Binärdatei an einen bestimmten Speicherort hochladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion UploadDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"FileName": "test.txt",
"RelativeUrl": "/Shared Documents/TestFolder",
"ContentBytes": "SGVsbG8gd29ybGQK",
"HasBytes": "true"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UploadDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Status": "Success"
}]

Beispiel: Datei herunterladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DownloadDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"RemoteFile": "/TestFolder/test.txt",
"Library": "Shared Documents"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DownloadDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Success": "True",
"Content": "Test File",
}]

Beispiel: Binärdatei herunterladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DownloadDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"RemoteFile": "/TestFolder/test1.png",
"Library": "Shared Documents"
"HasBytes": "true"  
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DownloadDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Success": "True",
"ContentBytes": "VGVzdCBGaWxl",
}]

Beispiel: Datei von einer bestimmten Website herunterladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DownloadDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
  "RemoteFile": "	http://z8**.sharepoint.com/sites/SharepointGCS/Docs/SharpointGCS.docx",
  "Library": "Docs",
  "HasBytes": true
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DownloadDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [
  {
    "Success": "True",
    "ContentBytes": "UEsDBAoAAAAAAAAAIQD/////TwEAAE8BAAAQAAAAW3RyYXNoXS8wMDAwLmRhdP////nFmjQeC1QbGmk9o7n0xjiLgudAMOrYQBpOZdZp5/OrWkWbudVPccasL5uVSKun3URrHAxow7iMUm2WSi7nlGy2Mr+sjJxQSrYFcFtDQyo/QSutWhbNcAODEWh14mklzxCS9C5CW3Fmwme/gMKGjGoXlSVyvtDoB+u0A6XtA8bkWTnPNHSvxcepoAKIdsR96imCvxe4MxOWqHWnQkLDyjNMOMrrQeMDF7nOMCCvPlVn5Vd6KlDYnHlW1zLOcQf6WmKl2xN4Z8WBXZfkrJZqPv6yNdWyp8ADRmgTdRSqDkPpQqzvqWj3qpdiRZqSwyBRtfr2kHBumkTNjSi6drBMFMxZEgrktw6ZxuEXcx3v16cXd6k5JVO3kOXMg/HFnH"
  }
]

    Wenn Sie eine Datei von einer bestimmten Website herunterladen möchten, müssen Sie die vollständige Adresse der Remotedatei angeben.

Beispiel: Anlage an einen anderen Ort verschieben

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion MoveAttachmentOrDocument aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"SourceFileURL": "/Shared Documents/test.txt",
"DestinationFolderURL": "/Shared Documents/TestFolder"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des MoveAttachmentOrDocument-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Result": "Success"
}]

Beispiel: Ordner an einem bestimmten Speicherort erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CreateFolder aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"FolderName": "TestFolder123"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CreateFolder-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Id": "110842b7-2393-4f11-9391-3d75214e9fb8",
"Status": "Success"
}]

Beispiel: Einer Liste einen Anhang hinzufügen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion AddAttachments aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"ListTitle": "My Lists",
"FileName": "TestAttachment2",
"Content": "abcd text",
"ItemId": "1"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des AddAttachments-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment2",
"Status": "Success"
}]

Beispiel: Binären Anhang zu einer Liste hinzufügen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion AddAttachments aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"ListTitle": "My Lists",
"FileName": "TestAttachment3",
"ContentBytes": "VGVzdCBGaWxl",
"HasBytes": "true",  
"ItemId": "1"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des AddAttachments-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment3",
"Status": "Success"
}]

Beispiel: Anhang herunterladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DownloadAttachments aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"RemoteFile": "/Shared Documents/Document.txt"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DownloadAttachments-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Success": "True",
"Content": "Test File",
}]

Beispiel: Binäranhang herunterladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DownloadAttachments aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"RemoteFile": "/Shared Documents/Document.docx",
"HasBytes": "true"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DownloadAttachments-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
"Success": "True",
"ContentBytes": "VGVzdCBGaWxl",
}]

Beispiele für Entitätsvorgänge

In diesem Abschnitt wird beschrieben, wie Sie einige Entitätsvorgänge in diesem Connector ausführen.

Version 1

In Version 1 unterstützte Entitäten

Dateien und „Meine Listen“.

Version 2

In Version 2 unterstützte Entitäten

Dateien, ListItem, MyLists, RoleAssignments, SharingLinks, SitePages, Subsites und Users.

Beispiel: Alle Dateien auflisten

In diesem Beispiel werden alle Dateien in der Files-Entität aufgelistet.

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Files aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
  4. Optional können Sie im Bereich Aufgabeneingabe der Aufgabe Connectors das Ergebnisset filtern, indem Sie eine Filterklausel angeben. Mit den Logikoperatoren können Sie auch mehrere Filterbedingungen angeben.

Beispiel: Alle Freigabelinks von Dateien auflisten

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Sharing Links aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.

Beispiel: Alle Freigabelinks von Ordnern auflisten

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Sharing Links aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.

Beispiel: Alle Seiten einer Website auflisten

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie SitePages aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.

Beispiel – Alle untergeordneten Websites auflisten

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Subsites aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.

Beispiel: Alle meine Listen auflisten

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie My Lists aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.

Beispiel: Alle Nutzer auflisten

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Users aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.

Beispiel: Alle Elemente auflisten

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie ListItem aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.

Beispiel: Alle Rollenzuweisungen auflisten

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie RoleAssignments aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.

Beispiel: Freigabelink für eine Datei abrufen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Sharing Links aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
  4. Legen Sie entityId auf „Sharing Links“ fest. Wenn Sie die entityId festlegen möchten, klicken Sie im Bereich Data Mapper des Data Mapping auf Open Data Mapping Editor (Datenabgleichs-Editor öffnen), geben Sie 1.0 in das Feld Input Value (Eingabewert) ein und wählen Sie entityId als lokale Variable aus.

Beispiel: Dateidetails abrufen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Files aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
  4. Setzen Sie entityId auf „Files“. Wenn Sie die entityId festlegen möchten, klicken Sie im Bereich Data Mapper des Data Mapping auf Open Data Mapping Editor (Datenabgleichs-Editor öffnen), geben Sie ZETdEU1T_UOBEzbgDmsvcubxvUaXbcJNrrNPM4LqoklbdDZx3Eo0SIWPCsc_L6yI in das Feld Input Value (Eingabewert) ein und wählen Sie entityId als lokale Variable aus.

Beispiel: Freigabelink für einen Ordner abrufen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Sharing Links aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
  4. Legen Sie entityId auf „Sharing Links“ fest. Wenn Sie die entityId festlegen möchten, klicken Sie im Bereich Data Mapper des Data Mapping auf Open Data Mapping Editor (Datenabgleichs-Editor öffnen), geben Sie 3.0 in das Feld Input Value (Eingabewert) ein und wählen Sie entityId als lokale Variable aus.

Beispiel: Liste abrufen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie My Lists aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf entityId und geben Sie dann 3 in das Feld Standardwert ein.

    Dabei ist 3 ein Primärschlüsselwert in der Entität My Lists.

Beispiel: Liste erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie My Lists aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein: 
    {
"AuthorId": 11.0,
"BaseName": "3_",
"Attachments": false,
"Title": "Created List New"
}

    Wenn die Integration erfolgreich ist, hat das Feld connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    [{
"ID": 3.0
}]

Beispiel: Liste löschen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie My Lists aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf entityId und geben Sie dann 2 in das Feld Standardwert ein.
  • Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Apigee Integration finden Sie unter Connectors-Aufgabe.
  • Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Application Integration finden Sie unter Connectors-Aufgabe.

Beschränkungen

Für den SharePoint-Connector gelten die folgenden Einschränkungen:
  • Der Aktualisierungsvorgang für die Entitäten SitePages und Events funktioniert nicht.
  • Der Listenoperation für die Entitäten AllFiles, AllPages, AllEvents, AllLists und Sites funktioniert nicht.

Hilfe von der Google Cloud-Community erhalten

Sie können Ihre Fragen und Anregungen zu diesem Connector in der Google Cloud-Community unter Cloud-Foren posten.

Nächste Schritte