Skript på nettstedet ditt kan kjøres ved hjelp av Skriptkjøring-handlingen i Automatiseringer-panelet. Dette lar deg kjøre skript manuelt fra et dokument, regneark eller en presentasjon.
Skripting er inkludert i Tilpass Workiva. For å bruke skripting må arbeidsområdet ditt ha Tilpass Workiva/skripting aktivert, og brukerne trenger riktig(e) skriptrolle(r) og filtillatelser.
Krav
- Workiva-skripting må være aktivert for arbeidsområdet ditt. Lær mer om Workiva-skripting.
- Skript kan bare kjøres i samme arbeidsområde der de er lagret. Finn ut mer.
- Bare fileiere kan opprette en automatisering.
- Rollen Skriptredigerer er nødvendig for å lage skript.
Lag din automatisering
Slik oppretter du en automatisering fra en fil du eier:
- Fra Hjem åpner du et dokument, en presentasjon eller et regneark.
- Klikk på lynikonet for automatiseringer i høyre sidefelt.
- Klikk på + eller Opprett en ny automatisering for å legge til en ny automatisering.
-
Fra rullegardinmenyen Automatiseringsutløser velger du Manuell utførelse .
- (Valgfritt) Gi andre brukere muligheten til å kjøre denne automatiseringen manuelt ved å skrive inn navnene deres og velge dem i feltet Når kjøring er valgt av .
-
Under Handlingsdetaljer velger du Utfør skript .
- Skriv inn ID-en fra slutten av skriptets URL i feltet Skript-ID .
- (Valgfritt) Velg regnearket og seksjonen som inneholder skriptets inndata.
- Klikk på Opprett for å fullføre.
Kjør og administrer automatiseringen din
Den nye automatiseringen din vil vises som «Aktiv» i Automatiseringer-panelet. Som filens eier kan du utføre flere handlinger fra rullegardinmenyen:
- Kjør : Kjører automatiseringsskriptet manuelt.
- Rediger: Oppdater detaljer om automatiseringen, for eksempel utløserkriterier.
- Deaktiver/Aktiver : Velg om en automatisering er tilgjengelig for kjøring.
- Vis aktivitet : Åpne automatiseringens aktivitetslogg.
- Slett : Fjerner automatiseringen permanent fra filen.
Merknad : For å forhindre dupliserte kjøringer er alternativet Kjør deaktivert i 20 sekunder mellom klikk.
Informasjon skriptet ditt mottar
Når en automatisering kjører, sender den informasjon som skriptet leser som miljøvariabler:
- DOKUMENT_ID : ID-en til dokumentet der automatiseringen kjøres.
- INPUT_SHEET_ID : WURL-en til regnearket som brukes til å administrere automatiseringens inndataparametere.
- INPUT_RESOURCE_ID : WURL-en til seksjonen i det ovennevnte regnearket.
- INPUT_SPREADSHEET_ID : ID-en til det ovennevnte regnearket.
- INPUT_SPREADSHEET_SHEET_ID : ID-en til seksjonen i det ovennevnte regnearket.
En WURL er en proprietær, Workiva-spesifikk URL som inneholder ID-en og annen informasjon om regnearket eller seksjonen.
For å hente ID-ene fra parameterne, bruk dette skriptet:
# Velkommen til Workiva Scripting import requests import json import os DOCUMENT_ID = os.getenv('DOCUMENT_ID') SPREADSHEET_ID = os.getenv('INPUT_SPREADSHEET_ID') SHEET_ID = os.getenv('INPUT_SPREADSHEET_SHEET_ID') print("RAW-parametere:") print(os.environ) print("") print("Faktiske ID-er:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Merk : Automatiseringen sender for øyeblikket ingen Workiva offentlige API-legitimasjon – for eksempel klient-ID eller hemmelighet – til skriptet. Du må kanskje kode disse påloggingsinformasjonen direkte inn i skriptet.
Vanlige spørsmål
Kan jeg kjøre et skript som ligger i et annet arbeidsområde, en annen organisasjon eller en annen region (APAC, CA, EU eller USA)?
Workiva-automatiseringer kan bare kjøre skript som ligger i samme arbeidsområde som filen. For å kjøre et skript i et annet arbeidsområde, en annen organisasjon eller en annen region, bruk Workiva Scripting-koblingen eller Workiva Scripting API .
Når du bruker Scripting API-et, må du opprette API-tildelingen i arbeidsområdet som er vert for målskriptet. Tildelingen krever script:execute ; hvis integrasjonen henter kjørestatus, logger eller utdata, krever den også script:read . For instruksjoner om hvordan du oppretter eller oppdaterer et API-tildelingsprosjekt, se Workiva API-oppsett .
Kan jeg sende kjøretidsinndata/parametere ved skriptkjøring?
For øyeblikket tillater ikke automatiseringsfunksjonen kjøretidsinndata som sendes til skriptet når skriptet kjøres.
Hvilke metadata sendes til en skriptutførelse fra en automatisering?Er arbeidsområde-ID-en sendt?
Når et skript kjøres fra en automatisering, sendes følgende parametere:
- DOKUMENT_ID : ID-en til dokumentet der automatiseringen kjøres.
- INPUT_SHEET_ID : WURL-en til regnearket som brukes til å administrere automatiseringens inndataparametere.
- INPUT_RESOURCE_ID : WURL-en til seksjonen i «input»-regnearket.
- INPUT_SPREADSHEET_ID : ID-en til regnearket som er satt inn.
- INPUT_SPREADSHEET_SHEET_ID : ID-en til seksjonen i «input»-regnearket.
For mer informasjon, se Workiva-støttesiden Utfør skript med automatiseringer .
Hvordan får jeg tilgang til påloggingsinformasjon til Workiva- og ikke-Workiva-systemer fra skriptkjøringen?
Når et skript kjøres fra en automatisering, er det eneste alternativet å hardkode legitimasjonen i selve koden.
Kan det samme skriptet kjøres samtidig fra to eller flere filer?
Ja, et skript kan kjøres samtidig fra enten samme fil eller flere filer.