|
Die klassischen Dateitypen können ab Januar 2021 nicht mehr verwendet werden. Sie können Ihre klassischen Dateien übertragen oder eine PDF herunterladen. Weitere Informationen

Workiva Support Center

Emissionsdaten von Enablon® für die Nachhaltigkeitsberichterstattung herunterladen

Emissionsdaten von Enablon® für die Nachhaltigkeitsberichterstattung herunterladen

  • Zuletzt aktualisiert am

Unter Chain Builder können Sie eine Kette erstellen, um Daten von Enablon® herunterzuladen, z. B. Ihre Treibhausgasemissionen für die Umwelt-, Sozial- und Unternehmensführung (ESG) oder die Nachhaltigkeitsberichterstattung. 

download-enablon_08.png

Voraussetzungen

Um diese Kette zu bilden, werden Sie diese Kernverbinder verwenden:

Hinweis: Alle Befehle in dieser Kette verwenden den Standard-CloudRunner. Es wird kein GroundRunner benötigt.

Um die Kette auszuführen, benötigen Sie Details von Enablon, um auf die Daten zuzugreifen:

  • Der Enablon Simple Object Access Protocol (SOAP) Application Programming Interface (API)-Endpunkt, der für das Herunterladen der Daten verwendet wird
  • Die ID der Enablon-Umgebung, auf die zugegriffen werden soll
  • Der Benutzername und das Passwort für den Zugriff auf die Umgebung

Schritt 1. Die Kette erstellen

  1. Klicken Sie unter Chains auf Create, und wählen Sie Create chain.
    download-schneider_01.png
  2. Geben Sie unter Setup einen Namen und eine Beschreibung ein, um die Kette und ihren Zweck zu identifizieren.
    download-enablon_09.png
  3. Fügen Sie unter Variablen Variablen für die für den Zugriff auf die Daten erforderlichen Enablon-Details hinzu:
    • Endpunkt
      Tipp: Geben Sie für die Variable Endpoint den Standardwert ExportData oder, um die Daten in einem 64-Bit-Kodierungsformat herunterzuladen, ExportBinaryData ein.
    • Umgebung
    • Benutzername
    • Kennwort
  4. Klicken Sie auf Speichern.

Schritt 2. Beginnen Sie mit dem Trigger-Ereignis Runtime Inputs

Um die Ausgabe bei jeder Ausführung der Kette zu filtern, starten Sie mit einem Runtime Inputs Ereignis, um die Kriterien für die herunterzuladenden Daten einzugeben.

  1. Verschieben Sie Runtime Inputs von unter Trigger Events nach Start.
  2. Wählen Sie das Ereignis Runtime Inputs und klicken Sie auf Edit.
    download-enablon_10.png
  3. Fügen Sie jedes Mal, wenn die Kette läuft, die Eingaben zur Anforderung hinzu:
    Anzeigename Typ Erforderlich?
    Datum des Beginns des Berichtszeitraums DateField Ja
    Enddatum des Berichtszeitraums DateField Ja
    Kampagne TextField oder DropdownField:
    • TextField, für ein offenes Textfeld
    • DropdownField, zur Auswahl aus einer bestimmten Liste von Optionen
    		 Ja
    Entitäten ArrayField Ja
  4. Klicken Sie auf Speichern.

Schritt 3. Fügen Sie einen HTTP Request Connector POST-Befehl hinzu

Um die Daten vom Enablon-Endpunkt abzurufen, richten Sie einen HTTP Connector POST Befehl ein:

  1. Klicken Sie unter Connectors auf HTTP, und verschieben Sie den Befehl POST auf die Leinwand.
  2. Ziehen Sie einen Link von Start auf den Befehl POST .
  3. Wählen Sie den Befehl POST und klicken Sie auf Bearbeiten.
  4. Wählen Sie unter Befehlseigenschaften den zu verwendenden HTTP Connector.
  5. Geben Sie die Eigenschaften des Befehls ein:
    download-enablon_01.png
    Eigenschaft Beschreibung
    Name des Benutzers Wählen Sie die Variable Benutzername unter Kette.
    Kennwort Wählen Sie die Variable Passwort unter Kette.
    Antwort anzeigen Kreuzen Sie dieses Feld an.
    URL Wählen Sie unter Chain die Variable Endpoint aus.
    Inhaltstyp Geben Sie text/xml ein.
  6. Geben Sie in Textkörpert diese Extensible Markup Language (XML)-Syntax ein: 
    <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">[Username]</EnaUserName> <EnaPassword xsi:type="xsd:string">[Password]</EnaPassword> </UserInfo> </soapenv:Header> <soapenv:Body> <enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"> <Table>/sd/Entitäten/Daten</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>
  7. Aktualisieren Sie die XML-Syntax mit den Laufzeit-Eingabe- und Kettenvariablen:
    • Ersetzen Sie in der Kopfzeile [Umgebung], [Benutzername] und [Passwort] durch die entsprechenden Variablen unter Kette.
    • Ersetzen Sie im Textkörper [ReportPeriodEndDate], [ReportPeriodStartDate], [Campaign] und [Entities] durch ihre Laufzeiteingaben unter Trigger.
  8. Klicken Sie auf Speichern.

