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.

Hinweise

Führen Sie die folgenden Schritte aus, bevor Sie den SharePoint-Connector verwenden:

  • In Ihrem Google Cloud-Projekt:
    • 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.

SharePoint-Anwendung in Azure (AD) konfigurieren

Wenn Sie Azure Active Directory (AD) für die Onlineversion von SharePoint verwenden, führen Sie die folgenden Schritte aus, um die SharePoint-Anwendung in Azure AD zu konfigurieren:

  1. Wählen Sie im Azure AD-Portal das Verzeichnis Ihrer Organisation aus.
  2. Klicken Sie im Abschnitt Verwalten auf App-Registrierungen und dann auf Neue Registrierung.
  3. Registrieren Sie die Anwendung in Azure AD. Geben Sie dazu die Registrierungsdetails ein:
    1. Wählen Sie unter Unterstützte Kontotypen die Option Nur Konten in diesem Organisationsverzeichnis aus.
    2. Wählen Sie unter Weiterleitungs-URI (optional) die Option Web aus und fügen Sie https://your_connections_host.spo.index.html als URI für Ihre Verbindungsnutzer hinzu, an die ihre Authentifizierungsantwort gesendet werden soll.
    3. Klicken Sie auf Registrieren.

      4. Weitere Informationen zum Registrieren einer Anwendung in Azure

  4. Klicken Sie auf der Seite Übersicht Ihrer App auf API-Berechtigungen und dann auf Berechtigung hinzufügen.
  5. Konfigurieren Sie Ihre Anwendung für den Zugriff auf eine Web-API. Gehen Sie dazu so vor:
    1. Wählen Sie unter API-Berechtigungen anfordern auf dem Tab Microsoft APIs die Option SharePoint aus.
    2. Wählen Sie unter Delegierte Berechtigungen die Option Nutzerdateien lesen und schreiben und Elemente in allen Websitesammlungen lesen und schreiben aus.
    3. Klicken Sie auf Berechtigungen hinzufügen.
    4. Wählen Sie auf dem Bildschirm mit den konfigurierten API-Berechtigungen die Option Administratoreinwilligung für your_organizational_directory erteilen aus.
  6. Fügen Sie einen Weiterleitungs-URI für die mobile SharePoint-App Ihrer Organisation hinzu:
    1. Klicken Sie auf Authentifizierung.
    2. Klicken Sie im Web auf URI hinzufügen und fügen Sie https://your_connections_host/spo/mobile.html als Antwort-URL für mobile Nutzer hinzu.
    3. Wählen Sie unter Implizite Gewährung sowohl Zugriffstokens als auch ID-Tokens aus.
    4. Klicken Sie auf Speichern.
  7. Bearbeiten Sie das Manifest der Azure Active Directory-Anwendung, um die von der Anwendung verwendete offene Authentifizierung zuzulassen:
    1. Klicken Sie auf der Seite Übersicht der App auf den Abschnitt Manifest.
    2. Ändern Sie das Attribut oauth2AllowImplicitFlow in true.
    3. Klicken Sie auf Speichern.
  8. Notieren Sie sich auf der Seite Übersicht Ihrer App die Anwendungs- bzw. Client-ID. Sie müssen ihn im Authentifizierungsbereich angeben, wenn Sie den SharePoint-Connector konfigurieren, wenn Sie den Azure AD-Authentifizierungstyp auswählen.

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 63 Zeichen haben.
    4. Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
    5. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
    6. Konfigurieren Sie optional die Einstellungen für Verbindungsknoten:

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

    7. Sie können auch auf + Label hinzufügen klicken, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
    8. 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.
      1. Geben Sie im Feld Hostadresse den Hostnamen oder die IP-Adresse des Ziels ein.
        1. Wenn Sie eine private Verbindung zu Ihren Back-End-Systemen herstellen möchten, gehen Sie so vor:
          1. Erstellen Sie einen PSC-Dienstanhang.
          2. Erstellen Sie einen Endpunktanhang und geben Sie dann die Details des Endpunktanhangs in das Feld Hostadresse ein.
        2. 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.

      Klicken Sie auf + Ziel hinzufügen, um weitere Ziele einzugeben.

    2. Klicken Sie auf Weiter.
  6. Geben Sie im Abschnitt Authentifizierung die Authentifizierungsdetails ein.
    1. Wählen Sie einen der folgenden Authentifizierungstypen aus und geben Sie die entsprechenden Details ein.
      • Windows-Anmeldedaten: Wählen Sie diese Option aus, wenn Sie eine lokale Version von SharePoint verwenden. Gehen Sie dann so vor:
        1. Nutzername: Geben Sie den Nutzernamen ein.
        2. Passwort: Wählen Sie das Passwort aus.
        3. Secret-Version: Geben Sie die Secret-Version ein.
      • AzureAD: Wählen Sie diese Option aus, wenn Sie die Onlineversion von Sharepoint verwenden. Gehen Sie dann so vor:
        1. Client-ID: Geben Sie die Client-ID ein, die zum Anfordern von Zugriffstokens verwendet wird. Sie können die Client-ID abrufen, indem Sie die SharePoint-Anwendung in Azure AD konfigurieren.
        2. Bereiche: Geben Sie eine durch Kommas getrennte Liste der gewünschten Bereiche ein. z. B. Sites.FullControl.All.
        3. Clientschlüssel: Geben Sie den Clientschlüssel ein, der den Clientschlüssel für die von Ihnen erstellte verbundene App enthält.
        4. Secret-Version: Die Secret-Version für das oben ausgewählte Secret.
        5. Autorisierungs-URL: Die beim Erstellen des Clients generierte Autorisierungs-URL. 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
    2. Klicken Sie auf Weiter.
  7. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
  8. Klicken Sie auf Erstellen.

