Considérons une situation où nous souhaitons lancer automatiquement plusieurs flux de travail dans Pneumatic en fonction de certaines entrées tabulées que nous avons dans une feuille de calcul Google Sheets.
Cas d’utilisation de l’API publique de Pneumatic
La façon dont nous procéderions est d’abord d’obtenir des informations sur les champs de formulaire de démarrage que nous devrions fournir pour chaque flux de travail, puis d’utiliser ces informations pour structurer notre feuille de calcul. Ensuite, nous entrerions des informations pour chaque flux de travail dans notre feuille de calcul et exécuterions un script pour lancer les flux de travail dans Pneumatic.
Configuration de votre environnement
Nous avons créé une feuille de calcul Google avec deux simples scripts App que vous pouvez consulter et étendre. Un script récupère des informations sur les champs de formulaire de démarrage à partir d’un modèle, l’autre lance des flux de travail en fonction des informations que vous saisissez dans les lignes.
Commencer par la copier et essayez de l’exécuter tel quel, en fournissant simplement votre clé API. Pour l’utiliser, vous devez d’abord saisir votre clé API et l’identifiant du modèle que vous souhaitez utiliser pour lancer plusieurs flux de travail.
Obtention des entrées initiales
Vous devez fournir deux informations pour que le script fonctionne:
Votre clé API et
L’identifiant du modèle à partir duquel vous exécuterez de nouveaux flux de travail
Clé API
Vous trouverez votre clé API sur la page d’intégrations de votre interface Pneumatic - il vous suffit de la copier-coller dans la feuille de calcul là où il est indiqué d’entrer votre clé API.
Identifiant du modèle
Pour obtenir l’identifiant du modèle, accédez à la page d’édition du modèle du modèle que vous souhaitez et regardez l’URL du modèle. La valeur numérique avant le dernier slash est l’identifiant du modèle, il vous suffit de le copier-coller dans la cellule ID de modèle de la feuille de calcul.
Autorisations
Si vous essayez d’exécuter l’un ou l’autre script dans la feuille de calcul, Google vous demandera l’autorisation de les exécuter, donnez l’autorisation en cliquant sur Autoriser.
Obtenir les données du modèle
Une fois que vous avez fait cela, cliquez sur le bouton Obtenir les champs de démarrage pour lancer le premier script:
Voir vos scripts
Vous pouvez trouver les scripts dans le fichier en allant à Extensions —> Apps Script
Le script interroge Pneumatic pour le modèle dont vous avez entré l’identifiant dans la feuille de calcul et remplit la 4e ligne avec les noms des champs ainsi que les identifiants d’option pour les champs qui ont des sélections.
Une fois que vous avez les noms des champs et les identifiants de sélection, vous pouvez saisir les valeurs des champs de formulaire de démarrage que vous souhaitez transmettre à Pneumatic pour de nouveaux flux de travail dans les lignes ci-dessous.
Exportation des valeurs des champs de données de flux de travail
Apprenez à utiliser l'API de Pneumatic pour obtenir des données des champs de sortie de flux de travail et des champs de formulaire de démarrage dans Pneumatic dans une feuille de calcul Google Sheet.
Notez que vous devez entrer les identifiants d’option numériques pour les champs qui ont des sélections. Ceux-ci auront été ajoutés entre parenthèses aux noms des champs qui ont des sélections.
Une fois que vous avez fait cela, vous pouvez cliquer sur le bouton Lancer les flux de travail pour lancer le deuxième script attaché à la feuille de calcul:
Ce script itère sur les lignes à partir de la ligne 6 aussi longtemps qu’il y a des données dans les lignes. Pour chaque ligne, le script lance un nouveau flux de travail en utilisant les informations contenues dans les cellules de cette ligne - cela se fait en bouclant sur les cellules de chaque ligne (la deuxième boucle while).
Vous pouvez utiliser ce tableau tel quel. En fonction du modèle que vous choisissez, les noms des champs varieront. Alternativement, vous pouvez modifier les scripts pour étendre leurs capacités.
Résultats
Si vous allez maintenant dans Pneumatic, vous verrez vos flux de travail nouvellement créés :
Et si les responsables de vos tâches accèdent à leurs tâches, ils verront qu’ils ont été attribués de nouvelles tâches à partir des flux de travail qui viennent d’être créés :
4 minute de lecture
