Da Chain Builder, puoi creare una catena per scaricare i dati da Enablon®, ad esempio le emissioni di gas serra (GHG) per il reporting ambientale, sociale e di governance (ESG) o di sostenibilità.
Prerequisiti
Per costruire questa catena, utilizzerai questi connettori centrali:
- Connettore HTTP Request
- Connettore Utilità dei file
- Connettore XML
- Connettore Workiva , se hai bisogno di utilizzare i dati in un foglio di calcolo o in una tabella Wdata
Nota: Tutti i comandi di questa catena utilizzano il CloudRunner predefinito. Non è necessario GroundRunner.
Per eseguire la catena, avrai bisogno di informazioni da Enablon per accedere ai dati:
- L'endpoint dell'Application Programming Interface (API) Enablon Simple Object Access Protocol (SOAP) da utilizzare per scaricare i dati.
- L'ID dell'ambiente Enablon a cui accedere
- Il nome utente e la password da utilizzare per accedere all'ambiente
Passo 1. Crea la catena
- Da Catene, clicca su Crea e seleziona Crea la catena.
- In Setup, inserisci un nome e una descrizione per identificare la catena e il suo scopo.
- In Variabili, aggiungi le variabili per i dettagli di Enablon necessari per accedere ai dati:
- Endpoint
Suggerimento: Per la variabile Endpoint, inserisci un valore predefinito di
ExportDatao, per scaricare i dati in un formato di codifica a 64 bit,ExportBinaryData. - Ambiente
- Nome utente
- Password
- Endpoint
- Clicca su Salva.
Passo 2. Iniziare con l'evento di attivazione Runtime Inputs
Per filtrare l'output ogni volta che la catena viene eseguita, inizia con un evento Runtime Inputs per richiedere i criteri dei dati da scaricare.
- Sposta Runtime Inputs da Trigger Events a Avvia.
- Seleziona l'evento Runtime Inputs e clicca su Edit.
- Aggiungi gli input da richiedere ogni volta che la catena viene eseguita:
Nome visualizzato Tipo È necessario? Data di inizio del periodo di riferimento Campo Data Sì Data di fine periodo del report Campo Data Sì Campagna Campo di testo o campo a discesa: - TextField, per un campo di testo aperto
- DropdownField, per selezionare da un elenco specifico di opzioni
Sì Entità ArrayField Sì - Clicca su Salva.
Passo 3. Aggiungi un comando HTTP Request connector POST
Per recuperare i dati dall'endpoint di Enablon, imposta un comando HTTP POST:
- Sotto Connettori, clicca su HTTP e sposta il comando POST nell'area di disegno.
- Trascina un link da Start al comando POST .
- Seleziona il comando PUBBLICA e clicca su Modifica.
- In Proprietà del comando, seleziona il connettore HTTP da utilizzare.
- Inserisci le proprietà del comando:
Proprietà Descrizione Nome utente Seleziona la variabile Username sotto Chain. Password Seleziona la variabile Password sotto Chain. Mostra la risposta Seleziona questa casella. URL Seleziona la variabile Endpoint sotto Chain. Tipo di contenuto Inserisci text/xml. - Nel testo Body, inserisci questa sintassi 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<4> <soapenv:Header> <UserInfo xsi:type="wsdl:AuthHeader" xmlns:wsdl="http://enablon/wsdl/"> <EnaHomeSite xsi:type="xsd:string<6>[Environment]</EnaHomeSite> <EnaUserName xsi:type="xsd:string">[Nome utente]</EnaUserName> <EnaPassword xsi:type="xsd:string<8>[Password]</EnaPassword> </UserInfo> </soapenv:Header> <soapenv:Body> <enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"> <Table>/sd/Entità/Dati</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> <ExportOptions>8192</ExportOptions> </enab:ExportData> </soapenv:Body> </soapenv:Envelope>
- Aggiorna la sintassi XML con le variabili di input e chain del runtime:
- Nell'intestazione, sostituisci
[Environment],[Username], e[Password]con le rispettive variabili sotto Chain. - Nel corpo, sostituisci
[ReportPeriodEndDate],[ReportPeriodStartDate],[Campaign], e[Entities]con i loro input di runtime sotto Trigger.
- Nell'intestazione, sostituisci
- Clicca su Salva.
Passo 4. Aggiungi i comandi Trova e sostituisci del connettore File Utilities
Per preparare i dati XML scaricati, aggiungi i comandi File Utilities connector Find and replace per correggere le parentesi angolari e i tubi.
Suggerimento: Per differenziare facilmente i comandi Trova e sostituisci, inserisci dei nomi che identifichino il carattere che ogni comando corregge, ad esempio "Trova e sostituisci le parentesi angolari iniziali" o "Trova e sostituisci i tubi".
- Sotto Connectors, clicca su File Utilities, e sposta il comando Find and replace nell'area di disegno.
- Trascina un collegamento dal comando POST al comando Trova e sostituisci .
- Seleziona il comando Trova e sostituisci e clicca su Modifica.
- In Proprietà dei comandi, seleziona il connettore File Utilities da utilizzare.
- Inserisci le proprietà del comando e clicca su Salva:
Proprietà Descrizione Fonte Seleziona l'output Response del comando POST. Trova Inserisci <.Sostituire Inserisci una parentesi angolare iniziale ( <).Sintassi di ricerca Seleziona Exact. - In Connettori, clicca su Utilità file, e sposta un altro comando Trova e sostituisci nell'area di disegno.
- Trascina un collegamento tra i comandi Trova e sostituisci .
- Seleziona il nuovo comando Trova e sostituisci e clicca su Modifica.
- In Proprietà dei comandi, seleziona lo stesso connettore Utilità dei file.
- Inserisci le proprietà del comando e clicca su Salva:
Proprietà Descrizione Fonte Seleziona il risultato Sostituito del comando Trova e sostituisci. Trova Inserisci >.Sostituire Inserisci una parentesi angolare iniziale ( >).Trova la sintassi Seleziona Exact. - Sotto Connectors, clicca su File Utilities, e sposta un altro comando Trova e sostituisci nell'area di disegno.
- Trascina un collegamento tra il secondo e il terzo comando Trova e sostituisci .
- Seleziona il terzo comando Trova e sostituisci e clicca su Modifica.
- In Proprietà dei comandi, seleziona lo stesso connettore Utilità dei file.
- Inserisci le proprietà del comando e clicca su Salva:
Proprietà Descrizione Fonte Seleziona il risultato Sostituito del secondo comando Trova e sostituisci. Trova Inserisci >.Sostituire Inserisci una virgola ( |).Sintassi di ricerca Seleziona Esatto.
Passo 5. Aggiungi un connettore XML Elenco di elementi al comando CSV
Per convertire l'XML scaricato in dati tabellari, aggiungi un connettore XML Elenco di elementi in CSV comando:
- In Connettori, clicca su XML e sposta un altro comando Elenco di elementi in CSV nell'area di disegno.
- Trascina un link dal terzo comando Trova e sostituisci al comando Elenco di elementi in CSV.
- Seleziona il comando Elenco di elementi in CSV e clicca su Modifica.
- In Proprietà del comando, seleziona il connettore XML da utilizzare.
- Inserisci le proprietà del comando:
Proprietà Descrizione Fonte Seleziona il risultato Sostituito del terzo comando Trova e sostituisci. Percorso verso la radice Inserisci //Document/Record.Anteprima del risultato Seleziona questa casella. - In Columns, aggiungi il nome della colonna e l'XPath per ogni elemento:
Nome della colonna XPath Periodo /Periodo di riferimento Indicatore /Ref IndName /NomeIndicatore ValoreNumero /NumeroValore Unità /LocalUnit - In delimitatore di valori multipli, inserisci una virgola (
,). - Clicca su Salva.
Passo 6. Aggiungi un connettore di Utilità file Comando Crea file
Per creare un file di valori separati da virgola (CSV) dai dati tabellari, aggiungi il comando File Utilities Create file:
- Sotto Connectors, clicca su File Utilities e sposta il comando Create file nell'area di disegno.
- Trascina un collegamento dal comando Elenco elementi in CSV al comando Crea file .
- Seleziona il comando Crea file e clicca su Modifica.
- In Proprietà dei comandi, seleziona lo stesso connettore di Utilità file dei comandi Trova e sostituisci.
- Inserisci le proprietà del comando e clicca su Salva:
Proprietà Descrizione Testo Seleziona il file convertito in uscita dal comando Elenco di elementi in CSV. Percorso del file Seleziona la variabile Chain.Workspace sotto Runtime e aggiungi \test.csv.
Passo 7. Aggiungi i comandi per utilizzare i dati in Workiva
Per utilizzare i dati CSV nella piattaforma Workiva, aggiungi i comandi del connettore Workiva per utilizzare l'output variabile File creato del comando Crea file con un foglio di calcolo o una tabella Wdata. Ad esempio, per aggiungere i dati di Enablon come set di dati in una tabella Wdata, aggiungi un evento Run chain che utilizza una catena creata da e Update datasets in una tabella template.
Passo 8. Pubblica ed esegui la catena
Per consentire l'esecuzione della catena:
- Clicca su Pubblica.
- Inserisci un commento sulla sua pubblicazione e clicca su Pubblica.
Per eseguire la catena:
- Da Catene, seleziona Modifica dal menu della catena.
- Clicca su Chain Settings, inserisci i valori delle variabili e clicca su Save.
Nota: Per la variabile Endpoint, inserisci
ExportDataoppure, per scaricare i dati in un formato di codifica a 64 bit,ExportBinaryData. - Clicca su Execute.
- Da Monitora, clicca su Esegui con gli input, inserisci gli input di runtime e clicca su Avvia.