Portail de support Workiva

Workiva Scripting offre un environnement flexible et sécurisé permettant d'exécuter du code Python sur la plateforme Workiva. Cet article couvre certains des scénarios les plus courants que vous pouvez rencontrer lors de l'élaboration de votre script.

Workiva Scripting est inclus dans Customize Workiva. Pour utiliser la fonctionnalité « Scripting », votre espace de travail doit disposer de l'option « Personnaliser Workiva/Scripting » activée, et les utilisateurs devront disposer des rôles « Scripting » appropriés ainsi que des autorisations d'accès aux fichiers nécessaires.

Pour toute question non abordée ici, consultez notre page « », les autres articles sur les scripts Workiva ou rendez-vous sur les communautés (API Workiva) et (scripts Workiva) .

Problèmes d'administration et d'autorisation

L'action Exécuter le script n'apparaît pas dans les automatisations

L'action « Exécuter un script » n'est accessible qu'aux utilisateurs disposant d'un rôle de script approprié . Contactez l'administrateur de votre espace de travail pour qu'il vous attribue le rôle requis. Si le rôle est déjà attribué et que l'action n'est toujours pas disponible, contactez le support Workiva.

Le connecteur Workiva Scripting n'est pas disponible dans les chaînes

Cela indique que le connecteur Workiva Scripting n'a pas été activé pour votre espace de travail. Si vous estimez que cette fonctionnalité devrait être activée et qu'elle ne l'est pas, veuillez contacter votre équipe de gestion de compte Workiva.

Aucun rôle de script n'est visible pour l'administrateur de l'espace de travail.

Cela indique que la fonction de script n'a pas été activée pour votre espace de travail. Si vous estimez que cette fonctionnalité devrait être activée et qu'elle ne l'est pas, veuillez contacter votre équipe de gestion de compte Workiva.

Connecteur de script Workiva et problèmes de commande (chaînes)

L'exécution de la commande démarre mais pas celle du script

Vérifiez que la fonction de script a été activée pour votre espace de travail. Si vous estimez que cette fonctionnalité devrait être activée et qu'elle ne l'est pas, veuillez contacter votre équipe de gestion de compte Workiva.

Si vous avez confirmé que la création de scripts est activée, il se peut que l'utilisateur d'intégration pour le connecteur Workiva Scripting n'ait pas le rôle nécessaire. Contactez votre administrateur d'espace de travail pour lui attribuer un rôle approprié Scripting. Vous devez également vérifier que l'utilisateur d'intégration a le droit d'accéder au script déclenché par la commande.

L'exécution de la commande est toujours en cours mais l'exécution du script s'arrête inopinément

Si la chaîne de commandes continue de s'exécuter après l'arrêt du script, vérifiez les points suivants :

• Vérifiez si la course a été annulée :  

  L'historique des exécutions est accessible dans le panneau « Propriétés » de l'éditeur de scripts, ainsi que via GET /scripts/{scriptId}/runs ou GET /scripts/{scriptId}/runs/{runId} . Les requêtes API nécessitent le script « » avec le champ « script:read » et doivent inclure X-Version: 2026-01-01 . 

  Pour savoir comment créer ou mettre à jour une autorisation d'API, consultez la page « » (Configuration de l'API Workiva) à l'adresse .

  

• Vérifiez si le script a dépassé une limite de ressources :

  L'utilisation de la mémoire, du processeur, du disque et les durées d'exécution sont automatiquement consignées dans les journaux d'exécution des scripts et dans les données d'exécution des scripts renvoyées par l'API.

  Pour plus d'informations, consultez , « Gestion des limites de ressources dans Workiva Scripting » et , « Limites de Workiva Scripting » .

• Vérifiez si le script a atteint sa durée d'exécution maximale :

  Si tel est le cas, réduisez la quantité de travail effectuée au cours d'un cycle ou divisez le travail en opérations plus petites. Voir Limites de la programmation Workiva .

• Vérifiez s'il existe des fonctions qui arrêtent explicitement le processus Python :

  Vérifiez que le script n'appelle pas :

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

  quit() , exit() , et sys.exit() raise SystemExit . os._exit() arrête immédiatement le processus sans exécuter les gestionnaires de nettoyage habituels.

Pour plus d'informations sur les opérations de l'API de script, consultez le guide de l'API de script d' à l'adresse .

Désynchronisation de l'exécution des commandes et des scripts

Cela se produit lorsque la commande se termine et que l'exécution du script se poursuit, ou inversement.

Si la commande s'achève avant la fin de l'exécution du script, veuillez vous assurer que le délai d'expiration de la commande est supérieur à la durée d'exécution du script (consultez Limites de script Workiva pour en savoir plus sur la durée maximale d'exécution d'un script).

Si l'exécution du script s'achève quelques secondes avant la commande, il peut s'agir d'un retard prévisible causé par le traitement des informations par le système de script après la fin de l'exécution du script. La commande ne signalera l'achèvement que lorsque l'ensemble du processus sera terminé.

Editeur de scripts

L'importation d'une bibliothèque ne fonctionne pas

Workiva Scripting prend en charge la bibliothèque standard de Python dans sa version standard, ainsi que les composants disponibles dans le Python Package Index (voir Supported Workiva Scripting libraries and dependencies pour plus d'informations). Les composants PyPI qui nécessitent des installations supplémentaires peuvent ne pas être pris en charge.

Assurez-vous que la bibliothèque que vous essayez d'importer fait partie de la bibliothèque standard de Python ou du Python Package Index. S'il s'agit d'un composant de ce dernier, assurez-vous qu'aucune installation supplémentaire n'est nécessaire.