Workiva-ondersteuningscentrum

Via Chain Builder kunt u deze ketensjablonen gebruiken, die samen de implementatie van ESG- of duurzaamheidsgegevens vereenvoudigen:

• 1a. ESG doorrollen | Primair | Begin hier
• 1b. ESG doorrollen | Verbindingen en status vernieuwen
• 1c. ESG doorrollen | Verbinding vernieuwen | Uitvoering

Tip: Hoewel u drie ketens maakt van deze sjablonen, voert u alleen de eerste gemaakte keten uit, die ze automatisch allemaal uitvoert.

Opmerking: Deze ketens rollen alleen gegevensverzamelspreadsheets door - niet een Duurzaamheidsprogramma. Om te leren hoe u waarden in een programma kunt doorrollen, raadpleegt u Rapportagejaren doorrollen en beheren in Duurzaamheidsprogramma.

Wanneer u ketens uitvoert die vanuit deze sjablonen zijn gemaakt, werken ze samen om automatisch de dataset van het vorige jaar te archiveren en in een tabel te importeren. Wanneer u de kettingen uitvoert, kunt u ook kiezen om:

• Vernieuw de verbindingen van de bronspreadsheet voordat u de dataset importeert, bijvoorbeeld om ervoor te zorgen dat de laatste waarden
• Waarden in de bronspreadsheet wissen (behalve de waarden die gekoppeld zijn aan bronnen of bestemmingen), bijvoorbeeld om de gegevensverzameling van het volgende jaar voor te bereiden

Opmerking: Deze ketens vervangen automatisch elke dataset uit dezelfde periode in de gekoppelde Wdatatabel. Als er een fout optreedt bij het importeren van de nieuwe dataset, keert de tabel terug naar de vorige dataset.

Vereisten

Ketens die vanuit deze sjablonen worden aangemaakt, hebben specifieke connectors nodig om hun opdrachten uit te voeren.

Voordat u ketens maakt van deze sjablonen, moet u deze connectoren instellen in Chain Builder:

• Workiva connector
• Workiva kettingen connector
• Tabulaire transformatie connector
• JSON connector
• Stuur connector
• Bestandshulpprogramma's connector
• HTTP-aanvraag connector

Opmerking: Alle connectors die in de ketens van deze sjablonen worden gebruikt, gebruiken de standaard CloudRunner. Er zijn geen GroundRunners nodig.

Opmerking: Om zijn opdrachten uit te voeren, heeft de HTTP Request-connector de client-ID en het geheim nodig van de OAuth-subsidie die is aangemaakt voor de Workiva-connector integratiegebruiker. Zorg ervoor dat de OAuth-subsidie het juiste bereik heeft.

Stap 1. De Workiva-bestanden instellen

Ketens die aangemaakt zijn met deze sjablonen vereisen een specifieke opzet van Workiva-bestanden voor duurzaamheidsgegevens. Voordat u de ketens van deze sjablonen uitvoert, moet u de Workiva-bestanden instellen om gegevens te verzamelen en door te rollen:

1. Identificeer in Spreadsheets het gegevensverzamelingsblad dat gebruikt wordt voor duurzaamheidsrapportage.
2. Maak in Wdata een tabel die de Spreadsheet gebruikt als een gekoppelde dataset, en leg de ID van de tabel vast voor wanneer u de ketens uitvoert.
3. Voeg in het werkblad een blad toe om de verversingsstatus van de uitgaande verbinding met de tabel Wdata bij te houden, en noteer de naam van het blad voor wanneer u de ketens uitvoert. 
4. Maak een query om uit te voeren wanneer de ketens gegevens archiveren:
   • Gebruik de Wdata-tabel die is verbonden met de gegevensverzamelspreadsheet als een gegevensbron.
   • Neem in de query een multi-select parameter op voor Jaar, met hetzelfde gegevenstype als de kolom Jaar van de tabel.
   • Noteer de ID van de query voor wanneer u de ketens uitvoert.

