|
Klassiska filtyper är inte längre tillgängliga för användning från och med januari 2021. Du kan överföra dina klassiska filer eller ladda ner en PDF. Läs mer

Workiva supportcenter

Exekvera skript med automatiseringar

Exekvera skript med automatiseringar

  • Senast uppdaterad

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 Skriptredigerare krävs för att skapa skript.

Skapa din automatisering

För att skapa en automatisering från en egen arkivering:

  1. Från Hem öppnar du ett dokument, en presentation eller ett kalkylblad.
  2. I den högra sidofältet klickar du på blixtikonen för Automations.
  3. Klicka på + eller Skapa en ny automatisering för att lägga till en ny automatisering.
    automations-panel__1_.jpeg
  4. Från rullgardinsmenyn Automation trigger väljer du Manuell körning .
    3. Välj Manuell körning
  5. (Valfritt) Ge andra användare möjlighet att köra den här automatiseringen manuellt genom att ange deras namn och välja dem i fältet När körning väljs av .
    När körning är valt av
  6. Under Åtgärdsinformation väljer du Kör skript .
    Kör skript
  7. Ange ID:t från slutet av skriptets URL i fältet Skript-ID .
    automation_enter-script-id.jpeg
  8. (Valfritt) Välj kalkylbladet och avsnittet som innehåller skriptets indata. automation_enter-script-id2.png
  9. 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.
  • Redigera: Uppdatera detaljer om automatiseringen, till exempel dess utlösningskriterier.
  • Inaktivera/Aktivera : Välj om en automatisering är tillgänglig att köra.
  • Visa aktivitet : Öppna automatiseringens aktivitetslogg.
  • Ta bort : Ta bort automatiseringen permanent från filen.

automation_menu.jpeg

Obs ! För att förhindra dubbletter är alternativet Kör inaktiverat i 20 sekunder mellan klick.

 

Information som ditt manus får

När en automatisering körs skickar den information som skriptet läser som miljövariabler:

  • DOKUMENT_ID : ID:t för dokumentet där automatiseringen körs.
  • INPUT_SHEET_ID : WURL:en för kalkylbladet som används för att hantera automatiseringens inparametrar.
  • INPUT_RESOURCE_ID : WURL:n för avsnittet i det ovannämnda kalkylbladet.
  • INPUT_SPREADSHEET_ID : ID:t för det ovannämnda kalkylbladet.
  • INPUT_SPREADSHEET_SHEET_ID : ID för avsnittet i det ovannämnda kalkylbladet.

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 i en annan arbetsyta, organisation eller region (APAC, CA, EU eller USA)?

Workiva-automatiseringar kan endast köra skript som finns i samma arbetsyta som filen. För att köra ett skript i en annan arbetsyta, organisation eller region, använd Workiva Scripting-anslutningen eller Workiva Scripting API .

När du använder Scripting API:et skapar du API-tilldelningen i arbetsytan som är värd för målskriptet. Beviljandet kräver script:execute ; om integrationen hämtar körningsstatus, loggar eller utdata kräver den också script:read . För instruktioner om hur du skapar eller uppdaterar ett API-tillstånd, se Workiva API-konfiguration .

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:

  • DOKUMENT_ID : ID:t för dokumentet där automatiseringen körs.
  • INPUT_SHEET_ID : WURL:en för kalkylbladet som används för att hantera automatiseringens inparametrar.
  • INPUT_RESOURCE_ID : WURL:en för avsnittet i kalkylbladet "input".
  • INPUT_SPREADSHEET_ID : ID:t för kalkylbladet "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.

Skript på din webbplats kan köras med hjälp av åtgärden Skriptexekvering i panelen Automatiseringar. Detta gör att du...