Centrum wsparcia Workiva

Na stronie Chain Builder możesz utworzyć łańcuch, aby pobrać dane z Enablon®, 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:

• Złącze HTTP Request
• File Utilities connector
• Złącze XML
• Konektor Workiva , jeśli potrzebujesz użyć danych w arkuszu kalkulacyjnym lub tabeli Wdata

Uwaga: Wszystkie polecenia tego łańcucha używają domyślnego CloudRunnera. GroundRunner nie jest wymagany.

Aby uruchomić łańcuch, będziesz potrzebować danych z Enablon, aby uzyskać dostęp do danych:

• Punkt końcowy interfejsu programowania aplikacji (API) Enablon Simple Object Access Protocol (SOAP), którego należy użyć do pobrania danych
• Identyfikator środowiska Enablon, do którego chcesz uzyskać dostęp
• Nazwa użytkownika i hasło dostępu do środowiska

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, które pomogą zidentyfikować łańcuch i jego przeznaczenie.
   
3. W sekcji Variables dodaj zmienne dla szczegółów Enablon wymaganych do uzyskania dostępu do danych:
   • Punkt końcowy

     Wskazówka: Dla zmiennej Endpoint wprowadź domyślną wartość ExportData lub, aby pobrać dane w 64-bitowym formacie kodowania, ExportBinaryData.

   • Środowisko
   • Nazwa użytkownika
   • Hasło
4. Kliknij Zapisz.

Krok 2. Rozpocznij od zdarzenia wyzwalającego Runtime Inputs

Aby filtrować dane wyjściowe przy każdym uruchomieniu łańcucha, rozpocznij od zdarzenia Runtime Inputs, aby wyświetlić monit o kryteria danych do pobrania.

1. Przenieś Runtime Inputs spod Trigger Events do Start.
2. Wybierz zdarzenie Runtime Inputs i kliknij Edit.
   
3. Dodaj dane wejściowe do żądania za każdym razem, gdy łańcuch jest uruchamiany:

   Nazwa wyświetlana	Typ	Wymagane?
   Data rozpoczęcia okresu sprawozdawczego	DateField	Tak
   Data zakończenia okresu sprawozdawczego	DateField	Tak
   Kampania	TextField lub DropdownField: TextField, dla otwartego pola tekstowego DropdownField, aby wybrać z określonej listy opcji	Tak
   Podmioty	ArrayField	Tak

4. Kliknij Zapisz.

Krok 3. Dodaj polecenie POST złącza żądania HTTP

Aby pobrać dane z punktu końcowego Enablon, skonfiguruj złącze HTTP POST:

1. W sekcji Connectors kliknij HTTP i przenieś polecenie POST do obszaru roboczego.
2. Przeciągnij łącze z Start do polecenia POST .
3. Wybierz polecenie POST i kliknij Edytuj.
4. W sekcji Command properties wybierz złącze HTTP do użycia.
5. Wprowadź właściwości polecenia:
   
   

   Właściwość	Opis
   Nazwa użytkownika	Wybierz zmienną Username w obszarze Chain.
   Hasło	Wybierz zmienną Password w obszarze Chain.
   Pokaż odpowiedź	Zaznacz to pole.
   Adres URL	Wybierz zmienną Endpoint w obszarze Chain.
   Typ zawartości	Wpisz text/xml.

6. W tekście Body wprowadź następującą składnię Extensible Markup Language (XML):

   <soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:enab="enablon"> <soapenv:Header> <UserInfo xsi:type="wsdl:AuthHeader" xmlns:wsdl="http://enablon/wsdl/"> <EnaHomeSite xsi:type="xsd:string">[Environment]</EnaHomeSite> <EnaUserName xsi:type="xsd:string">[Nazwa użytkownika]</EnaUserName> <EnaPassword xsi:type="xsd:string">[Hasło]</EnaPassword> </UserInfo> </soapenv:Header> <soapenv:Body> <enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"> <Table>/sd/Entities/Data</Table>       <FolderId>0</FolderId> <Fields>FolderPath|ReportingPeriod|Ref|IndicatorName|ValueNumber|LocalUnit|ValueList</Fields> <Filter>ReportingPeriod in ([ReportPeriodEndDate],[ReportPeriodStartDate]) AND Campaign in([Campaign]) AND Entities=[Entities]< /Filter> <CSVSeparator>2</CSVSeparator> <FormatOptions>25</FormatOptions> <FormatType>3</FormatType>./Filter> <CSVSeparator>2</CSVSeparator> <FormatOptions>25</FormatOptions> <FormatType>3</FormatType> <ExportOptions>8192</ExportOptions> </enab:ExportData> </soapenv:Body> </soapenv:Envelope&gt

7. Zaktualizuj składnię XML za pomocą zmiennych wejściowych i łańcuchowych:
   • W nagłówku zastąp [Środowisko], [Nazwa użytkownika] i [Hasło] odpowiednimi zmiennymi w Łańcuch.
   • W treści zastąp [ReportPeriodEndDate], [ReportPeriodStartDate], [Campaign] i [Entities] ich danymi wejściowymi runtime w Trigger.
8. Kliknij Zapisz.

Krok 4. Dodaj polecenie Znajdź i zamień do złącza File Utilities

Aby przygotować pobrane dane XML, dodaj File Utilities connector Find and replace commands to fix the angle brackets and pipes.

