Vous cherchez à vous connecter à une application tierce au-delà des connecteurs Premium prédéfinis de Workiva ? Pour ce faire, vous pouvez utiliser les commandes du connecteur de requêtes HTTP afin d'interagir avec les API REST.
Remarque : bien que cette option soit intitulée « Requête HTTP », le protocole HTTPS (HTTP sécurisé) 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 CLP complet | Feuilles de calcul répertoriant les requêtes HTTP |
| Modèle de support | CLP | Demande HTTP Obtenir une seule feuille de calcul |
Étape 1 : Copier et modifier une chaîne
- Accédez à Chain Builder et recherchez les feuilles de calcul « Chain CLP | Liste des requêtes HTTP ».
- Cliquez sur les trois points verticaux pour copier la chaîne.
- Cliquez sur l’icône en forme de crayon pour modifier la chaîne.
- Cliquez sur « Paramètres de la chaîne » en haut à droite, puis renommez la chaîne : CLP | Requête HTTP pour récupérer une seule feuille de calcul .
- ( Facultatif ) Saisissez une description : « Cette chaîne génère un nouveau jeton d'accès à l'API 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 » pour déclencher 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éplacer la commande « POST - Récupérer un jeton » hors du nœud de départ.
- Ajoutez un événement « Chaîne d'entrées d'exécution » (Runtime Inputs Chain Event) de la catégorie « Événements de déclenchement de chaîne » (Chain Trigger Events ) au nœud de départ.
- Double-cliquez sur le lien qui relie les « Runtime Inputs » à la commande « Get - List Spreadsheets », puis supprimez ce lien.
- Connecter les entrées d'exécution à la commande « POST - Récupérer un jeton ».
-
Reliez la commande POST « Récupérer un jeton » à la commande GET « Lister les feuilles de calcul ».
- Double-cliquez sur l'événement « Runtime Inputs Chain » pour le configurer.
- Cliquez sur « Ajouter une entrée » et configurez les champs suivants :
- Type : Champ de texte
- Nom d'affichage : ID de la feuille de calcul - consultez ce document pour savoir comment trouver l'ID
- Obligatoire : cochez cette case
- ( Facultatif ) Saisissez une description : « Cette commande permet à l'utilisateur de spécifier les valeurs des paramètres d'exécution obligatoires. »
- 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 - Liste des feuilles de calcul » pour la configurer.
- Nom de la commande : Get - Récupérer une seule feuille de calcul .
-
Utilisez la variable « ID de la feuille de calcul » de la section « Entrées d'exécution » dans le champ URL pour indiquer quelle feuille de calcul récupérer.
Pour ce faire, cliquez sur le champ URL , puis ajoutez « / < ID de la feuille de calcul > » après /spreadsheets , en
remplaçant par <Spreadsheet ID> avec la variable issue des entrées d'exécution , comme suit :- Dans le volet de gauche, développez le menu déroulant « Déclencheur ».
- Dépliez le menu déroulant « Entrées d'exécution ».
- Sélectionnez la variable « ID de la feuille de calcul ».
- ( Facultatif ) Saisissez 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/2026-01-01/getspreadsheetbyid.html"
- 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 « Exécuter », puis sur « Exécuter avec les données d'entrée ».
- Trouver un ID de la feuille de calcul, en accédant à une feuille de calcul sur la plateforme Workiva. Assurez-vous que l’utilisateur a le droit d’accéder à cette feuille de calcul.
- Cliquez sur « Démarrer ».
- Une fois que la chaîne a terminé son exécution, vous pouvez constater que les détails de la feuille de calcul ont été générés dans l'onglet « Outputs » ( Résultats ), dans le corps de la réponse de la commande GET .