Stap 2. Waarden voor variabelen en runtime-invoer bepalen

Om de ketens in staat te stellen met meerdere werkruimten te werken, gebruiken ze variabelen om de integratiegebruiker en omgevingen voor de Workiva-connector te identificeren. In Chain Builder, maakt u deze werkruimtevariabelen:

Wanneer u de ketting uitvoert die is aangemaakt op 1a. ESG roll forward | Primary | Start here sjabloon, wordt er gevraagd om runtime invoer om de Workiva bestanden te identificeren waarmee moet worden geinterageerd en hoe de dataset moet worden geïdentificeerd:

Stap 3. Maak de kettingen

Om de ketens aan te maken die nodig zijn om de gegevensverzameling vooruit te spoelen, gebruikt u 1a. ESG roll forward | Primair | Begin hier sjabloon:

1. Van Templates in Chain Builder, open de 1a. ESG roll forward | Primair | Begin hier sjabloon, en klik op Nieuwe keten.
2. Voer een naam in om de ketting te identificeren.
   
3. Selecteer de omgeving waarin u de ketting wilt gebruiken en klik op Volgende.
4. Voer voor de variabele dcv-clearSuccess de naam dvc-clearSuccess in en klik op Next.
   
5. Selecteer voor elke verbinding de connector die u wilt gebruiken en klik op Volgende keten.

   Opmerking: Gebruik voor elke connector de standaard CloudRunner.

   
6. Stel elke variabele in en klik op Volgende.
   
   

   Variabel	Variabel type	Nieuwe variabele
   wsv-ClientID	Werkruimte	Selecteer wsv-ClientID.
   cv-TimeToCheck	Ketting	cv-TimeToCheck
   wsv-ClientSecret	Werkruimte	Selecteer wsv-ClientSecret.
   dcv-RefreshStatus	Ketting dynamisch	dcv-RefreshStatus
   wsv-BaseURL-IAM	Werkruimte	Selecteer wsv-BaseURL-IAM.
   wsv-BaseURL-OC	Werkruimte	Selecteer wsv-BaseURL-OC.

7. Selecteer voor elke verbinding de connector die u wilt gebruiken en klik op Volgende keten.

   Opmerking: Gebruik voor elke connector de standaard CloudRunner.

8. Stel elke variabele in en klik op Volgende.
   

   Variabel	Variabel type	Nieuwe variabele
   dcv-srcStatus	Ketting dynamisch	dcv-srcStatus
   wsv-ClientID	Werkruimte	Selecteer wsv-ClientID.
   dcv-destStatus	Ketting dynamisch	dcv-destStatus
   wsv-ClientSecret	Werkruimte	Selecteer wsv-ClientSecret.
   wsv-BaseURL-Wdata	Werkruimte	Selecteer wsv-BaseURL-Wdata.
   wsv-BaseURL-IAM	Werkruimte	Selecteer wsv-BaseURL-IAM.

9. Selecteer voor elke verbinding de connector die u wilt gebruiken en klik op Submit.

   Opmerking: Gebruik voor elke connector de standaard CloudRunner.

Stap 4. De ketens publiceren

Opmerking: Om de installatie te vergemakkelijken, heeft de sjabloon Verbindingen en status vernieuwen een gebeurtenis Keten uitvoeren. Voordat u de ketens publiceert die van de sjablonen zijn gemaakt, verwijdert u deze vreemde Run chain gebeurtenis.

1. Ga naar Ketens, voor de keten die is gemaakt vanuit de sjabloon Verbindingen en status vernieuwen en selecteer Bewerken.
   
2. Selecteer de gebeurtenis Uitvoerketen - verwijderen en klik op verwijderen en verwijderen.
   
3. Klik op Publiceer en Publiceer.
4. Selecteer op Ketens voor de keten die is gemaakt van de sjabloon Primary Edit.
5. Klik op Publiceer en Publiceer.
6. Ga naar Ketens en selecteer Bewerken voor de keten die is gemaakt van de sjabloon Uitvoering.
7. Klik op Publiceer en Publiceer.

