Rulla vidare kalkylark med hållbarhetsdata med Chains

Från Chain Builder kan du använda dessa kedjemallar, som tillsammans förenklar överföringen av ESG-data (Environmental, Social and Governance) eller hållbarhetsdata:

1a. ESG roll forward | Primär | Starta här
1b. ESG roll forward | Uppdatera anslutningar och status
1c. ESG roll forward | Refresh connection | Execution

Tips: Även om du skapar tre kedjor från dessa mallar, kommer du bara att köra den första kedjan som skapats, vilket automatiskt kör alla dem.

Obs: Dessa kedjor rullar bara vidare kalkylark för datainsamling - inte ett hållbarhetsprogram. För att lära dig hur du rullar fram värden i ett program, se Roll forward and manage reporting years in Sustainability Program.

När du kör kedjor som skapats från dessa mallar arbetar de tillsammans för att automatiskt arkivera och importera föregående års dataset till en tabell. När du kör kedjorna kan du också välja att:

Uppdatera anslutningarna i källans kalkylark innan du importerar datasetet, t.ex. för att säkerställa de senaste värdena
Rensa värden i kalkylarket för källan (utom de som är länkade till källor eller mål), till exempel för att förbereda nästa års datainsamling

Obs: Dessa kedjor ersätter automatiskt alla dataset från samma period i den anslutna Wdata-tabellen. Om ett fel uppstår vid import av det nya datasetet återgår tabellen till det tidigare datasetet.

Förkunskapskrav

Kedjor som skapas från dessa mallar kräver specifika kontakter för att utföra sina kommandon.

Innan du skapar kedjor från dessa mallar måste du konfigurera dessa anslutningar i Chain Builder:

Obs: Alla connectorer som används i dessa mallars kedjor använder standard CloudRunner. Inga GroundRunners behövs.

Obs: För att utföra sina kommandon kräver HTTP Request Connector klient-ID och hemlighet för OAuth beviljandet som skapats för Workiva Connectors integrationsanvändare. Se till att OAuth-beslutet om beviljande har rätt omfattning.

Steg 1. Konfigurera Workiva-filerna

Kedjor som skapas från dessa mallar kräver en specifik inställning av Workiva-filer för hållbarhetsdata. Innan du kör dessa mallars kedjor ska du konfigurera Workiva-arkiverna för att samla in och rulla fram data:

I Kalkylark identifierar du den ark för datainsamling som används för hållbarhetsrapportering.
I Wdata, skapar du en tabell som använder kalkylarket som en ansluten dataset, och postar tabellens ID för när du kör kedjorna.
I kalkylarket, lägg till ett ark för att spåra uppdateringsstatusen för den utgående anslutningen till Wdata-tabellen och posta arkets namn för när du kör kedjorna.
Skapa en fråga som ska köras när kedjorna arkiverar data:
- Använd tabellen Wdata som är ansluten till kalkylarket för datainsamling som en datakälla.
- I frågan ingår en flervalsparameter för Year, med samma datatyp som tabellens Year kolumn.
- Posta frågans ID för att kunna använda det när du kör kedjorna.

Steg 2. Bestäm värden för variabler och ingångar för exekvering

För att kedjorna ska kunna arbeta med flera arbetsytor använder de variabler för att identifiera integrationsanvändaren och miljöerna för Workiva Connector. I Chain Builder, skapar du dessa variabler på arbetsytan:

