Centrum wsparcia Workiva

Na stronie Chain Builder możesz utworzyć łańcuch, aby pobrać dane ze Schneider Electric® do Workiva, takie jak emisje gazów cieplarnianych (GHG) na potrzeby raportowania środowiskowego, społecznego i zarządzania (ESG) lub zrównoważonego rozwoju.

Wymagania wstępne

Aby zbudować ten łańcuch, użyjesz tych podstawowych złączy:

• Łącznik żądań HTTP
• Złącze JSON
• Złącze narzędzi plików
• Złącze Workiva

Uwaga: Wszystkie konektory korzystają z CloudRunner. Ten łańcuch nie wymaga GroundRunnerów.

Aby pobrać dane dotyczące emisji, będziesz również potrzebować nazwy użytkownika i hasła używanego do podstawowej autoryzacji w Schneider Electric.

Krok 1. Utwórz łańcuch

1. Na stronie Łańcuchy kliknij Utwórz, a następnie wybierz Utwórz łańcuch.
   
2. W sekcji Setup wprowadź nazwę i opis, aby zidentyfikować łańcuch.
   
3. W sekcji Variables dodaj zmienne, aby określić dane do pobrania z Schneider Electric:

   Nazwa	Wartość
   clientHierIds	Wprowadź identyfikator hierarchii klientów swojej firmy, skonfigurowany dla Schneider Electric w Resource Advisor.
   serviceIds	Aby pobrać dane tylko dla określonego źródła, wprowadź identyfikator źródła GHG, dla którego chcesz pobrać dane dotyczące emisji.
   fromMonth	Wprowadź najwcześniejszy miesiąc okresu, dla którego chcesz pobrać dane, w formacie rrrr-MM.
   toMonth	Wprowadź ostatni miesiąc okresu, dla którego chcesz pobrać dane, w formacie rrrr-MM.
   carbonMapType	Wprowadź mapę węglową z Resource Advisor, której chcesz użyć - Primary lub Secondary. Jeśli pozostanie puste, polecenie użyje podstawowej mapy węglowej.
   emissionUOMId	Wprowadź preferowaną jednostkę miary do użycia z pobranymi danymi dotyczącymi emisji.
   emissionURL	Wprowadź adres URL punktu końcowego API Schneider Electric, aby zażądać danych.

4. Kliknij Zapisz.

Krok 2. Zacznij od żądania HTTP

Aby zażądać danych do pobrania od Schneider Electric, rozpocznij od polecenia HTTP POST.

1. W sekcji Connectors wybierz HTTP i przenieś POST do Start.
2. Wybierz polecenie POST i kliknij Edytuj.
3. W sekcji Podstawowe informacje wprowadź nazwę i opis, aby ułatwić identyfikację polecenia.
4. W sekcji Command properties wybierz łącznik HTTP Request, który ma zostać użyty.
5. Wprowadź właściwości polecenia:
   
   

   Właściwość	Opis
   Nazwa użytkownika	Wprowadź nazwę użytkownika używaną do podstawowego uwierzytelniania w Schneider Electric.
   Hasło	Wprowadź hasło używane do podstawowego uwierzytelniania w Schneider Electric.
   Pokaż odpowiedź	Zaznacz to pole.
   Adres URL	Wybierz zmienną emissionsURL w obszarze Chain.
   Typ zawartości	Wybierz application/json.
   Treść	Wprowadź żądanie jako ciąg JavaScript Object Notation (JSON), wybierając odpowiednią zmienną w obszarze Chain jako wartość każdej pary nazwa/wartość: { "clientHierIds": [<zmienna clientHierId>], "serviceIds": [<zmienna serviceIds>], "fromMonth": "<zmienna fromMonth>", "toMonth": "<zmienna toMonth>", "carbonMapType": "<zmienna carbonMapType>", "emissionsUOMId": "<zmienna emissionUOMId>", }
   Schemat wyjściowy	Wprowadź przykładową odpowiedź JSON od Schneider Electric: { "serviceOutput": [ { "divisionClientHierId": 0, "divisionName": "string", "siteClientHierId": 0, "siteName": "string", "dataSourceLevel": "string", "serviceId": 0, "serviceName": "string", "scope": "string", "usage": 0, "emission": 0, "emissionUOM": "string", "usageUOM": "string", "serviceMonth": "string" } errorMessage": "string", "errorCode": "string" }

6. Kliknij Zapisz.

Krok 3. Dodaj tablicę do polecenia CSV

Aby przekonwertować odpowiedź JSON od Schneider Electric na format wartości oddzielonych przecinkami (CSV), dodaj polecenie Array to CSV:

1. W sekcji Connectors wybierz JSON i przenieś Array to CSV do obszaru roboczego.
2. Przeciągnij łącze z Start do polecenia Array to CSV.
3. Wybierz polecenie Array to CSV i kliknij Edit.
4. W sekcji Podstawowe informacje wprowadź nazwę i opis, aby ułatwić identyfikację polecenia.
5. W sekcji Command properties wybierz łącznik JSON, którego chcesz użyć.
   
6. W przypadku danych JSON wybierz dane wyjściowe Response polecenia POST.
7. W sekcji Kolumny dodaj kolumny dla danych pobranych z Schneider Electric:
   
   

   Nazwa kolumny	JSONPath
   użycie	.usage
   emisje	.emisje

8. Dla Delimiter, wybierz Przecinek.
9. Kliknij Zapisz.

Krok 4. Dodaj polecenie Utwórz plik

Aby utworzyć plik CSV z danych, dodaj polecenie Create file:

1. W obszarze Connectors wybierz File Utilities i przenieś Create file do obszaru roboczego.
2. Przeciągnij łącze z polecenia Array to CSV do polecenia Create file.
3. Wybierz polecenie Create file i kliknij Edit.
4. W sekcji Podstawowe informacje wprowadź nazwę i opis, aby ułatwić identyfikację polecenia.
5. W sekcji Command properties wybierz łącznik File Utilities, który ma być używany.
   
6. Wprowadź właściwości polecenia:
   

   Właściwość	Opis
   Tekst	Wybierz plik Converted wyjściowy polecenia Array to CSV.
   Ścieżka pliku	Wybierz zmienną Chain.Workspace w obszarze Runtime i wprowadź \ oraz nazwę pliku z rozszerzeniem .csv.

7. Kliknij Zapisz.

Krok 5. Dodaj polecenia, aby korzystać z danych w Workiva

Aby użyć danych CSV na platformie Workiva, dodaj polecenia łącznika Workiva, aby użyć zmiennej wyjściowej Utworzony plik polecenia Utwórz plik z arkuszem kalkulacyjnym lub tabelą Wdata. Na przykład, aby dodać dane Schneider Electric jako zestaw danych w tabeli Wdata, dodaj zdarzenie Run chain, które wykorzystuje łańcuch utworzony z i Update datasets w tabeli template. 

Krok 6. Opublikuj i uruchom łańcuch

Aby umożliwić uruchomienie łańcucha:

1. Kliknij Publish.
2. Wprowadź dowolny komentarz dotyczący jego publikacji i kliknij Publish.

Aby uruchomić łańcuch:

1. Z Łańcuchy, wybierz Edytuj z menu łańcucha.
2. Kliknij Ustawienia łańcucha, wprowadź wartości zmiennych, aby określić dane do pobrania, a następnie kliknij Zapisz.
3. Kliknij Execute i Run chain.