Pobierz dane dotyczące śladu węglowego z Watershed® na potrzeby raportowania zrównoważonego rozwoju

Platforma klimatyczna dla przedsiębiorstw Watershed umożliwia pomiar, raportowanie i redukcję śladu węglowego Twojej organizacji.

Dzięki platformie Workiva możesz tworzyć łańcuchy, aby automatycznie pobierać dane dotyczące śladu węglowego z Watershed - na przykład w celu ujawnienia ich w raportach dotyczących środowiska, spraw społecznych i zarządzania (ESG) lub zrównoważonego rozwoju - do tabeli, w oparciu o okres określony w niestandardowym arkuszu kalkulacyjnym Watershed. Następnie możesz użyć tabeli jako źródła dla zapytania lub połączenia arkusza kalkulacyjnego, na przykład w celu uwzględnienia danych w raportach.

Uwaga: Podczas tworzenia wielu łańcuchów w tych instrukcjach, uruchomisz tylko jeden łańcuch - który następnie automatycznie uruchomi pozostałe - aby pobrać dane z Watershed i zaktualizować arkusz kalkulacyjny.

Uwaga: Arkusz kalkulacyjny Watershed używany przez te łańcuchy jest dostarczany przez Workiva. Jeśli go nie masz, ale jesteś zainteresowany, skontaktuj się ze swoim Customer Success Managerem, aby uzyskać szczegółowe informacje.

Wymagania wstępne

Aby zbudować te łańcuchy, będziesz potrzebować tych łączników:

Wskazówka: Wszystkie polecenia łańcuchów używają domyślnego CloudRunnera. GroundRunnerzy nie są potrzebni.

Aby pomyślnie uruchomić łańcuchy, również zidentyfikuj:

Klucz dla dostawcy aktywności używany do uwierzytelniania i wykonywania działań za pomocą interfejsu API Watershed
Identyfikatory arkusza kalkulacyjnego Watershed , jego sekcji Control sheet i połączonej z nim tabeli

Zbuduj łańcuch do rejestrowania pobranych danych

Na początek utwórz łańcuch, aby zaktualizować arkusz kontrolny , aby śledzić, kiedy dane dotyczące śladu węglowego są przesyłane do Workiva.

Krok 1. Utwórz łańcuch

Na stronie Łańcuchy kliknij Utwórz, a następnie wybierz Utwórz łańcuch.
W polu Setup wprowadź nazwę 3. Watershed i opis pomagający zidentyfikować, że łańcuch rejestruje przesyłane dane Watershed.
Kliknij Zapisz.

Krok 2. Rozpocznij od zdarzenia Runtime Inputs

Z Chain events, przenieś Runtime inputs do Start.
Wybierz zdarzenie Runtime inputs i kliknij Edit.
W sekcji Podstawowe informacje wprowadź nazwę i opis, aby ułatwić identyfikację zdarzenia.
Na stronie Variables dodaj wejścia TextField z tymi nazwami wyświetlania:
- Zakres
- SpreadsheetID
- SheetID
Wskazówka: Pozostaw wartości domyślne tych zmiennych puste; zostaną one wygenerowane po uruchomieniu 1. Łańcuch Watershed został utworzony później.
Wybierz Required dla wszystkich trzech zmiennych i kliknij Save.

Krok 3. Dodaj polecenie File Utilities Create File

Aby utworzyć plik dziennika dla sekcji Control Sheet, dodaj polecenie File Utilities Create file:

Z Dostępne złącza, wybierz Narzędzia plików i przenieś Utwórz plik do obszaru roboczego.
Przeciągnij łącze z Wejścia środowiska uruchomieniowego do Utwórz plik.
Wybierz polecenie Create file i kliknij Edit.
W polu Basic info wprowadź nazwę i opis, aby ułatwić identyfikację polecenia.

Wprowadź właściwości polecenia i kliknij Zapisz:

Właściwość	Wartość
Łącznik	Wybierz złącze File Utilities, którego chcesz użyć.
Tekst	Wprowadź dane `Footprint ostatnio odświeżone na stronie` i wybierz zmienną runtime System.DateTime.

Krok 4. Dodaj polecenie Workiva Write Sheet Data

Aby zaktualizować sekcję Control Sheet z plikiem dziennika, dodaj polecenie Workiva Write sheet data:

