Centrum wsparcia Workiva

W tej połączonej ścieżce edukacyjnej stworzymy łańcuch, który ilustruje, jak wykorzystać Handlebars Connector do analizowania danych z odpowiedzi HTTP i szablonowania zmiennych, które mogą być używane w całym łańcuchu.

Krok 1: Utwórz łańcuch

1. Dodaj nowy łańcuch .
2. Nazwij Łańcuch CLP | Konfiguracja Kierownicy.
3. Utwórz zmienną łańcuchową. Wprowadź następujące wartości dla nazwy i wartości zmiennej:
   • Nazwa zmiennej: cv-AllStations
   • Wartość zmiennej: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
4. Uratuj łańcuch.
   

Krok 2: Pobieranie danych JSON

Ten krok wykorzystuje konektor HTTP do pobierania danych związanych z Citibike w formacie JSON z lokalizacji internetowej.

1. Dodaj polecenie GET z konektora HTTP do węzła Start.

2. Skonfiguruj polecenie przy użyciu następujących wartości:

   Nazwa	GET - Wszystkie stacje
   Nazwa użytkownika	<pozostaw puste&gt
   Hasło	<pozostaw puste&gt
   Certyfikat CA	<pozostaw puste&gt
   Certyfikat	<pozostaw puste&gt
   Klucz prywatny certyfikatu	<pozostaw puste&gt
   Pokaż odpowiedź	Sprawdzone
   Adres URL	cv-AllStations Zmienna łańcuchowa
   Ciąg zapytania	<pozostaw puste&gt
   Typ zawartości	application/json
   Odpowiedź	<pozostaw puste&gt

3. Zapisz polecenie.
   

Krok 3: Iteruj przez dane JSON

Użyj polecenia Handlebars - Render Text template, aby iterować dane stacji CitiBike w celu uzyskania formatu zawierającego połączone dane poszczególnych stacji.

