Unter Chain Builder können Sie diese Kettenvorlagen verwenden, die zusammen die Weitergabe von Umwelt-, Sozial- und Governance- (ESG) oder Nachhaltigkeitsdaten vereinfachen:
- 1a. ESG-Rollforward | Primär | Hier starten
- 1b. ESG-Rollforward | Verbindungen und Status aktualisieren
- 1c. ESG-Rollforward | Verbindung aktualisieren | Ausführung
Tipp: Während Sie drei Ketten aus diesen Vorlagen erstellen, führen Sie nur die erste erstellte Kette aus, wodurch alle automatisch ausgeführt werden.
Hinweis: Diese Ketten rollen nur Datenerfassungsblätter vorwärts - nicht ein Nachhaltigkeitsprogramm. Wie Sie die Werte in einem Programm fortschreiben können, erfahren Sie unter Fortschreiben und Verwalten von Berichtsjahren im Nachhaltigkeitsprogramm.
Wenn Sie Ketten ausführen, die aus diesen Vorlagen erstellt wurden, arbeiten sie zusammen, um den Datensatz des Vorjahres automatisch zu archivieren und in eine Tabelle zu importieren. Wenn Sie die Ketten ausführen, können Sie auch Folgendes auswählen:
- Aktualisierung der Verbindungen der Quellkalkulationstabelle vor dem Importieren des Datensatzes, um z. B. die neuesten Werte zu erhalten
- Löschen von Werten in der Quellen-Kalkulationstabelle (mit Ausnahme derjenigen, die mit Quellen oder Zielen verknüpft sind), z. B. zur Vorbereitung der Datenerhebung für das nächste Jahr
Hinweis: Diese Ketten ersetzen automatisch jeden Datensatz aus demselben Zeitraum in der verbundenen Wdata-Tabelle. Wenn beim Importieren des neuen Datensatzes ein Fehler auftritt, wird die Tabelle auf den vorherigen Datensatz zurückgesetzt.
Voraussetzungen
Ketten, die aus diesen Vorlagen erstellt werden, benötigen bestimmte Konnektoren, um ihre Befehle auszuführen.
Bevor Sie Ketten aus diesen Vorlagen erstellen, richten Sie diese Konnektoren im Ketten-Generator ein:
- Workiva Konnektor
- Workiva-Ketten Konnektor
- Tabellen-Transformation Konnektor
- JSON Konnektor
- Handlebars Konnektor
- Dateidienstprogramm Konnektor
- HTTP-Anfrage Konnektor
Hinweis: Alle in den Ketten dieser Vorlagen verwendeten Konnektoren verwenden den Standard-CloudRunner. Es werden keine GroundRunners benötigt.
Hinweis: Um seine Befehle auszuführen, benötigt der HTTP Request Connector die Client ID und das Geheimnis des OAuth Grant, das für den Integrationsbenutzer des Workiva Connectors erstellt wurde. Stellen Sie sicher, dass der OAuth Grant den richtigen Umfang hat.
Schritt 1. Einrichten der Workiva-Dateien
Ketten, die auf der Grundlage dieser Vorlagen erstellt werden, erfordern eine spezielle Einrichtung von Workiva-Dateien für Nachhaltigkeitsdaten. Bevor Sie die Ketten dieser Vorlagen ausführen, richten Sie die Workiva-Dateien zum Sammeln und Weiterleiten von Daten ein:
- Geben Sie unter Tabellenkalkulationen das für die Nachhaltigkeitsberichterstattung verwendete Datenerfassungsblatt an.
- Klicken Sie in Wdata auf eine Tabelle erstellen, die das Arbeitsblatt als verbundenes Dataset verwendet, und notieren Sie die ID der Tabelle, wenn Sie die Ketten ausführen.
- Im Arbeitsblatt müssen Sie ein Blatt hinzufügen, um den Aktualisierungsstatus der ausgehenden Verbindung zur Tabelle Wdata zu verfolgen, und notieren Sie den Namen des Blattes, wenn Sie die Ketten ausführen.
- Erstellen Sie eine Abfrage, die ausgeführt wird, wenn die Ketten Daten archivieren:
- Verwenden Sie die Tabelle Wdata, die mit dem Arbeitsblatt für die Datenerfassung verbunden ist, als Datenquelle.
- Fügen Sie in der Abfrage einen Mehrfachauswahl-Parameter für Jahr hinzu, der denselben Datentyp hat wie die Spalte Jahr der Tabelle.
- Notieren Sie die ID der Abfrage, wenn Sie die Ketten ausführen.
Schritt 2. Werte für Variablen und Laufzeiteingaben festlegen
Damit die Ketten mit mehreren Arbeitsbereichen arbeiten können, verwenden sie Variablen, um Integrationsbenutzende und die Umgebungen für den Workiva-Konnektor zu identifizieren. Legen Sie in Ketten-Generator diese Arbeitsbereichsvariablen an:
| Variabel | Wert |
|---|---|
| wsv-ClientID | Die Client-ID des OAuth2-Grants, der für den Workiva-Integrationsbenutzer erstellt wurde |
| wsv-ClientSecret | Das Client-Geheimnis, das für die für den Integrationsbenutzer erstellte OAuth2-Erlaubnis generiert wurde |
| wsv-BaseURL-Wdata | Die URL-Host-Basis und der Basispfad für die Wdata-Befehle, basierend auf der Region der Umgebung:
|
| wsv-BaseURL-IAM | Die URL-Hostbasis und der Basispfad für die Identitäts- und Zugriffsmanagement-Befehle, basierend auf der Region der Umgebung:
|
| wsv-BaseURL-OC | Die URL-Host-Basis und der Basispfad für die Ketten-Befehle, basierend auf der Region der Umgebung:
|
Wenn Sie die von erstellte Kette ausführen 1a. Die Vorlage ESG-Rollforward | Primär | Hier starten wird nach Laufzeit-Eingaben gefragt, um die Workiva-Dateien zu identifizieren, mit denen interagiert werden soll und wie der Datensatz identifiziert werden soll:
| Laufzeit-Eingabe | Wert |
|---|---|
| Datenerhebung – Rollforward-Tabellen-ID | Die ID der Wdata-Tabelle, die mit dem Spreadsheet für die Datenerfassung verbunden ist, in die der Datensatz importiert werden soll |
| Datenerhebung — Rollforward-Abfrage-ID | Die ID der Wdata-Abfrage, die zur Archivierung der Daten ausgeführt werden soll |
| PY-Jahr | Das Jahr der zu archivierenden Daten |
| Tag-Wert | Der Name für den archivierten Datensatz Hinweis: Die Ketten verwenden die Eingabe Tag-Wert mit der Eingabe PY-Jahr, um den Dateinamen des Datensatzes zu erstellen, als |
| Status — BlattName | Der Name des Blattes, in dem der Aktualisierungsstatus der ausgehenden Verbindung des Arbeitsblatts zur Tabelle Wdata verfolgt wird |
Schritt 3. Erstellen Sie die Ketten
Um die Ketten zu erstellen, die für die fortlaufende Datenerfassung benötigt werden, verwenden Sie die 1a. ESG-Rollforward | Primär | Hier starten Vorlage:
- Über Vorlagen in Ketten-Generator, öffnen Sie die Vorlage 1a. ESG-Rollforward | Primär | Hier starten , und klicken Sie auf Neue Kette.
- Geben Sie einen Namen ein, um die Kette zu identifizieren.
- Wählen Sie die Umgebung aus, in der die Kette verwendet werden soll, und klicken Sie auf Weiter.
- Geben Sie für die Variable dcv-clearSuccess den Namen
dvc-clearSuccessein, und klicken Sie auf Weiter. - Wählen Sie für jede Verbindung den zu verwendenden Anschluss aus, und klicken Sie auf Nächste Kette.
Hinweis: Verwenden Sie für jeden Anschluss den Standard-CloudRunner.
- Legen Sie jede Variable fest und klicken Sie auf Weiter.
Variabel Variabel-Typ Neue Variable wsv-ClientID Arbeitsbereich Wählen Sie wsv-ClientID. cv-TimeToCheck Kette cv-TimeToCheckwsv-ClientSecret Arbeitsbereich Wählen Sie wsv-ClientSecret. dcv-RefreshStatus Dynamik der Kette dcv-RefreshStatuswsv-BaseURL-IAM Arbeitsbereich Wählen Sie wsv-BaseURL-IAM. wsv-BaseURL-OC Arbeitsbereich Wählen Sie wsv-BaseURL-OC. - Wählen Sie für jede Verbindung den zu verwendenden Anschluss aus, und klicken Sie auf Nächste Kette.
Hinweis: Verwenden Sie für jeden Anschluss den Standard-CloudRunner.
- Legen Sie jede Variable fest und klicken Sie auf Weiter.
Variabel Variabel-Typ Neue Variable dcv-srcStatus Dynamik der Kette dcv-srcStatuswsv-ClientID Arbeitsbereich Wählen Sie wsv-ClientID. dcv-destStatus Dynamik der Kette dcv-destStatuswsv-ClientSecret Arbeitsbereich Wählen Sie wsv-ClientSecret. wsv-BaseURL-Wdata Arbeitsbereich Wählen Sie wsv-BaseURL-Wdata. wsv-BaseURL-IAM Arbeitsbereich Wählen Sie wsv-BaseURL-IAM. - Wählen Sie für jede Verbindung den zu verwendenden Konnektor aus, und klicken Sie auf Senden.
Hinweis: Verwenden Sie für jeden Anschluss den Standard-CloudRunner.
Schritt 4. Veröffentlichen Sie die Ketten
Hinweis: Um die Installation zu erleichtern, verfügt die Vorlage Verbindungen und Status aktualisieren über das Ereignis Kette ausführen. Bevor Sie die aus den Vorlagen erstellten Ketten veröffentlichen, löschen Sie dieses überflüssige Ereignis Kette ausführen.
- Wählen Sie unter Ketten für die Kette, die mit der Vorlage Verbindungen und Status aktualisieren erstellt wurde: Bearbeiten.
- Wählen Sie das Ereignis Kette ausführen - Löschen und klicken Sie auf Löschen und Löschen.
- Klicken Sie auf Veröffentlichen und Veröffentlichen.
- Wählen Sie unter Chains für die Kette, die aus der Vorlage Primär erstellt wurde, Bearbeiten.
- Klicken Sie auf Veröffentlichen und Veröffentlichen.
- Wählen Sie unter Ketten für die Kette, die aus der Vorlage Ausführung erstellt wurde, Bearbeiten.
- Klicken Sie auf Veröffentlichen und Veröffentlichen.
Die Ketten ausführen
Zur Archivierung Ihrer Daten und zur Vorbereitung der Datenerhebung im nächsten Jahr:
- In Ketten-Generator, in Ketten, wählen Sie Ausführen für die Kette erstellt aus 1a.ESG-Rollforward | Primär | Hier starten Vorlage.
- Klicken Sie auf Ausführen mit Eingaben und geben Sie die Laufzeit-Eingaben ein:
Laufzeit-Eingabe Wert Datenerhebung – Rollforward-Tabellen-ID Geben Sie die ID der Wdata-Tabelle ein, in die der Datensatz importiert werden soll. Datenerhebung — Rollforward-Abfrage-ID Geben Sie die ID der Abfrage ein, die zur Archivierung der Daten ausgeführt werden soll. PY-Jahr Geben Sie das Jahr der zu archivierenden Daten ein. Tag-Wert Geben Sie den Namen für den archivierten Datensatz ein. Hinweis: Mit der Eingabe PY Jahr wird der Dateiname des Datensatzes als
[Tag-Wert]_[PY-Jahr].csverstellt. Ein PY-Jahr von 2021 und Tag-Wert von Archiviert erzeugt zum Beispiel den DateinamenArchiviert_2021.csv.Aktualisieren von Blattverbindungen vor der Datenarchivierung Legen Sie fest, ob die ausgehenden Verbindungen des Arbeitsblatts zur Tabelle Wdata aktualisiert werden sollen, bevor die Rollforward-Abfrage ausgeführt wird, z. B. um den Datensatz vor der Archivierung zu aktualisieren. Status — BlattName Geben Sie den Namen des Blattes ein, das den Aktualisierungsstatus der ausgehenden Verbindungen vom Arbeitsblatt zur Tabelle Wdata verfolgt. AusführungAktualisieren — KettenName Geben Sie den Namen der Kette ein, die aus der Vorlage ESG-Rollforward | Ausführung aktualisieren | Ausführung erstellt wurde. Tabellenkalkulationswert-Spalte löschen Legen Sie fest, ob die Eingabewerte im Rahmen des Rollforwards aus der Kalkulationstabelle gelöscht werden sollen. Hinweis: Es werden keine Werte mit einem Quell- oder Ziellink gelöscht.
- Um die aktuellsten Werte vor dem Import des Datensatzes sicherzustellen, wählen Sie Verbindungen vor der Datenarchivierung aktualisieren.
Wenn Sie diese Option wählen, aktualisieren die Ketten die ausgehenden Verbindungen des Spreadsheets und verfolgen deren Aktualisierungsstatus in einem Kontrollblatt:- Geben Sie unter Status — Blattname den Namen des Blattes im Quell-Arbeitsblatt ein, in dem die Ketten den Aktualisierungsstatus der ausgehenden Verbindungen speichern können.
- Geben Sie unter AusführungAktualisieren — KettenName den Namen der Kette ein, die aus der Vorlage ESG Rollforward | Ausführung aktualisieren | Ausführung erstellt wurde.
Tipp: Die Aktualisierung kann je nach Anzahl der ausgehenden Verbindungen der Tabellenkalkulation bis zu einige Minuten dauern. Um die Wartezeit anzupassen, bearbeiten Sie das Ereignis Kette pausieren der Kette, die aus 1b erstellt wurde. ESG-Rollforward | Verbindungen und Status aktualiseren Vorlage.
- Um Eingabewerte aus der Quellkalkulationstabelle als Teil der Archivierung zu löschen, z. B. zur Vorbereitung der Datenerfassung für das nächste Jahr, wählen Sie Tabellenkalkulationswert-Spalte löschen.
Hinweis: Die Kette behält alle mit einer Quelle oder einem Ziel verbundenen Werte bei. Aus dem Arbeitsblatt gelöschte Werte können nicht wiederhergestellt werden. Wir empfehlen, diese Option nur für den letzten Rollforward des Jahres zu wählen, um die Kalkulationstabelle für die Datenerhebung des nächsten Jahres vorzubereiten.
Tipp: Standardmäßig löscht die Kette Werte, die in Zeile 2 der Tabellenblätter beginnen. Um dies anzupassen, bearbeiten Sie die Eigenschaft Region des Befehls Blattdaten löschen.
- Klicken Sie auf Start.