Le connecteur Workiva Scripting offre un moyen simple d'exécuter des scripts Python au sein de la plateforme Workiva. Il fonctionne indépendamment de l'expérience de script complète, ce qui permet aux utilisateurs non techniques d'exécuter des scripts sans avoir à se plonger dans le code source sous-jacent.
Pour une liste complète des commandes compatibles, voir l'article Workiva Scripting commands.
La fonction de script n'est actuellement disponible que dans le cadre du programme Early Adopter. Si vous souhaitez ajouter des scripts à votre espace de travail, contactez votre Customer Success Manager pour discuter de votre participation au programme.
Pour en savoir plus sur les exigences en matière de scripts, consultez la page.
Exigences
Avant d'utiliser le connecteur Workiva :
- Un administrateur de sécurité de l'org doit activer le connecteur Workiva Scripting via l'écran Configurations.
- Pour exécuter la chaîne dans un environnement de test, vous aurez besoin des URL pour remplacer les hôtes et les chemins de base de l'API.
Pourquoi devrais-je utiliser le connecteur Workiva Scripting sur HTTP Request ?
Le connecteur HTTP Request nécessite une logique supplémentaire pour rafraîchir les jetons de support et interroger l'état du script. Ces exigences sont éliminées par l'utilisation du connecteur Workiva Scripting.
En outre, le connecteur Workiva Scripting offre des fonctionnalités supplémentaires telles que la possibilité d'utiliser les sorties de commandes (comme stdout et logs) ailleurs dans une chaîne.
Configuration de la connexion
Pour configurer le connecteur Workiva Scripting :
- Ouvrez « » Chain Builder.
- Cliquez sur « Connections » dans la barre de navigation de gauche, puis sur « Create » en haut à droite de la page.
- Sous « » (Configuration du connecteur) « Connection » (Connexion), sélectionnez « » (Scripts Workiva) et l’option par défaut « CloudRunner ».
- Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.
-
Sous « Propriétés d'», saisissez les informations relatives à la connexion :
Propriété Détails Identifiant du client Saisissez l'ID de la subvention OAuth de l'utilisateur d'intégration.
Il est généré de manière aléatoire.Secret du client Entrez le secret de la propriété ID.
Il est généré de manière aléatoire.API du serveur de script (Facultatif) Saisissez l'URL qui remplacera l'URL hôte et le chemin de base par défaut pour l'API du serveur de script. Remplacement de l’hôte IAM (Facultatif) Saisissez l'URL qui remplacera l'URL hôte et le chemin de base par défaut pour les points de terminaison Identify and Access Management (IAM). Versions de l'API de script Sélectionnez la version de l'API à utiliser.
La version V1 est la version par défaut et est recommandée pour la plupart des utilisateurs.
La V0 sera supprimée dans un avenir proche. - Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
Remplacements d’URL
En fonction de la région de votre environnement de production, une URL de remplacement peut s'appliquer. Vous pouvez le vérifier en comparant avec l'URL utilisée pour se connecter à Wdesk. Si l'URL contient EU ou APAC, une dérogation est nécessaire.
Remarque : les informations relatives à la région États-Unis de sont fournies à titre indicatif. Si vous vous trouvez dans cette région, vous n'avez pas besoin d'appliquer de règles de remplacement.
| Champ | Valeur |
|---|---|
| Remplacement de l’hôte cérébral | https://h.app.wdesk.com/s/cerebral |
| Remplacement de l’hôte des feuilles de calcul | https://api.app.wdesk.com/spreadsheets/v1/ |
| Remplacement de l’hôte IAM | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Remplacement de l’hôte administrateur | https://api.app.wdesk.com/admin/v1 |
| Remplacement de l’hôte GraphDB | https://api.app.wdesk.com/graphdb/v1/ |
| Remplacement de l’hôte de l’API de la plateforme | https://api.app.wdesk.com/platform/v1 |
| Remplacement de l'API du serveur de scripts | https://h.app.wdesk.com/s/scripting |
| Champ | Valeur |
|---|---|
| Remplacement de l’hôte cérébral | https://h.apac.wdesk.com/s/cerebral |
| Remplacement de l’hôte des feuilles de calcul | https://api.apac.wdesk.com/spreadsheets/v1/ |
| Remplacement de l’hôte IAM | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Remplacement de l’hôte administrateur | https://api.apac.wdesk.com/admin/v1 |
| Remplacement de l’hôte GraphDB | https://api.apac.wdesk.com/graphdb/v1 |
| Remplacement de l’hôte de l’API de la plateforme | https://api.apac.wdesk.com/platform/v1 |
| Remplacement de l'API du serveur de scripts | https://h.apac.wdesk.com/s/scripting |
| Champ | Valeur |
|---|---|
| Remplacement de l’hôte cérébral | https://h.ca.wdesk.com/s/cerebral |
| Remplacement de l’hôte des feuilles de calcul | https://api.ca.wdesk.com/spreadsheets/v1/ |
| Remplacement de l’hôte IAM | https://api.ca.wdesk.com/iam/v1/oauth2/token |
| Remplacement de l’hôte administrateur | https://api.ca.wdesk.com/admin/v1 |
| Remplacement de l’hôte GraphDB | https://api.ca.wdesk.com/graphdb/v1/ |
| Remplacement de l’hôte de l’API de la plateforme | https://api.ca.wdesk.com/platform/v1 |
| Remplacement de l'API du serveur de scripts | https://h.ca.wdesk.com/s/scripting |
| Champ | Valeur |
|---|---|
| Remplacement de l’hôte cérébral | https://h.eu.wdesk.com/s/cerebral |
| Remplacement de l’hôte des feuilles de calcul | https://api.eu.wdesk.com/spreadsheets/v1/ |
| Remplacement de l’hôte IAM | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Remplacement de l’hôte administrateur | https://api.eu.wdesk.com/admin/v1 |
| Remplacement de l’hôte GraphDB | https://api.eu.wdesk.com/graphdb/v1/ |
| Remplacement de l’hôte de l’API de la plateforme | https://api.eu.wdesk.com/platform/v1 |
| Remplacement de l'API du serveur de scripts | https://h.eu.wdesk.com/s/scripting |