Mit Chains können Sie Routineaufgaben automatisieren und Daten über mehrere Datensysteme hinweg abrufen oder senden. Sie können z. B. eine Kette erstellen, um automatisch Finanzinformationen aus einer Datenquelle in eine Tabelle zu ziehen und diese Daten dann an ein anderes System weiterzuleiten, um einen Bericht zu erstellen. In Chain Builder ordnen und verknüpfen Sie die Aufgaben - oder Befehle-, die eine Kette ausführen soll.
Hinweis: Nur Arbeitsbereichseigentümer oder Ketteneigentümer können auf Chain Builder zugreifen. Klicken Sie in Wdata auf Chains, und dann auf Open Chain Builder.
Mit den Übungen in Erste Schritte mit Tabellen und Erste Schritte mit Abfragen erstellen Sie Tabellen und Abfragen, wie sie für die Finanzberichterstattung verwendet werden. In dieser Übung wollen wir eine Kette erstellen, um diese Abfrage auszuführen und die Ergebnisse in Tabellenkalkulationen zu exportieren.
Schritt 1. ID und der Parameter der Abfrage abrufen
Wenn Sie dies noch nicht getan haben, laden Sie die Beispieldaten herunter und führen Sie die Übungen Erste Schritte mit Tabellen und Erste Schritte mit Abfragen durch, da Sie die Abfrage in der Kette verwenden werden. Notieren Sie sich die ID der Abfrage, mit der Sie die Abfrage in der Kette identifizieren können.
Hinweis: Wenn Sie eine Abfrage in Wdata öffnen, erscheint ihre ID nach /queries/ in ihrer URL.
Wenn Sie die Filter der Abfrage mit Parametern anstelle von statischen Werten erstellt haben, notieren Sie sich auch die Namen der Parameter. Zum Beispiel:
- PY oder Vorheriges_Jahr
- CY oder Aktuelles_Jahr
- Aktueller_Zeitraum
Schritt 2. Tabellenkalkulation erstellen
Bevor Sie die Kette erstellen, erstellen Sie unter eine Tabellenkalkulation, in die Sie die Abfrageergebnisse exportieren.
Um einen Missbrauch des Arbeitsblatts zu vermeiden, sollten Sie den pädagogischen Zweck des Arbeitsblatts in seinem Namen klar angeben.
Nachdem Sie das Arbeitsblatt erstellt haben, notieren Sie seine URL; verwenden Sie es, um zu ermitteln, wohin die Abfrageergebnisse exportiert werden sollen.
Schritt 3. Erstellen Sie die Kette
Jetzt ist es an der Zeit, die Kette zu bauen! Schließlich enthält es Befehle zum Ausführen der Abfrage und zum Exportieren der letzten Ergebnisse in Tabellenkalkulationen.
Bevor Sie eine Kette erstellen, vergewissern Sie sich, dass Sie den core Workiva Connector eingerichtet haben, der für die Ausführung seiner Befehle verwendet wird. Während für diese Kette nur ein Konnektor erforderlich ist, können Ketten mehrere Konnektoren verwenden, um Daten zwischen Ihren verschiedenen Aufzeichnungssystemen vorzubereiten und zu übertragen.
Wenn der Anschluss eingerichtet ist, können Sie die Kette in Chain Builder hinzufügen:
- Klicken Sie in Wdata auf Chains , Chain Builder.
- Klicken Sie auf Build, Chains, und dann auf Add, Create Chain in der unteren rechten Ecke.
-
Geben Sie einen eindeutigen Namen und eine Beschreibung ein, um die Kette zu identifizieren.
Hinweis: Ketten erscheinen in Chain Builder für jeden im Arbeitsbereich; benennen Sie sie, damit die Mitglieder ihre Absicht klar verstehen. Siehe Führende Praxis: Benennungskonventionen für Ketten und ihre Objekte für weitere Informationen zur Benennung.
- Klicken Sie auf Speichern.
Schritt 4. Starten Sie mit einem Runtime Inputs Trigger Event
Damit die Kette mit der Abfrage der Variablen beginnt, die sie für ihre Befehle benötigt, fügen Sie ein Runtime Inputs trigger event hinzu.
Tipp: Zusätzlich zu den Laufzeiteingaben können Sie Variablen für die Kette oder den Arbeitsbereich hinzufügen. Mit Variablen können Sie die Verwendung einer Kette erweitern, z. B. mit jede beliebige Abfrage oder Tabellenkalkulation anstelle nur einer bestimmten Abfrage oder Tabellenkalkulation.
- Klicken Sie Trigger events , verschieben Sie Runtime inputs nach Start, und klicken Sie Edit .
- Geben Sie unter Basic info einen eindeutigen Namen und eine Beschreibung ein, um das Ereignis zu identifizieren.
-
Unter Variablen, fügen Sie Variablen für:
- Die Abfrage-ID
- Beliebige Abfrageparameterwerte
- Die URL der Tabellenkalkulation
Tipp: Klicken Sie für jede Variable auf Add Input, wählen Sie TextField, und geben Sie den Namen, die Beschreibung und den Standardwert ein.
- Klicken Sie auf Speichern.
Schritt 5. Fügen Sie einen Befehl zur Ausführung der Abfrage hinzu
Fügen Sie als Nächstes den Befehl Run query hinzu, damit die Kette bei jeder Ausführung die neuesten Ergebnisse erhält. Sie werden die Laufzeiteingaben verwenden, um die ID und die Parameterwerte der Abfrage zu identifizieren.
- Wählen Sie unter Available Connectors, Workiva, und ziehen Sie Run query auf die Leinwand.
-
Ziehen Sie einen Link von Start auf Abfrage ausführen, und klicken Sie auf den Befehl Bearbeiten.
Hinweis: Stellen Sie sicher, dass Sie den Befehl mit Start verknüpfen, damit er die Laufzeiteingaben verwenden kann.
- Geben Sie unter Basic info einen eindeutigen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
- Wählen Sie unter Befehlseigenschaften den Anschluss Workiva, um den Befehl auszuführen.
- Für Query ID, wählen Sie unter Trigger die Laufzeiteingabe der Query ID.
-
Wenn die Filter der Abfrage Parameterwerte verwenden, klicken Sie auf Hinzufügen ( ) unter Parameters, und geben Sie die Schlüssel/Wertpaare ein:
Schlüssel Wert PY oder Vorheriges_Jahr Wählen Sie unter Trigger die Laufzeiteingabe für das Vorjahr aus. CY oder Aktuelles_Jahr Wählen Sie unter Trigger den Laufzeit-Input für das aktuelle Jahr. Aktueller_Zeitraum Wählen Sie unter Trigger den Laufzeit-Eingang für den aktuellen Zeitraum. - Klicken Sie auf Speichern.
Schritt 6. Hinzufügen eines Befehls zum Exportieren der Ergebnisse
Fügen Sie nun einen Befehl zum Exportieren der Abfrageergebnisse in Tabellenkalkulationen hinzu:
- Wählen Sie unter Available Connectors, Workiva, und ziehen Sie Export query result auf die Leinwand.
- Ziehen Sie einen Link von Abfrage ausführen auf Abfrageergebnis exportieren, und klicken Sie auf Bearbeiten für letzteres.
- Geben Sie unter Basic info einen eindeutigen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
- Wählen Sie unter Befehlseigenschaften denselben Workiva Connector wie Abfrage ausführen.
- Für Query result ID, wählen Sie ID für die Query result Ausgabe unter Run query.
- Unter Spreadsheet URL wählen Sie unter Trigger die Laufzeiteingabe für die URL des Spreadsheets.
- Klicken Sie auf Speichern.
Schritt 7. Führen Sie die Kette aus
Um die Kette laufen zu lassen:
- Klicken Sie auf Veröffentlichen, dann erneut auf Veröffentlichen.
- Klicken Sie auf Ausführen und dann Ausführen mit Eingaben.
- Geben Sie die Werte für die Laufzeiteingaben ein, und klicken Sie auf Start.
- Um zu überprüfen, ob die Kette erfolgreich ist, überprüfen Sie die Tabelle mit den Abfrageergebnissen.
Wenn die Kette fehlschlägt, klicken Sie auf die Befehle im Ausführungsverlauf, um deren Protokolle auf Meldungen zu überprüfen, die bei der Fehlersuche helfen.