Na stronie Chain Builder możesz skorzystać z tych szablonów łańcucha, które razem upraszczają przekazywanie danych środowiskowych, społecznych i związanych z zarządzaniem (ESG) lub danych dotyczących zrównoważonego rozwoju:
- 1a. ESG roll forward | Primary | Zacznij tutaj
- 1b. ESG roll forward | Odśwież połączenia i status
- 1c. ESG roll forward | Odśwież połączenie | Wykonanie
Wskazówka: Podczas gdy tworzysz trzy łańcuchy z tych szablonów, wykonasz tylko pierwszy utworzony łańcuch, który automatycznie uruchomi je wszystkie.
Uwaga: Łańcuchy te rozwijają tylko arkusze kalkulacyjne gromadzenia danych - nie a Program Zrównoważonego Rozwoju. Aby dowiedzieć się, jak przenosić wartości w Programie, zobacz Przenosić wartości i zarządzać latami sprawozdawczymi w Programie Zrównoważonego Rozwoju.
Gdy uruchamiasz łańcuchy utworzone z tych szablonów, współpracują one ze sobą, aby automatycznie archiwizować i importować zestaw danych z poprzedniego roku do tabeli. Po uruchomieniu łańcuchów możesz również wybrać opcję:
- Odśwież połączenia źródłowego arkusza kalkulacyjnego przed zaimportowaniem zestawu danych, na przykład w celu zapewnienia najnowszych wartości
- Wyczyść wartości w źródłowym arkuszu kalkulacyjnym (z wyjątkiem tych powiązanych ze źródłami lub miejscami docelowymi), na przykład w celu przygotowania się do gromadzenia danych w następnym roku
Uwaga: Łańcuchy te automatycznie zastępują dowolny zestaw danych z tego samego okresu w połączonej tabeli Wdata. Jeśli podczas importowania nowego zestawu danych wystąpi błąd, tabela powróci do poprzedniego zestawu danych.
Wymagania wstępne
Łańcuchy utworzone na podstawie tych szablonów wymagają określonych łączników do wykonywania poleceń.
Zanim utworzysz łańcuchy z tych szablonów, skonfiguruj te łączniki w narzędziu Chain Builder:
- Złącze Workiva
- Łańcuchy Workiva złącze
- Transformacja tabelaryczna złącze
- Konektor JSON
- Kierownica złącze
- File Utilities connector
- Złącze HTTP Request
Uwaga: Wszystkie konektory używane w łańcuchach tych szablonów używają domyślnego CloudRunnera. GroundRunnerzy nie są potrzebni.
Uwaga: Aby wykonać swoje polecenia, konektor żądania HTTP wymaga identyfikatora klienta i tajnego grantu OAuth utworzonego dla użytkownika integracji konektora Workiva. Upewnij się, że grant OAuth ma odpowiedni zakres.
Krok 1. Skonfiguruj pliki Workiva
Łańcuchy utworzone na podstawie tych szablonów wymagają określonej konfiguracji plików Workiva dla danych dotyczących zrównoważonego rozwoju. Zanim uruchomisz łańcuchy tych szablonów, skonfiguruj pliki Workiva do zbierania i przenoszenia danych:
- W sekcji Arkusze kalkulacyjne zidentyfikuj arkusz gromadzenia danych używany do raportowania zrównoważonego rozwoju.
- W Wdata, utwórz tabelę, która używa arkusza kalkulacyjnego jako połączonego zbioru danych, a zapisz identyfikator tabeli, aby móc uruchomić łańcuchy.
- W arkuszu kalkulacyjnym dodaj arkusz, aby śledzić stan odświeżania połączenia wychodzącego do tabeli Wdata, i zapisz nazwę arkusza, gdy będziesz uruchamiać łańcuchy.
- Utwórz zapytanie, które zostanie uruchomione, gdy łańcuchy zarchiwizują dane:
- Użyj tabeli Wdata połączonej z arkuszem kalkulacyjnym gromadzenia danych jako źródła danych .
- W zapytaniu dołącz parametr multi-select dla Year, z tym samym typem danych co kolumna Year tabeli.
- Zapisz identyfikator zapytania, aby móc uruchomić łańcuchy.
Krok 2. Określ wartości zmiennych i danych wejściowych środowiska wykonawczego
Aby umożliwić łańcuchom pracę z wieloma obszarami roboczymi, używają one zmiennych do identyfikacji użytkownika integracji i środowisk dla konektora Workiva. W programie Chain Builder, utwórz te zmienne przestrzeni roboczej:
| Zmienna | Wartość |
|---|---|
| wsv-ClientID | Identyfikator klienta grantu OAuth2 utworzonego dla użytkownika integracji Workiva |
| wsv-ClientSecret | Klucz tajny klienta wygenerowany dla grantu OAuth2 utworzonego dla użytkownika integracji |
| wsv-BaseURL-Wdata | Baza hosta URL i ścieżka bazowa dla poleceń Wdata, w oparciu o region środowiska:
|
| wsv-BaseURL-IAM | Baza hosta URL i ścieżka bazowa dla poleceń zarządzania tożsamością i dostępem, w oparciu o region środowiska:
|
| wsv-BaseURL-OC | Baza hosta URL i ścieżka bazowa dla poleceń Chains, w oparciu o region środowiska:
|
Gdy uruchomisz łańcuch utworzony z 1a. ESG roll forward | Primary | Start here szablon, wyświetla monit o dane wejściowe w celu zidentyfikowania plików Workiva do interakcji i sposobu identyfikacji zestawu danych:
| Wejście w czasie wykonywania | Wartość |
|---|---|
| Gromadzenie danych - identyfikator tabeli przekazywania | Identyfikator tabeli Wdata - połączonej z arkuszem kalkulacyjnym gromadzenia danych - do zaimportowania zbioru danych |
| Gromadzenie danych - identyfikator zapytania przesyłanego dalej | Identyfikator zapytania Wdata do uruchomienia w celu zarchiwizowania danych |
| Rok podatkowy | Rok danych, które mają zostać zarchiwizowane |
| Wartość znacznika | Nazwa zarchiwizowanego zbioru danych Uwaga: Łańcuchy używają danych wejściowych Tag value z danymi wejściowymi PY year do utworzenia nazwy pliku zbioru danych, jako |
| Status-SheetName | Nazwa arkusza do śledzenia stanu odświeżania połączenia wychodzącego arkusza kalkulacyjnego z tabelą Wdata |
Krok 3. Utwórz łańcuchy
Aby utworzyć łańcuchy potrzebne do dalszego gromadzenia danych, użyj strony 1a. ESG roll forward | Primary | Start here szablon:
- Na stronie Templates w Chain Builder, otwórz 1a. ESG roll forward | Primary | Start here szablon i kliknij New chain.
- Wprowadź nazwę, aby ułatwić identyfikację łańcucha.
- Wybierz środowisko do użycia łańcucha i kliknij Next.
- Dla zmiennej dcv-clearSuccess wprowadź nazwę
dvc-clearSuccessi kliknij Next. - Dla każdego połączenia wybierz złącze, którego chcesz użyć i kliknij Następny łańcuch.
Uwaga: Dla każdego konektora użyj domyślnego CloudRunnera.
- Skonfiguruj każdą zmienną i kliknij Next.
Zmienna Zmienny typ Nowa zmienna wsv-ClientID Obszar roboczy Wybierz wsv-ClientID. cv-TimeToCheck Łańcuch cv-TimeToCheckwsv-ClientSecret Obszar roboczy Wybierz wsv-ClientSecret. dcv-RefreshStatus Dynamiczny łańcuch dcv-RefreshStatuswsv-BaseURL-IAM Obszar roboczy Wybierz wsv-BaseURL-IAM. wsv-BaseURL-OC Obszar roboczy Wybierz wsv-BaseURL-OC. - Dla każdego połączenia wybierz złącze, którego chcesz użyć i kliknij Następny łańcuch.
Uwaga: Dla każdego konektora użyj domyślnego CloudRunnera.
- Skonfiguruj każdą zmienną i kliknij Next.
Zmienna Zmienny typ Nowa zmienna dcv-srcStatus Dynamiczny łańcuch dcv-srcStatuswsv-ClientID Obszar roboczy Wybierz wsv-ClientID. dcv-destStatus Dynamiczny łańcuch dcv-destStatuswsv-ClientSecret Obszar roboczy Wybierz wsv-ClientSecret. wsv-BaseURL-Wdata Obszar roboczy Wybierz wsv-BaseURL-Wdata. wsv-BaseURL-IAM Obszar roboczy Wybierz wsv-BaseURL-IAM. - Dla każdego połączenia wybierz złącze, którego chcesz użyć, a następnie kliknij Submit.
Uwaga: Dla każdego konektora użyj domyślnego CloudRunnera.
Krok 4. Opublikuj łańcuchy
Uwaga: Aby ułatwić instalację, szablon Refresh connections & status ma zdarzenie Run chain. Przed opublikowaniem łańcuchów utworzonych z szablonów usuń to obce zdarzenie Run chain.
- Na stronie Łańcuchy, dla łańcucha utworzonego z szablonu Odśwież połączenia i status, wybierz Edytuj.
- Wybierz zdarzenie Run chain - Delete, a następnie kliknij Delete i Delete.
- Kliknij Publish i Publish.
- Na stronie Łańcuchy, dla łańcucha utworzonego z szablonu Podstawowy, wybierz Edytuj.
- Kliknij Publish i Publish.
- Na stronie Łańcuchy dla łańcucha utworzonego z szablonu Wykonanie wybierz Edytuj.
- Kliknij Publish i Publish.
Uruchom łańcuchy
Aby zarchiwizować dane i przygotować się do gromadzenia danych w następnym roku:
- W Chain Builder, z Chains, wybierz Execute dla łańcucha utworzonego z 1a.ESG roll forward | Primary | Start here szablon.
- Kliknij Uruchom z danymi wejściowymi i wprowadź dane wejściowe uruchomienia:
Wejście w czasie wykonywania Wartość Gromadzenie danych - identyfikator tabeli przekazywania Wprowadź ID tabeli Wdata, do której chcesz zaimportować zestaw danych. Gromadzenie danych - identyfikator zapytania przesyłanego dalej Wprowadź identyfikator zapytania, które ma zostać uruchomione w celu archiwizacji danych. Rok podatkowy Wprowadź rok danych, które mają zostać zarchiwizowane. Wartość znacznika Wprowadź nazwę zarchiwizowanego zbioru danych. Uwaga: W przypadku danych wejściowych PY year, dane te tworzą nazwę pliku zbioru danych jako
[Tag value]_[PY year].csv. Na przykład PY year z 2021 i Tag value z Archived tworzy plik o nazwieArchived_2021.csv.Odśwież połączenia arkuszy przed archiwizacją danych Wybierz, czy odświeżać połączenia wychodzące arkusza kalkulacyjnego z tabelą Wdata przed uruchomieniem zapytania przenoszącego, np. w celu aktualizacji zestawu danych przed archiwizacją. Status-SheetName Wprowadź nazwę arkusza, który śledzi stan odświeżania połączeń wychodzących z arkusza kalkulacyjnego do tabeli Wdata. RefreshExecution-ChainName Wprowadź nazwę łańcucha utworzonego z szablonu ESG Rollforward | Refresh connection | Execution. Wyczyść kolumnę Wartość arkusza kalkulacyjnego Wybierz, czy wartości wejściowe mają zostać usunięte z arkusza kalkulacyjnego w ramach przeniesienia. Uwaga: Żadne wartości z łączem źródłowym lub docelowym nie zostaną usunięte.
- Aby zapewnić najnowsze wartości przed zaimportowaniem zestawu danych, wybierz Odśwież połączenia przed archiwizacją danych.
Jeśli wybierzesz tę opcję, łańcuchy odświeżają połączenia wychodzące arkusza kalkulacyjnego i śledzą stan ich odświeżenia w arkuszu kontrolnym:- W polu Status-SheetName wprowadź nazwę arkusza w źródłowym arkuszu kalkulacyjnym, w którym łańcuchy mogą zapisywać stan odświeżania połączeń wychodzących.
- W polu RefreshExecution-ChainName wprowadź nazwę łańcucha utworzonego z szablonu ESG Rollforward | Refresh connection | Execution.
Wskazówka: Odświeżanie może potrwać do kilku minut, w zależności od liczby połączeń wychodzących arkusza kalkulacyjnego. Aby dostosować czas oczekiwania, edytuj zdarzenie Pause chain łańcucha utworzonego z 1b. ESG roll forward | Odśwież połączenia i status szablon.
- Aby usunąć wartości wejściowe ze źródłowego arkusza kalkulacyjnego w ramach archiwizacji, np. w celu przygotowania do gromadzenia danych w następnym roku, wybierz Wyczyść kolumnę wartości arkusza kalkulacyjnego.
Uwaga: Łańcuch zachowuje wszystkie wartości powiązane ze źródłem lub miejscem docelowym. Nie możesz odzyskać żadnych wartości usuniętych z arkusza kalkulacyjnego. Zalecamy wybranie tej opcji tylko dla końcowego podsumowania roku, aby przygotować arkusz kalkulacyjny do gromadzenia danych w następnym roku.
Wskazówka: Domyślnie łańcuch usuwa wartości począwszy od wiersza 2 arkusza kalkulacyjnego. Aby to dostosować, edytuj właściwość Region polecenia Clear sheet data.
- Kliknij Start.