|
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 - Podstawy łańcuchów

CLP - Podstawy łańcuchów

  • Ostatnia aktualizacja

Czy oglądałeś webinarium Chains Foundations Webinar? Chcesz podążać we własnym tempie? W tej połączonej ścieżce edukacyjnej utworzymy łańcuch, który pobiera dane ze źródła, przesyła je do tabeli Wdata i odświeża połączenia, wykonując kroki podjęte podczas webinarium Chains Foundations.

Główny biznesowy przypadek użycia Automatyzacja procesów raportowania
Podstawowy cel edukacyjny Poznaj podstawowe koncepcje łańcuchów
Wymagania wstępne

Wykonaj następujące czynności:

Szablon pomocniczy CLP | Podstawy łańcuchów

 

Krok 1: Utwórz łańcuch

Aby zautomatyzować przenoszenie naszych danych źródłowych do raportów końcowych, musimy najpierw utworzyć łańcuch, który zaaranżuje proces od początku do końca. Ponieważ zawsze będziemy używać tego samego arkusza kalkulacyjnego i tabeli, skonfigurujemy zmienne łańcuchowe do przechowywania tych szczegółów w celu zapewnienia spójnego dostępu.

  1. Utwórz nowy łańcuch i nadaj mu nazwę: CLP | Chains Foundations.

  2. W sekcji Chain Variables kliknij dwukrotnie znak plus, aby utworzyć dwie zmienne łańcuchowe i skonfigurować je w sposób opisany poniżej:

    Zmienna 1:

    • Typ: Zmienny łańcuchowy (cv)
    • Nazwa: cv-Spreadsheet ID
    • Wartość:Identyfikator arkusza kalkulacyjnego CLP Company Spend by Department utworzonego w aplikacji Wdata Foundations CLP.
    • Aby znaleźć identyfikator arkusza kalkulacyjnego:
      1. Przejdź do arkusza kalkulacyjnego CLP Company Spend by Department.
      2. W adresie URL wybierz identyfikator arkusza kalkulacyjnego, który znajduje się po "spreadsheet/" i przed "/sheet".
        Na przykład identyfikator arkusza kalkulacyjnego jest tutaj pogrubiony: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13

    Zmienna 2:

    • Typ: Zmienny łańcuchowy (cv)
    • Nazwa: cv-Table ID
    • Wartość: wprowadź identyfikator tabeli wydatków firmy CLP.
    • Aby znaleźć identyfikator tabeli:
      1. Przejdź do tabeli wydatków firmy CLP.
      2. W adresie URL wybierz identyfikator tabeli, który znajduje się po "table/".
        Na przykład identyfikator tabeli jest tutaj pogrubiony: app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
  3. Zapisz Łańcuch.

Krok 2: Pobierz plik

Polecenie HTTP Request Get zostanie użyte do pobrania pliku, który zostanie przesłany do tabeli. Aby zademonstrować pobieranie plików z chmury, udostępniliśmy Łańcuchowi pliki do pobrania online. Aby uczynić ten proces dynamicznym, dodamy bieżący okres do adresu URL, który odpowiada miesiącowi, w którym się znajdujemy i zapewni, że pobieramy aktualny zestaw danych.

  1. Dodaj polecenie Get z łącznika HTTP Request do obszaru startowego.
  2. Kliknij dwukrotnie polecenie, aby je skonfigurować.
    1. Wypełnij pole URL poniższą treścią, używając zmiennej do wygenerowania bieżącego miesiąca, który odpowiada okresowi:
      https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv.
    2. Zastąp <System.DateTime> zmienną Runtime dla daty i godziny systemowej.
    3. W panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Runtime.
    4. Wybierz System.DateTime.
    5. Kliknij zmienną System.DateTime, aby ją przekształcić. Użyj następujących wartości:
      1. Dla wybierz Transformation:, wybierz Parse Date/Time.
      2. Kliknij przycisk +.
      3. Z listy rozwijanej Format: wybierz opcję ISO Extended (Platform Standard).
      4. Dla Output date format:, wybierz %m.
        To wyjście oznacza, że otrzymamy tylko dwucyfrowy miesiąc z daty i godziny systemowej.
        Dowiedz się więcej o typowych przekształceniach daty i czasu tutaj.
      5. W polach Strefa czasowa daty wejściowej i Strefa czasowa daty wyjściowej wybierz bieżącą strefę czasową.
      6. Kliknij ACCEPT.
  3. Zaktualizuj pole Content type do: application/csv.
  4. Zapisz polecenie.

Krok 3: Utwórz plik