Ze strony Dostępne złącza wybierz Workiva i przenieś Zapisz dane arkusza do obszaru roboczego.
Przeciągnij łącze z Utwórz plik do Zapisz dane arkusza.
Wybierz polecenie Write sheet data i kliknij Edit.
W polu Basic info wprowadź nazwę i opis, aby ułatwić identyfikację polecenia.

Wprowadź właściwości polecenia i kliknij Zapisz:

Właściwość	Wartość
Łącznik	Wybierz złącze Workiva, którego chcesz użyć.
Identyfikator arkusza kalkulacyjnego	Wybierz dane wejściowe runtime SpreadsheetID z Trigger.
ID/nazwa arkusza	Wybierz wejście runtime SheetID z Trigger.
Plik danych	Wybierz plik Utworzony plik będący wynikiem polecenia Utwórz plik.
Ogranicznik	Wprowadź przecinek (`,`).
Region	Wybierz wejście runtime Range z Trigger.

Kliknij Opublikuj, wprowadź informację o publikacji i kliknij Opublikuj.

Twórz łańcuchy z szablonu Load Data to Wdata

Następnie użyj szablonu Load Data to Wdata , aby utworzyć łańcuchy aktualizujące połączoną tabelę Watershed arkusza kalkulacyjnego z danymi pobranymi z Watershed. Szablon Load Data to Wdata tworzy łańcuchy, które współpracują ze sobą w celu ustalenia, czy zestaw danych już istnieje w tabeli i zaktualizowania tabeli najnowszym zestawem danych.

Aby utworzyć łańcuchy z szablonów , otwórz szablon Load Data to Wdata | Primary chain i kliknij New chain.

Zbuduj łańcuch, aby pobrać dane z Watershed

Na koniec zbuduj łańcuch, aby pobrać i zaimportować dane śladu węglowego z Watershed.

Uwaga: Utwórz pozostałe dwa łańcuchy przed tym, dla jego Uruchom łańcuch zdarzeń.

Krok 1. Utwórz łańcuch

Na stronie Łańcuchy kliknij Utwórz, a następnie wybierz Utwórz łańcuch.
W Setup wprowadź nazwę 1. Watershed oraz opis pomagający w dalszej identyfikacji łańcucha.

W sekcji Variables dodaj zmienne dla klucza API Watershed oraz identyfikatory arkusza kalkulacyjnego Watershed i jego arkusza kontrolnego.

Nazwa	Wartość
APIKey	Wprowadź klucz API Watershed.
SpreadsheetID	Wprowadź identyfikator arkusza kalkulacyjnego Watershed.
SheetID	Wprowadź identyfikator arkusza kontrolnego sekcji arkusza kalkulacyjnego Watershed.

Kliknij Zapisz.

Krok 2. Rozpocznij od polecenia Workiva Get Sheet Data

Rozpocznij od polecenia Workiva Get sheet data, aby zidentyfikować dane do pobrania na podstawie okresu w arkuszu kalkulacyjnym Watershed Control sheet:

Z Dostępne złącza wybierz Workiva i przenieś Pobierz dane arkusza do Uruchom.
Wybierz polecenie Get sheet data i kliknij Edit.
W polu Basic info wprowadź nazwę i opis, aby ułatwić identyfikację polecenia.

Wprowadź właściwości polecenia i kliknij Zapisz:

Właściwość	Wartość
Łącznik	Wybierz złącze Workiva, którego chcesz użyć.
Identyfikator arkusza kalkulacyjnego	Wybierz zmienną łańcuchową Spreadsheet ID.
ID/nazwa arkusza	Wybierz zmienną łańcuchową Sheet ID.
Region	Wprowadź `A11:`.
Styl wartości	Wybierz opcję Obliczone.
Wersja	Aby sprawdzić najnowszą wersję, wpisz `-1`.

Krok 3. Dodaj polecenia, aby przygotować okres czasu dla Watershed

Aby zidentyfikować okres czasu dla Watershed, dodaj polecenia Advanced query i CSV do JSON:

Ze strony Dostępne konektory wybierz Przekształcenie tabelaryczne i przenieś Zaawansowane zapytanie do obszaru roboczego.
Przeciągnij łącze z Pobierz dane arkusza do Zaawansowane zapytanie.
Wybierz polecenie Advanced query i kliknij Edit.
W polu Basic info wprowadź nazwę i opis, aby ułatwić identyfikację polecenia.

