Workiva Support Center

Unter Chain Builder können Sie eine Kette erstellen, um Daten von Schneider Electric® in Workiva herunterzuladen, z. B. Ihre Treibhausgasemissionen für die Umwelt-, Sozial- und Governance-Berichterstattung (ESG) oder die Nachhaltigkeitsberichterstattung.

Voraussetzungen

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

• HTTP-Anfrage Konnektor
• JSON Konnektor
• Dateidienstprogramm Konnektor
• Workiva Konnektor

Hinweis: Alle Anschlüsse verwenden den CloudRunner. Für diese Kette sind keine GroundRunners erforderlich.

Um Emissionsdaten herunterzuladen, benötigen Sie außerdem den Benutzernamen und das Passwort, die Sie für die Basisauthentifizierung bei Schneider Electric verwenden.

Schritt 1. Die Kette erstellen

1. Klicken Sie unter Chains auf Create, und wählen Sie Create chain.
   
2.  Geben Sie unter Setup einen Namen und eine Beschreibung ein, um die Kette zu identifizieren.
   
3. Unter Variables fügen Sie Variablen hinzu, um die von Schneider Electric herunterzuladenden Daten zu spezifizieren:

   Name	Wert
   clientHierIds	Geben Sie die ID der Kundenhierarchie Ihres Unternehmens ein, wie sie für Schneider Electric in Resource Advisor eingerichtet wurde.
   serviceIds	Um Daten nur für eine bestimmte Quelle herunterzuladen, geben Sie die ID der Treibhausgasquelle ein, für die Sie Emissionsdaten herunterladen möchten.
   vonMonat	Geben Sie den frühesten Monat des Zeitraums, für den Daten heruntergeladen werden sollen, im Format yyyy-MM ein.
   toMonth	Geben Sie den letzten Monat des Zeitraums, für den Daten heruntergeladen werden sollen, im Format yyyy-MM ein.
   carbonMapType	Geben Sie die zu verwendende Kohlenstoffkarte aus Resource Advisor ein - primär oder sekundär. Wenn diese Option leer bleibt, verwendet der Befehl die primäre Kohlenstoffkarte.
   emissionUOMId	Geben Sie die bevorzugte Maßeinheit für die heruntergeladenen Emissionsdaten ein.
   emissionsURL	Geben Sie die URL des Schneider Electric API-Endpunkts ein, von dem Daten angefordert werden sollen.

4. Klicken Sie auf Speichern.

Schritt 2. Beginnen Sie mit einer HTTP-Anfrage

Um die herunterzuladenden Daten von Schneider Electric anzufordern, beginnen Sie mit einem HTTP POST Befehl.

1. Wählen Sie unter Connectors, HTTP, und verschieben Sie POST auf Start.
2. Wählen Sie den Befehl POST und klicken Sie auf Bearbeiten.
3. Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
4. Wählen Sie unter Befehlseigenschaften den zu verwendenden HTTP-Anfrage-Connector.
5. Geben Sie die Eigenschaften des Befehls ein:
   
   

   Eigenschaft	Beschreibung
   Name des Benutzers	Geben Sie den Benutzernamen ein, der für die grundlegende Authentifizierung bei Schneider Electric verwendet wird.
   Kennwort	Geben Sie das Passwort ein, das für die grundlegende Authentifizierung bei Schneider Electric verwendet wird.
   Antwort anzeigen	Kreuzen Sie dieses Feld an.
   URL	Wählen Sie die Variable emissionsURL unter Kette aus.
   Inhaltstyp	Wählen Sie application/json.
   Haupttext	Geben Sie die Anfrage als JavaScript Object Notation (JSON)-String ein und wählen Sie die entsprechende Variable unter Chain als Wert für jedes Name/Wert-Paar: { "clientHierIds": [<clientHierId>], "serviceIds": [<serviceIds>], "fromMonth": "<fromMonth>", "toMonth": "<toMonth>", "carbonMapType": "<carbonMapType>", "emissionsUOMId": "<emissionUOMId>" }
   Ausgabeschema	Geben Sie die JSON-Beispielantwortung von Schneider Electric ein: { "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. Klicken Sie auf Speichern.

Schritt 3. Hinzufügen eines Arrays zum CSV-Befehl

Um die JSON-Antwort von Schneider Electric in ein CSV-Format (Comma-Separated Values) zu konvertieren, fügen Sie den Befehl Array to CSV hinzu:

1. Wählen Sie unter Connectors die Option JSON, und verschieben Sie Array to CSV auf die Leinwand.
2. Ziehen Sie einen Link von Start auf den Befehl Array to CSV.
3. Wählen Sie den Befehl Array to CSV und klicken Sie auf Bearbeiten.
4. Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
5. Wählen Sie unter Befehlseigenschaften den zu verwendenden JSON-Connector aus.
   
6. Für JSON-Daten, wählen Sie die Antwort Ausgabe des POST Befehls.
7. Unter Columns fügen Sie Spalten für die von Schneider Electric heruntergeladenen Daten hinzu:
   
   

   Spaltenname	JSONPath
   Nutzung	.Verwendung
   Emissionen	.Emissionen

8. Wählen Sie für Trennzeichen Komma aus.
9. Klicken Sie auf Speichern.

Schritt 4. Hinzufügen eines Befehls Datei erstellen

Um eine CSV-Datei aus den Daten zu erstellen, fügen Sie den Befehl Datei erstellen hinzu:

1. Wählen Sie unter Konnektoren Dateidienstprogramm aus und verschieben Sie Datei erstellen in den Hauptbereich.
2. Ziehen Sie einen Link vom Befehl Array to CSV auf den Befehl Datei erstellen.
3. Wählen Sie den Befehl Datei erstellen, und klicken Sie auf Bearbeiten.
4. Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
5. Wählen Sie unter Befehlseigenschaften den zu verwendenden File Utilities-Anschluss.
   
6. Geben Sie die Eigenschaften des Befehls ein:
   

   Eigenschaft	Beschreibung
   Text	Wählen Sie die Ausgabe Konvertierte Datei des Befehls Array in CSV.
   Dateipfad	Wählen Sie die Variable Chain.Workspace unter Runtime, und geben Sie \ und den Dateinamen mit der Erweiterung .csv ein.

7. Klicken Sie auf Speichern.

Schritt 5. Befehle zur Verwendung von 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 Schneider Electric-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 6. 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, um die herunterzuladenden Daten anzugeben, und klicken Sie auf Speichern.
3. Klicken Sie auf Ausführen und Kette ausführen.