Scripts in uw site kunnen worden uitgevoerd met de actie Script uitvoeren in het paneel Automations. Hiermee kunt u handmatig scripts uitvoeren vanuit een document, spreadsheet of presentatie.
Opmerking: Scripting is momenteel alleen beschikbaar via Customize Workiva. Meer informatie.
Vereisten
- Workiva Scripting moet ingeschakeld zijn voor uw werkruimte. Meer informatie over Workiva Scripting.
- Scripts kunnen alleen worden uitgevoerd in dezelfde werkruimte waar ze worden gehost. Meer informatie.
- Alleen bestandseigenaars kunnen een automatisering aanmaken.
- De rol Script Editor is vereist om scripts te maken.
Uw automatisering aanmaken
Om een automatisering te maken van een bestand waarvan u de eigenaar bent:
- Op Home, opent u een document, presentatie of spreadsheet.
- Selecteer uiterst rechts op het scherm Automations in het paneel.
- Klik op + of Create om een nieuwe automatisering toe te voegen.
- Selecteer in het vervolgkeuzemenu Automatiseringstrigger Handmatige uitvoering.
- Geef onder Wanneer uitvoeren is geselecteerd door optioneel andere gebruikers de mogelijkheid om deze automatisering handmatig uit te voeren.
- Selecteer onder Actie details, Script uitvoeren.
- Voer onder Script-ID de ID in vanaf het einde van de URL van het script.
- Selecteer de spreadsheet en de sectie die de invoer van het script bevatten. Dit is optioneel.
- Klik op Create om te voltooien.
Uw automatisering uitvoeren en beheren
Uw nieuwe automatisering verschijnt als "Actief" in het paneel Automations. Als eigenaar van het bestand kunt u verschillende acties uitvoeren vanuit het vervolgkeuzemenu:
- Uitvoeren: Voert het script van de automatisering handmatig uit.
- Bewerken: Werk details over de automatisering bij, zoals de triggercriteria.
- Uitschakelen/Activeren: Selecteer of een automatisering beschikbaar is om uit te voeren.
- Activiteit bekijken: Open het activiteitenlogboek van de automatisering.
- Verwijderen: De automatisering permanent uit het bestand verwijderen.
Opmerking: Om dubbele runs te voorkomen, is de optie Run uitgeschakeld gedurende 20 seconden tussen twee klikken.
Informatie die uw script ontvangt
Wanneer een automatisering wordt uitgevoerd, verzendt het informatie die het script leest als omgevingsvariabelen:
- DOCUMENT_ID: Het ID van het document waarop de automatisering wordt uitgevoerd.
- INPUT_SHEET_ID: De WURL van de spreadsheet die wordt gebruikt om de invoerparameters van de automatisering te beheren.
- INPUT_RESOURCE_ID: De WURL van de sectie in de eerder genoemde spreadsheet.
- INPUT_SPREADSHEET_ID: De ID van de bovengenoemde spreadsheet.
- INPUT_SPREADSHEET_SHEET_ID: De ID van de sectie in de bovengenoemde spreadsheet.
Een WURL is een eigen, Workiva-specifieke URL die de ID en andere informatie van de spreadsheet of sectie bevat.
Gebruik dit script om de ID's van de parameters op te halen:
# Welkom bij 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("Werkelijke ID's:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Opmerking: De automatisering stuurt momenteel geen Workiva publieke API referenties - zoals de client ID of het geheim - naar het script. Mogelijk moet u deze referenties rechtstreeks in het script coderen.
veelgestelde vragen|FAQ
Kan ik een script uitvoeren dat in een andere workspace, org of omgeving (APAC, EU, US) wordt gehost?
De functie automations in Workiva kan alleen scripts uitvoeren in dezelfde werkruimte waar het bestand zich bevindt. De Workiva Scripting connector of de Workiva Scripting API kunnen echter worden gebruikt om een script uit te voeren dat op een andere locatie wordt gehost.
Als u de Scripting API gebruikt, moet u een script maken en hosten in de hoofdwerkruimte met als enige doel de Scripting API aan te roepen en het script uit te voeren in de secundaire werkruimte.
Kan ik runtime-invoer/parameters verzenden tijdens het uitvoeren van het script?
Op dit moment staat de automatiseringsfunctie geen runtime-invoer toe die naar het script wordt verzonden wanneer het script wordt uitgevoerd.
Welke metadata worden vanuit een automatisering naar een scriptuitvoering gestuurd? Is de werkruimte-id verzonden?
Wanneer een script wordt uitgevoerd vanuit een automatisering, is de enige parameter die wordt verzonden de ID van het document waarin de automatisering is geconfigureerd.
Hoe krijg ik toegang tot referenties naar Workiva en niet-Workiva systemen vanuit de scriptuitvoering?
Wanneer een script vanuit een automatisering wordt uitgevoerd, is de enige optie om de referenties hard te coderen in de code zelf.
Kan hetzelfde script tegelijkertijd worden uitgevoerd vanuit twee of meer bestanden?
Ja, een script kan gelijktijdig worden uitgevoerd vanuit hetzelfde bestand of vanuit meerdere bestanden.