Authentifizierung konfigurieren

Geben Sie die Details basierend auf der zu verwendenden Authentifizierung ein.

  • Windows-Anmeldedaten
    • Nutzername: Geben Sie den Nutzernamen ein.
    • Passwort: Wählen Sie das Secret Manager-Secret mit dem Nutzerpasswort aus.
    • Secret-Version : Wählen Sie die Secret Manager-Secret-Version aus.
  • AzureAD (OAuth 2.0 – Autorisierungscode)
    • Client-ID: Client-ID, die von Ihrer externen Anwendung bereitgestellt wird.
    • Bereiche : Geben Sie durch Kommas getrennte Berechtigungsbereiche ein.
    • Client-Secret: Wählen Sie das Secret Manager-Secret aus. Sie sollten das Secret Manager-Secret erstellt haben, bevor Sie diese Autorisierung konfigurieren.
    • Secret-Version: Secret Manager-Secret-Version für den Clientschlüssel.

    Für den Authentifizierungstyp Authorization code sollten Sie nach dem Erstellen der Verbindung einige zusätzliche Schritte zum Konfigurieren der Authentifizierung ausführen. Weitere Informationen finden Sie unter Zusätzliche Schritte nach dem Erstellen der Verbindung.

Zusätzliche Schritte nach dem Erstellen der Verbindung

Wenn Sie OAuth 2.0 - Authorization code für die Authentifizierung ausgewählt haben, müssen Sie nach dem Erstellen der Verbindung die folgenden zusätzlichen Schritte ausführen:

  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 für den Weiterleitungs-URI in die externe Anwendung.
  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.

Erneute Autorisierung für Autorisierungscode

Wenn Sie den Authentifizierungstyp Authorization code verwenden und die Konfiguration in der Sharepoint-Anwendung geändert haben, müssen Sie die Sharepoint-Verbindung noch einmal autorisieren. So autorisieren Sie eine Verbindung noch einmal:

  1. Klicken Sie auf der Seite Verbindungen auf die erforderliche Verbindung.

    Die Seite mit den Verbindungsdetails wird geöffnet.

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

    Nehmen Sie bei Bedarf die erforderlichen Änderungen vor.

  4. Klicken Sie auf Speichern. Die Seite mit den Verbindungsdetails wird geöffnet.
  5. Klicken Sie im Bereich Authentifizierung auf Autorisierung bearbeiten. Daraufhin wird der Bereich Autorisieren angezeigt.
  6. Klicken Sie auf Autorisieren.

    Nach erfolgreicher Autorisierung wird der Verbindungsstatus auf der Seite Verbindungen auf Aktiv gesetzt.

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 solche 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. 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 von Aktionen finden Sie unter Aktionsbeispiele.

Aktion „DeleteAttachment“

Durch diese Aktion wird ein Anhang gelöscht.

Eingabeparameter der Aktion DeleteAttachment

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

Informationen zum Konfigurieren der Aktion DeleteAttachment finden Sie unter Aktionsbeispiele.

Aktion „CheckInDocument“

Durch diese Aktion können Sie ein Dokument einchecken.

