|
Klasyczne typy plików nie są już dostępne od stycznia 2021 r. Możesz przenieść swoje klasyczne pliki lub pobrać plik PDF. Dowiedz się więcej

Centrum wsparcia Workiva

CLP - Transformacja kierownicy

CLP - Transformacja kierownicy

  • Ostatnia aktualizacja

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.

Podstawowy cel edukacyjny Możliwości poleceń kierownicy
Dodatkowe cele edukacyjne Złącze łańcuchowe Workiva
Wymagania wstępne Skonfiguruj złącze kierownicy .
Skonfiguruj połączenie Workiva Chains Connector.
Szablon pomocniczy CLP | Konfiguracja kierownicy

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.
    image (79).png

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.
    image (80).png

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.
    2023-08-16_12-49-57.gif

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.
    image (48).png

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.
    image (49).png

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.
    image (50).png

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.
      image (51).png

    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:
      image (52).png

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

      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).
      2023-08-10_16-56-22.gif

    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

W tej połączonej ścieżce edukacyjnej stworzymy łańcuch, który ilustruje, jak wykorzystać Handlebars Connector do anal...