Excel Online

Verwenden Sie den Excel Online-Connector, um Vorgänge in Excel Online auszuführen.

Hinweise

Konfigurieren Sie Ihr Google Cloud-Projekt, erstellen Sie Ihre OAuth-Anwendung und gewähren Sie die erforderlichen Berechtigungen.

Konfigurieren Sie Ihr Google Cloud-Projekt.

Führen Sie die folgenden Aufgaben in Ihrem Google Cloud-Projekt aus, bevor Sie den Excel Online-Connector verwenden:

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

Benutzerdefinierte OAuth-Anwendung erstellen – Azure AD

1. Melden Sie sich im Azure-Portal an.
2. Wählen Sie im linken Navigationsbereich „Azure Active Directory“ und dann „applicationRegistrations“ aus.
3. Klicken Sie auf „Neue Registrierung“.
4. Geben Sie einen Namen für die Anwendung ein.
5. Wählen Sie die gewünschte Tenant-Einrichtung aus: Einzel- oder Mehrmandaten-Umgebung und öffentliche oder private Nutzung.
• Wenn Sie die Standardoption „Konten nur in diesem Organisationsverzeichnis“ auswählen, müssen Sie die AzureTenant-Verbindungseigenschaft auf die ID des Azure AD-Mandanten festlegen, wenn Sie eine Verbindung mit dem CData-JDBC-Treiber für Microsoft Excel Online herstellen. Andernfalls schlägt der Authentifizierungsversuch mit einer Fehlermeldung fehl.
• Wenn Ihre Anwendung nur für den privaten Gebrauch bestimmt ist, geben Sie nur Konten in diesem Organisationsverzeichnis an.
• Wenn Sie Ihre Anwendung verteilen möchten, wählen Sie eine der mandantenfähigen Optionen aus.
6. Stellen Sie die Weiterleitungs-URL auf http://localhost:33333 (Standardeinstellung des Treibers) ein ODER geben Sie einen anderen Port an und stellen Sie CallbackURL auf die exakte Antwort-URL ein, die Sie definiert haben.
7. Klicken Sie auf „Registrieren“, um die neue Anwendung zu registrieren. Ein Bildschirm für die Anwendungsverwaltung wird angezeigt. Notieren Sie sich den Wert in der Anwendungs-ID (Client-ID) als OAuthClientId und die Verzeichnis-ID (Mandant) als Azure-Mandant.
8. Rufen Sie „Zertifikate und Secrets“ auf und definieren Sie den Authentifizierungstyp der Anwendung. Es sind zwei Arten der Authentifizierung verfügbar: Zertifikat (empfohlen) oder Clientschlüssel.
• Für die Zertifikatsauthentifizierung: Wählen Sie unter „Zertifikate und Secrets“ die Option „Zertifikat hochladen“ aus und laden Sie das Zertifikat von Ihrem lokalen Computer hoch.
• Zum Erstellen eines neuen Clientschlüssels: unter Zertifikate und Secrets, wählen Sie „Neuer Clientschlüssel“ für die Anwendung aus und geben Sie ihre Dauer an. Nachdem der Clientschlüssel gespeichert wurde, zeigt Microsoft Excel Online den Schlüsselwert an. Kopieren Sie diesen Wert, da er nur einmal angezeigt wird. Dieser Wert wird zum OAuthClientSecret.
9. „API-Berechtigungen“ auswählen > Hinzufügen > Delegierte Berechtigungen.
10. Fügen Sie die folgenden Anwendungsberechtigungen hinzu: Sites.Read.All, Files.Read, Files.Read.All, Files.Read.Selected, Files.ReadWrite, Files.ReadWrite.All, Files.ReadWrite.AppFolder, Files.ReadWrite.Selected und offline_access.
11. Speichern Sie die Änderungen.
12. Wenn Sie die Verwendung von Berechtigungen festgelegt haben, für die die Einwilligung des Administrators erforderlich ist (z. B. Anwendungsberechtigungen), können Sie diese vom aktuellen Mandanten auf der Seite „API-Berechtigungen“ gewähren.

Benutzerdefinierte OAuth-Anwendung erstellen – Azure-Dienstprinzipal

1. Verwende die Suchleiste, um nach dem Abodienst zu suchen.
2. Öffnen Sie die Seite „Abos“.
3. Wählen Sie das Abo aus, dem Sie die Anwendung zuweisen möchten.
4. Öffnen Sie die Zugriffssteuerung (IAM).
5. Wählen Sie Hinzufügen > Rollenzuweisung hinzufügen. Microsoft Excel Online öffnet die Seite Rollenzuweisung hinzufügen.
6. Weisen Sie Ihrer benutzerdefinierten Azure AD-Anwendung die Rolle „Owner“ zu.

