Die Klimaplattform für Unternehmen von Watershed ermöglicht es Ihnen, den CO2-Fußabdruck Ihres Unternehmens zu messen, zu melden und zu reduzieren.
Mit der Workiva Plattform können Sie Ketten erstellen, um automatisch Carbon Footprint Daten von Watershed herunterzuladen - z.B. für die Offenlegung in Ihrem Environment, Social, and Governance (ESG) oder Nachhaltigkeitsreporting - in eine Tabelle, basierend auf einem Zeitraum, der in einer benutzerdefinierten Watershed Tabelle festgelegt wurde. Sie können die Tabelle dann als Quelle für eine Abfrage oder eine Tabellenkalkulationsverbindung verwenden, z. B. um die Daten in Berichtsausgaben einzubeziehen.
Hinweis: Während Sie in dieser Anleitung mehrere Ketten erstellen, führen Sie nur eine Kette aus - die dann automatisch die anderen ausführt -, um Daten aus Watershed herunterzuladen und die Kalkulationstabelle zu aktualisieren.
Hinweis: Die von diesen Ketten verwendete Tabelle Watershed wird von Workiva bereitgestellt. Wenn Sie es nicht haben, aber daran interessiert sind, wenden Sie sich an Ihren Customer Success Manager, um Einzelheiten zu erfahren.
Voraussetzungen
Um diese Ketten zu bilden, benötigen Sie diese Verbindungsstücke:
- Workiva Konnektor
- Tabellen-Transformation Konnektor
- JSON Konnektor
- HTTP-Anfrage Konnektor
- Dateidienstprogramm Konnektor
Tipp: Alle Befehle in den Ketten verwenden den Standard-CloudRunner. Es werden keine GroundRunners benötigt.
Um die Ketten erfolgreich auszuführen, müssen Sie auch Folgendes identifizieren:
- Der -Schlüssel für den Aktivitätsanbieter, der für die Authentifizierung bei der Watershed-API und die Durchführung von Aktionen mit dieser verwendet wird
- Die IDs des Arbeitsblatts Wassereinzugsgebiet , seines Abschnitts Kontrollblatt und der damit verbundenen Tabelle
Erstellen Sie eine Kette zum Protokollieren von Datendownloads
Erstellen Sie zunächst eine Kette, um das Kontrollblatt zu aktualisieren und zu verfolgen, wann die Carbon Footprint-Daten in Workiva hochgeladen werden.
Schritt 1. Die Kette erstellen
- Klicken Sie unter Chains auf Create, und wählen Sie Create chain.
- Geben Sie unter Einrichtung einen Namen für
3 ein. Watershedund eine Beschreibung, um zu erkennen, dass die Kette Watershed-Daten-Uploads protokolliert. - Klicken Sie auf Speichern.
Schritt 2. Starten Sie mit einem Runtime Inputs Ereignis
- Von Chain events, verschieben Sie Runtime inputs nach Start.
- Wählen Sie das Ereignis Runtime inputs und klicken Sie auf Edit.
- Geben Sie unter Basisinfo einen Namen und eine Beschreibung ein, um das Ereignis zu identifizieren.
- Fügen Sie unter Variablen TextField-Eingaben mit diesen Anzeigenamen hinzu:
BereichTabellenkalkulationIDBlattID
Tipp: Lassen Sie diese Standardwerte der Variablen leer; sie werden generiert, wenn Sie die 1 ausführen. Die Kette der Wassereinzugsgebiete wurde später erstellt.
- Wählen Sie Erforderlich für alle drei Variablen, und klicken Sie auf Speichern.
Schritt 3. Hinzufügen des Befehls Dateidienstprogramme Datei erstellen
Um die Protokolldatei für den Abschnitt Control Sheet zu erstellen, fügen Sie den Befehl File Utilities Create file hinzu:
- Wählen Sie unter Verfügbare Verbindungen, wählen Sie File Utilities, und verschieben Sie Create file auf die Leinwand.
- Ziehen Sie eine Verknüpfung von Laufzeiteingaben auf Datei erstellen.
- Wählen Sie den Befehl Datei erstellen, und klicken Sie auf Bearbeiten.
- Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
- Geben Sie die Eigenschaften des Befehls ein, und klicken Sie auf Speichern:
Eigenschaft Wert Konnektor Wählen Sie den zu verwendenden File Utilities-Anschluss. Text Geben Sie Footprint-Daten ein, die zuletzt amaktualisiert wurden, und wählen Sie die Laufzeitvariable System.DateTime.
Schritt 4. Hinzufügen eines Workiva Write Sheet Data Befehls
Um den Abschnitt Kontrollblatt mit der Protokolldatei zu aktualisieren, fügen Sie den Befehl Workiva Blattdaten schreiben hinzu:
- Wählen Sie unter Verfügbare Anschlüsse, wählen Sie Workiva, und verschieben Sie Blattdaten schreiben auf die Leinwand.
- Ziehen Sie eine Verknüpfung von Datei erstellen zu Blattdaten schreiben.
- Wählen Sie den Befehl Blattdaten schreiben, und klicken Sie auf Bearbeiten.
- Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
- Geben Sie die Eigenschaften des Befehls ein, und klicken Sie auf Speichern:
Eigenschaft Wert Konnektor Wählen Sie den zu verwendenden Workiva-Anschluss. Arbeitsblatt-ID Wählen Sie die SpreadsheetID Laufzeiteingabe aus Trigger. Blatt-ID/Name Wählen Sie die SheetID Laufzeiteingabe aus Trigger. Datendatei Wählen Sie die Ausgabe Created file des Befehls Create file. Trennzeichen Geben Sie ein Komma ein ( ,).Region Wählen Sie den Bereich Laufzeiteingang aus Auslöser. - Klicken Sie auf Veröffentlichen, geben Sie einen Hinweis auf die Veröffentlichung ein, und klicken Sie auf Veröffentlichen.
Ketten aus der Vorlage Load Data to Wdata erstellen
Als Nächstes verwenden Sie die Vorlage Load Data to Wdata , um Ketten zu erstellen, die die verbundene Tabelle des Tabellenblatts Watershed mit den von Watershed heruntergeladenen Daten aktualisieren. Die Vorlage Load Data to Wdata erstellt Ketten, die zusammenarbeiten, um festzustellen, ob der Datensatz bereits in der Tabelle vorhanden ist und die Tabelle mit dem neuesten Datensatz zu aktualisieren.
Um die Ketten aus Vorlagen zu erstellen, öffnen Sie die Vorlage Load Data to Wdata | Primary chain und klicken Sie auf New chain.
Erstellen Sie eine Kette zum Herunterladen von Daten aus Watershed
Erstellen Sie schließlich eine Kette zum Herunterladen und Importieren von Carbon Footprint-Daten aus Watershed.
Hinweis: Erstellen Sie die beiden anderen Ketten vor dieser, für ihre Kette Ereignisse ausführen.
Schritt 1. Die Kette erstellen
- Klicken Sie unter Chains auf Create, und wählen Sie Create chain.
- Geben Sie unter Setup einen Namen für
ein. 1. Watershedund eine Beschreibung zur weiteren Identifizierung der Kette. - Fügen Sie unter Variablen Variablen für den Watershed-API-Schlüssel und die IDs des Watershed-Arbeitsblatts und seines Kontrollblatts hinzu.
Name Wert APIKey Geben Sie den Watershed-API-Schlüssel ein. TabellenkalkulationID Geben Sie die ID des Wassereinzugsgebiets-Tabellenblatts ein. BlattID Geben Sie die ID des Kontrollblatts des Tabellenblatts "Watershed" ein. - Klicken Sie auf Speichern.
Schritt 2. Beginnen Sie mit einem Workiva Get Sheet Data Befehl
Beginnen Sie mit einem Workiva Get sheet data Befehl, um die herunterzuladenden Daten zu identifizieren, basierend auf dem Zeitraum im Watershed Spreadsheet Control sheet:
- Wählen Sie aus Verfügbare Konnektoren Workiva und verschieben Sie Blattdaten abrufen zu Start.
- Wählen Sie den Befehl Blattdaten abrufen, und klicken Sie auf Bearbeiten.
- Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
- Geben Sie die Eigenschaften des Befehls ein, und klicken Sie auf Speichern:
Eigenschaft Wert Konnektor Wählen Sie den zu verwendenden Workiva-Anschluss. Arbeitsblatt-ID Wählen Sie die Kettenvariable Spreadsheet ID. Blatt-ID/Name Wählen Sie die Kettenvariable Blatt-ID. Region Geben Sie A11 ein:.Wertstil Wählen Sie Berechnet. Überarbeitung Um die neueste Version zu erhalten, geben Sie -1ein.
Schritt 3. Hinzufügen von Befehlen zur Vorbereitung des Zeitraums für Watershed
Um den Zeitraum für Watershed zu ermitteln, fügen Sie die Befehle Erweiterte Abfrage und CSV zu JSON hinzu:
- Wählen Sie unter Verfügbare Konnektoren, wählen Sie Tabellarische Transformation, und verschieben Sie Erweiterte Abfrage auf die Leinwand.
- Ziehen Sie einen Link von Blattdaten abrufen auf Erweiterte Abfrage.
- Wählen Sie den Befehl Erweiterte Abfrage, und klicken Sie auf Bearbeiten.
- Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
- Geben Sie die Eigenschaften des Befehls ein, und klicken Sie auf Speichern:
Eigenschaft Wert Konnektor Wählen Sie den zu verwendenden Tabellentransformations-Connector aus. Tabellen Fügen Sie die Tabelle für die Daten des Zeitraums hinzu: - Wählen Sie unter File die Ausgabe Data des Befehls Get sheet data.
- Geben Sie in Tabellenname
aein.
Abfrage Geben Sie die Abfrage ein, die ausgeführt werden soll: select case wenn `Start Monat` = 'Januar' dann '01' wenn `Start Monat` = 'Februar' dann '02' wenn `Start Monat` = 'März' dann '03' wenn `Start Monat` = 'April' dann '04' wenn `Start Monat` = 'Mai' dann '05' wenn `Start Monat` = 'Juni' dann '06' wenn `Anfangsmonat` = 'Juli' dann '07' wenn `Anfangsmonat` = 'August' dann '08' wenn `Anfangsmonat` = 'September' dann '09' wenn `Anfangsmonat` = 'Oktober' dann '10' wenn `Anfangsmonat` = 'November' dann '11' sonst '12' end as 'sm', case wenn `Ende Monat` = 'Januar' dann '01' wenn `Ende Monat` = 'Februar' dann '02' wenn `Ende Monat` = 'März' dann '03' wenn `Ende Monat` = 'April' dann '04' wenn `Ende Monat` = 'Mai' dann '05' wenn `Ende Monat` = 'Juni' dann '06' wenn `Ende Monat` = 'Juli' dann '07' wenn `Ende Monat` = 'August' dann '08' wenn `Ende Monat` = 'September' dann '09' wenn `Ende Monat` = 'Oktober' dann '10' wenn `Ende Monat` = 'November' dann '11' sonst '12' Ende als 'em', Berichtsjahr` als 'ry', TableId als 'tid' from a
Eingabebegrenzer Wählen Sie Komma. Begrenzungszeichen für die Ausgabe Wählen Sie Komma. Vorschau der Ergebnisse Aktivieren Sie dieses Kontrollkästchen. - Wählen Sie unter Verfügbare Verbindungen, wählen Sie JSON, und verschieben Sie CSV to JSON auf die Leinwand.
- Ziehen Sie einen Link von Erweiterte Abfrage zu CSV zu JSON.
- Wählen Sie den Befehl CSV to JSON und klicken Sie auf Bearbeiten.
- Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
- Geben Sie die Eigenschaften des Befehls ein, und klicken Sie auf Speichern:
Eigenschaft Wert Konnektor Wählen Sie den zu verwendenden JSON-Konnektor aus. Eingabedatei Wählen Sie die Ausgabe Ergebnis des Befehls Erweiterte Abfrage. Trennzeichen Wählen Sie Komma (,).
Schritt 4. Hinzufügen eines HTTP-Request GET-Befehls
Um Carbon Footprint-Daten für den ausgewählten Zeitraum herunterzuladen, fügen Sie einen HTTP-Request GET Befehl hinzu:
- Wählen Sie aus Verfügbare Verbindungen, wählen Sie HTTP-Anfrage, und verschieben Sie GET auf die Leinwand.
- Ziehen Sie einen Link von CSV zu JSON zu GET.
- Wählen Sie den Befehl GET und klicken Sie auf Bearbeiten.
- Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um den Befehl zu identifizieren.
- Geben Sie die Eigenschaften des Befehls ein, und klicken Sie auf Speichern:
Eigenschaft Wert Konnektor Wählen Sie den zu verwendenden HTTP-Anfrage-Connector. Antwort anzeigen Aktivieren Sie dieses Kontrollkästchen. URL Geben Sie https://api.watershedclimate.com/v1/report/footprint_detailein.Abfrage-Zeichenfolge Geben Sie die Abfragezeichenfolge ein, um den Anfangs- und Endmonat der herunterzuladenden Daten anzugeben: - Geben Sie für den Startmonat
startMonth=ein, und wählen Sie zweimal die JSON-Datei aus, die mit dem Befehl CSV to JSON ausgegeben wurde. - Geben Sie dann für den Endmonat
&endMonth=ein, und wählen Sie die JSON-Datei aus, die mit dem Befehl CSV to JSON zweimal ausgegeben wurde. - Klicken Sie für beide Monate auf die erste JSON-Datei Ausgabe, und wenden Sie eine Get variable from JSON Transformation an:
- Wählen Sie unter Output die Option Text.
- In Wert,
0undryeingeben.
- Klicken Sie für beide Monate auf die zweite JSON-Datei Ausgabe, und wenden Sie eine weitere Get variable from JSON Transformation an:
- Wählen Sie unter Output die Option Text.
- In Wert,
0undsmeingeben.
Kopfzeilen Fügen Sie eine Kopfzeile hinzu: - Geben Sie unter Schlüssel,
Berechtigungein. - Geben Sie in Wert,
Inhaberein und wählen Sie dann die Kettenvariable APIKey.
Inhaltstyp Geben Sie application/jsonein. - Geben Sie für den Startmonat
Schritt 5. Fügen Sie Ereignisse der Ausführungskette hinzu, um den Daten-Upload durchzuführen und zu protokollieren
Um die Daten in Wdata hochzuladen und den Upload im Abschnitt Control sheet zu protokollieren, fügen Sie Run chain Ereignisse für die zuvor erstellten Ketten hinzu:
- Verschieben Sie Kette ausführen aus Kettenereignisse in den Hauptbereich.
- Ziehen Sie einen Link aus HOLEN nach Kette ausführen.
- Wählen Sie das Ereignis Run chain aus, und klicken Sie auf Edit.
- Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um zu verdeutlichen, dass das Ereignis die Daten in Wdata hochlädt.
- Wählen Sie unter Chain to run Load Data to Wdata | Primary chain, die zuvor aus der Vorlage Load Data to Wdata erstellt wurde.
- Geben Sie die Eingaben zur Kettenlaufzeit ein und klicken Sie auf Speichern:
Eingabe Wert Tabellen-ID: Zur Angabe der ID der Wdata-Tabelle, in die die Daten hochgeladen werden sollen: - Wählen Sie die JSON-Datei aus, die mit dem Befehl CSV zu JSON ausgegeben wurde.
- Klicken Sie auf die Ausgabe der JSON-Datei und wenden Sie eine Get variable from JSON Transformation an:
- Wählen Sie unter Output die Option Text.
- In Wert,
0undtideingeben.
Präfix der Datei Zur Festlegung des Präfixes des hochzuladenden Datensatzes, basierend auf dem Zeitraum der Daten: - Wählen Sie für den Startmonat die JSON-Datei zweimal aus, die mit dem Befehl CSV zu JSON ausgegeben wurde.
- Geben Sie einen Unterstrich ein (
_). - Wählen Sie für den Endmonat die Ausgabe JSON-Datei des Befehls CSV to JSON zwei weitere Male aus.
- Geben Sie
.csvein. - Klicken Sie für beide Monate auf die erste Ausgabe der JSON-Datei und wenden Sie die Transformation Get variable from JSON an:
- Wählen Sie unter Output die Option Text.
- In Wert,
0undryeingeben.
- Klicken Sie für beide Monate auf die zweite Ausgabe der JSON-Datei und wenden Sie eine weitere Transformation Variable von JSON beziehen an:
- Wählen Sie unter Output die Option Text.
- In Wert,
0undsmeingeben.
Datendatei Wählen Sie die Ausgabe Antwort des Befehls HOLEN. Methode laden Wählen Sie Datensatz ersetzen. Rollback Aktivieren Sie dieses Kontrollkästchen. - Verschieben Sie von Kettenereignisse eine weitere Laufkette auf die Leinwand.
- Ziehen Sie ein Glied von der ersten Laufkette zur zweiten.
- Wählen Sie das zweite Ereignis Kette ausführen und klicken Sie auf Bearbeiten.
- Geben Sie unter Basic info einen Namen und eine Beschreibung ein, um zu verdeutlichen, dass das Ereignis das Hochladen von Daten in die Watershed-Tabelle protokolliert.
- In Chain to run, wählen Sie die 3. Watershed-Kette zuvor erstellt.
- Geben Sie die Eingaben zur Kettenlaufzeit ein und klicken Sie auf Speichern:
Eingabe Wert Bereich Geben Sie F12:F12ein.Arbeitsblatt-ID Wählen Sie die Kettenvariable SpreadsheetID aus. Blatt-ID Wählen Sie die Kettenvariable SheetID aus. - Klicken Sie auf Veröffentlichen, geben Sie eventuelle Anmerkungen zur Veröffentlichung ein und klicken Sie auf Veröffentlichen.
Die Ketten ausführen
Aktualisierung der Tabelle Watershed mit den neuesten Daten zum Kohlenstoff-Fußabdruck:
- Wählen Sie im Abschnitt Kontrollblatt des Tabellenblatts Watershed den Zeitraum - Monate und Jahr - der Daten aus, die von Watershed heruntergeladen werden sollen.
- Wählen Sie unter Wdata Chains die Seite 1. Watershed und klicken Sie auf Execute und Run chain.
Hinweis: Wenn Sie diese Kette ausführen, werden automatisch die beiden anderen Ketten ausgeführt, um die Tabelle Wdata und das Arbeitsblatt Watershed mit den Daten zu aktualisieren.