SharePoint

Der SharePoint-Connector bietet SQL-Zugriff auf SharePoint-Dienste und ‑Server.

Unterstützte Versionen

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

Hinweis

Führen Sie vor der Verwendung des SharePoint-Connectors die folgenden Aufgaben aus:

  • In Ihrem Google Cloud-Projekt:
    • Prüfen Sie, ob eine Netzwerkverbindung eingerichtet ist. Informationen zu Netzwerkmustern finden Sie unter Netzwerkkonnektivität.
    • 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 folgenden IAM-Rollen zu:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Ein Dienstkonto ist eine spezielle Art von Google-Konto, das einen nicht menschlichen Nutzer repräsentiert. Es muss authentifiziert und autorisiert werden, um Zugriff auf Daten in Google APIs zu erhalten. Wenn Sie kein Dienstkonto haben, müssen Sie eins erstellen. Weitere Informationen finden Sie unter Dienstkonto erstellen.

    • Aktivieren Sie die folgenden Dienste:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      Informationen zum Aktivieren von Diensten finden Sie unter Dienste aktivieren.

    Wenn diese Dienste oder Berechtigungen für Ihr Projekt zuvor nicht aktiviert wurden, werden Sie aufgefordert, sie beim Konfigurieren des Connectors zu aktivieren.

Connector konfigurieren

Für die Konfiguration des Connectors müssen Sie eine Verbindung zu Ihrer Datenquelle (Backend-System) 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 Abschnitt Standort den Standort für die Verbindung aus.
    1. Region: Wählen Sie einen Standort aus der Drop-down-Liste aus.

      Unterstützte Regionen für Connectors:

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

    2. Klicken Sie auf Weiter.
  4. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
    1. Connector: Wählen Sie SharePoint aus der Drop-down-Liste der verfügbaren Connectors aus.
    2. Connector-Version: Wählen Sie die Connector-Version aus der Drop-down-Liste der verfügbaren Versionen aus.
    3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein.

      Verbindungsnamen müssen die folgenden Kriterien erfüllen:

      • Verbindungsnamen können Buchstaben, Ziffern oder Bindestriche enthalten.
      • Buchstaben müssen Kleinbuchstaben sein.
      • Verbindungsnamen müssen mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden.
      • Verbindungsnamen dürfen maximal 49 Zeichen haben.
    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. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
    7. Optional: Konfigurieren Sie 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. Klicken Sie optional auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
    9. Klicken Sie auf Weiter.
  5. Geben Sie im Abschnitt Ziele die Details zum Remote-Host (Backend-System) ein, zu dem Sie eine Verbindung herstellen möchten.
    1. Zieltyp: Wählen Sie einen Zieltyp aus. Die Hostadresse ist beispielsweise https://xxxxx.sharepoint.com.
      • Wählen Sie in der Liste Hostadresse aus, um den Hostnamen oder die IP-Adresse des Ziels anzugeben.
      • Wenn Sie eine private Verbindung zu Ihren Backend-Systemen herstellen möchten, wählen Sie in der Liste Endpunktanhang und dann den erforderlichen Endpunktanhang 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.

    2. Klicken Sie auf Weiter.
  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 On-Premise-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 für die Authentifizierung OAuth 2.0-Clientanmeldedaten mit JWT-Inhaber 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.

    3. Klicken Sie auf Next (Weiter).
  7. Überprüfen: Prüfen Sie 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. Konfigurieren Sie PSC und erstellen Sie einen Endpunktanhang.
  2. Geben Sie die Anmeldedaten in Google Cloud an.

PSC konfigurieren und Endpunktanhang erstellen

  1. Erstellen Sie eine Instanzgruppe mit der IP-Adresse, unter 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. Erstellen Sie nach dem Erstellen des Endpunktanhangs eine SharePoint-Verbindung mit der IP-Adresse des Endpunktanhangs.
  7. Weitere Informationen zum Erstellen eines Endpunkt-Anhangs finden Sie unter Endpunkt-Anhang erstellen.

Geben Sie die Windows-Anmeldedaten in Google Cloudan.

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

Wählen Sie im Abschnitt Authentifizierung als Authentifizierungstyp Windows-Anmeldedaten 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 für Windows-Anmeldedaten

In der folgenden Tabelle sind 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
Anschluss 1 24
Authentifizierung Anmeldedaten für Windows
Nutzername USER_NAME
Passwort PASSWORT
Secret-Version 1

