Centrum wsparcia Workiva

W tej połączonej ścieżce edukacyjnej utworzymy łańcuch ilustrujący sposób dynamicznego uwzględniania roku przestępnego.

Krok 1: Utwórz łańcuch

• Z modułu łańcuchów w obszarze roboczym wybierz środowisko DEV
• Dodaj nowy łańcuch
  • Name the Chain, CLP | Variable Transformation | Parsing Date and Time.
  • Dodaj opis: Szablon Connected Learning Path Chain ilustruje, w jaki sposób dane wejściowe Runtime dla miesiąca i roku mogą dynamicznie generować różne formaty klucza okresu i uwzględniać lata przestępne.szablon ten wykorzystuje transformację zmiennych do ponownego formatowania dat, a także obliczania klucza okresu końcowego przy dynamicznym uwzględnianiu lat przestępnych.
• Uratuj łańcuch

Krok 2: Dodaj dane wejściowe środowiska uruchomieniowego

Runtime Inputs ilustruje, w jaki sposób łańcuch może monitować o wartości podczas wykonywania. Jest to cenny sposób, aby łańcuchy mogły być używane w wielu procesach.

• Utwórz polecenie
  • Dodaj Runtime Inputs do węzła Start
    Użyj paska wyszukiwania, aby wyszukać "runtime". Następnie kliknij dwukrotnie, aby automatycznie załadować polecenie do kręgu startowego.
  • Kliknij Add Input i wybierz DropdownField.
  • Skonfiguruj pole DropdownField w następujący sposób:
    

    Nazwa wyświetlana	Miesiąc
    Wymagane	Sprawdzone
    Opis	Wybierz bieżący miesiąc

  • Kliknij Dodaj opcję
  • Skonfiguruj za pomocą poniższej opcji:
    

    Wartość	{"display":"January","value":"01-01"}
    Nazwa wyświetlana	Styczeń
    Domyślne	Nie zaznaczono

• Wypełnij pole rozwijane
  • Dodaj opcje na pozostałe jedenaście miesięcy w roku. Zaktualizuj odpowiednio wartość i wyświetlane nazwy
    • Przykład: {"display":"February","value":"02-01"}
• Dodaj pole NumberField Runtime Input
  • Po wypełnieniu pola rozwijanego dodaj pole wejściowe NumberField
  • Skonfiguruj pole NumberField w następujący sposób:
    

    Nazwa wyświetlana	Rok
    Wymagane	Sprawdzone
    Opis	Wprowadź bieżący rok w formacie RRRR
    Wartość domyślna	<pozostaw puste&gt
    Wartość minimalna (zaznaczona)	2000
    Wartość maksymalna (zaznaczona)	2050

• Zapisz dane wejściowe środowiska uruchomieniowego

Krok 3: Dodaj polecenie, aby utworzyć klucz okresowy

Używamy Handlebars Connector, aby pobrać wartości określone w Runtime Inputs i utworzyć klucz okresu w formacie RRRR-MM-DD.

• Dodaj szablon renderowania tekstu Polecenie z kierownicy Złącze do łańcucha
• Połącz węzeł początkowy (Runtime Inputs) z poleceniem Render Text Template
• Edytuj polecenie
  • Nazwij polecenie: Renderuj szablon tekstu - Utwórz klucz kropki
  • W parametrze Szablon wprowadź następujące dane:
    

    {{Rok}}-{{Okres}}

  • W sekcji Variables (Zmienne) dodaj dwie zmienne, klikając dwukrotnie przycisk Add (Dodaj) w sekcji Variables (Zmienne)
  • W przypadku pierwszej zmiennej określ jej nazwę jako Year
    • Uwaga: W nazwach zmiennych uwzględniana jest wielkość liter
  • Kliknij pole Value
    • W panelu zmiennych rozwiń Trigger ➡ Runtime Inputs i wybierz Year
  • W drugiej zmiennej określ nazwę jako Period
  • Kliknij pole Value
    • W panelu Variable rozwiń Trigger ➡ Runtime Inputs i wybierz Month
    • Kliknij zmienną Month (oznaczoną dymkiem), która została przypisana do wartości
    • Kliknij menu rozwijane Wybierz transformację
      • Wybierz Parsuj tekst jako JSON
      • Kliknij symbol plusa (+)
      • Kliknij ponownie menu rozwijane Wybierz transformację
        • Wybierz Pobierz wartość z JSON
        • Kliknij symbol plusa
      • W polu Pobierz wartość z JSON ,
        • Z listy rozwijanej kolumny Wyjście wybierz "T".
          • Uwaga: T to zmienna miesiąca, która została ustalona w poprzednim kroku
        • W polu kolumny Wartość wpisz "value" i naciśnij klawisz Enter
          • Uwaga: Wartość tekstowa musi być wpisana małymi literami i pojawi się jako szary dymek po naciśnięciu klawisza Enter
      • Kliknij Akceptuj
• Zapisz polecenie