Der Anwendung eine Rolle zuweisen

1. Damit Sie auf Ressourcen in Ihrem Abo zugreifen können, müssen Sie der Anwendung eine Rolle zuweisen.
2. Öffne die Aboseite, indem du in der Suchleiste nach dem Abodienst suchst und ihn auswählst.
3. Wählen Sie das Abo aus, dem Sie die Anwendung zuweisen möchten.
4. Öffnen Sie die Zugriffssteuerung und wählen Sie „Hinzufügen“ > „Hinzufügen“ aus. Rollenzuweisung hinzufügen, um die Seite „Rollenzuweisung hinzufügen“ zu öffnen.
5. Wählen Sie „Inhaber“ als Rolle aus, die Sie der erstellten Azure AD-Anwendung zuweisen möchten.

Einwilligung des Administrators erteilen

1. Melden Sie sich im Azure-Portal an.
2. Gehen Sie zu „App Registrations“ (App-Registrierungen) und suchen Sie nach der benutzerdefinierten OAuth-Anwendung, die Sie erstellt haben.
3. Klicken Sie unter „API-Berechtigungen“ auf „Einwilligung erteilen“.

Berechtigungen für Clientanmeldedaten gewähren

1. Melden Sie sich im Azure-Portal an.
2. Rufen Sie „App-Registrierungen“ auf.
3. Suchen Sie die Anwendung, die Sie gerade erstellt haben, und öffnen Sie die API-Berechtigungen.
4. Wählen Sie die Microsoft Graph-Berechtigungen aus. Es gibt zwei verschiedene Gruppen von Berechtigungen: „Delegiert“ und „Anwendung“.
5. Wählen Sie unter „Anwendungsberechtigungen“ die Berechtigungen aus, die Sie für Ihre Integration benötigen.

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 Excel Online 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. Aktivieren Sie optional Cloud Logging. und wählen Sie dann eine Logebene aus. Standardmäßig ist die Logebene 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.

   Hinweis: Sie können die Verbindungsknotenwerte nur anpassen, wenn Sie ein „Pay as you go”-Kunde sind.
   8. Azure-Mandant: Der Microsoft Online-Mandant, der für den Zugriff auf Daten verwendet wird. Wenn keine Angabe erfolgt, wird der Standardmandant verwendet.
   9. Drive: Die ID des Laufwerks. In den Ansichten „Drives“ und „SharePointSites“ können Sie sich alle Websites und Laufwerke ansehen, auf die Sie Zugriff haben.
   10. SharePoint-URL: Die Basis-URL Ihres SharePoint-Servers.
   11. Freigegebene Dokumente anzeigen: Gibt an, ob freigegebene Dokumente angezeigt werden sollen oder nicht.
   12. Arbeitsmappe: Der Name oder die ID der Arbeitsmappe.
   13. Kopfzeile: Gibt an, ob die Spaltennamen aus der ersten Zeile ermittelt werden sollen.
   14. Tabelle: Damit wird die Verbindung zu einer Tabelle eingeschränkt, die einen Zellenbereich eines Arbeitsblatts enthält. Format: [{Name der Arbeitsmappe}_{Name des Arbeitsblatts}!{Bereich}]
   15. Klicken Sie optional auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
   16. Klicken Sie auf Weiter.
5. 1. Geben Sie im Abschnitt Authentifizierung die Authentifizierungsdetails ein. Informationen zum Konfigurieren dieser Authentifizierungsdetails finden Sie unter Authentifizierung konfigurieren.
   2. Klicken Sie auf Weiter.
6. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
7. Klicken Sie auf Erstellen.

Authentifizierung konfigurieren

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

• Client-ID: Die Client-ID, die zum Anfordern von Zugriffstokens verwendet wird.
• Bereich: Eine durch Kommas getrennte Liste der gewünschten Bereiche.
• Clientschlüssel: Der Clientschlüssel, der zum Anfordern von Zugriffstokens verwendet wird.
• Authorization URL (Autorisierungs-URL): Die beim Erstellen des Clients generierte Autorisierungs-URL.

Excel Online – Internetverbindungstyp

In diesem Abschnitt werden die Beispielwerte für die verschiedenen Felder aufgeführt, die Sie beim Erstellen der Excel Online-Verbindung konfigurieren.