Wprowadź właściwości polecenia i kliknij Zapisz:

Właściwość	Wartość
Łącznik	Wybierz łącznik transformacji tabelarycznej do użycia.
Tabele	Dodaj tabelę dla danych przedziału czasowego: W oknie File wybierz dane wyjściowe Data polecenia Get sheet data. W polu Nazwa tabeli wpisz `a`.
Zapytanie	Wprowadź zapytanie do uruchomienia: select case when `Start Month` = 'January' then '01' when `Start Month` = 'February' then '02' when `Start Month` = 'March' then '03' when `Start Month` = 'April' then '04' when `Start Month` = 'May' then '05' when `Start Month` = 'June' then '06' when `Start Month` = 'July' then '07' when `Start Month` = 'August' then '08' when `Start Month` = 'September' then '09' when `Start Month` = 'October' then '10' when `Start Month` = 'November' then '11' else '12' end as 'sm', case when `End Month` = 'January' then '01' when `End Month` = 'February' then '02' when `End Month` = 'March' then '03' when `End Month` = 'April' then '04' when `End Month` = 'May' then '05' when `End Month` = 'June' then "06", gdy "Koniec miesiąca" = "lipiec", a następnie "07", gdy "Koniec miesiąca" = "sierpień", a następnie "08", gdy "Koniec miesiąca" = "wrzesień", a następnie "09", gdy "Koniec miesiąca" = "październik", a następnie "10", gdy "Koniec miesiąca" = "listopad", a następnie "11", a następnie "12" zakończ jako "em", `Reporting Year` as 'ry', TableId as 'tid' from a
Ogranicznik wejścia	Wybierz Przecinek.
Ogranicznik wyjścia	Wybierz Przecinek.
Podgląd wyników	Zaznacz to pole wyboru.

Z Dostępne konektory wybierz JSON i przenieś CSV do JSON do kanwy.
Przeciągnij link z Zaawansowane zapytanie do CSV do JSON.
Wybierz polecenie CSV to JSON i kliknij Edytuj.
W polu Basic info wprowadź nazwę i opis, aby ułatwić identyfikację polecenia.
Wprowadź właściwości polecenia i kliknij Zapisz:

Właściwość Wartość

Łącznik Wybierz łącznik JSON, którego chcesz użyć.

Plik wejściowy Wybierz wynik Result polecenia Advanced query.

Ogranicznik Wybierz Przecinek (,).

Krok 4. Dodaj polecenie HTTP Request GET

Aby pobrać dane dotyczące śladu węglowego dla wybranego okresu, dodaj polecenie HTTP Request GET:

Z Dostępne złącza wybierz Żądanie HTTP i przenieś GET do obszaru roboczego.
Przeciągnij link z CSV do JSON do GET.
Wybierz polecenie GET i kliknij Edytuj.
W polu Basic info wprowadź nazwę i opis, aby ułatwić identyfikację polecenia.

Wprowadź właściwości polecenia i kliknij Zapisz:

Właściwość	Wartość
Łącznik	Wybierz łącznik żądań HTTP, który ma zostać użyty.
Pokaż odpowiedź	Zaznacz to pole wyboru.
Adres URL	Wpisz `https://api.watershedclimate.com/v1/report/footprint_detail`.
Ciąg zapytania	Wprowadź ciąg zapytania, aby wskazać początkowy i końcowy miesiąc danych do pobrania: Dla miesiąca początkowego wpisz `startMonth=` i wybierz plik JSON wyjściowy z polecenia CSV to JSON dwukrotnie. Następnie, dla miesiąca końcowego, wpisz `&endMonth=` i wybierz plik JSON wyjściowy z polecenia CSV to JSON jeszcze dwa razy. Dla obu miesięcy kliknij pierwszy plik JSON wyjściowy i zastosuj transformację Get variable from JSON : Na stronie Output wybierz opcję Text. W polu Wartość wpisz `0` i `ry`. Dla obu miesięcy kliknij drugi plik JSON wyjściowy i zastosuj kolejną Pobierz zmienną z JSON transformację: Na stronie Output wybierz opcję Text. W polu Wartość wpisz `0` i `sm`.
Nagłówki	Dodaj nagłówek: W polu Key wpisz `Authorization`. W polu Value wpisz `Bearer` , a następnie wybierz zmienną łańcuchową APIKey.
Typ zawartości	Wpisz `application/json`.

