CLP - Lenkstangen Transformation

Schritt 1: Erstellen einer Kette

• Eine neue Kette hinzufügen
• Benennen Sie die Kette: CLP | Lenker Konfiguration
• Erstellen Sie eine Kettenvariable
  • Name: cv-AllStations
  • Wert: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
• Rettet die Kette

Schritt 2: Abrufen von JSON-Daten

Wir verwenden den HTTP-Connector, um Daten zu Fahrrädern im JSON-Format von einer Webadresse abzurufen.

• Hinzufügen eines GET Befehls vom HTTP Connector zum Startknoten
• Konfigurieren Sie den Befehl wie folgt:

• Speichern Sie den Befehl

Schritt 3: Iteration durch JSON-Daten

Verwenden Sie den Befehl Lenker - Textvorlage rendern, um die Daten der CitiBike-Stationen zu durchlaufen und ein Format zu erstellen, das die Daten der einzelnen Stationen kombiniert.

• Fügen Sie den Befehl Handlebars - Render Text Template zum Chain Canvas 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:

• • • Dies ermöglicht es dem Befehl, die JSON-Antwort zu durchlaufen, wobei ein Wurzelpfad von data.stations verwendet wird, um Textwerte von jedem Schlüssel bereitzustellen: ("name", "capacity")
      
      • Zusätzlich wird für jede verarbeitete Zeile ein index Wert hinzugefügt
• Speichern Sie den Befehl

Schritt 4: Templatisierung von Laufzeitvariablen

Verwenden Sie die Handlebars - Textvorlage rendern, um Variablen zu schablonieren. Dies ermöglicht dem Benutzer, eine Textvorlage zu rendern, die Kontext zu verschiedenen Komponenten der Kette auf der Grundlage ihrer Laufzeit liefert.

• Fügen Sie den Befehl Handlebars - Render Text Template zum Chain Canvas 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 - Variablen schablonisieren
  • Fügen Sie die folgenden Informationen für den Abschnitt Variablen hinzu und füllen Sie ihn aus:
    • Die Felder "Wert" werden aus dem Dropdown-Menü "Laufzeit" des linken Variablenfensters ausgefüllt
    • Variable 1
      • Name der Variablen: Ketten-Env
      • Wert: <Chain.Enviroment> (Laufzeitvariable)
    • Variable 2
      • Name der Variablen: Chain-Exec-Time
      • Wert: <Chain.ExecutionDateTime> (Laufzeitvariable)
    • Variable 3
      • Name der Variablen: System-Laufzeit-Monat
      • Wert: <System.DateTime> (Laufzeitvariable)
        • Klicken Sie auf die Laufzeitvariable <System.DateTime>, um die Variable umzuwandeln
        • Wählen Sie auf die Transformation, wählen Sie Datum/Uhrzeit parsen
          • Klicken Sie auf das "+"
        • Wählen Sie im ersten Wertefeld "ISO Extended (Platform Standard)".
        • Geben Sie in das Feld für das Ausgabeformat "%m" ein
        • Wählen Sie im Feld Zeitzone des Eingabedatums "UTC (Etc/UTC)"
        • Wählen Sie im Feld Zeitzone des Ausgabedatums "UTC (Etc/UTC)"
        • Klicken Sie auf Akzeptieren
    • Variable 4
      • Name der Variablen: "System-Laufzeit-Jahr"
      • Wert: <System.DateTime> (Laufzeitvariable)
        • Klicken Sie auf die Laufzeitvariable <System.DateTime>, um die Variable umzuwandeln
        • Wählen Sie auf die Transformation, wählen Sie Datum/Uhrzeit parsen
          • Klicken Sie auf das "+"
        • Wählen Sie im ersten Wertefeld "ISO Extended (Platform Standard)
        • Geben Sie in das Feld Format des Ausgabedatums"%Y" ein
        • Wählen Sie im Feld Input date timezone"UTC (Etc/UTC)"
        • Wählen Sie im Feld Zeitzone des Ausgabedatums"UTC (Etc/UTC)"
        • Klicken Sie auf Akzeptieren
  • Füllen Sie das Feld Vorlage mit folgendem Wert aus

