Fra Chain Builder kan du bruke disse kjedemalene, som til sammen forenkler innføringen av ESG-data (Environmental, Social and Governance) eller bærekraftsdata:
- 1a. ESG roll forward | Primær | Start her
- 1b. ESG roll forward | Oppdater tilkoblinger og status
- 1c. ESG roll forward | Refresh connection | Execution
Tips: Selv om du oppretter tre kjeder fra disse malene, kjører du bare den første kjeden som opprettes, som automatisk kjører alle.
Merk: Disse kjedene viderefører kun regneark for datainnsamling - ikke a Bærekraftsprogram. Hvis du vil lære hvordan du ruller frem verdier i et program, kan du se Rull frem og administrer rapporteringsår i Sustainability Program.
Når du kjører kjeder som er opprettet fra disse malene, fungerer de sammen slik at de automatisk arkiverer og importerer forrige års datasett til en tabell. Når du kjører kjedene, kan du også velge å:
- Oppdater kildearkets tilkoblinger før du importerer datasettet, for eksempel for å sikre at de nyeste verdiene
- Fjerne verdier i kildearket (unntatt de som er knyttet til kilder eller destinasjoner), for eksempel for å forberede neste års datainnsamling
Merk: Disse kjedene erstatter automatisk alle datasett fra samme periode i den tilkoblede Wdata-tabellen. Hvis det oppstår en feil ved import av det nye datasettet, går tabellen tilbake til det forrige datasettet.
Forutsetninger
Kjeder som opprettes fra disse malene, krever spesifikke koblinger for å utføre kommandoene.
Før du oppretter kjeder fra disse malene, må du konfigurere disse koblingene i Chain Builder:
- Workiva kontakt
- Workiva Chains kontakt
- Tabular Transformation kontakt
- JSON kontakt
- Styr kontakt
- File Utilities kontakt
- HTTP-forespørsel kontakt
Merk: Alle koblinger som brukes i disse malene, bruker standard CloudRunner. Det er ikke behov for GroundRunners.
Merk: For å utføre kommandoene krever HTTP Request-kontakten klient-ID og hemmeligheten til OAuth-tildelingen som er opprettet for Workiva-kontaktens integrasjonsbruker. Sørg for at OAuth-tildelingen har riktig omfang.
Trinn 1. Konfigurer Workiva-filene
Kjeder som opprettes fra disse malene, krever et spesifikt oppsett av Workiva-filer for bærekraftsdata. Før du kjører disse malkjedene, må du konfigurere Workiva-filene for innsamling og videreføring av data:
- Under Regneark identifiserer du datainnsamlingsarket som brukes til bærekraftsrapportering.
- I Wdata, oppretter du en tabell som bruker regnearket som et tilkoblet datasett, og registrerer tabellens ID for når du kjører kjedene.
- I regnearket legger du til et ark for å spore oppdateringsstatusen for den utgående tilkoblingen til Wdata-tabellen, og registrerer arkets navn for når du kjører kjedene.
- Opprett en spørring som skal kjøres når kjedene arkiverer data:
- Bruk Wdata-tabellen som er koblet til regnearket for datainnsamling, som en datakilde.
- I spørringen inkluderer en flervalgsparameter for Year, med samme datatype som kolonnen Year i tabellen.
- Registrer spørringens ID for når du kjører kjedene.
Trinn 2. Bestem verdier for variabler og kjøretidsinnganger
For at kjedene skal kunne arbeide med flere arbeidsområder, bruker de variabler for å identifisere integrasjonsbrukeren og miljøene for Workiva-kontakten. I Chain Builder, oppretter du disse arbeidsområdevariablene:
| Variabel | Verdi |
|---|---|
| wsv-KlientID | Klient-ID for OAuth2-tildelingen som er opprettet for Workiva-integrasjonsbrukeren |
| wsv-ClientSecret | Klienthemmeligheten som genereres for OAuth2-tildelingen som er opprettet for integrasjonsbrukeren |
| wsv-BaseURL-Wdata | URL-vertbasen og basebanen for Wdata-kommandoene, basert på miljøets region:
|
| wsv-BaseURL-IAM | URL-vertbasen og basebanen for Identity and Access Management-kommandoene, basert på miljøets region:
|
| wsv-BaseURL-OC | URL-vertbasen og basebanen for kjedekommandoene, basert på miljøets region:
|
Når du kjører kjeden som er opprettet fra 1a. ESG roll forward | Primary | Start here mal, ber den om kjøretidsinndata for å identifisere Workiva-filene som skal samhandle med, og hvordan datasettet skal identifiseres:
| Inndata ved kjøretid | Verdi |
|---|---|
| Datainnsamling-Roll forward table ID | ID-en til Wdata-tabellen - knyttet til datainnsamlingsregnearket - som datasettet skal importeres til |
| Datainnsamling-Roll forward spørring ID | ID-en til Wdata-spørringen som skal kjøres for å arkivere data |
| PY år | Årstallet for dataene som skal arkiveres |
| Taggverdi | Navnet på det arkiverte datasettet Merk: Kjedene bruker Tag value input med PY year input for å lage datasettets filnavn, som |
| Status-arknavn | Navnet på arket som sporer oppdateringsstatusen til regnearkets utgående forbindelse til Wdata-tabellen |
Trinn 3. Opprett kjedene
Bruk 1a for å opprette kjedene som trengs for å videreføre datainnsamlingen. ESG roll forward | Primary | Start here mal:
- Fra Maler i Chain Builder åpner du 1a. ESG roll forward | Primary | Start here mal, og klikk på Ny kjede.
- Skriv inn et navn for å identifisere kjeden.
- Velg miljøet som skal bruke kjeden, og klikk på Next.
- For variabelen dcv-clearSuccess skriver du inn navnet
dvc-clearSuccess, og klikker på Next. - Velg hvilken kontakt du vil bruke for hver tilkobling, og klikk på Neste kjede.
Merk: Bruk standard CloudRunner for hver kontakt.
- Konfigurer hver variabel, og klikk på Next.
Variabel Variabel type Ny variabel wsv-KlientID Arbeidsområde Velg wsv-ClientID. cv-TimeToCheck Kjede cv-TimeToCheckwsv-ClientSecret Arbeidsområde Velg wsv-ClientSecret. dcv-RefreshStatus Dynamisk kjede dcv-RefreshStatuswsv-BaseURL-IAM Arbeidsområde Velg wsv-BaseURL-IAM. wsv-BaseURL-OC Arbeidsområde Velg wsv-BaseURL-OC. - Velg hvilken kontakt du vil bruke for hver tilkobling, og klikk på Neste kjede.
Merk: Bruk standard CloudRunner for hver kontakt.
- Konfigurer hver variabel, og klikk på Next.
Variabel Variabel type Ny variabel dcv-srcStatus Dynamisk kjede dcv-srcStatuswsv-KlientID Arbeidsområde Velg wsv-ClientID. dcv-destStatus Dynamisk kjede dcv-destStatuswsv-ClientSecret Arbeidsområde Velg wsv-ClientSecret. wsv-BaseURL-Wdata Arbeidsområde Velg wsv-BaseURL-Wdata. wsv-BaseURL-IAM Arbeidsområde Velg wsv-BaseURL-IAM. - Velg hvilken kontakt du vil bruke for hver tilkobling, og klikk på Submit.
Merk: Bruk standard CloudRunner for hver kontakt.
Trinn 4. Publiser kjedene
Merk: For å forenkle installasjonen har malen Oppdater tilkoblinger og status en Kjør kjede hendelse. Før du publiserer kjedene som er opprettet fra malene, sletter du denne uvedkommende Kjør kjede hendelsen.
- Fra Kjeder, for kjeden som er opprettet fra Oppdater tilkoblinger og status mal, velger du Rediger.
- Velg hendelsen Kjør kjede - Slett, og klikk på Slett og Slett.
- Klikk på Publiser og Publiser.
- Fra Kjeder, for kjeden som er opprettet fra Primær mal, velger du Rediger.
- Klikk på Publiser og Publiser.
- Fra Kjeder, for kjeden som er opprettet fra Utførelse mal, velger du Rediger.
- Klikk på Publiser og Publiser.
Kjør kjedene
Slik arkiverer du dataene dine og forbereder neste års datainnsamling:
- I Chain Builder, fra Chains, velg Execute for kjeden som er opprettet fra 1a.ESG roll forward | Primary | Start here mal.
- Klikk på Kjør med inndata, og skriv inn inndataene for kjøretiden:
Inndata ved kjøretid Verdi Datainnsamling-Roll forward table ID Skriv inn ID-en til Wdata-tabellen som datasettet skal importeres til. Datainnsamling-Roll forward spørring ID Skriv inn ID-en til spørringen som skal kjøres for å arkivere data. PY år Skriv inn årstallet for dataene som skal arkiveres. Taggverdi Skriv inn navnet på det arkiverte datasettet. Merk: Med inndataene PY year vil denne inndataen opprette datasettets filnavn som
[Tag value]_[PY year].csv. For eksempel vil PY-året 2021 og Tag-verdien Arkivert opprette filnavnetArkivert_2021.csv.Oppdater arktilkoblinger før dataarkivering Velg om regnearkets utgående tilkoblinger til Wdata-tabellen skal oppdateres før spørringen kjøres, for eksempel for å oppdatere datasettet før arkivering. Status-arknavn Skriv inn navnet på arket som sporer oppdateringsstatusen for utgående tilkoblinger fra regnearket til Wdata-tabellen. RefreshExecution-ChainName Skriv inn navnet på kjeden som er opprettet fra ESG Rollforward | Refresh connection | Execution malen. Tøm kolonnen for regnearkverdi Velg om du vil slette inndataverdier fra regnearket som en del av fremføringen. Merk: Ingen verdier med en kilde- eller destinasjonslenke vil bli slettet.
- For å sikre de nyeste verdiene før du importerer datasettet, velger du Refresh connections before data archival.
Hvis du velger dette alternativet, oppdaterer kjedene regnearkets utgående tilkoblinger og registrerer oppdateringsstatusen i et kontrollark:- I Status-SheetName skriver du inn navnet på arket i kildearket der kjedene kan lagre oppdateringsstatusen for de utgående forbindelsene.
- I RefreshExecution-ChainName skriver du inn navnet på kjeden som er opprettet fra ESG Rollforward | Refresh connection | Execution malen.
Tips: Oppdateringen kan ta opptil noen minutter, avhengig av hvor mange utgående tilkoblinger regnearket har. For å justere ventetiden redigerer du Pause-kjeden hendelsen i kjeden som er opprettet fra 1b. ESG roll forward | Oppdater tilkoblinger og status mal.
- Hvis du vil slette inndataverdier fra kilderegnearket som en del av arkiveringen, for eksempel for å forberede neste års datainnsamling, velger du Clear spreadsheet value column.
Merk: Kjeden beholder alle verdier som er knyttet til en kilde eller destinasjon. Du kan ikke gjenopprette verdier som er slettet fra regnearket. Vi anbefaler at du velger dette alternativet kun for årets siste rollforward, slik at du kan forberede regnearket for neste års datainnsamling.
Tips: Som standard sletter kjeden verdier som begynner med rad 2 i regnearkets ark. Du kan justere dette ved å redigere egenskapen Region i kommandoen Clear sheet data.
- Klikk på Start.