Workiva-ondersteuningscentrum

Workiva Scripting biedt een flexibele en veilige omgeving voor het uitvoeren van Python-code op het Workiva-platform. Dit artikel behandelt enkele van de meest voorkomende scenario's die je kunt tegenkomen tijdens het ontwikkelen van je script.

Workiva 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.

Voor onderwerpen die hier niet aan bod komen, raadpleeg onze andere Workiva Scripting-artikelen of bezoek de Workiva API's en Workiva Scripting communities.

Beheer- en machtigingsproblemen

De actie 'Script uitvoeren' verschijnt niet in de automatiseringen.

De actie 'Script uitvoeren' is alleen beschikbaar voor gebruikers met de juiste scriptrol . Neem contact op met uw werkruimtebeheerder om de vereiste rol toe te wijzen. Als de rol al is toegewezen en de actie nog steeds niet beschikbaar is, neem dan contact op met Workiva Support.

De Workiva Scripting-connector is niet beschikbaar in Chains.

Dit geeft aan dat de Workiva Scripting-connector niet is ingeschakeld voor uw werkruimte. Als u van mening bent dat deze functie ingeschakeld zou moeten zijn en dat niet het geval is, neem dan contact op met uw Workiva-accountteam.

De werkruimtebeheerder heeft geen scriptrollen tot zijn beschikking.

Dit geeft aan dat de scriptfunctie niet is ingeschakeld voor uw werkruimte. Als u van mening bent dat deze functie ingeschakeld zou moeten zijn en dat niet het geval is, neem dan contact op met uw Workiva-accountteam.

Problemen met de Workiva Scripting-connector en commandoketens

De opdracht wordt wel uitgevoerd, maar het script niet.

Controleer of de scriptfunctie is ingeschakeld voor uw werkruimte. Als u van mening bent dat deze functie ingeschakeld zou moeten zijn en dat niet het geval is, neem dan contact op met uw Workiva-accountteam.

Als je hebt bevestigd dat scripting is ingeschakeld, dan heeft de integratiegebruiker voor de Workiva Scripting-connector mogelijk niet de benodigde rol toegewezen. Neem contact op met uw werkruimtebeheerder om een ​​geschikte scriptrol toe te wijzen. U dient er ook voor te zorgen dat de integratiegebruiker de juiste machtigingen heeft om toegang te krijgen tot het script dat door de opdracht wordt uitgevoerd.

De opdracht wordt nog uitgevoerd, maar de scriptuitvoering stopt onverwacht.

Als de ketenopdracht na het stoppen van het script nog steeds wordt uitgevoerd, controleer dan het volgende:

• Controleer of de run is geannuleerd:

  De uitvoeringsgeschiedenis is beschikbaar in het paneel Eigenschappen van de Scripting Editor en via GET /scripts/{scriptId}/runs of GET /scripts/{scriptId}/runs/{runId} . API-verzoeken vereisen de scope script:read en moeten X-Version: 2026-01-01 bevatten. 

  Voor instructies over het aanmaken of bijwerken van een API-toekenning, zie Workiva API Setup .

  

• Controleer of het script een resourcebeperking heeft overschreden:

  Geheugen-, CPU-, schijf- en runtimegebruik worden automatisch gerapporteerd in de scriptuitvoeringslogboeken en in de scriptuitvoeringsgegevens die door de API worden geretourneerd.

  Zie voor meer informatie Omgaan met resourcebeperkingen in Workiva Scripting en Workiva Scripting-limieten .

• Controleer of het script de maximale uitvoertijd heeft bereikt:

  Als dat het geval is, verminder dan de hoeveelheid werk die tijdens één run wordt uitgevoerd of verdeel het werk in kleinere bewerkingen. Zie Workiva Scripting-limieten .

• Controleer op functies die het Python-proces expliciet stoppen:

  Controleer of het script de volgende aanroep niet uitvoert:

  quit() exit() sys.exit() os._exit()

  quit() , exit() , en sys.exit() verhogen SystemExit . os._exit() stopt het proces onmiddellijk zonder de normale opschoonhandlers uit te voeren.

Voor meer informatie over bewerkingen met de Scripting API, zie de Scripting API-handleiding .

De uitvoering van opdrachten en scripts verloopt niet synchroon.

Dit gebeurt wanneer de opdracht is voltooid en het script blijft draaien, of andersom.

Als de opdracht voltooid is voordat het script is uitgevoerd, zorg er dan voor dat de opdrachttime-out groter is dan de uitvoeringsduur van het script (zie Workiva Scripting Limits voor meer informatie over de maximale uitvoeringsduur van het script).

Als de scriptuitvoering enkele seconden vóór de opdracht is voltooid, kan dit een verwachte vertraging zijn die wordt veroorzaakt doordat het scriptingsysteem informatie verwerkt nadat de scriptuitvoering is voltooid. Het commando meldt de voltooiing pas wanneer het hele proces is afgerond.

Scripteditor

Het importeren van een bibliotheek werkt niet.

Workiva Scripting ondersteunt de standaardbibliotheek van Python direct , evenals componenten die beschikbaar zijn via de Python Package Index ( zie Ondersteunde Workiva Scripting-bibliotheken en -afhankelijkheden voor meer informatie). PyPI-componenten die aanvullende installaties vereisen, worden mogelijk niet ondersteund.

Zorg ervoor dat de bibliotheek die u probeert te importeren, deel uitmaakt van de standaardbibliotheek van Python of de Python Package Index. Als het een onderdeel van dat laatste betreft, controleer dan of er geen extra installaties nodig zijn.