Scripts op uw site kunnen worden uitgevoerd met behulp van de actie 'Scriptuitvoering' in het paneel 'Automatiseringen'. Hiermee kunt u scripts handmatig uitvoeren vanuit een document, spreadsheet of presentatie.
Scripting is inbegrepen bij Customize Workiva. Om scripting te gebruiken, moet de optie 'Workiva/Scripting aanpassen' in uw werkruimte zijn ingeschakeld en moeten gebruikers de juiste scriptingrol(len) en bestandsrechten hebben.
Vereisten
- Workiva Scripting moet ingeschakeld zijn voor uw werkruimte. Leer meer over Workiva Scripting.
- Scripts kunnen alleen worden uitgevoerd in dezelfde werkruimte waar ze worden gehost. Leer meer.
- Alleen bestandseigenaren kunnen een automatisering aanmaken.
- De rol Scripteditor is vereist om scripts te maken.
Maak je eigen automatisering
Om een automatisering te maken van een bestand dat je zelf bezit:
- Vanuit Homekunt u een document, presentatie of spreadsheet openen.
- Klik in de rechterzijbalk op het bliksemschichtpictogram voor automatiseringen.
- Klik op + of Een nieuwe automatisering maken om een nieuwe automatisering toe te voegen.
- Selecteer in het dropdownmenu Automation trigger de optie Manual Execution.
- (Optioneel) Geef andere gebruikers de mogelijkheid om deze automatisering handmatig uit te voeren door hun naam in te voeren en deze te selecteren in het veld Wanneer uitvoeren is geselecteerd door.
- Onder Actiegegevensselecteer je Script uitvoeren.
- Voer de ID van het einde van de URL van het script in het veld Script-ID in.
- (Optioneel) Selecteer het spreadsheet en de sectie die de invoer voor het script bevatten.
- Klik op Maak om te voltooien.
Voer uw automatisering uit en beheer deze.
Je nieuwe automatisering wordt in het paneel Automatiseringen weergegeven als 'Actief'. Als eigenaar van het bestand kunt u verschillende acties uitvoeren via het keuzemenu:
- Uitvoeren: Voert het automatiseringsscript handmatig uit.
- Bewerken: Details over de automatisering bijwerken, 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 uitvoeringen te voorkomen, is de Uitvoering optie 20 seconden tussen klikken uitgeschakeld.
Informatie die uw script ontvangt
Wanneer een automatisering wordt uitgevoerd, stuurt deze informatie die het script leest als omgevingsvariabelen:
- DOCUMENT_ID: De ID van het document waarop de automatisering wordt uitgevoerd.
- INPUT_SHEET_ID: De WURL van het spreadsheet dat wordt gebruikt om de invoerparameters van de automatisering te beheren.
- INPUT_RESOURCE_ID: De WURL van de sectie in het eerdergenoemde spreadsheet.
- INPUT_SPREADSHEET_ID: De ID van het bovengenoemde spreadsheet.
- INPUT_SPREADSHEET_SHEET_ID: De ID van de sectie in het bovengenoemde spreadsheet.
Een WURL is een eigen, Workiva-specifieke URL die de ID en andere informatie van het spreadsheet of de sectie bevat.
Om de ID's uit de parameters op te halen, gebruik je dit script:
# 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 openbare Workiva API-gegevens — zoals de client-ID of het geheim — naar het script. Mogelijk moet u deze inloggegevens rechtstreeks in het script coderen.
veelgestelde vragen|FAQ
Kan ik een script uitvoeren dat gehost wordt in een andere werkruimte, organisatie of omgeving (APAC, EU, VS)?
De automatiseringsfunctie in Workiva kan scripts alleen 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 dat als enig doel heeft de scripting-API aan te roepen en het script in de secundaire werkruimte uit te voeren.
Kan ik tijdens de uitvoering van een script invoer/parameters meesturen?
Op dit moment staat de automatiseringsfunctie geen runtime-inputs toe die naar het script worden verzonden wanneer het script wordt uitgevoerd.
Welke metadata wordt vanuit een automatisering naar een scriptuitvoering verzonden?Is de werkruimte-ID verzonden?
Wanneer een script vanuit een automatisering wordt uitgevoerd, worden de volgende parameters verzonden.
- DOCUMENT_ID: De ID van het document waarop de automatisering wordt uitgevoerd.
- INPUT_SHEET_ID: De WURL van het spreadsheet dat wordt gebruikt om de invoerparameters van de automatisering te beheren.
- INPUT_RESOURCE_ID: De WURL van de sectie in het spreadsheet "input".
- INPUT_SPREADSHEET_ID: De ID van het "input"-spreadsheet.
- INPUT_SPREADSHEET_SHEET_ID: De ID van de sectie in het "input"-spreadsheet.
Voor meer informatie, zie de Workiva-ondersteuningspagina Scripts uitvoeren met automatiseringen.
Hoe krijg ik vanuit de scriptuitvoering toegang tot inloggegevens voor Workiva- en niet-Workiva-systemen?
Wanneer een script vanuit een automatisering wordt uitgevoerd, is de enige optie om de inloggegevens in de code zelf vast te leggen.
Kan hetzelfde script gelijktijdig vanuit twee of meer bestanden worden uitgevoerd?
Ja, een script kan gelijktijdig worden uitgevoerd vanuit hetzelfde bestand of vanuit meerdere bestanden.