Vous cherchez à vous connecter à une application tierce au-delà des connecteurs Premium prédéfinis de Workiva ? Vous pouvez y parvenir en utilisant les commandes du connecteur de requêtes HTTP pour interagir avec les API REST.
Note : Bien qu’il s’agisse d’une requête HTTP, le protocole HTTPS (Secure HTTP) est pris en charge (et recommandé).
Dans ce parcours d’apprentissage connecté, nous allons mettre à jour notre chaîne pour utiliser les entrées d’exécution où nous pouvons spécifier la feuille de calcul que nous voulons récupérer.
| Cas d'utilisation principal | Se connecter à des systèmes tiers |
| Objectif d'apprentissage principal | Utilisez les commandes du connecteur de requêtes HTTP de Workiva pour interagir avec les API REST pour les applications tierces au-delà des connecteurs prédéfinis. Mettre à jour les chaînes pour utiliser les entrées d’exécution afin de spécifier la feuille de calcul à utiliser. |
| Objectif pédagogique secondaire | Utilisation des entrées d’exécution |
| Conditions préalables |
Configurer l’API Grant de Workiva Configuration du connecteur de requêtes HTTP Compléter CLP | HTTP Request List Spreadsheets |
| Modèle de support | CLP | Demande HTTP Obtenir une seule feuille de calcul |
Étape 1 : Copier et modifier une chaîne
- Naviguez vers Chain Builder et localisez la chaîne CLP | HTTP Request List Spreadsheets.
- Cliquez sur l’ellipse verticale pour Copier la chaîne.
- Cliquez sur l’icône en forme de crayon pour modifier la chaîne.
- Cliquez sur Chain Settings en haut à droite, et renommez la chaîne : CLP | HTTP Request Get a Single Spreadsheet.
- (Optional) Entrez une Description : « Cette chaîne génère un nouveau jeton d’accès à l’API de Workiva. Vous devez fournir un ID client et un secret client valides provenant d’une subvention API précédemment générée dans les valeurs variables ci-dessous. Lorsque la chaîne est exécutée, elle invite l’utilisateur à saisir un ID de feuille de calcul. La chaîne récupère la feuille de calcul. »
- Sauvez la chaîne.
Étape 2 : Entrées en cours d'exécution
Utilisez l’événement Runtime Inputs Chain Event pour lancer la chaîne.
Cela nous permet de spécifier l’ID de la feuille de calcul que nous voulons obtenir. En savoir plus sur Runtime Inputs.
- Déplacez la commande POST - Retrieve a Token du nœud de départ.
- Ajoutez au nœud de départ un événement en chaîne Runtime Inputs provenant de Chain Trigger Events.
- Double-cliquez sur le lien qui relie Runtime Inputs à la commande Get - List Spreadsheets et supprimez le lien.
- Connectez Runtime Inputs à la commande POST - Retrieve a Token.
-
Connectez la commande POST - Retrieve a Token à la commande GET - List Spreadsheets.
- Double-cliquez sur l’événement de chaîne Runtime Inputs pour le configurer.
- Cliquez sur Add Input et configurez les champs suivants :
- Type : Champ de texte Champ de texte
- Nom affiché : ID de la feuille de calcul - consultez ce document pour vous aider à trouver l’ID.
- Obligatoire : Cochez cette case
- (Facultatif) Entrez une description : « Cette commande permet à l’utilisateur de spécifier les valeurs des données d’entrée requises pour l’exécution.
- Enregistrez la commande.
Étape 3 : Mise à jour de la commande Get
Nous allons mettre à jour la commande HTTP Request Get afin d’obtenir les détails d’une seule feuille de calcul au lieu de lister toutes les feuilles de calcul de l’espace de travail.
- Double-cliquez sur la commande Get - List of Spreadsheets pour la configurer.
- Nommez la commande : Obtenir - Récupérer une seule feuille de calcul.
-
Utilisez la variable Spreadsheet ID de Runtime Inputs dans le champ URL pour spécifier la feuille de calcul à récupérer.
Pour ce faire, cliquez sur le champ URL, et après /spreadsheets ajoutez « /<> »,
en remplaçant <Spreadsheet> par la variable de Runtime Inputs comme suit :- Dans le panneau de gauche, développez la liste déroulante Trigger.
- Développez la liste déroulante Runtime Inputs.
- Sélectionnez la variable Spreadsheet ID.
- (Facultatif) Entrez une Description : « Cette commande renvoie une seule feuille de calcul. Pour plus d’informations, consultez la documentation destinée aux développeurs à l’adresse https ://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/ »
- Enregistrez la commande .
Étape 4 : Testez l’exercice
Maintenant que la chaîne est terminée, nous pouvons tester le résultat.
- Publier la chaîne.
- Cliquez sur Execute, puis sur Run with Inputs.
- Trouvez une feuille de calcul ID, en accédant à une feuille de calcul dans la plate-forme Workiva. Assurez-vous que l’utilisateur a le droit d’accéder à cette feuille de calcul.
- Cliquez sur Démarrer.
- Une fois l’exécution de la chaîne terminée, vous pouvez voir que les détails de la feuille de calcul ont été générés dans l’onglet Outputs - Response Body de la commande Get.
To continue to challenge yourself and learn more about using the HTTP Request Connector to connect to a third party API, check out the next exercise CLP Copy a Spreadsheet (add link when document created).
-->