CLP – Handlebars-Transformation – Supportcenter

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.
1. Nennen Sie den Befehl: RTT - Parsen der JSON-Antwort.
2. Fügen Sie eine JSON Variable hinzu und nennen Sie sie citibikeData.
3. Für das Feld Value verwenden Sie die Variable Response aus dem Befehl Get - All Stations.
4. 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.stations verwendet, 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:
1. Benennen Sie den Befehl: RTT - Templating Variables.
2. 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)
      1. Klicken Sie auf die Laufzeitvariable <System.DateTime> , um die Variable zu transformieren.
      2. Auf Wählen Sie Transformation, wählen Sie Parse Date/Time, und klicken Sie auf die Schaltfläche "+".
      3. Wählen Sie im ersten Wertefeld "ISO Extended (Platform Standard)".
      4. Geben Sie in das Feld Datumsformat ausgeben "%m" ein.
      5. Im Feld Zeitzone des Eingabedatums, wählen Sie "UTC (Etc/UTC)".
      6. Im Feld Ausgabezeitzone wählen Sie "UTC (Etc/UTC)".
      7. Klicken Sie auf Akzeptieren Sie.
  - Variable 4
    - Name der Variablen: System-RunTime-Year
    - Wert: <System.DateTime> (Laufzeitvariable)
      1. Klicken Sie auf die Laufzeitvariable <System.DateTime>, um die Variable umzuwandeln.
      2. In Wählen Sie Transformation, wählen Sie Datum/Uhrzeit analysieren, und klicken Sie auf "+".
      3. Wählen Sie im ersten Wertefeld "ISO Extended (Platform Standard)".
      4. In das Feld Ausgabe-Datumsformat, geben Sie "%Y" ein.
      5. Im Feld Zeitzone des Eingabedatums, wählen Sie "UTC (Etc/UTC)".
      6. Im Feld Ausgabezeitzone wählen Sie "UTC (Etc/UTC)".
      7. Klicken Sie auf Akzeptieren Sie.
3. 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:
1. Benennen Sie den Befehl: RTT - EnvironmentID.
2. 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.
3. 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.
4. Speichern Sie den Befehl.
Schritt 9: Testen Sie die Übung
1. Veröffentlichen Sie die Kette.
2. Klicken Sie auf Ausführen, und wählen Sie dann Kette ausführen.
3. 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:
4. 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.
5. Klicken Sie auf den Knoten RTT - Environment ID und wählen Sie die Registerkarte Outputs.
6. 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