Sie möchten eine Verbindung zu einer Anwendung eines Drittanbieters herstellen, die über die vordefinierten Premium Connectors von Workiva hinausgeht? Dies können Sie erreichen, indem Sie die Befehle des HTTP-Request-Connectors nutzen, um mit REST-APIs zu interagieren.
Hinweis: Obwohl dies als HTTP-Anfrage bezeichnet wird, 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ändige CLP | Tabellen mit HTTP-Anfragen |
| Unterstützende Vorlage | CLP | HTTP-Anfrage Ein einzelnes Arbeitsblatt abrufen |
Schritt 1: Kopieren und Ändern einer Kette
- Rufen Sie „Chain Builder“ auf und suchen Sie die Tabellen „Chain CLP | HTTP-Anfragenliste “.
- 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 in: CLP | HTTP-Anfrage – Eine einzelne Tabelle abrufen .
- ( Optional ) Geben Sie eine Beschreibung ein: „Diese Kette generiert ein neues Workiva-API-Zugriffstoken.“ 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."
- Rettet die Kette.
Schritt 2: Laufzeit-Eingaben
Verwenden Sie das Ereignis „Runtime Inputs Chain“ , 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 Befehl „POST – Token abrufen “ vom Startknoten weg.
- Fügen Sie dem Startknoten ein „Runtime InputsChain“-Ereignis aus den Kettenauslöseereignissen hinzu.
- Doppelklicken Sie auf den Link, der die Laufzeitparameter mit dem Befehl „Get – List Spreadsheets“ verknüpft, und löschen Sie die Verknüpfung.
- Verbinden Sie die Laufzeit-Eingaben mit dem Befehl „POST – Token abrufen “.
-
Verbinden Sie den Befehl „POST – Token abrufen “ mit dem Befehl „GET – Tabellen auflisten “.
- Doppelklicken Sie auf das Ereignis „Runtime Inputs Chain“, um es zu konfigurieren.
- Klicken Sie auf „Eingabe hinzufügen “ und konfigurieren Sie die folgenden Felder:
- Typ: Textfeld
- Anzeigename: Tabellen-ID – in diesem Dokument finden Sie Hilfe beim Auffinden der ID
- Erforderlich: Aktivieren Sie dieses Kontrollkästchen
- ( Optional ) Geben Sie eine Beschreibung ein: „Mit diesem Befehl kann der Benutzer Werte für erforderliche Laufzeitparameter 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 „Get – Liste der Tabellen“ , um ihn zu konfigurieren.
- Befehlsname: Get – Eine einzelne Tabelle abrufen .
-
Geben Sie im Feld „URL“ die Variable „Spreadsheet-ID“ aus den Laufzeitparametern ein, um anzugeben, welche Tabelle abgerufen werden soll.
Klicken Sie dazu auf das URL- Feld und fügen Sie hinter „/spreadsheets“ „/< Spreadsheet-ID > “ ein,
wobei „ “ durch <Spreadsheet ID> mit der Variablen aus den Laufzeit-Eingaben wie folgt:- Erweitern Sie im linken Bereich das Dropdown-Menü „Trigger “.
- Erweitern Sie das Dropdown-Menü „Laufzeit-Eingaben “.
- Wählen Sie die Variable „Spreadsheet-ID“ aus.
- ( Optional ) Geben Sie eine Beschreibung ein: „Dieser Befehl gibt eine einzelne Tabelle zurück.“ Weitere Informationen finden Sie in der Entwicklerdokumentation unter https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html"
- Speichern Sie den Befehl.
Schritt 4: Testen Sie die Übung
Nun, da die Kette vollständig ist, können wir das Ergebnis testen.
- Die Blockchain veröffentlichen .
- Klicken Sie auf „Ausführen “ und anschließend auf „Mit Eingaben ausführen “.
- Finde einen Arbeitsblatt-ID, indem Sie auf der Workiva-Plattform zu einer Tabelle navigieren. Vergewissern Sie sich, dass der Benutzer, der die Berechtigung erteilt hat, Zugriff auf diese Tabelle hat.
- Klicken Sie auf „Start “.
- Sobald die Kette ihre Ausführung abgeschlossen hat, können Sie sehen, dass die Tabellenkalkulationsdaten auf der Registerkarte „Outputs“ – im Antworttext des Get-Befehls – generiert wurden.