Exporter les valeurs des champs de données du flux de travail
Les flux de travail pneumatics vous permettent d'ajouter plusieurs champs de données personnalisés au formulaire de lancement et à chaque étape du processus. Et si je vous disais comment vous pourriez obtenir les valeurs de ces champs de données depuis l'extérieur de Pneumatic et les placer, par exemple, dans une feuille de calcul Google Sheets dans un format tabulaire ? Vous pouvez le faire en exploitant l'API publique de Pneumatic.
Configuration de votre environnement
Nous avons préparé une feuille de calcul Google Sheets pour vous avec un AppScript qui accède à l’API publique de Pneumatic en utilisant une clé d’API et un ID de modèle que vous fournissez.
Il est partagé en tant que feuille de calcul en lecture seule, vous devez donc en faire une copie avant de commencer.
Trouver votre clé d’API et votre ID de modèle
Pour que le script fonctionne correctement, vous devez fournir votre clé API et un ID de modèle, car il récupère les valeurs des champs de données pour les workflows basés sur un modèle spécifique. Vous trouvez votre clé API sur votre page d’intégration. Il vous suffit de la copier et de la coller dans la feuille de calcul.
La prochaine information que vous devez fournir est un ID de modèle, accédez aux modèles, sélectionnez un modèle dont vous voulez obtenir les champs de données, et regardez l’URL du modèle :
L’ID de modèle est le code numérique avant le dernier slash dans l’URL, il vous suffit de le copier et de l’entrer dans la feuille de calcul sous la clé API. Copiez-le simplement et collez-le dans la troisième ligne de la feuille de calcul, ajoutez une virgule et ensuite un autre nom de champ API, et ainsi de suite.
Trouver vos ID de champ
La dernière information dont vous avez besoin est une liste séparée par des virgules des noms API des champs de données dont vous souhaitez obtenir les valeurs.
Je sais, cela peut sembler un peu intimidant, mais vous pouvez en fait les trouver dans votre interface également. Sur la page d’édition du modèle, ouvrez le formulaire de lancement ou la tâche qui contient les champs qui vous intéressent, puis allez dans le menu hamburger sur la droite, le nom API du champ est le premier élément de la liste qui s’ouvre.
Copiez-le simplement et collez-le dans la troisième ligne de la feuille de calcul, ajoutez une virgule et ensuite un autre nom de champ API, et ainsi de suite.
Autorisations
Si vous essayez d’exécuter l’un des scripts dans la feuille de calcul, Google vous demandera l’autorisation de les exécuter, donnez la permission en cliquant sur Autoriser.
Exécution du script d’application d’exemple
Une fois que vous avez fourni toutes ces informations, cliquez simplement sur Obtenir les champs de données et le script remplira la quatrième ligne avec les noms des champs tels que vous les avez définis, tandis que les autres lignes contiendront les noms des workflows et les valeurs des champs :
Notez que la première fois que vous essayez d’exécuter le script, Google vous demandera l’autorisation de l’exécuter, cliquez sur Autoriser, puis cliquez à nouveau sur le bouton.
Vous pouvez trouver le script lui-même en allant sur Extensions —> Apps Script
Le script assigné au bouton Obtenir les champs de données est nommé showFieldValues, vous pouvez le consulter et le modifier selon vos préférences :
Il récupère les valeurs que vous saisissez dans la feuille de calcul, puis assemble un objet de configuration et un objet de paramètres, l’objet de paramètres est ensuite transformé en une queryString et ajouté au paramètre apiUrl. Le script effectue alors une requête fetch sur l’objet UrlFetchApp.
Il boucle ensuite sur les résultats analysés de la requête pour récupérer les valeurs des champs de données. Lors de la récupération des valeurs pour la première ligne, il obtient également les noms des colonnes (c’est ce que fait l’instruction if à l’intérieur de la boucle for interne).
Lancement de plusieurs workflows depuis Google Sheets
Apprenez à utiliser l'API de Pneumatic pour lancer plusieurs workflows de manière programmée dans Pneumatic en fonction des données tabulées dans une feuille de calcul Google Sheets.
Le fichier contient également plusieurs autres scripts d’exemple qui récupèrent des données de l’API de Pneumatic. Tous ces scripts récupèrent l’ID de modèle et la clé API de la feuille de calcul, puis affichent simplement les résultats dans le journal d’exécution. De cette manière, vous pouvez voir quel type de données vous pouvez obtenir en accédant aux différents points finaux de l’API de Pneumatic.
3 minute de lecture