Variabel	Värde
wsv-KlientID	Klient-ID för det OAuth2 beviljande som skapats för Workiva-integrationsanvändaren
wsv-KlientSekretess	Den klienthemlighet som genereras för det OAuth2 beviljande som skapats för integrationsanvändaren
wsv-BaseURL-Wdata	URL-värdbasen och basvägen för Wdata-kommandona, baserat på miljöns region: US: `https://h.app.wdesk.com/s/cerebral` EU: `https://h.eu.wdesk.com/s/cerebral` APAC: `https://h.apac.wdesk.com/s/cerebral`
wsv-BaseURL-IAM	Basen och sökvägen för URL-värden för kommandona för Identity and Access Management, baserat på miljöns region: US: `https://api.app.wdesk.com/iam/v1/oauth2/token` EU: `https://api.eu.wdesk.com/iam/v1/oauth2/token` APAC: `https://api.apac.wdesk.com/iam/v1/oauth2/token`
wsv-BaseURL-OC	URL-värdbasen och basvägen för kedjekommandona, baserat på miljöns region: US: `https://h.app.wdesk.com/s/wdata/oc/api/` EU: `https://h.eu.wdesk.com/s/wdata/oc/api/` APAC: `https://h.apac.wdesk.com/s/wdata/oc/api/`

När du kör kedjan som skapats från 1a. ESG roll forward | Primary | Start here mallen, uppmanas den till exekvering för att identifiera Workiva-filerna som ska interageras med och hur man identifierar datasetet:

Inmatning vid exekvering	Värde
Datainsamling-Roll forward table ID	ID för Wdata-tabellen - kopplad till datainsamlingen Kalkylark - att importera datasetet till
Datainsamling-Roll forward query ID	ID för den Wdata-fråga som ska köras för att arkivera data
PY år	Årtalet för de data som ska arkiveras
Taggvärde	Namnet på det arkiverade datasetet Obs: Kedjorna använder Taggvärde tillsammans med PY-år för att skapa datasetets filnamn, som `[Taggvärde]_[PY-år].csv`. Till exempel skapar ett PY-år 2021 och Tag-värde Arkiverad filnamnet `Arkiverad_2021.csv`.
Status-bladets namn	Namnet på arket för att spåra uppdateringsstatusen för kalkylarkets utgående anslutning till Wdata-tabellen

Steg 3. Skapa kedjorna

För att skapa de kedjor som behövs för att rulla vidare datainsamlingen, använd 1a. ESG roll forward | Primär | Börja här mall:

Från Mallar i Chain Builder, öppna 1a. ESG roll forward | Primary | Starta här mall, och klicka på Ny kedja.
Ange ett namn som hjälper till att identifiera kedjan.
Välj den miljö som ska använda kedjan och klicka på Next.
Ange namnet dvc-clearSuccess för variabeln dcv-clearSuccess och klicka på Next.
För varje anslutning väljer du den anslutning som ska användas och klickar på Nästa kedja.
Obs: Använd standard CloudRunner för varje anslutning.

Ställ in varje variabel och klicka på Next.

Variabel	Variabel typ	Ny variabel
wsv-KlientID	Arbetsyta	Välj wsv-ClientID.
cv-TidTillKontroll	Kedja	`cv-TidTillKontroll`
wsv-KlientSekretess	Arbetsyta	Välj wsv-ClientSecret.
dcv-uppdateringsstatus	Dynamisk kedja	`dcv-uppdateringsstatus`
wsv-BaseURL-IAM	Arbetsyta	Välj wsv-BaseURL-IAM.
wsv-BaseURL-OC	Arbetsyta	Välj wsv-BaseURL-OC.

För varje anslutning väljer du den anslutning som ska användas och klickar på Nästa kedja.
Obs: Använd standard CloudRunner för varje anslutning.

Ställ in varje variabel och klicka på Next.

Variabel	Variabel typ	Ny variabel
dcv-srcStatus	Dynamisk kedja	`dcv-srcStatus`
wsv-KlientID	Arbetsyta	Välj wsv-ClientID.
dcv-destStatus	Dynamisk kedja	`dcv-destStatus`
wsv-KlientSekretess	Arbetsyta	Välj wsv-ClientSecret.
wsv-BaseURL-Wdata	Arbetsyta	Välj wsv-BaseURL-Wdata.
wsv-BaseURL-IAM	Arbetsyta	Välj wsv-BaseURL-IAM.

För varje anslutning väljer du vilken anslutning som ska användas och klickar på Submit.
Obs: Använd standard CloudRunner för varje anslutning.