Azure AD-Authentifizierungstyp

Führen Sie die folgenden Schritte aus, um den Azure AD-Authentifizierungstyp zu aktivieren:
  1. Registrieren Sie Ihre App und rufen Sie die OAuthClientId und den OAuthClientSecret ab.
  2. Geben Sie die Anmeldedaten in Google Cloud an.
  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 das 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 – Mehrfachkundenfähig aus. Auf der folgenden Abbildung ist die Seite Anwendung registrieren zu sehen:
  4. Rufen Sie nach dem Erstellen der App den Bereich Zertifikate und Secrets auf, erstellen Sie einen Clientschlüssel für die Anwendung und speichern Sie den Wert des Clientschlüssels. Die folgende Abbildung zeigt die Seite Zertifikate und Geheimnisse:
  5. Wählen Sie unter API-Berechtigungen die erforderlichen Anwendungs- und delegierten Berechtigungen aus. Damit die Verbindung aktiv ist, müssen Sie mindestens die folgende Berechtigung erteilen:AllSites.Manage

    In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für Vorgänge in der Anwendung erforderlich sind.

    Delegierte Berechtigungen Anwendungsberechtigungen
    ConsentRequest.Read.All AllSites.FullControl
    ConsentRequest.ReadWrite.All AllSites.Manage
    DelegatedAdminRelationship.Read.All AllSites.Read
    DelegatedAdminRelationship.ReadWrite.All AllSites.Write
    DelegatedPermissionGrant.Read.All EnterpriseResource.Read
    DelegatedPermissionGrant.ReadWrite.All EnterpriseResource.Write
    Files.Read.All MyFiles.Read
    Files.ReadWrite.All MyFiles.Write
    Group.Create Project.Read
    Group.Read.All Project.Write
    Group.ReadWrite.All ProjectWebApp.FullControl
    Sites.FullControl.All ProjectWebAppReporting.Read
    Sites.FullControl.All Sites.FullControl.All
    Sites.Manage.All Sites.Manage.All
    Sites.Read.All Sites.Read.All
    Sites.ReadWrite.All Sites.ReadWrite.All
    Sites.Selected Sites.Search.All
    User.Export.All Sites.Selected
    User.Read TaskStatus.Submit
    User.Read.All TermStore.Read.All
    User.ReadWrite.All TermStore.Read.All
    TermStore.ReadWrite.All
    TermStore.ReadWrite.All
    User.Read.All
    User.Read.All
    User.ReadWrite.All
    User.ReadWrite.All
  6. Speichern Sie die Änderungen.
  7. Wenn Sie Berechtigungen verwenden möchten, für die die Einwilligung des Administrators erforderlich ist, können Sie diese über den aktuellen Tenant auf der Seite API-Berechtigungen gewähren. Auf der folgenden Abbildung ist die Seite „API-Berechtigungen“ zu sehen:
  8. Wenn Sie den Umfang hinzufügen möchten, rufen Sie den Bereich API freigeben auf, fügen Sie AllSites.Manage, Sites.FullControl.All-Umfänge hinzu und wählen Sie aus, wer die Kontrolle übernehmen darf (Administratoren und Nutzer). Auf der folgenden Abbildung ist die Seite „API veröffentlichen“ zu sehen:
  9. Klicken Sie auf Speichern.

Geben Sie die Anmeldedaten in Google Cloudan.

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

Wählen Sie im Abschnitt Authentifizierung AzureAD als Authentifizierungstyp aus und geben Sie dann 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. z. B. 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: Autorisierungs-URL, die beim Erstellen des Clients generiert wird. Geben Sie die URL im folgenden Format ein: https://login.microsoftonline.com/<tenant_identifier>/oauth2/v2.0/authorize. Beispiel: https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize

Autorisieren Sie die Verbindung in Google Cloud.

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

    Der Status des neuen Connectors lautet Autorisierung erforderlich.

  2. Klicken Sie auf Autorisierung erforderlich.

    Daraufhin wird der Bereich Autorisierung bearbeiten angezeigt.

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

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

Fügen Sie Ihrer App die Weiterleitungs-URL hinzu.

  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 kopiert haben, als Sie Google Cloudautorisiert haben.

Azure AD-Verbindungstyp