Krok 5. Dodaj zdarzenia Run chain, aby wykonać i zarejestrować przesyłanie danych

Aby przesłać dane do Wdata i zarejestrować przesłanie w sekcji Control sheet, dodaj zdarzenia Run chain dla łańcuchów utworzonych wcześniej:

Z Łańcuch zdarzeń, przenieś Uruchom łańcuch do obszaru roboczego.
Przeciągnij link z GET do Uruchom łańcuch.
Wybierz zdarzenie Run chain i kliknij Edit.
Na stronie Basic info wprowadź nazwę i opis, które pomogą zidentyfikować, że zdarzenie przesyła dane do Wdata.
W Chain to run wybierz Load Data to Wdata | Primary chain utworzony wcześniej z szablonu Load Data to Wdata.

Wprowadź dane wejściowe czasu pracy łańcucha i kliknij Zapisz:

Wejście	Wartość
Identyfikator tabeli	Podaj identyfikator tabeli Wdata, do której mają zostać przesłane dane: Wybierz plik JSON będący wynikiem polecenia CSV to JSON. Kliknij plik wyjściowy JSON i zastosuj transformację Get variable from JSON: Na stronie Output wybierz opcję Text. W polu Wartość wpisz `0` i `tid`.
Prefiks pliku	Aby zdefiniować prefiks zestawu danych do przesłania, w oparciu o okres danych: Jako miesiąc początkowy wybierz dwukrotnie plik JSON będący wynikiem polecenia CSV to JSON. Wprowadź podkreślenie (`_`). Dla miesiąca końcowego wybierz plik JSON z polecenia CSV to JSON jeszcze dwa razy. Wprowadź `.csv`. Dla obu miesięcy kliknij pierwszy plik JSON i zastosuj transformację Get variable from JSON: Na stronie Output wybierz opcję Text. W polu Wartość wpisz `0` i `ry`. Dla obu miesięcy kliknij drugi plik JSON i zastosuj kolejną transformację Get variable from JSON: Na stronie Output wybierz opcję Text. W polu Wartość wpisz `0` i `sm`.
Plik danych	Wybierz wyjście Response polecenia GET.
Metoda ładowania	Wybierz opcję Zastąp zestaw danych.
Cofnięcie	Zaznacz to pole wyboru.

Z Łańcuch zdarzeń, przenieś kolejny Uruchom łańcuch do obszaru roboczego.
Przeciągnij łącze z pierwszego łańcucha Run do drugiego.
Wybierz drugie zdarzenie Run chain i kliknij Edit.
Na stronie Basic info wprowadź nazwę i opis, które pomogą zidentyfikować zdarzenie rejestrujące przesłanie danych w arkuszu kalkulacyjnym Watershed.
W Chain, aby uruchomić, wybierz 3. Łańcuch Watershed utworzony wcześniej.

Wprowadź dane wejściowe czasu pracy łańcucha i kliknij Zapisz:

Wejście	Wartość
Zakres	Wprowadź `F12:F12`.
Identyfikator arkusza kalkulacyjnego	Wybierz zmienną łańcuchową SpreadsheetID.
Identyfikator arkusza	Wybierz zmienną łańcuchową SheetID.

Kliknij Opublikuj, wprowadź wszelkie uwagi dotyczące publikacji i kliknij Opublikuj.

Uruchom łańcuchy

Aby odświeżyć arkusz kalkulacyjny Watershed o najnowsze dane dotyczące śladu węglowego:

W sekcji Control sheet arkusza kalkulacyjnego Watershed wybierz okres - miesiące i rok - danych do pobrania z Watershed.
Z Wdata Chains, wybierz 1. Łańcuch Watershed i kliknij Wykonaj i Uruchom łańcuch.

Uwaga: Gdy uruchomisz ten łańcuch, automatycznie uruchomi on dwa inne łańcuchy, aby zaktualizować tabelę Wdata i arkusz kalkulacyjny Watershed z danymi.

Wsparcie

Wspólnota

Centrum wsparcia Workiva