Skript på din webbplats kan köras med hjälp av åtgärden Skriptexekvering i panelen Automatiseringar. Detta gör att du manuellt kan köra skript från ett dokument, en kalkylark eller en presentation.
Skript ingår i Anpassa Workiva. För att använda skript måste din arbetsyta ha Anpassa Workiva/skript aktiverat, och användarna behöver lämplig(a) skriptroll(er) och filbehörigheter.
Krav
- Workiva Scripting måste vara aktiverat för din arbetsyta. Läs mer om Workiva Scripting.
- Skript kan bara köras i samma arbetsyta där de finns. Läs mer.
- Endast ägare av filer kan skapa en automatisering.
- Rollen Script Editor krävs för att skapa skript.
Skapa din automatisering
För att skapa en automatisering från en egen arkivering:
- Från Home öppnar du ett dokument, en presentation eller en kalkylark.
- I den högra sidofältet klickar du på blixtikonen för Automations.
- Klicka på + eller Skapa en ny automatisering för att lägga till en ny automatisering.
- I rullgardinsmenyn Automation trigger väljer du Manual Execution.
- (Valfritt) Ge andra användare möjlighet att köra denna automatisering manuellt genom att ange deras namn och välja dem i fältet När körning är vald med.
- Under Action details, välj Execute script.
- Ange ID:t från slutet av skriptets URL i fältet Skript-ID.
- (Valfritt) Välj kalkylbladet och avsnittet som innehåller skriptets indata.
- Klicka på Skapa för att avsluta.
Kör och hantera din automatisering
Din nya automatisering visas som "Aktiv" i panelen Automatiseringar. Som ägare till filen kan du utföra flera åtgärder från rullgardinsmenyn:
- Kör: Kör automatiseringens skript manuellt.
- Edit: Uppdatera detaljer om automatiseringen, t.ex. dess triggerkriterier.
- Inaktivera/Aktivera: Välj om en automatisering är tillgänglig för körning.
- Visa aktivitet: Öppna automatiseringens aktivitetslogg.
- Radera: Ta bort automatiseringen permanent från arkiveringen.
Obs: För att förhindra dubbla körningar inaktiveras alternativet Kör i 20 sekunder mellan klickningarna.
Information som ditt manus får
När en automatisering körs skickar den information som skriptet läser som miljövariabler:
- DOCUMENT_ID: ID för det dokument där automatiseringen körs.
- INPUT_SHEET_ID: WURL för kalkylarket som används för att hantera automatiseringens ingångsparametrar.
- INPUT_RESOURCE_ID: WURL för avsnittet i den ovannämnda kalkylarket.
- INPUT_SPREADSHEET_ID: ID för det ovannämnda kalkylarket.
- INPUT_SPREADSHEET_SHEET_ID: ID för avsnittet i det ovan nämnda kalkylarket.
En WURL är en proprietär, Workiva-specifik URL som innehåller ID och annan information om kalkylarket eller avsnittet.
Använd det här skriptet för att hämta ID:n från parametrarna:
# Välkommen till 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-parametrar:") print(os.environ) print("") print("Faktiska ID:n:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID)Obs: Automatiseringen skickar för närvarande inga Workiva-publika API-inloggningsuppgifter – såsom klient-ID eller hemlighet – till skriptet. Du kan behöva koda dessa autentiseringsuppgifter direkt i skriptet.
VANLIGA FRÅGOR
Kan jag köra ett skript som finns på en annan arbetsyta, organisation eller miljö (APAC, EU, US)?
Automationsfunktionen i Workiva kan bara köra skript i samma arbetsyta där arkiveringen finns. Däremot kan Workiva Scripting connector eller Workiva Scripting API användas för att köra ett skript som finns på en annan plats.
Om du använder skript-API:t måste du skapa och vara värd för ett skript i den huvudsakliga arbetsytan vars enda syfte är att anropa skript-API:t och köra skriptet i den sekundära arbetsytan.
Kan jag skicka inmatningar/parametrar under exekvering av skript?
För närvarande tillåter inte automatiseringsfunktionen exekvering av indata som skickas till skriptet när skriptet körs.
Vilka metadata skickas till en skriptexekvering från en automatisering? Har id:t för arbetsytan skickats?
När ett skript körs från en automatisering skickas följande parametrar
- DOCUMENT_ID: ID för det dokument där automatiseringen körs.
- INPUT_SHEET_ID: WURL för kalkylarket som används för att hantera automatiseringens ingångsparametrar.
- INPUT_RESOURCE_ID: WURL:en för avsnittet i kalkylbladet "input".
- INPUT_SPREADSHEET_ID: ID för kalkylarket "input".
- INPUT_SPREADSHEET_SHEET_ID: ID för avsnittet i kalkylbladet "input".
För mer information, se Workivas supportsida Kör skript med automatiseringar.
Hur får jag åtkomst till autentiseringsuppgifter till Workiva- och icke-Workiva-system från skriptexekveringen?
När ett skript exekveras från en automatisering är det enda alternativet att hårdkoda autentiseringsuppgifterna i själva koden.
Kan samma skript köras samtidigt från två eller flera arkiveringar?
Ja, ett skript kan köras samtidigt från antingen samma arkivering eller flera arkiveringar.