Sie möchten eine Verbindung zu einer Anwendung eines Drittanbieters herstellen, die über die vordefinierten Premium Connectors von Workiva hinausgeht? Sie können dies erreichen, indem Sie die HTTP Request Connector-Befehle zur Interaktion mit REST-APIs nutzen.
Hinweis: Obwohl dies als HTTP-Anfrage gekennzeichnet ist, wird HTTPS (Secure HTTP) unterstützt (und empfohlen).
In diesem Connected Learning Path aktualisieren wir unsere Kette, um Runtime Inputs zu verwenden, bei denen wir angeben können, welche Tabelle wir abrufen möchten.
| Primärer geschäftlicher Anwendungsfall | Verbinden mit Systemen von Drittanbietern |
| Primäres Lernziel | Nutzen Sie Workivas HTTP Request Connector Commands, um über die vorgefertigten Konnektoren hinaus mit REST-APIs für Drittanbieteranwendungen zu interagieren. Aktualisieren Sie Chains, um mithilfe von Runtime Inputs festzulegen, welches Arbeitsblatt verwendet werden soll. |
| Sekundäres Lernziel | Runtime-Inputs verwenden |
| Voraussetzungen |
Workiva-API-Zuteilung konfigurieren HTTP Request Connector konfigurieren Vollständig CLP | HTTP-Anfrage Tabellenkalkulationen auflisten |
| Unterstützende Vorlage | CLP | HTTP-Anfrage Ein einzelnes Arbeitsblatt abrufen |
Schritt 1: Kopieren und Ändern einer Kette
- Navigieren Sie zum Chain Builder und suchen Sie die Kette CLP | HTTP Request List Spreadsheets.
- Klicken Sie auf die vertikale Ellipse, um die Kette zu kopieren.
- Klicken Sie auf das Bleistiftsymbol, um die Kette zu bearbeiten.
- Klicken Sie oben rechts auf Ketteneinstellungen und benennen Sie die Kette um: CLP | HTTP Request Get a Single Spreadsheet.
- (Optional) Geben Sie eine Beschreibung: "Diese Kette generiert ein neues Workiva API Access Token. Sie müssen eine gültige Client-ID und ein Client-Geheimnis aus einer zuvor generierten API-Berechtigung in die unten stehenden Variablenwerte eingeben. Wenn die Kette ausgeführt wird, wird sie den Benutzer auffordern, eine Spreadsheet ID einzugeben. Die Kette ruft das Rechenblatt ab."
- Speichern Sie die Kette.
Schritt 2: Laufzeit-Eingaben
Verwenden Sie das Runtime Inputs Chain Event, um die Kette zu starten.
So können Sie die Spreadsheet ID des Spreadsheets angeben, das Sie abrufen möchten. Lesen Sie mehr über Runtime Inputs.
- Verschieben Sie den POST - Retrieve a Token Befehl vom Start Node.
- Fügen Sie ein Runtime Inputs Chain Event von Chain Trigger Events zum Start Node hinzu.
- Doppelklicken Sie auf den Link, der Runtime Inputs mit dem Get - List Spreadsheets Befehl verbindet und löschen Sie den Link.
- Verbinden Sie Runtime Inputs mit dem POST - Retrieve a Token Befehl.
-
Verbinden Sie den Befehl POST - Retrieve a Token mit dem Befehl GET - List Spreadsheets.
- Doppelklicken Sie auf das Runtime Inputs Kettenereignis, um es zu konfigurieren.
- Klicken Sie auf Add Input und konfigurieren Sie die folgenden Felder:
- Typ: Textfeld
- Name anzeigen: Spreadsheet ID - schauen Sie sich dieses Dokument an, um die ID zu finden
- Erforderlich: Markieren Sie dieses Kontrollkästchen
- (Optional) Geben Sie eine Beschreibung ein: "Mit diesem Befehl kann der Benutzer Werte für erforderliche Laufzeiteingaben festlegen."
- Speichern Sie den Befehl.
Schritt 3: Update des Befehls Get
Wir aktualisieren den HTTP Request Get-Befehl, so dass wir die Details zu einem einzelnen Arbeitsblatt erhalten, anstatt alle Arbeitsblätter im Arbeitsbereich aufzulisten.
- Doppelklicken Sie auf den Befehl Hole - Liste der Tabellenkalkulationen, um ihn zu konfigurieren.
- Benennen Sie den Befehl: Get - Abrufen eines einzelnen Arbeitsblatts.
-
Verwenden Sie die Variable Spreadsheet ID aus Runtime Inputs im URL-Feld, um anzugeben, welches Spreadsheet abgerufen werden soll.
Klicken Sie dazu auf das Feld URL und fügen Sie nach /spreadsheets "/<>",
ein und ersetzen Sie <Spreadsheet> durch die Variable aus Runtime Inputs wie folgt:- Erweitern Sie im linken Bereich die Dropdown-Liste Auslöser.
- Erweitern Sie die Auswahlliste Runtime Inputs.
- Wählen Sie die Variable Arbeitsblatt-ID.
- (Optional) Geben Sie eine Beschreibung ein: "Dieser Befehl gibt ein einzelnes Spreadsheet zurück. Weitere Informationen finden Sie in der Dokumentation für Entwickler unter https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/"
- Speichern Sie den Befehl.
Schritt 4: Testen Sie die Übung
Nun, da die Kette vollständig ist, können wir das Ergebnis testen.
- Veröffentlichen Sie die Kette.
- Klicken Sie auf Ausführen, und dann auf Ausführen mit Inputs.
- Suchen Sie die Spreadsheet ID, indem Sie zu einem Spreadsheet in der Workiva Plattform navigieren. Vergewissern Sie sich, dass der Benutzer, der die Berechtigung erteilt hat, Zugriff auf diese Tabelle hat.
- Klicken Sie auf Start.
- Sobald die Kette ihren Lauf beendet hat, können Sie sehen, dass die Details der Kalkulationstabelle auf der Registerkarte Outputs - Response Body des Befehls Get generiert wurden.
To continue to challenge yourself and learn more about using the HTTP Request Connector to connect to a third party API, check out the next exercise CLP Copy a Spreadsheet (add link when document created).
-->