Feldname	Details
Standort	us-central1
Connector	Excelonline
Connector-Version	1
Verbindungsname	excelonline-gcp
Dienstkonto	SERVICE_ACCOUNT_NAME@serviceaccount
Azure-Mandant	9b******-****-****-****-*********12
Drive	b!p_648NCXwk6hJ1pfyn0SeFaithFnRM1JmYNur9asmHAs2k8qe5UsR5a1cX6luuD0
Sharepoint-URL	https://*****.sharepoint.com/
Freigegebene Dokumente anzeigen	Wahr
Mindestanzahl von Knoten	2
Maximale Anzahl von Knoten	50
Client-ID	e89*****-****-****-****-*********b6
Bereiche	https://graph.microsoft.com/.default
Clientschlüssel	CLIENT_SECRET
Secret-Version	1
Autorisierungs-URL	https://login.microsoftonline.com/{Azure-Tenant}/oauth2/v2.0/authorize

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. Gehen Sie auf der Seite „Verbindungen“ so vor: finden Sie die neu erstellte Verbindung.

   Der Status für den neuen Connector 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 Ihre externe Anwendung.
4. Überprüfen Sie die Autorisierungsdetails.
5. Klicken Sie auf Autorisieren.

   Ist die Autorisierung erfolgreich, wird der Verbindungsstatus im Seite „Verbindungen“.

Erneute Autorisierung für Autorisierungscode

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

1. Klicken Sie auf der Seite Verbindungen auf die erforderliche 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 bei Bedarf die erforderlichen Änderungen vor.

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

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

Systemeinschränkungen

Die maximale Excel-Dateigröße, die der Excel Online-Connector verarbeiten kann, beträgt 25 MB.

Der Excel Online-Connector kann 3 Transaktionen pro Sekunde und pro Knoten verarbeiten. Transaktionen, die dieses Limit überschreiten, werden drosselt. Standardmäßig werden von Integration Connectors zwei Knoten (für eine bessere Verfügbarkeit) für eine Verbindung zugewiesen.

Informationen zu den für Integration Connectors geltenden Limits finden Sie unter Beschränkungen.

Hinweis: Die Anzahl der Integration Connectors-Knoten wird dynamisch automatisch skaliert. basierend auf Ihrer Nutzung. Wenn Sie jedoch Kapazitäten für große Volumes reservieren möchten, wenn Sie auf das Autoscaling warten, können Sie den minimalen Knotenwert für eine Verbindung anpassen. Mehr Knoten sind erforderlich, um mehr Transaktionen für eine Verbindung zu verarbeiten. Umgekehrt benötigen weniger Knoten sind erforderlich, wenn über eine Verbindung weniger Transaktionen verarbeitet werden. Knoten konfigurieren Gehen Sie so vor:

• Konfigurieren Sie als „Pay as you go“-Kunde den minimalen und maximalen Knotenwert auf der Seite „Verbindung bearbeiten“.
• Wenn Sie ein Abo haben, wenden Sie sich bitte an den Support.

Die maximale Anzahl von Transaktionen, die ein Knoten verarbeiten kann, hängt von verschiedenen Faktoren ab. Bevor Sie die Mindestanzahl von Knoten für einen besseren Durchsatz anpassen, sollten Sie prüfen, ob Ihre Back-End-Systeme optimal für die Verarbeitung des erforderlichen Traffics eingerichtet sind.

Excel Online-Verbindung in einer Integration verwenden

Nachdem Sie die Verbindung erstellt haben, ist sie in beiden Apigee-Integration und Anwendungsintegration Sie können die Verbindung über die Connectors-Aufgabe in einer Integration.

• Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in der Apigee-Integration finden Sie unter Connectors-Aufgabe.
• Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in der Anwendungsintegration finden Sie unter Connectors-Aufgabe.

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.

Hinweis: Sie können die Entitäten, Vorgänge und Aktionen eines Connectors in der Connectors-Aufgabe aufrufen.

• 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:
  • Liste
  • Abrufen
  • Erstellen
  • Aktualisieren
  • Löschen

  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 eine Ausgabe . Es ist jedoch möglich, dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Actions-Liste leer.