In der folgenden Tabelle sind die Beispielkonfigurationswerte für den Azure AD-Verbindungstyp 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

OAuth 2.0 – Clientanmeldedaten mit JWT-Inhaber-Authentifizierungstyp

So aktivieren Sie OAuth 2.0-Clientanmeldedaten mit dem Authentifizierungstyp „JWT-Inhaber“:
  1. Erstellen Sie ein Zertifikat.
  2. Laden Sie das Zertifikat in das Azure-Portal hoch.
  3. Holen Sie sich einen privaten Schlüssel.
  4. Führen Sie die Einrichtung durch.
  5. Geben Sie die OAuth 2.0-JWT-Inhaberanmeldedaten in Google Cloud an.

Wenn Sie die JWT-Trägerauthentifizierung aktivieren möchten, müssen Sie ein Zertifikat erstellen, es in das Azure-Portal hochladen und dann einen privaten Schlüssel abrufen.

Zertifikat erstellen

  1. Erstellen Sie auf Ihrem Computer einen leeren Ordner.
  2. Erstellen Sie im Ordner eine Textdatei.
  3. Kopieren Sie das PowerShell-Script 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. Rufen Sie das Verzeichnis auf, 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 das Startdatum in das aktuelle Datum und das Enddatum in ein Datum Ihrer Wahl.

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

    Sie werden von Windows PowerShell aufgefordert, das Passwort zum Schutz des privaten Schlüssels einzugeben. Speichern Sie das Passwort für später.

    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. Geben Sie dazu die folgenden Details an:
    • Name: Geben Sie einen Namen für die Anwendung ein.
    • Unterstützte Kontotypen: Wählen Sie Nur Konten in diesem Organisationsverzeichnis (nur Kontoname – einzelner Nutzer) aus.
  2. Gehen Sie zu API-Berechtigungen > Berechtigung hinzufügen > API-Berechtigungen anfordern > SharePoint.
  3. Wählen Sie Anwendungsberechtigungen aus und fügen Sie die erforderlichen Berechtigungen hinzu.
  4. Wählen Sie Administratorzustimmung erteilen und dann Ja aus.
  5. Gehen Sie nach dem Erstellen der App zum Bereich Zertifikate und Secrets.
  6. Wählen Sie Zertifikat hochladen aus und laden Sie Ihr CER-Zertifikat von Ihrem Computer hoch. Wählen Sie nach Abschluss des Uploads Hinzufügen aus.

    Fügen Sie der App keine Clientschlüssel hinzu, da dies den ‑basierten Authentifizierungsablauf beeinträchtigt.

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

Privaten Schlüssel abrufen

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

  1. Rufen Sie über die Eingabeaufforderung den Ordner mit der 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 folgenden Abschnitt des privaten Schlüssels:
    -----BEGIN PRIVATE KEY----- 
    
    -----END PRIVATE KEY----- 
    

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 den folgenden Anmeldedaten mit der SharePoint-Listen-Diensthauptkonto-Authentifizierung an:
    • Client-ID
    • Mandanten-ID
    • Privater Schlüssel
    • Fingerabdruck (Passwort für den privaten Schlüssel)

Geben Sie die OAuth 2.0-JWT-Inhaberanmeldedaten in Google Cloudan.

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

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

  • Client-ID: Geben Sie die Client-ID ein, die zum Anfordern von Zugriffstokens verwendet wird. Dies ist der Consumer-Schlüssel, der generiert wurde, als Sie die App im Azure-Portal registriert haben.
  • Privater Schlüssel: Wählen Sie das Secret Manager-Secret aus, das den Inhalt der privaten Schlüsseldatei im PEM-Format enthält. Der private Schlüssel sollte mit dem Public-Key-Zertifikat übereinstimmen, das für Connector bereitgestellt wird.
  • Secret-Version: Secret-Version für das oben ausgewählte Secret.
  • Passwort für privaten Schlüssel: Wählen Sie das Secret Manager-Secret mit dem Passwort (Paraphrase) der privaten Schlüsseldatei aus.
  • Secret-Version: Secret-Version für das oben ausgewählte Secret.
  • Azure-Mandant: Der Microsoft Online-Mandant, der für den Zugriff auf Daten 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
Anschluss 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-Mandanten AZURE_TENANT_ID

OAuth 2.0 – Verbindungstyp „Clientschlüssel“

