Modules Azure DevOps
Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Azure DevOps et le connecter à plusieurs applications et services tiers.
Pour obtenir des instructions sur la création d’un scénario, consultez les articles sous Créer des scénarios : index d’article.
Pour plus d’informations sur les modules, consultez les articles sous Modules : index des articles.
Conditions d’accès
Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.
Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :
| Package Adobe Workfront | Tous |
| Licence Adobe Workfront |
Nouveau : Standard Ou En cours : Travail ou version ultérieure |
| Licence Adobe Workfront Fusion ** |
Actuel : aucune exigence de licence Workfront Fusion Ou Hérité : Workfront Fusion pour l’automatisation et l’intégration du travail |
| Produit |
Nouveau :
Ou Actuel : votre entreprise doit acheter Adobe Workfront Fusion. |
Pour plus d’informations sur les informations contenues dans ce tableau, voir Conditions d’accès requises dans la documentation.
Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.
Conditions préalables
Pour utiliser les modules Azure DevOps, vous devez disposer d’un compte Azure DevOps.
Informations sur l’API Azure DevOps
Le connecteur Azure DevOps utilise les éléments suivants :
| Version de l’API | v5.1 |
| Balise API | v1.29.33 |
Connecter Azure DevOps à Workfront Fusion
-
Ajoutez un module Azure DevOps à votre scénario.
-
Cliquez sur Ajouter à côté du champ Connexion.
-
Dans le champ Type de connexion, sélectionnez Azure DevOps.
IMPORTANTLe type de connexion Azure DevOps (Demander toutes les portées) sera bientôt obsolète. Nous vous déconseillons donc de l’utiliser. -
Remplissez les champs suivants :
Connection nameSaisissez un nom pour la connexion que vous créez.OrganizationSaisissez le nom de l’organisation dans laquelle vous avez créé votre application Azure DevOps. -
Pour saisir un ID d’application Azure DevOps ou un secret client, cliquez sur Afficher les paramètres avancés et saisissez-les dans les champs qui s’ouvrent.
-
Cliquez sur Continuer pour terminer la configuration de la connexion et poursuivre la création de votre scénario.
Modules Azure DevOps et leurs champs
Lorsque vous configurez les modules Azure DevOps, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs Azure DevOps supplémentaires peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.
Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, voir Mappage des informations d’un module à un autre.
Déclencheurs
Surveiller des éléments de travail
Ce module de déclenchement instantané exécute un scénario lorsqu’un enregistrement est ajouté, mis à jour ou supprimé dans Azure DevOps.
Le module renvoie tous les champs standard associés à l’enregistrement, ainsi que tous les champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Sélectionnez ou ajoutez un webhook pour le module.
Pour plus d’informations sur les webhooks dans les modules de déclenchement, voir Déclencheurs instantanés (webhooks).
Pour plus d’informations sur la création d’un webhook, voir Webhooks.
Actions
Créer un enregistrement
Ce module d’action crée un projet ou un élément de travail.
Le module génère l’ID de l’objet pour l’élément de travail nouvellement créé, ou l’URL et le code d’état d’un projet nouvellement créé.
Sélectionnez si vous souhaitez créer un élément de travail ou un projet.
-
Project
Remplissez les champs suivants :
-
Name : saisissez ou mappez un nom pour le nouveau projet.
-
Description : saisissez ou mappez une description pour le nouveau projet.
-
Visibility : sélectionnez si vous souhaitez que votre projet soit public ou privé. Les utilisateurs et utilisatrices doivent être connectés à votre organisation et avoir reçu l’autorisation d’accéder au projet pour pouvoir interagir avec un projet privé. Les projets publics sont visibles par les utilisateurs et utilisatrices qui ne sont pas connectés à votre organisation.
-
Version control : indiquez si vous souhaitez que le projet utilise Git ou Team Foundation Version Control (TFCV) pour la gestion de versions.
-
Work item process : sélectionnez le processus de travail que vous souhaitez utiliser pour le projet. Les options sont Basic, Scrum, Capability Maturity Model Integration (CMMI) et Agile.
Pour plus d’informations sur les processus Azure DevOps, voir Processus par défaut et modèles de processus dans la documentation Azure DevOps.
-
-
Work item
Remplissez les champs suivants :
-
Project : sélectionnez le projet dans lequel vous souhaitez créer l’élément de travail.
-
Work item type : sélectionnez le type d’élément de travail que vous souhaitez créer.
-
Autres champs : dans ces champs, saisissez la valeur que vous souhaitez que l’élément de travail ait pour une propriété donnée. Les champs disponibles dépendent du type d’élément de travail.
-
Appel API personnalisé
Ce module d’action vous permet d’effectuer un appel personnalisé et authentifié à l’API Azure DevOps. Cela vous permet de créer une automatisation du flux de données qui ne peut pas être réalisée par les autres modules Azure DevOps.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Saisissez l’URL relative à laquelle vous souhaitez vous connecter pour cet appel API.
Exemple : {organization}/_apis[/{area}]/{resource}
Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard.
Par exemple, {"Content-type":"application/json"}
Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard.
Par exemple : {"name":"something-urgent"}
Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.
Note :
Lorsque vous utilisez des instructions conditionnelles telles que if dans votre JSON, placez les guillemets à l’extérieur de l’instruction conditionnelle.
Télécharger une pièce jointe
Ce module d’action télécharge une pièce jointe.
Le module renvoie le contenu du fichier de la pièce jointe.
Lier des éléments de travail
Ce module d’action lie deux éléments de travail et définit la relation entre eux.
Définissez la relation entre les éléments de travail que vous souhaitez lier.
Pour plus d’informations, consultez le Guide de référence pour les types de liens dans la documentation Azure DevOps.
Lire l’enregistrement
Ce module d’action lit les données d’un seul enregistrement dans Azure DevOps.
Vous indiquez l’ID de l’enregistrement.
Le module renvoie l’identifiant de l’enregistrement et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Sélectionner si vous voulez lire un projet ou un élément de travail.
-
Project : sélectionnez le projet que vous souhaitez lire.
-
Work item : sélectionnez le projet qui contient l’élément de travail que vous souhaitez lire, puis sélectionnez le type d’élément de travail.
Mettre à jour un élément de travail
Ce module d’action met à jour un élément de travail existant à l’aide de son identifiant.
Le module renvoie l’identifiant de l’élément de travail mis à jour.
Charger une pièce jointe
Ce module d’action permet de charger un fichier et de le joindre à un élément de travail.
Le module renvoie l’ID de la pièce jointe et l’URL de téléchargement de la pièce jointe.
Recherches
Répertorier des éléments de travail
Ce module d’action récupère tous les éléments de travail d’un type spécifique dans un projet Azure DevOps.
Le module renvoie l’ID de l’élément de travail principal et tous les champs associés, ainsi que tous les champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.