Przesyłanie pliku do tabeli Wdata jest procesem dwuetapowym. Plik będzie musiał najpierw zostać utworzony w stanie Staged, zanim będzie można go zaimportować do ostatecznego użytku. Użyjemy polecenia Create File, aby utworzyć plik w tabeli Wdata w statusie Staged, wskazując, że został on utworzony, ale nie został jeszcze zaimportowany jako zestaw danych.

  1. Dodaj polecenie Create File z Workiva Connector do kanwy Chain.
  2. Połącz polecenie Get z poleceniem Create File.
  3. Kliknij dwukrotnie polecenie, aby je skonfigurować.
    1. Kliknij pole Table ID.
      1. W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Chain.
      2. Wybierz cv-Table ID.
    2. Kliknij pole File.
      1. W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć GET.
      2. Wybierz Response.
    3. Wypełnij pole Name poniższymi informacjami, wykonując te same kroki, co poprzednio, aby wypełnić pole Period w polu name:
      ERPSpendData<System.DateTime>.csv
    4. Zastąp <System.DateTime> zmienną Runtime dla daty i godziny systemowej.
      1. W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Runtime.
      2. Wybierz System.DateTime.
      3. Kliknij zmienną System.DateTime, aby ją przekształcić.
        1. Dla Select Transformation, wybierz Parse Date/Time.
        2. Kliknij przycisk + .
        3. Dla Format, wybierz ISO Extended (Platform Standard).
        4. Dla Format daty wyjściowej, wybierz %m-%d-%Y@T%H:%M.
          Oznacza to, że otrzymamy tylko pełną datę i godzinę uruchomienia łańcucha.
          Dowiedz się więcej o typowych przekształceniach daty i czasu tutaj.
        5. W polach Strefa czasowa daty wejściowej i Strefa czasowa daty wyjściowej wybierz bieżącą strefę czasową.
        6. Kliknij ACCEPT.
  4. Kliknij Save, aby zapisać polecenie.

Krok 4: Zaimportuj plik do tabeli

Drugim krokiem w procesie przesyłania plików do tabel Wdata jest zaimportowanie danych, dzięki czemu można je wykorzystać w zapytaniach. Ten krok pobiera plik etapowy i importuje go do wyznaczonej tabeli jako zestaw danych.

  1. Dodaj polecenie Import File into Table z Workiva Connector do kanwy Chain.
  2. Połącz polecenie Create File z poleceniem Import File into Table.
  3. Kliknij dwukrotnie polecenie, aby je skonfigurować.
  4. Kliknij pole Table ID.
    1. W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Chain.
    2. Wybierz cv-Table ID.
  5. Kliknij pole File ID.
    1. W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Create File.
    2. Kliknij strzałkę w dół, aby rozwinąć Wynik.
    3. Wybierz Id.
  6. Zapisz polecenie.

Krok 5: Wyświetl listę połączeń

Użyjemy polecenia List Connections, aby pobrać listę identyfikatorów połączeń powiązanych z identyfikatorem arkusza kalkulacyjnego. Wynikiem polecenia List Connections będzie plik JSON składający się z każdego połączenia w arkuszu kalkulacyjnym wraz ze szczegółami dotyczącymi połączenia, w tym identyfikatorem połączenia.

  1. Dodaj polecenie List Connections z łącznika Workiva Connector do kanwy Chain.
  2. Połącz polecenie Import File to Table z poleceniem List Connections.
  3. Kliknij dwukrotnie polecenie, aby je skonfigurować.
    • Typ miejsca docelowego: Arkusz kalkulacyjny
    • Identyfikator miejsca docelowego: Użyj zmiennej Spreadsheet ID Chain
      1. Kliknij pole ID miejsca docelowego.
      2. W lewym panelu zmiennych rozwiń listę rozwijaną Chain.
      3. Wybierz zmienną Spreadsheet ID.
  4. Zapisz polecenie.

Krok 6: Grupa poleceń

Użyjemy grupy poleceń, aby umożliwić iterację nad każdym połączeniem. Iterator grupowy przepchnie każde połączenie w arkuszu kalkulacyjnym przez następujące kroki, jeden po drugim.

  1. Dodaj grupę poleceń do kanwy Chain.
  2. Połącz polecenie List Connections z sekcją In grupy poleceń.
  3. Kliknij dwukrotnie polecenie, aby je skonfigurować.
    1. Nazwij grupę: Connections Iteration
    2. Przejdź do zakładki Iteratory.
    3. Włącz przełącznik Iteracje i kliknij pole Iteracje.
      1. W panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć List Connections.
      2. Wybierz wyjście Connections.
  4. Zapisz grupę poleceń.

Krok 7: Odśwież połączenie

Użyjemy polecenia Refresh Connection, aby odświeżyć nasze połączenia przy użyciu identyfikatora połączenia z iteracji.

  1. Dodaj polecenie Refresh Connection z Workiva Connector do kanwy Chain.
  2. Połącz sekcję Start z Iteratora grup z poleceniem Refresh Connection.
  3. Kliknij dwukrotnie polecenie, aby je skonfigurować.
    • Dla ID połączenia: użyj ID połączenia z iteratora grupy - Iteracja połączeń. Dzięki temu możemy przekazać identyfikator bieżącej iteracji do polecenia Refresh Connections
      1. Kliknij pole Connection ID.
      2. W lewym panelu rozwiń listę rozwijaną Group Iterator.
      3. Rozwiń listę rozwijaną Connections Iteration.
      4. Wybierz zmienną ConnectionId.
    • Zaznacz pole wyboru Use Previous Source Parameters.

Krok 8: Przetestuj ćwiczenie

Teraz, gdy łańcuch jest gotowy, przetestuj wynik.

  1. Opublikuj the Chain.
  2. Kliknij Execute, a następnie Run Chain.
  3. Po zakończeniu łańcucha przejdź z powrotem do tabeli i zobacz, że dane zostały załadowane, przejdź do arkusza kalkulacyjnego i zobacz, że połączenie zostało pomyślnie odświeżone.

Udany bieg łańcuchowy

Dane dodane do tabeli

Odświeżone połączenia

Czy oglądałeś webinarium Chains Foundations Webinar? Chcesz podążać we własnym tempie? W tej połączonej ścieżce eduka...