Steg 4. Publicera kedjorna

Obs: För att underlätta installationen har mallen Refresh connections & status en Run chain händelse. Innan du publicerar kedjorna som skapats från mallarna ska du ta bort den här ovidkommande händelsen Run chain.

På Chains väljer du Edit för den kedja som skapats från mallen Refresh connections & status.
Välj händelsen Kör kedja - Ta bort och klicka på Ta bort och Ta bort.
Klicka på Publish och Publish.
Från Chains, för den kedja som skapats från Primary mall, välj Edit.
Klicka på Publish och Publish.
På Chains, för den kedja som skapats från Execution -mallen, väljer du Edit.
Klicka på Publish och Publish.

Kör kedjorna

För att arkivera dina data och förbereda dig för nästa års datainsamling:

I Chain Builder, från Chains, välj Execute för den kedja som skapats från 1a.ESG roll forward | Primär | Börja här mall.

Klicka på Kör med indata, och ange indata för exekveringen:

Inmatning vid exekvering	Värde
Datainsamling-Roll forward table ID	Ange ID för den Wdata-tabell som datasetet ska importeras till.
Datainsamling-Roll forward query ID	Ange ID för den fråga som ska köras för att arkivera data.
PY år	Ange årtalet för de data som ska arkiveras.
Taggvärde	Ange namnet på det arkiverade datasetet. Obs: Med inmatningen PY-år skapar denna inmatning datasetets filnamn som `[Taggvärde]_[PY-år].csv`. Till exempel skapar ett PY-år 2021 och Tag-värde Arkiverad filnamnet `Arkiverad_2021.csv`.
Uppdatera anslutningar till ark före dataarkivering	Välj om kalkylarkets utgående anslutningar till tabellen Wdata ska uppdateras innan roll forward-frågan körs, t.ex. för att uppdatera datasetet före arkivering.
Status-bladets namn	Ange namnet på arket som spårar uppdateringsstatusen för de utgående anslutningarna från kalkylarket till tabellen Wdata.
RefreshExecution-ChainName	Ange namnet på den kedja som skapats från ESG Rollforward \| Uppdatera anslutning \| Exekvering mall.
Rensa kolumnen Värde i kalkylark	Välj om ingångsvärden ska raderas från kalkylarket som en del av roll forward. Obs: Inga värden med en käll- eller mållänk kommer att raderas.

För att säkerställa de senaste värdena innan du importerar datasetet väljer du Uppdatera anslutningar före dataarkivering.

Om du väljer det här alternativet uppdaterar kedjorna kalkylarkets utgående anslutningar och spårar deras uppdateringsstatus i en kontrollark:
- I Status-SheetName anger du namnet på arket i källkalkylarket där kedjorna kan spara uppdateringsstatusen för de utgående anslutningarna.
- I RefreshExecution-ChainName anger du namnet på den kedja som skapats från ESG Rollforward | Refresh connection | Execution mall.
Tips: Uppdateringen kan ta upp till några minuter, beroende på antalet utgående anslutningar i kalkylarket. För att justera väntetiden, redigera Pausa kedjan händelse i kedjan som skapats från 1b. ESG roll forward | Uppdatera anslutningar och status mall.
Om du vill ta bort indatavärden från källans kalkylark som en del av arkiveringen, t.ex. för att förbereda nästa års datainsamling, väljer du Rensa kalkylarkets värdekolumn.

Obs: Kedjan behåller alla värden som är kopplade till en källa eller ett mål. Du kan inte återställa några värden som raderats från kalkylarket. Vi rekommenderar att du väljer detta alternativ endast för årets sista rollforward, för att förbereda kalkylarket för nästa års datainsamling.

Tips: Som standard raderar kedjan värden som börjar med rad 2 i kalkylarkets ark. För att justera detta redigerar du egenskapen Region i kommandot Clear sheet data.
Klicka på Starta.

Support

Community

Workiva supportcenter