Skript på nettstedet ditt kan kjøres ved hjelp av handlingen Skriptekjøring i Automatiseringer-panelet. Dette gjør at du kan kjøre skript manuelt fra et dokument, et regneark eller en presentasjon.
Merk: Skripting er for øyeblikket bare tilgjengelig gjennom Customize Workiva. Lær mer om dette.
Krav
- Workiva Scripting må være aktivert for arbeidsområdet ditt. Finn ut mer om Workiva Scripting.
- Skript kan bare kjøres i det samme arbeidsområdet der de er lagret. Finn ut mer.
- Bare fileiere kan opprette en automatisering.
- Rollen Script Editor er nødvendig for å opprette skript.
Opprett automatiseringen din
Slik oppretter du en automatisering fra en fil du eier:
- Åpne et dokument, en presentasjon eller et regneark fra Home.
- Velg Automations fra panelet helt til høyre på skjermen.
- Klikk på + eller Create for å legge til en ny automatisering.
- Fra rullegardinmenyen Automation trigger velger du Manual Execution.
- Under When run is selected by kan du eventuelt gi andre brukere muligheten til å kjøre denne automatiseringen manuelt.
- Under Action details velger du Execute script.
- Under Skript-ID skriver du inn ID-en fra slutten av skriptets URL.
- Velg regnearket og delen som inneholder skriptets inndata. Dette er valgfritt.
- Klikk på Create for å fullføre.
Kjør og administrer automatiseringen din
Den nye automatiseringen vises som "Aktiv" i Automations-panelet. Som eier av filen kan du utføre flere handlinger fra rullegardinmenyen:
- Kjør: Kjører automasjonens skript manuelt.
- Rediger: Oppdater detaljer om automatiseringen, for eksempel utløserkriterier.
- Deaktiver/Aktiver: Velg om en automatisering er tilgjengelig for kjøring.
- Vis aktivitet: Åpne automasjonens aktivitetslogg.
- Slett: Fjern automatiseringen permanent fra filen.
Merk: For å unngå dupliserte kjøringer er alternativet Run deaktivert i 20 sekunder mellom hvert klikk.
Informasjon skriptet ditt mottar
Når en automatisering kjører, sender den informasjon som skriptet leser som miljøvariabler:
- DOCUMENT_ID: ID-en til dokumentet der automatiseringen kjøres.
- INPUT_SHEET_ID: WURL for regnearket som brukes til å administrere automasjonens inndataparametere.
- INPUT_RESOURCE_ID: WURL-en til seksjonen i det nevnte regnearket.
- INPUT_SPREADSHEET_ID: ID-en til det nevnte regnearket.
- INPUT_SPREADSHEET_SHEET_ID: ID-en til seksjonen i det nevnte regnearket.
En WURL er en proprietær, Workiva-spesifikk URL som inneholder ID-en og annen informasjon om regnearket eller seksjonen.
Bruk dette skriptet for å hente ID-ene fra parameterne:
# Welcome to 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 parameters:") print(os.environ) print("") print("Actual IDs:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Merk: Automatiseringen sender for øyeblikket ingen offentlige Workiva API-legitimasjonsopplysninger - som klient-ID eller hemmelighet - til skriptet. Det kan hende du må kode denne legitimasjonen 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)?
Funksjonen automations i Workiva kan bare kjøre skript i det samme arbeidsområdet der filen ligger. Workiva Scripting Connector 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 hoste et skript i hovedarbeidsområdet som har som eneste formål å kalle opp skript-API-et og kjøre skriptet i det sekundære arbeidsområdet.
Kan jeg sende inndata/parametere under kjøring av skriptet?
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, er den eneste parameteren som sendes, ID-en til dokumentet der automatiseringen er konfigurert.
Hvordan får jeg tilgang til legitimasjon til Workiva og andre 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.