Die Automatisierung von Verbindungsaktualisierungen ist für die Rationalisierung der Datenzentralisierung und -übertragung in die Workiva-Plattform von entscheidender Bedeutung, insbesondere wenn mehrere Verbindungen bestehen. In diesem Connected Learning Path werden wir lernen, wie man eine Kette erstellt, die eine Liste von Verbindungen zwischen Wdata und der Workiva Plattform mit Hilfe einer Spreadsheet ID aktualisiert. Diese Kette generiert eine Liste von Verbindungen auf einem einzigen Tabellenblatt und stellt uns dann die Liste der IDs dieser Verbindungen zur Verfügung, so dass wir die Aktualisierung jeder Verbindung im Tabellenblatt automatisieren können.
| Primärer geschäftlicher Anwendungsfall | Datenkonnektivität zwischen Workiva und Wdata |
| Primäres Lernziel | Erfahren Sie, wie Sie eine Liste von Verbindungen mit Hilfe von Chains aktualisieren können |
| Sekundäre Lernziele | Lernen Sie das Wesentliche über Gruppen-Iteratoren |
| Voraussetzungen |
Workiva Connector konfigurieren Vervollständigen Sie das CLP | Aktualisieren von Verbindungen mit einem Parameter Erteilen von Berechtigungen für das Spreadsheet für den zugehörigen OAuth Grant User |
| Unterstützende Vorlage | CLP | Liste der Verbindungen aktualisieren |
Schritt 1: Erstellen einer Kette
- Eine neue Kette hinzufügen
- Benennen Sie die Kette: CLP | Refresh List of Connections
- Rettet die Kette
Schritt 2: Laufzeit-Eingaben
Wir verwenden den Befehl Runtime Inputs, um die Kette zu starten. Auf diese Weise können wir angeben, für welches Tabellenblatt wir alle Verbindungen aktualisieren möchten.
- Fügen Sie ein Runtime Inputs Chain Event von Chain Trigger Events den Startknoten hinzu
- Bearbeiten Sie das Runtime Inputs Chain Event durch Doppelklick auf den Command
- Typ: TextField
- Name anzeigen: Tabellenkalkulations-ID
- Erforderlich: Abgehakt
- Speichern Sie den Befehl
Schritt 3: Verbindungen auflisten
Wir werden den Befehl Verbindungen auflisten verwenden, um die Liste der Verbindungs-IDs abzurufen, die mit der Spreadsheet-ID verbunden sind. Die Ausgabe des Befehls Verbindungen auflisten besteht aus einer JSON-Datei, die jede Verbindung in der Kalkulationstabelle mit Details zur Verbindung, einschließlich der Verbindungs-ID, enthält.
- Fügen Sie einen List Connections Befehl aus dem Workiva Connector zum Chain Canvas hinzu
- Verbinden Sie den Befehl Runtime Inputs mit dem Befehl List Connections
- Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren
- Zieltyp: Tabellenkalkulation
- Ziel-ID: Verwenden Sie die Variable Spreadsheet ID von Runtime Inputs - dies ermöglicht es uns, den zur Laufzeit der Kette angegebenen Wert an den Befehl Refresh Connections weiterzuleiten
- Klicken Sie auf das Feld Ziel-ID
- Erweitern Sie im linken Bereich das Dropdown-Menü Trigger
- Erweitern Sie das Dropdown-Menü Runtime Inputs
- Wählen Sie die Variable Spreadsheet ID
- Speichern Sie den Befehl
Schritt 4: Befehlsgruppe
Wir werden eine Befehlsgruppe verwenden, um die Iteration über jede Verbindung zu ermöglichen. Der Gruppen-Iterator schiebt jede Verbindung auf dem Arbeitsblatt durch die folgenden Schritte, einen nach dem anderen.
- Fügen Sie eine Befehlsgruppe zur Kettenleinwand hinzu
- Verbinden Sie den Befehl List Connections mit dem Abschnitt In der Befehlsgruppe
- Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren
- Benennen Sie die Gruppe: Verbindungen Iteration
- Navigieren Sie zur Registerkarte Iteratoren
- Aktivieren Sie das Kästchen Iterationen und klicken Sie auf das Feld Iterationen
- Klicken Sie im Bereich Select a Variable auf den Abwärtspfeil, um List Connections zu erweitern
- Wählen Sie den Ausgang Connections
- Aktivieren Sie das Kästchen Iterationen und klicken Sie auf das Feld Iterationen
- Speichern Sie die Befehlsgruppe
Schritt 5: Verbindung aktualisieren
Wir werden den Befehl Verbindung aktualisieren verwenden, um unsere Verbindungen mit der Verbindungs-ID aus der Iteration zu aktualisieren.
- Fügen Sie einen Refresh Connection Befehl aus dem Workiva Connector in den Chain Canvas ein
- Verbinden Sie den Abschnitt Start des Gruppen-Iterators mit dem Befehl Verbindung aktualisieren
- Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren
- Verbindungs-ID: Verwenden Sie die Verbindungs-ID aus dem Gruppen-Iterator - Iteration der Verbindungen. Dies ermöglicht es uns, die ID für die aktuelle Iteration an den Befehl "Verbindungen aktualisieren" weiterzuleiten
- Klicken Sie auf das Feld Verbindungs-ID
- Erweitern Sie im linken Bereich das Dropdown-Menü Group Iterator
- Erweitern Sie das Dropdown-Menü Connections Iteration
- Wählen Sie die Variable ConnectionId
- Vorherige Quellparameter verwenden: Abgehakt
- Damit können wir eine Verbindung mit den vorherigen Parameterwerten aus der Quelle aktualisieren - in unserem Fall wird die Abfrage mit dem Parameter Land weiterhin mit Brasilien als Filterwert aktualisiert
- Verbindungs-ID: Verwenden Sie die Verbindungs-ID aus dem Gruppen-Iterator - Iteration der Verbindungen. Dies ermöglicht es uns, die ID für die aktuelle Iteration an den Befehl "Verbindungen aktualisieren" weiterzuleiten
Schritt 6: Testen Sie die Übung
Testen Sie das Ergebnis, nachdem die Kette abgeschlossen ist
- Veröffentlichen die Kette
- Klicken Sie auf Execute und wählen Sie dann Run With Inputs
- Suchen Sie die Spreadsheet-ID
- Navigieren Sie zum Tabellenblatt CLP Employee Overview
- Wählen Sie in der URL die Spreadsheet-ID aus, die sich nach "spreadsheet/" und vor "/sheet" befindet.
- Die Tabellenkalkulations-ID ist hier zum Beispiel fett gedruckt: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Navigieren Sie zurück zum Chain Builder und fügen Sie die Spreadsheet ID in das Feld Spreadsheet ID ein
- Start anklicken
- Sobald die Kette abgeschlossen ist, navigieren Sie zurück zum Spreadsheet und sehen Sie, dass beide Verbindungen erfolgreich aktualisiert wurden!
Erfolgreicher Kettenlauf mit zwei Iterationen:
Erfolgreiche Aktualisierung der Verbindung:
Wenn Sie mehr über die Verwendung von Chains zur Rationalisierung der Datenerfassung erfahren möchten, lesen Sie den Rest des Data Centralization Paths!