Eingabeparameter der CheckInDocument-Aktion

Parametername Datentyp Erforderlich Beschreibung
RelativeURL String Yes Relative URL des Ordners.
DocumentName String Yes Name der Datei, die eingecheckt werden soll.
Kommentar String Nein Eine optionale Check-in-Nachricht.

Informationen zum Konfigurieren der Aktion CheckInDocument finden Sie unter Aktionsbeispiele.

ChekOutDocument-Aktion

Mit dieser Aktion können Sie eine Datei auschecken.

Eingabeparameter der ChekOutDocument-Aktion

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

Informationen zum Konfigurieren der Aktion ChekOutDocument finden Sie unter Aktionsbeispiele.

Aktion „CheckOutDocument“ verwerfen

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

Eingabeparameter der Aktion „Verwerfen CheckOutDocument“

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

Informationen zum Konfigurieren der Aktion DiscardCheckOutDocument finden Sie unter Aktionsbeispiele.

Aktion „CopyDocument“

So können Sie eine Datei von einem Speicherort an einen anderen kopieren.

Eingabeparameter der CopyDocument-Aktion

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

Informationen zum Konfigurieren der Aktion CopyDocument finden Sie unter Aktionsbeispiele.

Aktion „Dokument hochladen“

Diese Aktion ermöglicht das Hochladen einer Datei.

Eingabeparameter der UploadDocument-Aktion

Parametername Datentyp Erforderlich Beschreibung
FileName String Yes Name der hochzuladenden Datei.
RelativeUrl String Yes Relative URL des Ordners.
Inhalt String Nein Inhalt, der als Datei hochgeladen werden soll.
ContentBytes String Nein Byteinhalt (als Base64-String), der als Datei hochgeladen werden soll. Hiermit können Sie Binärdaten hochladen.
HasBytes Boolesch Nein Gibt an, ob der hochzuladende Inhalt binär ist. Der Standardwert ist false.

Informationen zum Konfigurieren der Aktion UploadDocument finden Sie unter Aktionsbeispiele.

Aktion „Dokument herunterladen“

Dadurch können Sie eine Datei herunterladen.

Eingabeparameter der Aktion "DownloadDocument"

Parametername Datentyp Erforderlich Beschreibung
RemoteFile String Yes Vollständige URL der herunterzuladenden Datei.
Bibliothek String Yes Name der Bibliothek auf dem SharePoint-Server.
HasBytes Boolesch Nein Gibt an, ob der Inhalt in Byte heruntergeladen werden soll. Der Standardwert ist false.

Informationen zum Konfigurieren der Aktion DownloadDocument finden Sie unter Aktionsbeispiele.

Aktion „MoveAttachmentOrDocument“

Dadurch können Sie eine Datei von einem Ordner in einen anderen Ordner verschieben.

Eingabeparameter der Aktion „MoveAttachmentOrDocument“

Parametername Datentyp Erforderlich Beschreibung
SourceFileURL String Yes URL der Quelldatei, die verschoben werden soll.
DestinationFolderURL String Yes URL des Zielordners

Informationen zum Konfigurieren der Aktion MoveAttachmentOrDocument finden Sie unter Aktionsbeispiele.

Aktion „CreateFolder“

Dadurch können Sie einen Ordner erstellen.

Eingabeparameter der CreateFolder-Aktion

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

Informationen zum Konfigurieren der Aktion CreateFolder finden Sie unter Aktionsbeispiele.

Aktion „AddAttachments“

Dadurch können Sie einen Anhang hinzufügen.

Eingabeparameter der Aktion „AddAttachments“

Parametername Datentyp Erforderlich Beschreibung
ListTitle String Yes Name der Anhangsliste.
FileName String Yes Name der Anhangsdatei.
ItemId String Yes ID des Anhangs, der hinzugefügt werden soll.
Inhalt String Yes Inhalt des Anhangs.
ContentBytes String Nein Byteinhalt (als Base64-String), der als Anhang hochgeladen werden soll. Hiermit können Sie Binärdaten hochladen.
HasBytes Boolesch Nein Gibt an, ob der hochzuladende Inhalt binär ist. Der Standardwert ist false.

Informationen zum Konfigurieren der Aktion AddAttachments finden Sie unter Aktionsbeispiele.

Aktion „DownloadAttachments“

Dadurch können Sie Anhänge herunterladen.

Eingabeparameter der Aktion „DownloadAttachments“