Laat de kettingen lopen

Uw gegevens archiveren en voorbereiden op de gegevensverzameling van het volgende jaar:

1. In Chain Builder, op Chains, selecteert u Execute voor de keten die is aangemaakt op 1a.ESG roll forward | Primair | Begin hier sjabloon.
   
2. Klik op Uitvoeren met invoer, en voer de runtime-invoer in:
   
   

   Runtime invoer	Waarde
   Gegevensverzameling-Roll forward tabel ID	Voer het ID in van de Wdatatabel waarin u de dataset wilt importeren.
   Gegevensverzameling-Roll forward query ID	Voer de ID in van de query die moet worden uitgevoerd om gegevens te archiveren.
   PY jaar	Voer het jaar van de te archiveren gegevens in.
   Tag-waarde	Voer de naam voor de gearchiveerde dataset in. Opmerking: Met de PY year input creëert deze input de bestandsnaam van de dataset als [Tag value]_[PY year].csv. Bijvoorbeeld, een PY-jaar van 2021 en Tag-waarde van Gearchiveerd creëert de bestandsnaam Archived_2021.csv.
   Bladaansluitingen verversen voor gegevensarchivering	Selecteer of de uitgaande verbindingen van de Spreadsheet met de Wdatatabel ververst moeten worden voordat de roll forward query wordt uitgevoerd, bijvoorbeeld om de dataset bij te werken voordat er wordt gearchiveerd.
   Status-BladNaam	Voer de naam in van het blad dat de verversingsstatus bijhoudt van de uitgaande verbindingen van het Spreadsheet naar de Wdatatabel.
   RefreshExecution-ChainName	Voer de naam in van de keten die is aangemaakt vanuit de sjabloon ESG Rollforward | Verbinding vernieuwen | Uitvoering.
   Wis de kolom Waarde van het werkblad	Selecteer of de invoerwaarden uit de spreadsheet moeten worden verwijderd als onderdeel van het doorrollen. Opmerking: Geen waarden met een bron- of bestemmingslink worden verwijderd.

3. Om zeker te zijn van de meest recente waarden voordat u de dataset importeert, selecteert u Verbindingen verversen voordat gegevens worden gearchiveerd.
   
   Als u deze optie selecteert, verversen de ketens de uitgaande verbindingen van het werkblad en houden ze hun verversingsstatus bij in een controleblad:
   • Voer in Status-SheetName de naam in van het blad in de bronspreadsheet waar de ketens de verversingsstatus van de uitgaande verbindingen kunnen opslaan.
   • Voer in RefreshExecution-ChainName de naam in van de keten die is aangemaakt vanuit de sjabloon ESG Rollforward | Refresh connection | Execution.

   Tip: Het verversen kan enkele minuten duren, afhankelijk van het aantal uitgaande verbindingen van de Spreadsheet. Om de wachttijd aan te passen, bewerkt u de gebeurtenis Pauzeketting van de keten die is gemaakt van de 1b. ESG roll forward | Verbindingen en status vernieuwen sjabloon.

4. Om invoerwaarden uit de bronspreadsheet te verwijderen als onderdeel van het archief, bijvoorbeeld om de gegevensverzameling van het volgende jaar voor te bereiden, selecteert u Wis spreadsheetwaardekolom.
   
   

   Opmerking: De ketting behoudt alle waarden die aan een bron of bestemming zijn gekoppeld. U kunt geen waarden herstellen die uit de spreadsheet zijn verwijderd. Wij raden u aan deze optie alleen te selecteren voor de laatste rollforward van het jaar, om de spreadsheet voor te bereiden op de gegevensverzameling van het volgende jaar.

   Tip: Standaard verwijdert de ketting waarden vanaf rij 2 van de bladen van het werkblad. Om dit aan te passen, bewerkt u de eigenschap Regio van de opdracht Bladgegevens wissen.

5. Klik op Start.