Centrum wsparcia Workiva

Krok 1: Utwórz arkusz kontrolny

Będziemy tworzyć arkusz kontrolny do przechowywania zmiennych używanych do przesyłania danych do tabeli Wdata, a następnie odświeżania połączeń dla tych danych. Zamiast określać te zmienne jako Runtime Inputs za każdym razem, gdy Łańcuch jest uruchamiany, dodamy nasze zmienne do arkusza kontrolnego, który Łańcuch będzie odczytywał i używał przez cały czas jego działania. 

Podczas gdy ten arkusz kontrolny demonstruje przesyłanie wielu plików do pojedynczej tabeli Wdata i odświeżanie połączeń w pojedynczym arkuszu kalkulacyjnym, proces ten można rozszerzyć na wiele tabel i arkuszy kalkulacyjnych, po prostu dodając unikalny identyfikator tabeli lub arkusza kalkulacyjnego do arkusza kontrolnego.

• Przejdź do platformy Workiva, aby utworzyć nowy arkusz kalkulacyjny
• Kliknij Utwórz i wybierz Arkusz kalkulacyjny
• Nazwij arkusz kalkulacyjny: Arkusz kontrolny CLP
  • Nazwij pierwszy arkusz: Główny arkusz kontrolny
• W głównym arkuszu kontrolnym utwórz następujące nagłówki
  • ActiveFlag
    • Ta kolumna określa, czy przepływ pracy musi zostać uruchomiony dla tego wiersza w arkuszu kontrolnym
  • FileName
    • Kolumna ta wskazuje nazwę zbioru danych, która pojawi się w tabeli Wdata
  • TableID
    • Identyfikator tabeli w Wdata, do której zostaną przesłane dane
  • SpreadsheetID
    • Identyfikator arkusza kalkulacyjnego, w którym dane będą odświeżane
  • FileLocation
    • Lokalizacja pliku, który zostanie pobrany
• Wypełnij arkusz następującymi wartościami, wypełniając kolumnę <TableID> identyfikatorem tabeli szczegółów pracowników CLP oraz kolumnę <SpreadsheetID> identyfikatorem arkusza kalkulacyjnego przeglądu pracowników CLP, identyfikatory te zostały utworzone w poprzednich połączonych ścieżkach edukacyjnych, zapoznaj się z wymaganiami wstępnymi, aby zobaczyć wymagane połączone ścieżki edukacyjne.
  • Zapoznaj się z tym dokumentem, aby uzyskać pomoc w znalezieniu identyfikatorów

ActiveFlag,FileName,TableID,FileLocation
TRUE,EmployeeDetailsP01,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
TRUE,EmployeeDetailsP02,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
TRUE,EmployeeDetailsP03,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv

Krok 2: Zaktualizuj uprawnienia do arkusza kalkulacyjnego

Aby zapewnić skuteczną komunikację między Poleceniem Workiva a Arkuszem kalkulacyjnym, wygenerowany Grant API musi być powiązany z użytkownikiem posiadającym uprawnienia właściciela lub edytora w Arkuszu kalkulacyjnym.

• W arkuszu kalkulacyjnym CLP Control Sheet kliknij File na wstążce u góry
• Kliknij Uprawnienia, a następnie Arkusz kalkulacyjny
  • Zapewnij dostęp dowolnemu użytkownikowi Workiva powiązanemu ze skonfigurowanym API Grant w ramach Workiva Connection

Krok 3: Utwórz łańcuch

Aby użyć zmiennych, które utworzyliśmy w arkuszu kontrolnym, utworzymy łańcuch, który je odczyta. Ponieważ zawsze będziemy używać tego samego arkusza kalkulacyjnego i arkusza, skonfigurujemy zmienne łańcuchowe do przechowywania tych szczegółów w celu zapewnienia spójnego dostępu.

• Przejdź do narzędzia Chain Builder
• Utwórz nowy łańcuch
  • Nazwij łańcuch: CLP | Czytanie z arkusza kontrolnego
• W sekcji Zmienne łańcuchowe kliknij dwukrotnie znak Plus, aby utworzyć dwie zmienne łańcuchowe i skonfigurować je jak poniżej:
  • Zmienna 1:
    • Typ: Zmienny łańcuchowy (cv)
    • Nazwa: cv-Control Spreadsheet ID
    • Wartość: wprowadź identyfikator arkusza kalkulacyjnego kontroli CLP
      • Aby znaleźć identyfikator arkusza kalkulacyjnego, przejdź do arkusza kalkulacyjnego CLP Control Sheet
        • 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-Nazwa arkusza kontrolnego
    • Wartość: Główny arkusz kontrolny
• Uratuj łańcuch

Krok 4: Pobierz dane arkusza

Do uruchomienia łańcucha używamy polecenia Get Sheet Data. Pozwala nam to na pobieranie informacji z arkusza kontrolnego w celu przekazania ich do łańcucha.

• Dodaj polecenie Get Sheet Data z łącznika Workiva Connector do obszaru początkowego łańcucha
• Kliknij dwukrotnie polecenie, aby je skonfigurować
  
  • Kliknij pole ID arkusza kalkulacyjnego
    • W panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć łańcuch
    • Wybierz identyfikator arkusza kalkulacyjnego cv-Control Zmienna łańcuchowa
  • Kliknij pole ID/Nazwa arkusza
    • W panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć łańcuch
    • Wybierz cv-Control Sheet Name Chain Variable
  • Region: możesz określić region. Jeśli pozostawisz ":", polecenie pobierze dane z całego arkusza kalkulacyjnego
• Zapisz polecenie

Krok 5: Przetestuj ćwiczenie

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

• Opublikuj Łańcuch
• Kliknij Execute, a następnie wybierz Run Chain
• Po zakończeniu tworzenia łańcucha kliknij węzeł Get Sheet Data, aby zweryfikować powodzenie
  • Polecenie powinno dostarczyć dane wyjściowe .csv w określonym arkuszu w arkuszu kalkulacyjnym, możesz zobaczyć .csv, klikając ikonę gałki ocznej

Dowiedz się więcej o korzystaniu z arkuszy kontrolnych, wykonując następną ścieżkę: Używanie wartości z arkusza kontrolnego!