Schritt 4. Hinzufügen der Befehle „Suchen und Ersetzen“ zum Dateidienstprogramm-Konnektor

Um die heruntergeladenen XML-Daten vorzubereiten, fügen Sie File Utilities connector Find and replace commands to fix the angle brackets and pipes.

Tipp: Um die Befehle Suchen und Ersetzen leicht unterscheiden zu können, geben Sie Namen ein, um das Zeichen zu identifizieren, das jeder Befehl korrigiert, wie z. B. "Beginnende spitze Klammern suchen und ersetzen" oder "Rohre suchen und ersetzen".
  1. Klicken Sie unter Connectors auf File Utilities, und verschieben Sie den Befehl Find and replace auf die Leinwand.
  2. Ziehen Sie eine Verknüpfung aus dem Befehl POST in den Befehl Suchen und Ersetzen .
  3. Wählen Sie den Befehl Suchen und Ersetzen, und klicken Sie auf Bearbeiten.
  4. Wählen Sie unter Befehlseigenschaften den zu verwendenden Connector File Utilities.
    download-enablon_02.png
  5. Geben Sie die Eigenschaften des Befehls ein, und klicken Sie auf Speichern:
    Eigenschaft Beschreibung
    Quelle Wählen Sie die Ausgabe Antwort des VERÖFFENTLICHEN-Befehls.
    Suchen Geben Sie < ein.
    Ersetzen Geben Sie eine Anfangswinkelklammer ein ( <).
    Syntax finden Genau auswählen.
  6. Klicken Sie unter Konnektoren auf Dateidienstprogramm und verschieben Sie einen weiteren Suchen und Ersetzen-Befehl in den Hauptbereich.
  7. Ziehen Sie eine Verknüpfung zwischen den Befehlen Suchen und Ersetzen .
  8. Wählen Sie den neuen Befehl Suchen und ersetzen und klicken Sie auf Bearbeiten.
  9. Wählen Sie unter Befehlseigenschaften denselben Dateidienstprogramm-Konnektor aus.
    download-enablon_03.png
  10. Geben Sie die Eigenschaften des Befehls ein, und klicken Sie auf Speichern:
    Eigenschaft Beschreibung
    Quelle Wählen Sie die Ausgabe Ersetztes Ergebnis des Befehls Suchen und Ersetzen.
    Suchen Geben Sie > ein.
    Ersetzen Geben Sie eine Startwinkelklammer ein (>).
    Syntax finden Genau auswählen.
  11. Klicken Sie unter Konnektoren auf Dateidienstprogramm und verschieben Sie einen weiteren Suchen und Ersetzen-Befehl in den Hauptbereich.
  12. Ziehen Sie eine Verknüpfung zwischen dem zweiten und dritten Suchen und Ersetzen Befehl.
  13. Wählen Sie den dritten Befehl Suchen und ersetzen und klicken Sie auf Bearbeiten.
  14. Wählen Sie unter Befehlseigenschaften denselben Dateidienstprogramm-Konnektor aus.
    download-enablon_04.png
  15. Geben Sie die Eigenschaften des Befehls ein, und klicken Sie auf Speichern:
    Eigenschaft Beschreibung
    Quelle Wählen Sie die Ausgabe Ersetztes Ergebnis des zweiten Befehls Suchen und Ersetzen.
    Suchen Geben Sie > ein.
    Ersetzen Geben Sie eine Pipe ein (|).
    Syntax finden Genau auswählen.

Schritt 5. Hinzufügen einer XML-Verbindungselementliste zum CSV-Befehl