Hinweis : Allen Entitäten und Aktionen ist ein Schema zugeordnet. Ein Aktionsschema hat beispielsweise folgende Parameterdetails: den Parameter und den zugehörigen Datentyp. Das Schema (Metadaten) für Entitäten und Aktionen wird von der Verbindung unter aus Ihrem Back-End. Falls das Schema aktualisiert wird, werden diese Aktualisierungen nicht automatisch in Ihren bestehenden Verbindungen widergespiegelt; müssen Sie das Schema manuell aktualisieren. Aktualisieren das Schema für eine Verbindung. Öffnen Sie dazu die Seite Verbindungsdetails der Verbindung und klicken Sie auf Verbindungsschema aktualisieren

Aktionen

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

Hinweis:Die Ergebnisse aller Aktionen sind als JSON-Antwort in der connectorOutputPayload der Aufgabe Connectors -Antwortparameter, nachdem Sie die Integration ausgeführt haben.

Aktion "Arbeitsblatt hinzufügen"

Fügt einer vorhandenen Excel Online-Arbeitsmappe ein Arbeitsblatt hinzu.

Eingabeparameter der Aktion "AddWorksheet"

Parametername	Datentyp	Erforderlich	Beschreibung
Titel	String	Wahr	Name des Arbeitsblatts.
WorkbookId	String	Wahr	Die ID der Arbeitsmappe. Diese ID muss zu dem Laufwerk gehören, auf das über die aktuellen Verbindungseigenschaften zugegriffen werden kann.

Ausgabeparameter der Aktion „AddWorksheet“

So konfigurieren Sie beispielsweise die Aktion AddWorksheet. Siehe Beispiele.

Beispiele

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

Aktionsbeispiele

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

Beispiel – Aktion „AddWorksheet“ ausführen

In diesem Beispiel wird einer vorhandenen Excel Online-Arbeitsmappe ein Arbeitsblatt hinzugefügt.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion AddWorksheet aus und klicken Sie auf Fertig.
3. Im Bereich Datenzuordnung Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Feld Input:

   {   
   "WorkbookId": "01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL",
   "Title": "Worksheet_SP1"
   }

Wenn die Aktion erfolgreich ist, connectorOutputPayload-Antwort der Aufgabe von AddWorksheet hat einen Wert ähnlich dem folgenden:

[{
  "Success": "true",
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#workbookWorksheet",
  "@odata.type": "#microsoft.graph.workbookWorksheet",
  "@odata.id": "/drives('b%21p_648NCXwk6hJ1pfyn0SeFaithFnRM1JmYNur9asmHAs2k8qe5UsR5a1cX6luuD0')/items('01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL')/workbook/worksheets(%27%7BD9372F53-CB1B-4082-9E13-02E65C2FC233%7D%27)",
  "id": "{D9372F53-CB1B-4082-9E13-02E65C2FC233}",
  "name": "Worksheet_SP1",
  "position": "1",
  "visibility": "Visible"
}]

Beispiele für Entitätsvorgänge

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

Beispiel – Alle Laufwerke auflisten

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

Beispiel: Alle freigegebenen Dokumente auflisten

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

Beispiel – Alle Arbeitsmappen auflisten

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

Beispiel – Laufwerke abrufen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
Laufwerke in der Entity-Liste.
2. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
3. Legen Sie die Entitäts-ID auf „Einzelne Laufwerke abrufen“ fest. Um die Entitäts-ID festzulegen, Klicken Sie unter Datenzuordnung im Abschnitt Data Mapper auf Datenzuordnungseditor öffnen und Geben Sie dann b!ZETdEU1T_UOBEzbgDmsvcubxvUaXbcJNrrNPM4LqokkwLC3zCRPiQLi2PBfCs9-v in das Feld Eingabewert ein und wählen Sie die Entitäts-ID als lokale Variable aus.

Beispiel – SharedDocument abrufen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie „SharedDocuments“ aus der Liste Entity aus.
3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „Einzelnes freigegebenes Dokument abrufen“ fest. Um die Entitäts-ID festzulegen, Klicken Sie unter Datenzuordnung im Abschnitt Data Mapper auf Datenzuordnungseditor öffnen und Geben Sie dann 01BDTL6TS3OQ3HDXCKGREILDYKY47S7LEI in das Feld Eingabewert ein und wählen Sie die Entitäts-ID als lokale Variable aus.

Beispiel: Tabellenbücher abrufen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity Arbeitsmappen aus.
3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „Einzelne Arbeitsmappen abrufen“ fest. Um die Entitäts-ID festzulegen, Klicken Sie unter Datenzuordnung im Abschnitt Data Mapper auf Datenzuordnungseditor öffnen und Geben Sie dann 01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL in das Feld Eingabewert ein und wählen Sie die Entitäts-ID als lokale Variable aus.