• Speichern Sie den Befehl

Schritt 5: Arbeitsbereich-Variablen vordefinieren - Arbeitsbereiche abrufen

Verwenden Sie die Handlebars - Textvorlage rendern, um die Komponenten eines Arbeitsbereichs mit Vorlagen zu versehen. Dies ermöglicht dem Benutzer, eine Textvorlage zu rendern, 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 in den Chain Canvas ein
• Verbinden Sie den Befehl GET - All Stations mit dem Befehl Get Workspaces
• Doppelklicken Sie auf den Befehl, um ihn zu bearbeiten
  • Prüfen Sie, ob 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 Chain Canvas hinzu
• Verbinden Sie den Befehl Get Workspaces mit dem Befehl Handlebars - Render Text Template
• Doppelklicken Sie auf den Befehl, um ihn zu bearbeiten
  • Nennen Sie den Befehl "RTT - WorkspaceID"
    • Geben Sie den folgenden Wert in das Feld "Vorlage" ein:

• • Wählen Sie die Variable <Chain.Workspace> aus dem Abschnitt Laufzeitvariablen im linken Fensterbereich
  • Hinzufügen einer JSON-Variable
    • Füllen Sie die folgenden Informationen aus:
      • Name: Arbeitsbereiche
      • Wert: <Arbeitsbereiche&gt
        • Erweitern Sie die Variable Get Workspaces im Variablenbereich auf der linken Seite und wählen Sie Workspaces
• Speichern Sie den Befehl

Schritt 7: Schablonieren von Arbeitsbereich-Variablen - Umgebungen holen

• 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
  • Fügen 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 - Render Text Template zum Chain Canvas hinzu
• Verbinden Sie den Befehl Get Environments mit dem Befehl Handlebars - Render Text Template
• Doppelklicken Sie auf den Befehl, um ihn zu bearbeiten
  • Benennen Sie es "RTT - EnvironmentID"
  • Geben Sie den folgenden Wert in das Feld "Vorlage" ein:

• • • Die <Chain.Environment> ist eine Laufzeitvariable, die sich im linken Fenster befindet
  • Hinzufügen einer JSON-Variable
    • Füllen Sie die folgenden Informationen aus:
      • Name: Umgebungen
      • Wert: <Umgebungen&gt
        • Sie finden diese auf dem linken Variablenfeld unter dem Befehl Get Environments
• Speichern Sie den Befehl

Schritt 9: Testen Sie die Übung

• Veröffentlichen die Kette
• Klicken Sie auf Execute und wählen Sie dann Run Chain
• Sobald die Kette abgeschlossen ist:
  • Bestätigen Sie, dass alle Knoten erfolgreich ausgeführt wurden
    • Klicken Sie auf den ausgeführten Befehl RTT - Parsing JSON Response
      • Überprüfen Sie, ob die ersten Zeilen der Ausgabe wie folgt aussehen:

• • • Klicken Sie auf den ausgeführten RTT - Templatizing Variables Befehl
      • Überprüfen Sie, ob der gerenderte Text auf der Registerkarte "Protokolle" korrekt ist

• • • • Diese Werte ändern sich je nachdem, in welcher Umgebung die Kette ausgeführt wird und wann sie ausgeführt wird
    • Klicken Sie auf den Knoten RTT - Environment ID und wählen Sie die Registerkarte Outputs
      • Bestätigen Sie, dass ein Wert für die gerenderte Textvariable eingegeben wurde (dieses Ergebnis hängt von der Umgebung des Benutzers ab)

Um mehr über die Datentransformation mit Hilfe von Chains zu erfahren, schauen Sie sich die Connected Learning Paths - Transformation Introductionan!