Parametername Datentyp Erforderlich Beschreibung
RemoteFile String Yes Relative URL der Datei.
HasBytes Boolesch Nein Gibt an, ob der herunterzuladende Inhalt binär ist. Der Standardwert ist false.

Informationen zum Konfigurieren der Aktion DownloadAttachments finden Sie unter Aktionsbeispiele.

Aktionsbeispiele

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

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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"ListTitle": "My lists",
"ItemId": "1",
"FileName": "sitepages.txt"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe DeleteAttachment einen Wert wie dieser:

    [{
"Status": "Success"
}]

Beispiel: Einchecken in einem Dokument

In diesem Beispiel wird ein Dokument überprüft.

  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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.txt",
"Comment": "Comment test"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe CheckInDocument einen Wert wie dieser:

    [{
"Status": "Success"
}]

Beispiel – Datei aussuchen

In diesem Beispiel wird eine Datei geprüft.

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

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe ChekOutDocument einen Wert wie dieser:

    [{
"Status": "Success"
}]

Beispiel – Bezahlvorgang verwerfen

In diesem Beispiel wird der Auscheckvorgang einer Datei wiederhergestellt.

  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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.docx"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe DiscardCheckOutDocument einen Wert wie dieser:

    [{
"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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das 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 der Aufgabe CopyDocument einen Wert wie dieser:

    [{
"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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"FileName": "test.txt",
"RelativeUrl": "/Shared Documents/TestFolder",
"Content": "abcd"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe UploadDocument einen Wert wie dieser:

    [{
"Status": "Success"
}]

Beispiel – Binärdatei hochladen

In diesem Beispiel wird eine Binärdatei in den angegebenen Speicherort hochgeladen. Geben Sie beim Hochladen einer Binärdatei den hochzuladenden 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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das 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 der Aufgabe UploadDocument einen Wert wie dieser:

    [{
"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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"RemoteFile": "/TestFolder/test.txt",
"Library": "Shared Documents"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe DownloadDocument einen Wert wie dieser:

    [{
"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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"RemoteFile": "/TestFolder/test1.png",
"Library": "Shared Documents"
"HasBytes": "true"  
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe DownloadDocument einen Wert wie dieser:

    [{
"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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"SourceFileURL": "/Shared Documents/test.txt",
"DestinationFolderURL": "/Shared Documents/TestFolder"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe MoveAttachmentOrDocument einen Wert wie dieser:

    [{
"Result": "Success"
}]

Beispiel – Ordner erstellen

In diesem Beispiel wird am angegebenen Speicherort ein Ordner 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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"FolderName": "TestFolder123"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe CreateFolder einen Wert wie dieser:

    [{
"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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"ListTitle": "My Lists",
"FileName": "TestAttachment2",
"Content": "abcd text",
"ItemId": "1"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe AddAttachments einen Wert wie dieser:

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

Beispiel – Binäranhang 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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das 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 der Aufgabe AddAttachments einen Wert wie dieser:

    [{
"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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"RemoteFile": "/Shared Documents/Document.txt"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe DownloadAttachments einen Wert ähnlich dem folgenden:

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

Beispiel – Binäranhang 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 Task Input der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert wie den folgenden in das Feld Default Value ein: 
    {
"RemoteFile": "/Shared Documents/Document.docx",
"HasBytes": "true"
}

    4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe DownloadAttachments einen Wert ähnlich dem folgenden:

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

Beispiele für Entitätsvorgang

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 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 die Ergebnisse filtern, indem Sie eine Filterklausel angeben. Mit logischen Operatoren können Sie auch mehrere Filterbedingungen angeben.

Beispiel – Liste abrufen

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

  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 Entitäts-ID und geben Sie 3 in das Feld Standardwert ein.

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

Beispiel – Eintrag erstellen

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

  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 wie den folgenden in das Feld Default Value ein: 
    {
"AuthorId": 11.0, 
"BaseName": "3_",
"Attachments": false,
"Title": "Created List New"
}

    Wenn die Integration erfolgreich ist, enthält das Feld connectorOutputPayload der Connector-Aufgabe einen Wert wie diesen:

    [{
"ID": 3.0
}]

Beispiel – Eintrag löschen

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

  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 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 Connector-Aufgabe in einer Integration verwenden.

  • Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in der Apigee-Integration finden Sie unter Connectors-Task.
  • Informationen zum Erstellen und Verwenden der Aufgabe „Connectors“ 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