Um das heruntergeladene XML in tabellarische Daten zu konvertieren, fügen Sie einen XML Connector Element list to CSV Befehl hinzu:

  1. Klicken Sie unter Connectors auf XML, und verschieben Sie einen weiteren Element list to CSV Befehl auf die Leinwand.
  2. Ziehen Sie eine Verknüpfung aus dem dritten Befehl Suchen und Ersetzen auf den Befehl Elementliste nach CSV.
  3. Wählen Sie den Befehl Elementliste zu CSV und klicken Sie auf Bearbeiten.
  4. Wählen Sie unter Befehlseigenschaften den zu verwendenden XML Connector.
    download-enablon_05.png
  5. Geben Sie die Eigenschaften des Befehls ein:
    Eigenschaft Beschreibung
    Quelle Wählen Sie die Ausgabe Ersetztes Ergebnis des dritten Befehls Suchen und Ersetzen.
    Pfad zur Wurzel Geben Sie ein //Document/Record.
    Vorschau Ergebnis Kreuzen Sie dieses Feld an.
  6. Fügen Sie unter Columns den Spaltennamen und den XPath für jedes Element hinzu:
    download-enablon_11.png
    Spaltenname XPath
    Zeitraum /Berichtszeitraum
    Indikator /Ref
    IndName /IndikatorName
    NumValue /WertZahl
    Einheit /LokalEinheit
  7. Geben Sie in Mehrwertiges Trennzeichen ein Komma ein (,).
  8. Klicken Sie auf Speichern.

Schritt 6. Hinzufügen eines File Utilities-Konnektors Create File Befehl

Um eine CSV-Datei (Comma-Separated Values) aus den Tabellendaten zu erstellen, fügen Sie einen File Utilities Connector Create file Befehl hinzu:

  1. Klicken Sie unter Connectors auf File Utilities, und verschieben Sie den Befehl Create file auf die Leinwand.
  2. Ziehen Sie einen Link aus dem Befehl Elementliste zu CSV auf den Befehl Datei erstellen .
  3. Wählen Sie den Befehl Datei erstellen, und klicken Sie auf Bearbeiten.
  4. Wählen Sie unter Befehlseigenschaften denselben Anschluss File Utilities wie die Befehle Suchen und Ersetzen.
    download-enablon_07.png
  5. Geben Sie die Eigenschaften des Befehls ein, und klicken Sie auf Speichern:
    Eigenschaft Beschreibung
    Text Wählen Sie die Ausgabe Konvertierte Datei des Befehls Elementliste in CSV.
    Dateipfad Wählen Sie die Variable Chain.Workspace unter Runtime, und hängen Sie \test.csv an.

Schritt 7. Befehle zur Verwendung der Daten in Workiva hinzufügen

Um die CSV-Daten in der Workiva-Plattform zu verwenden, fügen Sie Workiva Connector-Befehle hinzu, um die Created file variable Ausgabe des Create file Befehls mit einer Tabellenkalkulation oder Wdata-Tabelle zu verwenden. Um beispielsweise die Enablon-Daten als Datensatz in einer Wdata-Tabelle hinzuzufügen, fügen Sie ein Kette ausführen-Ereignis hinzu, das eine Kette verwendet, die aus den Update-Datensätzen in einer  template-Tabelle erstellt wurde. 

Schritt 8. Veröffentlichen und Ausführen der Kette

Um die Kette in Gang zu setzen:

  1. Klicken Sie auf Veröffentlichen.
  2. Geben Sie einen beliebigen Kommentar zu seiner Veröffentlichung ein und klicken Sie auf Veröffentlichen.

Um die Kette laufen zu lassen:

  1. Wählen Sie unter Ketten Bearbeiten aus dem Menü der Kette.
  2. Klicken Sie auf Ketteneinstellungen, geben Sie die Variablenwerte ein, und klicken Sie auf Speichern.
    Hinweis: Geben Sie für die Variable Endpunkt ExportData oder, um die Daten in einem 64-Bit-Kodierungsformat herunterzuladen, ExportBinaryData ein.
  3. Klicken Sie auf Ausführen.
  4. Klicken Sie unter Monitor auf Run with inputs, geben Sie die Laufzeiteingaben ein und klicken Sie auf Start.
War dieser Beitrag hilfreich?
0 von 0 fanden dies hilfreich
Unter Chain Builder können Sie eine Kette erstellen, um Daten von Enablon® herunterzuladen, z. B. Ihre Treibhausgasem...