Krok 4: Dodaj polecenie do wykonywania operacji na datach

Używamy Handlebars Connector do wykonywania kilku operacji na datach, w tym matematyki daty i ponownego formatowania.

• Dodaj polecenie Render Text Template ze złącza kierownicy do łańcucha
• Połącz polecenie Render Text Template - Create Period Key z poleceniem Render Text Template
• Edytuj polecenie
  • Nazwij polecenie: Renderuj szablon tekstu - Parsowanie daty
  • W parametrze Template wprowadź następujące dane:

Wybrany okres czasu

Miesiąc: {{Month_Name}}

Rok

Klucz okresu: {{Period_Key}}

Klucz końca okresu miesięcznego: {{EOM_Key}}

• • W sekcji parametrów szablonu
    • Kliknij po roku
    • Następnie rozwiń Trigger ➡ Runtime Inputs i wybierz Year

Krok 5: Sekcja zmiennych

• Dodaj trzy zmienne, klikając przycisk Dodaj w sekcji Zmienne
  • Dla pierwszej zmiennej:
    • Określ pierwszą nazwę zmiennej jako Month_Name
      • Kliknij w polu Wartość
        • W panelu zmiennych rozwiń Trigger ➡ Runtime Inputs i wybierz Month
      • Kliknij dymek zmiennej Month w polu Value
        • Kliknij menu rozwijane Wybierz transformację
          • Wybierz Parsuj tekst jako JSON i kliknij symbol plusa (+)
        • Kliknij ponownie menu rozwijane Wybierz transformację
          • Wybierz Pobierz wartość z JSON i kliknij symbol plusa (+)
            • W wierszu Get Value from JSON wybierz T z listy rozwijanej Output
            • W tym samym wierszu Get Value from JSON wpisz display w polu Value i naciśnij klawisz Enter
            • Kliknij Akceptuj

• Dla drugiej zmiennej:
  • Określ nazwę zmiennej jako Period_Key
    • Kliknij pole Value
      • W panelu Zmienna rozwiń Renderuj szablon tekstu - Utwórz klucz okresu
        • Wybierz Renderowany tekst
    • Kliknij dymek zmiennej Rendered Text w polu Value
      • Kliknij menu rozwijane Select transformation i wybierz Parse Date / Time, a następnie kliknij przycisk plus (+)
      • W pierwszym rozwijanym polu wpisz %Y-%m-%d i koniecznie naciśnij Enter
      • W polu Format daty wyjściowej wpisz %m/%d/%Y
      • W menu rozwijanym Data wejścia wpisz UTC, a następnie wybierz strefę czasową (UTC) Dublin, Edinburgh, Lisbon, London
      • Powtórz wybór UTC dla pola Strefa czasowa daty wyjściowej
      • Kliknij Akceptuj

• Dla trzeciej zmiennej:
  • Określ nazwę zmiennej jako EOM_Key
    • Kliknij w polu Wartość. W panelu zmiennych rozwiń Render Text Template - Create Period Key i wybierz Rendered Text
    • Kliknij zmienną Rendered Text, która została przypisana do wartości
      • Kliknij menu rozwijane Wybierz transformację i wybierz Dodaj / odejmij datę i godzinę, a następnie kliknij symbol plusa (+)
        • W rozwijanym polu Format wpisz %Y-%m-%d i koniecznie naciśnij Enter
        • Z listy rozwijanej Operacja wybierz Dodaj
        • W polu Kwota wpisz 1
        • Z listy rozwijanej Jednostka wybierz Miesiąc
      • Dodaj dodatkowe Dodaj / odejmij datę i transformację czasu
        • W rozwijanym polu Format wpisz %Y-%m-%d i koniecznie naciśnij Enter
        • Z listy rozwijanej Operacja wybierz Odejmowanie
        • W polu Kwota wpisz 1
        • Z listy rozwijanej Jednostka wybierz Dzień
      • Wyjściowe pole strefy czasowej daty
      • Kliknij Akceptuj
• Zapisz polecenie

Krok 6: Przetestuj łańcuch

Teraz, gdy łańcuch jest gotowy, możemy przetestować wynik.

• Opublikuj Łańcuch
• Kliknij Execute, a następnie wybierz Run With Inputs
• Z listy rozwijanej Month wybierz February. W polu Rok wpisz 2024
• Kliknij Start. Przejrzyj wyniki łańcucha na stronie Log w zakładce Render Text Template - Create Period Key Command
  • Zweryfikuj klucz końca miesiąca , tj. rok przestępny

• Wykonaj łańcuch ponownie w lutym, ale wprowadź 2025 jako rok dla tego wykonania
  • Upewnij się, że miesiąc zakończył się we właściwym dniu, tj. nie był to rok przestępny

Aby dowiedzieć się więcej na temat transformacji danych przy użyciu łańcuchów, zapoznaj się ze ścieżką szkoleniową Connected Learning Paths - Transformation Introduction!