So aktivieren Sie den Verbindungstyp „OAuth 2.0-Clientschlüssel“:

  1. Registrieren Sie das Add-on.
  2. Gewähren Sie dem Add-on Berechtigungen.
  3. Geben Sie die OAuth 2.0-Clientanmeldedaten in Google Cloud an.
  4. Erneute Autorisierung für Autorisierungscode

Add-in registrieren

  1. Rufen Sie die Seite Add-on registrieren über die folgende URL auf: https://<SITE_NAME>.SharePoint.com/_layouts/15/appregnew.aspx.
  2. Erstellen 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-on wird registriert und die SharePoint-App zeigt die erstellten Informationen an.

Dem Add-on 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 gewähren 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“ sind ausgefüllt.
  3. Geben Sie die folgende Berechtigungsanfrage im XML-Format ein:
    <AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="FullControl"/>
    </AppPermissionRequests>
      
  4. Klicken Sie auf „Erstellen“. In der SharePoint App wird ein Dialogfeld zur Einwilligung in die Berechtigung angezeigt.
  5. Klicken Sie auf Vertrauen.

Geben Sie die OAuth 2.0-Clientanmeldedaten in Google Cloudan.

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

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

  • Client-ID: Geben Sie die Client-ID ein, die vom Connector für die von Ihnen erstellte Anwendung bereitgestellt wird.
  • Client-Secret: Wählen Sie das Secret Manager-Secret mit dem Clientschlüssel für die verbundene App aus, die Sie erstellt haben.
  • Secret-Version: Wählen Sie 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 noch einmal:

  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. Überprüfen Sie die Details unter OAuth 2.0 – Autorisierungscode im Abschnitt Authentifizierung.

    Nehmen Sie gegebenenfalls die erforderlichen Änderungen vor.

  4. Klicken Sie auf Speichern. Daraufhin gelangen Sie zur Seite mit den Verbindungsdetails.
  5. Klicken Sie im Abschnitt Authentifizierung auf Autorisierung bearbeiten. Daraufhin wird der Bereich Authorize (Autorisieren) angezeigt.
  6. Klicken Sie auf Autorisieren.

    Wenn die Autorisierung erfolgreich war, wird der Verbindungsstatus auf der Seite „Verbindungen“ auf Aktiv gesetzt.

Verbindungstyp für Clientanmeldedaten

In der folgenden Tabelle sind 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
Anschluss 1 ****
Authentifizierung OAuth 2.0-Clientanmeldedaten mit Clientschlüssel
Client-ID CLIENT_ID
Clientschlüssel CLIENT_SECRET
Secret-Version 1

Entitäten, Vorgänge und Aktionen

Alle Integration Connectors bieten eine Abstraktionsebene für die Objekte der verbundenen Anwendung. Sie können nur über diese Abstraktion auf die Objekte einer Anwendung zugreifen. Die Abstraktion wird Ihnen als Entitäten, Vorgänge und Aktionen zur Verfügung gestellt.

  • Entität: Eine Entität kann als Objekt oder Sammlung von Attributen in der verbundenen Anwendung oder im verbundenen Dienst verstanden werden. Die Definition einer Entität unterscheidet sich von Connector zu Connector. Beispiel: In einem Datenbank-Connector sind Tabellen die Entitäten, in einem Dateiserver-Connector sind Ordner die Entitäten und in einem Nachrichtensystem-Connector sind Warteschlangen die Entitäten.

    Es ist jedoch möglich, dass ein Connector keine Entitäten unterstützt oder keine Entitäten enthält. In diesem Fall ist die Liste Entities leer.

  • Vorgang: Ein Vorgang ist die Aktivität, die Sie für eine Entität ausführen können. Sie können einen der folgenden Vorgänge für eine Entität ausführen:

    Durch Auswahl einer Entität aus der verfügbaren Liste wird eine Liste der Vorgänge generiert, die für die Entität verfügbar sind. Eine detaillierte Beschreibung der Vorgänge finden Sie in den Entitätsvorgängen der Connectors-Aufgabe. Wenn ein Connector jedoch keinen der Entitätsvorgänge unterstützt, werden diese nicht unterstützten Vorgänge nicht in der Liste Operations aufgeführt.

  • Aktion: Eine Aktion ist eine Funktion erster Klasse, die über die Connector-Benutzeroberfläche für die Integration verfügbar gemacht wird. Mit einer Aktion können Sie Änderungen an einer oder mehreren Entitäten vornehmen, die von Connector zu Connector unterschiedlich sind. Normalerweise hat eine Aktion einige Eingabeparameter und einen Ausgabeparameter. Es ist jedoch möglich, dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Actions-Liste leer.