Beispiel: Daten aus einem Buch löschen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Book 4567_Sheet1 aus der Liste Entity aus.
3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
4. Setzen Sie die Entitäts-ID auf „Buch löschen“ 4567_Sheet1. Um die Entitäts-ID festzulegen, Klicken Sie unter Datenzuordnung im Abschnitt Data Mapper auf Datenzuordnungseditor öffnen und Geben Sie dann 5.0 in das Feld Eingabewert ein und wählen Sie die Entitäts-ID als lokale Variable aus.

Beispiel – Formel für Tabelle_Liste_Formel erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option „Formulae_Sheet_List“ aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Abschnitt Data Mapper der Aufgabe auf OpenDataMapping-Editor und geben Sie in das Feld field:

    {
     "Excel_Sheet": "Old_Excel",
     "B": "=SUM(C8:D8)",
     "C": "6",
     "D": "6"
     }
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 8.0
     } 
     

Example - Create With_Headers

1. In the Configure connector task dialog, click Entities.
2. Select Book 4567_Book4567_Sheet1 from the Entity list.
3. Select the Create operation, and then click Done.
4. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

    {
       "Name": "workbooknew",
       "Type": "newly created",
       "Sl no": 5.0
     }
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 6.0
     }
     

Example - Create Without_Headers

1. In the Configure connector task dialog, click Entities.
2. Select Book 4567_Book4567_Sheet1 from the Entity list.
3. Select the Create operation, and then click Done.
4. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

     {
       "A": "6",
       "B": "Halo",
       "C": "Stardust"
     } 
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 7.0
     } 
     

Example - Update an Formula for Formulae_Sheet_List

1. In the Configure connector task dialog, click Entities.
2. Select Formulae_Sheet_List from the Entity list.
3. Select the Update operation, and then click Done.
4. Set the entity ID to Update a Formulae_Sheet_List. To set the entity ID, in the Data mapper section of the Tasks, click entityId and then enter 8.0 in the given field.
5. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

    
     {
     "B": "=MAX(C8:D8)",
     "C": "7",
     "D": "10"
     } 
     

Wenn Sie dieses Beispiel ausführen, wird in der Ausgabevariablen connectorOutputPayload des Connector-Aufgaben eine Antwort ähnlich der folgenden zurückgegeben:

 
  {   
  "Id": 8.0
  }
  

Beispiel: Update Without_Header

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Book 4567_Book4567_Sheet1 aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Setzen Sie die Entitäts-ID auf „Buch aktualisieren“ 4567_Book4567_Sheet1. Um die Entitäts-ID festzulegen, Klicken Sie unter Tasks im Abschnitt Data Mapper auf entityId und und geben Sie 7.0 in das entsprechende Feld ein.
5. Klicken Sie im Abschnitt Data Mapper der Aufgabe auf OpenDataMapping-Editor und geben Sie in das Feld field:

    
      {
       "B": "cosmically",
       "C": "interlinked"
     }  
     

Wenn Sie dieses Beispiel ausführen, wird in der Ausgabevariablen connectorOutputPayload des Connector-Aufgaben eine Antwort ähnlich der folgenden zurückgegeben:

 
  {   
  "Id": 7.0
  }
  

Beispiel – Update_With_Header

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
li>Wählen Sie in der Liste Entity die Option „Book 4567_Book4567_Sheet1“ aus.
2. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
3. Legen Sie die Entitäts-ID für „Buch 4567 aktualisieren“ fest: 4567_Buch4567_Tabelle1. Klicken Sie dazu im Bereich Datenübersetzer der Aufgaben auf Entitäts-ID und geben Sie dann 6.0 in das entsprechende Feld ein.
4. Klicken Sie im Bereich Datenabgleich der Aufgabe auf den Editor OpenDataMapping und geben Sie dann einen Wert ähnlich dem folgenden in das Feld field: ein:

    
      {
       "Name": "updated",
       "Type": "newupdate"
     }
     

Wenn Sie dieses Beispiel ausführen, wird im Connector-Typ eine ähnliche Antwort wie die folgende zurückgegeben der connectorOutputPayload-Ausgabevariable der Aufgabe:

 
  {   
  "Id": 6.0
  }
  

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

• Informationen zum Anhalten und Fortsetzen einer Verbindung
• Informationen zum Überwachen der Connector-Nutzung
• Weitere Informationen zum Aufrufen von Connector-Logs