Centrum wsparcia Workiva

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.

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