Aktionen

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

Aktion „DeleteAttachment“

Durch diese Aktion wird ein Anhang gelöscht.

Eingabeparameter der Aktion „DeleteAttachment“

Parametername Datentyp Erforderlich Beschreibung
ListTitle String Ja Titel des Listenelements.
ItemId String Ja ID des Listenelements.
FileName String Ja Name der Datei, die aus der Dokumentenbibliothek gelöscht werden soll.

Informationen zum Konfigurieren der DeleteAttachment-Aktion finden Sie unter Beispiele für Aktionen.

Aktion „CheckInDocument“

Mit dieser Aktion können Sie ein Dokument einchecken.

Eingabeparameter der Aktion „CheckInDocument“

Parametername Datentyp Erforderlich Beschreibung
RelativeURL String Ja Relative URL des Ordners.
DocumentName String Ja Name der Datei, die eingecheckt werden soll.
Kommentar String Nein Optionale Nachricht zur Anmeldung

Informationen zum Konfigurieren der CheckInDocument-Aktion finden Sie unter Beispiele für Aktionen.

Aktion „CheckOutDocument“

Mit dieser Aktion können Sie eine Datei auschecken.

Eingabeparameter der Aktion „CheckOutDocument“

Parametername Datentyp Erforderlich Beschreibung
RelativeURL String Ja Relative URL des Ordners.
DocumentName String Ja Name der Datei, die auscheckt werden soll.

Informationen zum Konfigurieren der CheckOutDocument-Aktion finden Sie unter Beispiele für Aktionen.

DiscardCheckOutDocument-Aktion

Dadurch können Sie die Ausleihe einer Datei rückgängig machen.

Eingabeparameter der Aktion „DiscardCheckOutDocument“

Parametername Datentyp Erforderlich Beschreibung
RelativeURL String Ja Relative URL des Ordners.
DocumentName String Ja Name der Datei, für die die Ausleihe rückgängig gemacht werden soll.

Informationen zum Konfigurieren der DiscardCheckOutDocument-Aktion finden Sie unter Beispiele für Aktionen.

Aktion „CopyDocument“

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

Eingabeparameter der CopyDocument-Aktion

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

Informationen zum Konfigurieren der CopyDocument-Aktion finden Sie unter Beispiele für Aktionen.

Aktion „UploadDocument“

Mit dieser Aktion können Sie eine Datei hochladen.

Eingabeparameter der UploadDocument-Aktion

Parametername Datentyp Erforderlich Beschreibung
FileName String Ja Name der hochzuladenden Datei.
RelativeUrl String Ja Relative URL des Ordners.
Inhalt String Nein Inhalte, die als Datei hochgeladen werden sollen.
ContentBytes String Nein Byte-Inhalt (als Base64-String), der als Datei hochgeladen werden soll. Hiermit können Sie binäre Daten hochladen.
HasBytes Boolesch Nein Gibt an, ob die hochzuladenden Inhalte binär sind. Der Standardwert ist false.

Informationen zum Konfigurieren der UploadDocument-Aktion finden Sie unter Beispiele für Aktionen.

Aktion „DownloadDocument“

Mit dieser Aktion können Sie eine Datei herunterladen.

Eingabeparameter der Aktion „DownloadDocument“

Parametername Datentyp Erforderlich Beschreibung
RemoteFile String Ja Vollständige URL der Datei, die heruntergeladen werden soll.
Bibliothek String Ja Name der Bibliothek auf dem SharePoint-Server.
HasBytes Boolesch Nein Gibt an, ob die Inhalte als Bytes heruntergeladen werden sollen. Der Standardwert ist false.

Informationen zum Konfigurieren der DownloadDocument-Aktion finden Sie unter Beispiele für Aktionen.

Aktion „MoveAttachmentOrDocument“

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 URL der Quelldatei, die verschoben werden soll.
DestinationFolderURL String Ja URL des Zielordners.

Informationen zum Konfigurieren der MoveAttachmentOrDocument-Aktion finden Sie unter Beispiele für Aktionen.

Aktion „CreateFolder“

