Les scripts de votre site peuvent être exécutés à l'aide de l'action Exécution de script dans le panneau Automations. Cela vous permet d'exécuter manuellement des scripts à partir d'un document, d'une feuille de calcul ou d'une présentation.
Note: La création de scripts n'est actuellement possible que par l'intermédiaire de Customize Workiva. En savoir plus.
Exigences
- Workiva Scripting doit être activé pour votre espace de travail. En savoir plus sur Workiva Scripting.
- Les scripts ne peuvent être exécutés que dans l'espace de travail où ils sont hébergés. En savoir plus.
- Seuls les propriétaires de fichiers peuvent créer une automatisation.
- Le rôle d'éditeur de script est nécessaire pour créer des scripts.
Créez votre automatisation
Pour créer un automatisme à partir d'un fichier que vous possédez :
- À partir de Home, ouvrez un document, une présentation ou une feuille de calcul.
- Sur le côté droit de l'écran, sélectionnez Automations dans le tableau de bord.
- Cliquez sur ou Create pour ajouter une nouvelle automatisation.
- Dans le menu déroulant Automation trigger, sélectionnez Manual Execution.
- Sous When run is selected by, donnez éventuellement à d'autres utilisateurs la possibilité d'exécuter manuellement cette automatisation.
- Sous Action details, sélectionnez Execute script.
- Sous Script ID, entrez l'ID à partir de la fin de l'URL du script.
- Sélectionnez la feuille de calcul et la section qui contiennent les entrées du script. Cette option est facultative.
- Cliquez sur Créer pour terminer.
Exécutez et gérez votre automatisation
Votre nouvelle automatisation apparaîtra comme "Active" dans le panneau Automations. En tant que propriétaire du fichier, vous pouvez effectuer plusieurs actions à partir du menu déroulant :
- Exécuter: Exécute manuellement le script de l'automatisation.
- Modifier : Mettre à jour les détails de l'automatisation, tels que ses critères de déclenchement.
- Désactiver/Activer: Permet de déterminer si un automatisme est disponible pour être exécuté.
- Voir l'activité: Ouvrir le journal d'activité de l'automatisation.
- Supprimer: Supprime définitivement l'automatisation du fichier.
Note: Pour éviter les doubles exécutions, l'option Run est désactivée pendant 20 secondes entre les clics.
Informations reçues par votre script
Lorsqu'un automatisme s'exécute, il envoie des informations que le script lit sous forme de variables d'environnement :
- DOCUMENT_ID: L'ID du document dans lequel l'automatisation est exécutée.
- INPUT_SHEET_ID: Le WURL de la feuille de calcul utilisée pour gérer les paramètres d'entrée de l'automatisme.
- INPUT_RESOURCE_ID: Le WURL de la section dans la feuille de calcul mentionnée ci-dessus.
- INPUT_SPREADSHEET_ID: L'ID de la feuille de calcul mentionnée ci-dessus.
- INPUT_SPREADSHEET_SHEET_ID: L'ID de la section dans la feuille de calcul susmentionnée.
Une WURL est une URL propriétaire, spécifique à Workiva, qui contient l'identifiant et d'autres informations relatives à la feuille de calcul ou à la section.
Pour récupérer les identifiants à partir des paramètres, utilisez ce script :
# Welcome to 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("Actual IDs:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Note: The automation does not currently send any Workiva public API credentials — such as the client ID or secret — to the script. Il se peut que vous deviez coder ces informations d'identification directement dans le script.
FAQ
Puis-je exécuter un script hébergé dans un autre espace de travail, une autre organisation ou un autre environnement (APAC, EU, US) ?
La fonction d'automatisation dans Workiva ne peut exécuter des scripts que dans l'espace de travail où se trouve le fichier. Toutefois, le connecteur Workiva Scripting ou l'API Workiva Scripting peuvent être utilisés pour exécuter un script hébergé à un autre endroit.
Si vous utilisez l'API de script, vous devez créer et héberger un script dans l'espace de travail principal dont le seul but est d'appeler l'API de script et d'exécuter le script dans l'espace de travail secondaire.
Puis-je envoyer des entrées/paramètres lors de l'exécution du script ?
Pour l'instant, la fonction d'automatisation n'autorise pas les entrées d'exécution qui sont envoyées au script lorsque celui-ci est exécuté.
Quelles sont les métadonnées envoyées à l'exécution d'un script à partir d'une automatisation ? L'identifiant de l'espace de travail est-il envoyé ?
Lorsqu'un script est exécuté à partir d'une automatisation, le seul paramètre envoyé est l'ID du document dans lequel l'automatisation est configurée.
Comment puis-je accéder aux informations d'identification des systèmes Workiva et non Workiva à partir de l'exécution du script ?
Lorsqu'un script est exécuté à partir d'un automate, la seule option consiste à coder en dur les informations d'identification dans le code lui-même.
Le même script peut-il être exécuté simultanément à partir de deux fichiers ou plus ?
Oui, un script peut être exécuté simultanément à partir du même fichier ou de plusieurs fichiers.