1. Dodaj polecenie Handlebars - Render Text Template do kanwy Chain.
2. Połącz polecenie GET - All Stations z poleceniem Handlebars - Render Text Template.
3. Kliknij dwukrotnie polecenie, aby je edytować.
   1. Nazwij polecenie: RTT - Parsing JSON Response.
   2. Dodaj zmienną JSON i nazwij ją citibikeData.
   3. Dla pola Value użyj zmiennej Response z polecenia Get - All Stations.

   4. Wypełnij pole szablonu następującą wartością:

      {{#each citibikeData.data.stations}}  {{@index}} | {{name}} | {{capacity}} {{/each}}

      Umożliwi to poleceniu iterację przez odpowiedź JSON, przy użyciu ścieżki głównej data.stations w celu dostarczenia wartości tekstowych z każdego klucza: ("name", "capacity"). Ponadto dla każdego przetwarzanego wiersza dodawana jest wartość indeksu .

4. Zapisz polecenie.
   

Krok 4: Szablonowanie zmiennych środowiska uruchomieniowego

Użyj polecenia Handlebars - Render Text Template do szablonowania zmiennych. Umożliwi to łańcuchowi renderowanie szablonu tekstowego, który zapewnia kontekst dla różnych komponentów łańcucha w oparciu o jego czas działania.

1. Dodaj polecenie Handlebars - Render Text Template do kanwy Chain.
2. Połącz polecenie GET - All Stations z poleceniem Handlebars - Render Text Template.
3. Kliknij dwukrotnie polecenie, aby je edytować, używając następujących wartości:
   1. Nazwij polecenie: RTT - Templatizing Variables.
   2. Dodaj i wypełnij następujące informacje dla sekcji variables:
      Pola Value zostaną wypełnione z listy rozwijanej Runtime w lewym panelu variables.
      • Zmienna 1
        • Nazwa zmiennej: Chain-Env
        • Wartość: <Chain.Enviroment> (Runtime Variable)
      • Zmienna 2
        • Nazwa zmiennej: Chain-Exec-Time
        • Wartość: <Chain.ExecutionDateTime> (Runtime Variable)
      • Zmienna 3
        • Nazwa zmiennej: System-RunTime-Month
        • Wartość: <System.DateTime> (Runtime Variable)
          1. Kliknij zmienną runtime <System.DateTime>, aby ją przekształcić.
          2. Na stronie wybierz Transformation, wybierz Parse Date/Time i kliknij "+".
          3. W pierwszym polu wartości wybierz "ISO Extended (Platform Standard)".
          4. W polu Output date format wpisz "%m".
          5. W polu Wprowadź strefę czasową daty, wybierz "UTC (Etc/UTC)".
          6. W polu Output date timezone, wybierz "UTC (Etc/UTC)".
          7. Kliknij Akceptuj.
      • Zmienna 4
        • Nazwa zmiennej: System-RunTime-Year
        • Wartość: <System.DateTime> (Runtime Variable)
          1. Kliknij zmienną runtime <System.DateTime>, aby przekształcić zmienną
          2. W Wybierz transformację, wybierz Parsuj datę/godzinę i kliknij "+".
          3. W pierwszym polu wartości wybierz "ISO Extended (Platform Standard)".
          4. W polu Output date format wpisz "%Y".
          5. W polu Wprowadź strefę czasową daty, wybierz "UTC (Etc/UTC)".
          6. W polu Output date timezone, wybierz "UTC (Etc/UTC)".
          7. Kliknij Akceptuj.
   3. Wypełnij pole szablonu następującymi wartościami:
      • Środowisko łańcucha: {{Chain-Env}}
      • Data wykonania łańcucha: {{Chain-Exec-Time}}
      • Czas działania systemu miesiąc-rok: {{System-RunTime-Month}}-{{System-RunTime-Year}}
4. Zapisz polecenie.
   

Krok 5: Szablonowanie zmiennych obszaru roboczego - Pobierz obszary robocze

Użyj Handlebars - Render Text Template do szablonowania komponentów obszaru roboczego. Umożliwi to łańcuchowi renderowanie szablonu tekstowego, który zapewnia kontekst z różnych komponentów obszaru roboczego, w którym znajduje się łańcuch.

1. Dodaj polecenie Get Workspaces z konektora Workiva Chains do kanwy Chain.
2. Połącz polecenie GET - All Stations z poleceniem Get Workspaces.
3. Kliknij dwukrotnie polecenie, aby je edytować, i potwierdź, że połączenie jest prawidłowe.
4. Zapisz polecenie.
   

Krok 6: Szablonowanie zmiennych obszaru roboczego - RTT - WorkspaceID

1. Dodaj polecenie Handlebars - Render Text Template do kanwy Chain.
2. Połącz polecenie Get Workspaces z poleceniem Handlebars - Render Text Template.
3. Kliknij dwukrotnie polecenie, aby je edytować.
   • Nazwij polecenie RTT - WorkspaceID.

   • Wprowadź następującą wartość w polu Template:

     {{#each workspaces}} {{#if (equal name "<(chain.workspace)>") }} {{id}}{{/if}}{{/each}}

4. Wybierz zmienną <Chain.Workspace> z sekcji zmiennych uruchomieniowych w lewym panelu
5. W polu JSON Variables wprowadź następujące informacje:
   • Nazwa zmiennej: obszary robocze
   • Wartość zmiennej:: <Obszary robocze&gt
6. Rozwiń zmienną Get Workspaces z panelu zmiennych po lewej stronie i wybierz Workspaces.
7. Zapisz polecenie.
   

Krok 7: Szablonowanie zmiennych obszaru roboczego - Pobierz środowiska

1. Dodaj polecenie Get Environments z Workiva Chains Connector do kanwy Chain.
2. Połącz polecenie RTT - WorkspaceID z poleceniem Get Environments.
3. Kliknij dwukrotnie polecenie, aby je edytować i wprowadź zmienną Rendered Text z polecenia RTT-WorkspaceID w polu Workspace ID.
4. Zapisz polecenie.
   

Krok 8: Szablonowanie zmiennych obszaru roboczego - RTT - EnvironmentID

1. Dodaj polecenie Handlebars - Render Text Template do kanwy Chain.
2. Połącz polecenie Get Environments z poleceniem Handlebars - Render Text Template.

3. Kliknij dwukrotnie to polecenie, aby je edytować, używając następujących wartości:

   1. Nazwij polecenie: RTT - EnvironmentID.

   2. Wprowadź następującą wartość w polu Template:

      {{#each environments}} {{#if (equal name "<(chain.environment)>") }} {{id}}{{/if}}{{/each}}

      Zmienna <Chain.Environment> jest zmienną Runtime i można ją znaleźć w lewym panelu.

   3. W polu JSON variables wprowadź następujące informacje:
      • Nazwa zmiennej: environments
      • Wartość zmiennej: <Environments>
        Wartość ta znajduje się w lewym panelu zmiennych pod poleceniem Get Environments.
   4. Zapisz polecenie.
      

   Krok 9: Przetestuj ćwiczenie

   1. Opublikuj the Chain.
   2. Kliknij Execute, a następnie wybierz Run Chain.
   3. Po zakończeniu działania łańcucha:
      Potwierdź, że wszystkie węzły zostały pomyślnie wykonane, klikając wykonane polecenie RTT - Parsing JSON Response Command i sprawdzając, czy kilka pierwszych wierszy danych wyjściowych wygląda następująco:
      

   4. Kliknij wykonane polecenie RTT - Templatizing Variables i sprawdź, czy renderowany tekst jest poprawny w zakładce "Logs".
      

      Uwaga: Wartości te będą się zmieniać w zależności od środowiska, w którym łańcuch jest uruchamiany, oraz od czasu jego uruchomienia.

   5. Kliknij węzeł RTT - Environment ID i wybierz zakładkę Outputs.
   6. Potwierdź, że dla zmiennej renderowanego tekstu pojawiła się wartość (ponownie, wynik będzie się różnił w zależności od środowiska).
      

   Dowiedz się więcej

   Aby dowiedzieć się więcej na temat transformacji danych przy użyciu łańcuchów, sprawdź Connected Learning Paths - Transformation Introduction