Mit dieser Aktion können Sie einen Ordner erstellen.

Eingabeparameter der Aktion „CreateFolder“

Parametername Datentyp Erforderlich Beschreibung
RelativeURL String Ja Relative URL des Ordners.
FolderName String Ja Name des zu erstellenden Ordners.

Informationen zum Konfigurieren der CreateFolder-Aktion finden Sie unter Beispiele für Aktionen.

Aktion „AddAttachments“

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

Eingabeparameter der Aktion „AddAttachments“

Parametername Datentyp Erforderlich Beschreibung
ListTitle String Ja Name der Anhangsliste.
FileName String Ja Name der Anhangsdatei.
ItemId String Ja ID des hinzuzufügenden Anhangs.
Inhalt String Ja Inhalt des Anhangs.
ContentBytes String Nein Byte-Inhalt (als Base64-String), der als Anhang hochgeladen werden soll. Hiermit können Sie binäre Daten hochladen.
HasBytes Boolesch Nein Gibt an, ob die hochzuladenden Inhalte binär sind. Der Standardwert ist false.

Informationen zum Konfigurieren der AddAttachments-Aktion finden Sie unter Beispiele für Aktionen.

Aktion „DownloadAttachments“

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

Eingabeparameter der Aktion „DownloadAttachments“

Parametername Datentyp Erforderlich Beschreibung
RemoteFile String Ja Relative URL der Datei.
HasBytes Boolesch Nein Gibt an, ob die heruntergeladenen Inhalte binär sind. Der Standardwert ist false.

Informationen zum Konfigurieren der DownloadAttachments-Aktion finden Sie unter Beispiele für Aktionen.

Beispiele für Aktionen

