SharePoint

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.

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.

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 OAuthClientSecret ab.
2. Geben Sie die Anmeldedaten in Google Cloudan.
3. Autorisieren Sie die Verbindung in Google Cloud.
4. Weiterleitungs-URL zu Ihrer App hinzufügen

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 den Bereich Zertifikate und Secrets auf, erstellen Sie einen Clientschlüssel für die Anwendung und speichern Sie den Wert des Clientschlüssels.
6. Wählen Sie unter API-Berechtigungen die erforderlichen Anwendungsberechtigungen und delegierten Berechtigungen aus. Damit die Verbindung aktiv ist, müssen Sie mindestens die folgende Berechtigung erteilen:Sites.Read.All.

   In der folgenden Tabelle sind die Berechtigungen aufgeführt, die zum Ausführen von Vorgängen 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

7. Speichern Sie die Änderungen.
8. 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.
9. 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).
10. 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 Abschnitt Authentifizierung AzureAD als Authentifizierungstyp 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. 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: 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:

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.
   • Unterstützte Kontotypen: Wählen Sie 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. Nachdem Sie die App erstellt haben, rufen Sie den Bereich Zertifikate & 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 erhalten, indem Sie die PFX-Datei mit OpenSSL in eine PEM-Datei konvertieren.

1. Wechseln Sie in der Eingabeaufforderung zu dem Ordner mit Ihrer PFX-Datei 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 Abschnitt Authentifizierung die Option OAuth 2.0-Clientanmeldedaten mit JWT-Inhaber als Authentifizierungstyp aus und geben Sie 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 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.
• 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-Onlinemandanten 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.

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

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.

DeleteAttachment-Aktion

Durch diese Aktion wird ein Anhang gelöscht.

Eingabeparameter der Aktion „DeleteAttachment“

Aktion „CheckInDocument“

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

Eingabeparameter der Aktion „CheckInDocument“

Aktion „CheckOutDocument“

Mit dieser Aktion können Sie eine Datei auschecken.

Eingabeparameter der CheckOutDocument-Aktion

DiscardCheckOutDocument-Aktion

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

Eingabeparameter der Aktion „DiscardCheckOutDocument“

Aktion „CopyDocument“

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

Eingabeparameter der Aktion „CopyDocument“

Aktion „UploadDocument“

Mit dieser Aktion können Sie eine Datei hochladen.

Eingabeparameter der Aktion „UploadDocument“

Aktion „DownloadDocument“

Mit dieser Aktion können Sie eine Datei herunterladen.

Eingabeparameter der Aktion „DownloadDocument“

MoveAttachmentOrDocument-Aktion

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

Eingabeparameter der Aktion „MoveAttachmentOrDocument“

Aktion „CreateFolder“

Mit dieser Aktion können Sie einen Ordner erstellen.

Eingabeparameter der Aktion „CreateFolder“

AddAttachments-Aktion

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

Eingabeparameter der Aktion „AddAttachments“

Aktion „DownloadAttachments“

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

Eingabeparameter der Aktion „DownloadAttachments“

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"
   }

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

[{
"Status": "Success"
}]

Beispiel – Check in einem Dokument

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 Feld Default Value ein:

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "DocumentName": "Document.txt",
   "Comment": "Comment test"
   }

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

[{
"Status": "Success"
}]

Beispiel: Datei auschecken

In diesem Beispiel wird eine Datei ausgecheckt.

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"
   }

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"
   }

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

[{
"Status": "Success"
}]

Beispiel: Datei kopieren

In diesem Beispiel wird eine Datei von einem Ort 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 Feld Default Value ein:

   {
   "SourceFileRelativeUrl": "/Shared Documents/Document.docx",
   "DestFileRelativeUrl": "/Shared Documents/TestFolder/Document123.docx"
   }

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

[{
"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 Feld Default Value ein:

   {
   "FileName": "test.txt",
   "RelativeUrl": "/Shared Documents/TestFolder",
   "Content": "abcd"
   }

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

[{
"Status": "Success"
}]

Beispiel: Binärdatei hochladen

In diesem Beispiel wird eine Binärdatei an den angegebenen Speicherort hochgeladen. Wenn Sie eine Binärdatei hochladen, geben Sie 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 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"
   }

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

[{
"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 Feld Default Value ein:

   {
   "RemoteFile": "/TestFolder/test.txt",
   "Library": "Shared Documents"
   }

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

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 Feld Default Value ein:

   {
   "RemoteFile": "/TestFolder/test1.png",
   "Library": "Shared Documents"
   "HasBytes": "true"  
   }

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

In diesem Beispiel wird eine Datei von einer bestimmten Website 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 Feld Default Value ein:

   {
     "RemoteFile": "	http://z8**.sharepoint.com/sites/SharepointGCS/Docs/SharpointGCS.docx",
     "Library": "Docs",
     "HasBytes": true
   }
   

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

[
  {
    "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: 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 Feld Default Value ein:

   {
   "SourceFileURL": "/Shared Documents/test.txt",
   "DestinationFolderURL": "/Shared Documents/TestFolder"
   }

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

[{
"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 Feld Default Value ein:

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "FolderName": "TestFolder123"
   }

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: Anhang hinzufügen

In diesem Beispiel wird der angegebenen Liste eine Anlage 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 Feld Default Value ein:

   {
   "ListTitle": "My Lists",
   "FileName": "TestAttachment2",
   "Content": "abcd text",
   "ItemId": "1"
   }

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 hinzufügen

In diesem Beispiel wird der angegebenen Liste eine binäre Anlage 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 Feld Default Value ein:

   {
   "ListTitle": "My Lists",
   "FileName": "TestAttachment3",
   "ContentBytes": "VGVzdCBGaWxl",
   "HasBytes": "true",  
   "ItemId": "1"
   }

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

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 Feld Default Value ein:

   {
   "RemoteFile": "/Shared Documents/Document.txt"
   }

Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der DownloadAttachments-Aufgabe einen Wert, der dem folgenden ähnelt:

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

Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der DownloadAttachments-Aufgabe 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.

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: 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 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: Eintrag erstellen

In diesem Beispiel wird ein Datensatz 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 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: 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 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.