In diesem Connected Learning Path erstellen wir eine Kette, die veranschaulicht, wie Sie den Handlebars Connector nutzen können, um Daten aus einer HTTP-Antwort zu analysieren und Variablen, die in einer Kette verwendet werden können, in Vorlagen zu verwandeln.
| Primäres Lernziel | Handlebars-Befehlsfähigkeiten |
| Sekundäre Lernziele | Workiva Kettenverbinder |
| Voraussetzungen | Konfigurieren Sie Handlebars Connector Verbindung. Konfigurieren Sie die Workiva Chains Connector Verbindung. |
| Unterstützende Vorlage | CLP | Lenker Konfiguration |
Schritt 1: Erstellen einer Kette
- Fügen Sie eine neue Kette hinzu.
- Benennen Sie die Kette CLP | Handlebars Configuration.
- Erstellen Sie eine Chain-Variable. Geben Sie die folgenden Werte für den Variablennamen und -wert ein:
- Variablenname: cv-AllStations
- Variabler Wert: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
- Speichern Sie die Kette.
Schritt 2: Abrufen von JSON-Daten
Bei diesem Schritt wird der HTTP Connector verwendet, um Citibike-bezogene Daten im JSON-Format von einer Webadresse abzurufen.
- Fügen Sie einen GET Befehl vom HTTP Connector zum Start Knoten hinzu.
-
Konfigurieren Sie den Befehl unter Verwendung der folgenden Werte:
Name GET - Alle Bahnhöfe Name des Benutzers <leer lassen> Kennwort <leer lassen> CA-Zertifikat <leer lassen> Zertifikat <leer lassen> Privater Schlüssel des Zertifikats <leer lassen> Antwort anzeigen Geprüft URL cv-AllStations Kettenvariable Abfrage-Zeichenfolge <leer lassen> Inhaltstyp Anwendung/json Antwort <leer lassen> - Speichern Sie den Befehl.
Schritt 3: Iterieren Sie durch die JSON-Daten
Verwenden Sie den Befehl Handlebars - Render Text Template, um die Daten der CitiBike-Stationen zu iterieren und ein Format zu erstellen, das die Daten der einzelnen Stationen kombiniert.
- Fügen Sie den Befehl Handlebars - Render Text Template zum Leinwandbild Kette hinzu.
- Verbinden Sie den Befehl GET - All Stations mit dem Befehl Handlebars - Render Text Template.
- Doppelklicken Sie auf den Befehl, um ihn zu bearbeiten.
- Nennen Sie den Befehl: RTT - Parsen der JSON-Antwort.
- Fügen Sie eine JSON Variable hinzu und nennen Sie sie citibikeData.
- Für das Feld Value verwenden Sie die Variable Response aus dem Befehl Get - All Stations.
-
Füllen Sie das Feld Vorlage mit dem folgenden Wert aus:
{{#each citibikeData.data.stations}} {{@index}} | {{name}} | {{capacity}} {{/each}}Dies ermöglicht es dem Befehl, die JSON-Antwort zu durchlaufen, indem er einen Wurzelpfad von
data.stationsverwendet, um Textwerte für jeden Schlüssel bereitzustellen: ("name", "capacity"). Außerdem wird für jede verarbeitete Zeile ein index Wert hinzugefügt.
- Speichern Sie den Befehl.
Schritt 4: Templatisierung von Laufzeitvariablen
Verwenden Sie den Befehl Handlebars - Textvorlage rendern, um Variablen als Vorlage zu verwenden. Dadurch kann die Kette eine Textvorlage rendern, die je nach Laufzeit Kontext für verschiedene Komponenten der Kette liefert.
- Fügen Sie den Befehl Handlebars - Render Text Template zum Leinwandbild Kette hinzu.
- Verbinden Sie den Befehl GET - All Stations mit dem Befehl Handlebars - Rendering Text Template.
- Doppelklicken Sie auf den Befehl, um ihn zu bearbeiten, und verwenden Sie dabei die folgenden Werte:
- Benennen Sie den Befehl: RTT - Templating Variables.
- Fügen Sie die folgenden Informationen für den Abschnitt Variablen hinzu und füllen Sie sie aus:
Die Felder Wert werden aus dem Dropdown-Menü Laufzeit des linken Variablenfensters ausgefüllt.- Variable 1
- Name der Variable: Kette-Env
- Wert: <Chain.Enviroment> (Laufzeitvariable)
- Variable 2
- Name der Variablen: Chain-Exec-Time
- Wert: <Chain.ExecutionDateTime> (Laufzeitvariable)
- Variable 3
- Name der Variable: System-Laufzeit-Monat
- Wert: <System.DateTime> (Laufzeitvariable)
- Klicken Sie auf die Laufzeitvariable <System.DateTime> , um die Variable zu transformieren.
- Auf Wählen Sie Transformation, wählen Sie Parse Date/Time, und klicken Sie auf die Schaltfläche "+".
- Wählen Sie im ersten Wertefeld "ISO Extended (Platform Standard)".
- Geben Sie in das Feld Datumsformat ausgeben "%m" ein.
- Im Feld Zeitzone des Eingabedatums, wählen Sie "UTC (Etc/UTC)".
- Im Feld Ausgabezeitzone wählen Sie "UTC (Etc/UTC)".
- Klicken Sie auf Akzeptieren Sie.
- Variable 4
- Name der Variablen: System-RunTime-Year
- Wert: <System.DateTime> (Laufzeitvariable)
- Klicken Sie auf die Laufzeitvariable <System.DateTime>, um die Variable umzuwandeln.
- In Wählen Sie Transformation, wählen Sie Datum/Uhrzeit analysieren, und klicken Sie auf "+".
- Wählen Sie im ersten Wertefeld "ISO Extended (Platform Standard)".
- In das Feld Ausgabe-Datumsformat, geben Sie "%Y" ein.
- Im Feld Zeitzone des Eingabedatums, wählen Sie "UTC (Etc/UTC)".
- Im Feld Ausgabezeitzone wählen Sie "UTC (Etc/UTC)".
- Klicken Sie auf Akzeptieren Sie.
- Variable 1
- Füllen Sie das Vorlagenfeld mit den folgenden Werten aus:
- Umgebung der Kette: {{Chain-Env}}
- Ausführungsdatum der Kette: {{Ketten-Ausführungszeit}}
- Systemlaufzeit Monat-Jahr: {{System-Laufzeit-Monat}}-{{System-Laufzeit-Jahr}}
- Speichern Sie den Befehl.
Schritt 5: Schablonieren von Arbeitsbereich-Variablen - Arbeitsbereiche abrufen
Verwenden Sie Handlebars - Textvorlage rendern, um Komponenten eines Arbeitsbereichs als Vorlage zu verwenden. Dadurch kann die Kette eine Textvorlage darstellen, die Kontext aus verschiedenen Komponenten des Arbeitsbereichs, in dem sich die Kette befindet, liefert.
- Fügen Sie den Get Workspaces Befehl aus dem Workiva Chains Connector zum Chain Canvas hinzu.
- Verbinden Sie den GET - All Stations Befehl mit dem Get Workspaces Befehl.
- Doppelklicken Sie auf den Befehl, um ihn zu bearbeiten, und bestätigen Sie, dass die Verbindung korrekt ist.
- Speichern Sie den Befehl.
Schritt 6: Schablonieren von Arbeitsbereich-Variablen – RTT – WorkspaceID
- Fügen Sie den Befehl Handlebars - Render Text Template zum Leinwandbereich Chain hinzu.
- Verbinden Sie den Befehl Get Workspaces mit dem Befehl Handlebars - Render Text Template.
- Doppelklicken Sie auf den Befehl, um ihn zu bearbeiten.
- Benennen Sie den Befehl RTT - WorkspaceID.
-
Geben Sie den folgenden Wert in das Feld Vorlage ein:
{{#jeder Arbeitsbereich}} {{#if (gleich Name "<(chain.workspace)>") }} {{id}}{{/if}}{{/jeder}}
- Wählen Sie die Variable <Chain.Workspace> aus dem Bereich der Laufzeitvariablen im linken Fensterbereich
- Geben Sie in das Feld JSON-Variablen die folgenden Informationen ein:
- Variablenname: workspaces
- Variablenwert:: <Arbeitsbereiche>
- Erweitern Sie die Variable Get Workspaces im Variablenfenster auf der linken Seite und wählen Sie Workspaces.
- Speichern Sie den Befehl.
Schritt 7: Arbeitsbereich-Variablen vordefinieren - Umgebungen abrufen
- Fügen Sie den Get Environments Befehl aus dem Workiva Chains Connector in den Chain Canvas ein.
- Verbinden Sie den Befehl RTT - WorkspaceID mit dem Befehl Get Environments.
- Doppelklicken Sie auf den Befehl, um ihn zu bearbeiten, und geben Sie die Variable Rendered Text aus dem Befehl RTT-WorkspaceID in das Feld Workspace ID ein.
- Speichern Sie den Befehl.
Schritt 8: Schablonieren von Arbeitsbereich-Variablen – RTT – EnvironmentID
- Fügen Sie den Befehl Handlebars - Textvorlage rendern zum Leinwandbereich Kette hinzu.
- Verbinden Sie den Befehl Get Environments mit dem Befehl Handlebars - Rendering Text Template.
-
Doppelklicken Sie auf diesen Befehl, um ihn zu bearbeiten, und verwenden Sie dabei die folgenden Werte:
- Benennen Sie den Befehl: RTT - EnvironmentID.
-
Geben Sie den folgenden Wert in das Feld Vorlage ein:
{Umgebungen}} {{#if (equal name "<(chain.environment)>") }} {{id}}{{/if}}{{/each}}<Chain.Environment>ist eine Laufzeitvariable und befindet sich auf der linken Seite des Fensters. - Geben Sie in das Feld JSON-Variablen die folgenden Informationen ein:
- Name der Variable: environments
- Variabler Wert: <Environments>
Diesen Wert finden Sie auf dem linken Variablenfeld unter dem Befehl Get Environments.
- Speichern Sie den Befehl.
Schritt 9: Testen Sie die Übung
- Veröffentlichen Sie die Kette.
- Klicken Sie auf Ausführen, und wählen Sie dann Kette ausführen.
- Sobald die Kette ihren Lauf beendet hat:
Bestätigen Sie, dass alle Knoten erfolgreich ausgeführt wurden, indem Sie auf den ausgeführten RTT - Parsing JSON Response Command klicken und überprüfen, dass die ersten Zeilen der Ausgabe wie folgt aussehen: -
Klicken Sie auf den ausgeführten RTT - Templatizing Variables Befehl und überprüfen Sie auf der Registerkarte "Protokolle", ob der gerenderte Text korrekt ist.
Hinweis: Diese Werte ändern sich je nach der Umgebung, in der die Kette ausgeführt wird, und je nachdem, wann sie ausgeführt wird.
- Klicken Sie auf den Knoten RTT - Environment ID und wählen Sie die Registerkarte Outputs.
- Vergewissern Sie sich, dass ein Wert für die gerenderte Textvariable angezeigt wird (auch hier hängt das Ergebnis von Ihrer Umgebung ab).
Mehr lernen
Wenn Sie mehr über die Datenumwandlung mit Chains erfahren möchten, besuchen Sie Connected Learning Paths - Transformation Introduction