In diesem Abschnitt wird beschrieben, wie Sie einige 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 das Feld Default Value ein:
    {
    "ListTitle": "My lists",
    "ItemId": "1",
    "FileName": "sitepages.txt"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe DeleteAttachment einen Wert, der in etwa so aussieht:

    [{
    "Status": "Success"
    }]

Beispiel: Dokument einchecken

In diesem Beispiel wird ein Dokument eingecheckt.

  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 das Feld Default Value ein:
    {
    "RelativeURL": "/Shared Documents/TestFolder",
    "DocumentName": "Document.txt",
    "Comment": "Comment test"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe CheckInDocument einen Wert, der in etwa so aussieht:

    [{
    "Status": "Success"
    }]

Beispiel: Datei auschecken

In diesem Beispiel wird eine Datei auscheckt.

  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 das Feld Default Value ein:
    {
    "RelativeURL": "/Shared Documents/TestFolder",
    "DocumentName": "Document.txt"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe CheckOutDocument einen Wert, der in etwa so aussieht:

    [{
    "Status": "Success"
    }]

Beispiel: Ausleihe verwerfen

In diesem Beispiel wird eine Dateiausleihe 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 das Feld Default Value ein:
    {
    "RelativeURL": "/Shared Documents/TestFolder",
    "DocumentName": "Document.docx"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe DiscardCheckOutDocument einen Wert, der in etwa so aussieht:

    [{
    "Status": "Success"
    }]

Beispiel: Datei kopieren

In diesem Beispiel wird eine Datei von einem Speicherort an einen anderen kopiert.

  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 das Feld Default Value ein:
    {
    "SourceFileRelativeUrl": "/Shared Documents/Document.docx",
    "DestFileRelativeUrl": "/Shared Documents/TestFolder/Document123.docx"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe CopyDocument einen Wert, der in etwa so aussieht:

    [{
    "Status": "Success"
    }]

Beispiel: Textdatei hochladen

In diesem Beispiel wird eine Textdatei an den angegebenen Speicherort hochgeladen.

  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 das Feld Default Value ein:
    {
    "FileName": "test.txt",
    "RelativeUrl": "/Shared Documents/TestFolder",
    "Content": "abcd"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe UploadDocument einen Wert, der in etwa so aussieht:

    [{
    "Status": "Success"
    }]

Beispiel: Binärdatei hochladen

In diesem Beispiel wird eine Binärdatei an den angegebenen Speicherort hochgeladen. Geben Sie beim Hochladen einer Binärdatei den Inhalt als Base64-codierten String an.

  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 das Feld Default Value ein:
    {
    "FileName": "test.txt",
    "RelativeUrl": "/Shared Documents/TestFolder",
    "ContentBytes": "SGVsbG8gd29ybGQK",
    "HasBytes": "true"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe UploadDocument einen Wert, der in etwa so aussieht:

    [{
    "Status": "Success"
    }]

Beispiel: Datei herunterladen

In diesem Beispiel wird eine Datei heruntergeladen.

  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 das Feld Default Value ein:
    {
    "RemoteFile": "/TestFolder/test.txt",
    "Library": "Shared Documents"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe DownloadDocument einen Wert, der in etwa so aussieht:

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

Beispiel: Binärdatei herunterladen

In diesem Beispiel wird eine Binärdatei heruntergeladen.

  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 das Feld Default Value ein:
    {
    "RemoteFile": "/TestFolder/test1.png",
    "Library": "Shared Documents"
    "HasBytes": "true"  
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe DownloadDocument einen Wert, der in etwa so aussieht:

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

Beispiel: Anhang verschieben

In diesem Beispiel wird ein Anhang von einem Speicherort an einen anderen verschoben.

  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 das Feld Default Value ein:
    {
    "SourceFileURL": "/Shared Documents/test.txt",
    "DestinationFolderURL": "/Shared Documents/TestFolder"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe MoveAttachmentOrDocument einen Wert, der in etwa so aussieht:

    [{
    "Result": "Success"
    }]

Beispiel: Ordner erstellen

In diesem Beispiel wird ein Ordner am angegebenen Speicherort erstellt.

  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 das Feld Default Value ein:
    {
    "RelativeURL": "/Shared Documents/TestFolder",
    "FolderName": "TestFolder123"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe CreateFolder einen Wert, der in etwa so aussieht:

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

Beispiel: Anhang hinzufügen

In diesem Beispiel wird der angegebenen Liste ein Anhang hinzugefügt.

  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 das Feld Default Value ein:
    {
    "ListTitle": "My Lists",
    "FileName": "TestAttachment2",
    "Content": "abcd text",
    "ItemId": "1"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe AddAttachments einen Wert, der in etwa so aussieht:

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

Beispiel: Binären Anhang hinzufügen

In diesem Beispiel wird der angegebenen Liste ein binärer Anhang hinzugefügt.

  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 das Feld Default Value ein:
    {
    "ListTitle": "My Lists",
    "FileName": "TestAttachment3",
    "ContentBytes": "VGVzdCBGaWxl",
    "HasBytes": "true",  
    "ItemId": "1"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe AddAttachments einen Wert, der in etwa so aussieht:

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

Beispiel: Anhang herunterladen

In diesem Beispiel wird ein Anhang heruntergeladen.

  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 das Feld Default Value ein:
    {
    "RemoteFile": "/Shared Documents/Document.txt"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe DownloadAttachments einen Wert, der in etwa so aussieht:

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

Beispiel: Binären Anhang herunterladen

In diesem Beispiel wird ein binärer Anhang heruntergeladen.

  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 das Feld Default Value ein:
    {
    "RemoteFile": "/Shared Documents/Document.docx",
    "HasBytes": "true"
    }
  4. Wenn die Aktion erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe DownloadAttachments einen Wert, der in etwa so aussieht:

    [{
    "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.

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 in der Liste Entity die Option Files 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 einen Filter angeben, um den Ergebnissatz einzugrenzen. Mithilfe der Logikoperatoren können Sie auch mehrere Filterbedingungen angeben.

Beispiel: Liste abrufen

In diesem Beispiel wird eine Liste mit der angegebenen ID aus der Entität My Lists abgerufen.

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie in der Liste Entity die Option My Lists 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.

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

Beispiel: Eintrag erstellen

In diesem Beispiel wird ein Eintrag in der My Lists-Entität erstellt.

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie in der Liste Entity die Option My Lists 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 das Feld Default Value ein:
    {
    "AuthorId": 11.0, 
    "BaseName": "3_",
    "Attachments": false,
    "Title": "Created List New"
    }

    Wenn die Integration erfolgreich war, enthält das Feld connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

    [{
    "ID": 3.0
    }]

Beispiel: Eintrag löschen

In diesem Beispiel wird der Datensatz mit der angegebenen ID in der Entität My Lists gelöscht.

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie in der Liste Entity die Option My Lists 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.

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 über die Connectors-Aufgabe in einer Integration verwenden.

  • 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.

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