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 Handlingsdetaljervelger 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 et annet miljø (APAC, EU, USA)?
Automatiseringsfunksjonen i Workiva kan bare kjøre skript i samme arbeidsområde der filen befinner seg. Workiva Scripting-koblingen eller Workiva Scripting API kan imidlertid brukes til å kjøre et skript som ligger på et annet sted.
Hvis du bruker skript-API-et, må du opprette og drifte et skript i hovedarbeidsområdet, der det eneste formålet er å kalle skript-API-et og kjøre skriptet i det sekundære arbeidsområdet.
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.