Wskazówka: Aby łatwo rozróżnić polecenia Znajdź i zamień, wprowadź nazwy identyfikujące znak, który poprawia każde polecenie, takie jak "Znajdź i zamień początkowe nawiasy kątowe" lub "Znajdź i zamień potoki".

1. W obszarze Connectors kliknij File Utilities i przenieś polecenie Find and replace do obszaru roboczego.
2. Przeciągnij łącze z polecenia POST do polecenia Znajdź i zamień .
3. Wybierz polecenie Znajdź i zamień i kliknij Edytuj.
4. W sekcji Command properties wybierz złącze File Utilities do użycia.
   
5. Wprowadź właściwości polecenia i kliknij Zapisz:
   

   Właściwość	Opis
   Źródło	Wybierz wyjście Response polecenia POST.
   Znajdź	Wpisz <</kod>.
   Zastąp	Wprowadź początkowy nawias kątowy (<).
   Znajdź składnię	Wybierz dokładnie.

6. W obszarze Connectors kliknij File Utilities i przenieś kolejne polecenie Find and replace do obszaru roboczego.
7. Przeciągnij łącze między poleceniami Znajdź i zamień .
8. Wybierz nowe polecenie Znajdź i zamień i kliknij Edytuj.
9. W sekcji Command properties wybierz to samo złącze File Utilities.
   
10. Wprowadź właściwości polecenia i kliknij Zapisz:
    

    Właściwość	Opis
    Źródło	Wybierz wynik Zastąpiony wynik z polecenia Znajdź i zamień.
    Znajdź	Wprowadź >.
    Zastąp	Wprowadź początkowy nawias kątowy (>).
    Znajdź składnię	Wybierz dokładnie.

11. W obszarze Connectors kliknij File Utilities i przenieś kolejne polecenie Find and replace do obszaru roboczego.
12. Przeciągnij łącze między drugim i trzecim Polecenia Znajdź i zamień .
13. Wybierz trzecie polecenie Znajdź i zamień i kliknij Edytuj.
14. W sekcji Command properties wybierz to samo złącze File Utilities.
    
15. Wprowadź właściwości polecenia i kliknij Zapisz:
    

    Właściwość	Opis
    Źródło	Wybierz wynik Zastąpiony wynik drugiego polecenia Znajdź i zamień.
    Znajdź	Wprowadź >.
    Zastąp	Wprowadź potok (|).
    Znajdź składnię	Wybierz dokładnie.

Krok 5. Dodaj listę elementów łącznika XML do polecenia CSV

Aby przekonwertować pobrany plik XML na dane tabelaryczne, dodaj polecenie XML connector Element list to CSV:

1. W sekcji Connectors kliknij XML i przenieś kolejne polecenie Element list to CSV do obszaru roboczego.
2. Przeciągnij łącze z trzeciego polecenia Znajdź i zamień do polecenia Lista elementów do CSV.
3. Wybierz polecenie Element list to CSV i kliknij Edit.
4. W sekcji Command properties wybierz konektor XML do użycia.
   
5. Wprowadź właściwości polecenia:
   

   Właściwość	Opis
   Źródło	Wybierz wynik Zastąpiony wynik trzeciego polecenia Znajdź i zamień.
   Ścieżka do katalogu głównego	Wprowadź //Document/Record.
   Wynik podglądu	Zaznacz to pole.

6. W sekcji Columns dodaj nazwę kolumny i XPath dla każdego elementu:
   
   

   Nazwa kolumny	XPath
   Okres	/ReportingPeriod
   Wskaźnik	/Ref
   IndName	/IndicatorName
   NumValue	/ValueNumber
   Jednostka	/LocalUnit

7. W polu Ogranicznik wielu wartości wprowadź przecinek (,).
8. Kliknij Zapisz.

Krok 6. Dodaj złącze File Utilities do polecenia Create File

Aby utworzyć plik wartości oddzielonych przecinkami (CSV) z danych tabelarycznych, dodaj polecenie File Utilities connector Create file:

1. W obszarze Connectors kliknij File Utilities i przenieś polecenie Create file do obszaru roboczego.
2. Przeciągnij łącze z polecenia Lista elementów do CSV do polecenia Utwórz plik .
3. Wybierz polecenie Create file i kliknij Edit.
4. W sekcji Właściwości poleceń wybierz to samo złącze Narzędzia plików, co polecenia Znajdź i zamień.
   
5. Wprowadź właściwości polecenia i kliknij Zapisz:
   

   Właściwość	Opis
   Tekst	Wybierz plik Converted wyjściowy polecenia Element list to CSV.
   Ścieżka pliku	Wybierz zmienną Chain.Workspace w obszarze Runtime i dodaj \test.csv.

Krok 7. 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 Enablon jako zestaw danych w tabeli Wdata, dodaj zdarzenie Run chain, które wykorzystuje łańcuch utworzony z szablonu Update datasets in a table szablonu. 

Krok 8. 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 i kliknij Zapisz.

   Uwaga: Dla zmiennej Endpoint wpisz ExportData lub, aby pobrać dane w 64-bitowym formacie kodowania, ExportBinaryData.

3. Kliknij Execute.
4. Na stronie Monitor kliknij Uruchom z danymi wejściowymi, wprowadź dane wejściowe uruchomienia i kliknij Uruchom.