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.

Si vous avez besoin d’instructions sur la création d’un scénario, consultez Créer un scénario dans Adobe Workfront Fusion.

Pour plus d’informations sur les modules, voir Modules dans Adobe Workfront Fusion.

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Adobe Workfront formule*
Pro ou version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Exigences de licence héritées : Workfront Fusion for Work Automation and Integration

Produit

Exigences actuelles du produit : si vous avez le plan Select ou Prime Adobe Workfront, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule Workfront Ultimate.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.

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.

Azure DevOps informations sur l’API

Le connecteur Azure DevOps utilise les éléments suivants :

Version de l’API
v5.1
Balise API
1.29.33

Connecter Azure DevOps à Workfront Fusion connect-azure-devops-to-workfront-fusion

  1. Ajoutez un module Azure DevOps à votre scénario.

  2. Cliquez sur Ajouter à côté du champ Connexion.

  3. Dans le champ Type de connexion, sélectionnez Azure DevOps.

    note important
    IMPORTANT
    Le type de connexion Azure DevOps (Demander toutes les portées) sera bientôt obsolète. Nous vous déconseillons donc de l’utiliser.
  4. Remplissez les champs suivants :

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Connection name Saisissez un nom pour la connexion que vous créez.
    Organization Saisissez le nom de l’organisation dans laquelle vous avez créé votre application Azure DevOps.
  5. 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 Mapper des informations d’un module à l’autre dans Adobe Workfront Fusion.

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.

Webhook

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) dans Adobe Workfront Fusion.

Pour plus d’informations sur la création d’un webhook, voir Webhooks.

Actions

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.

Connection
Pour savoir comment connecter votre compte Azure DevOps à Workfront Fusion, voir Connecter Azure DevOps à Workfront Fusion dans cet article.
Base URL
Sélectionner ou mapper l’URL de base que vous utilisez pour vous connecter à votre compte Azure DevOps.
Relative URL

Saisissez l’URL relative à laquelle vous souhaitez vous connecter pour cet appel API.

Exemple : {organization}/_apis[/{area}]/{resource}

API Version
Sélectionnez ou mappez la version de l’API Azure DevOps à laquelle vous souhaitez vous connecter pour cet appel API. Si vous ne sélectionnez aucune version, Workfront Fusion se connecte à l’API Azure DevOps version 5.1.
Method
Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir Méthodes de requête HTTP dans Adobe Workfront Fusion.
Headers

Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard.

Par exemple, {"Content-type":"application/json"}

Query String

Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard.

Par exemple : {"name":"something-urgent"}

Body

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.

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éé.

Connection
Pour savoir comment connecter votre compte Azure DevOps à Workfront Fusion, voir Connecter Azure DevOps à Workfront Fusion dans cet article.
Record type

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, consultez Choisir un 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.

    • Other fields  : dans ces champs, saisissez la valeur que vous souhaitez donner à l’élément de travail pour une propriété donnée. Les champs disponibles dépendent du type d’élément de travail.

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.

Connection
Pour savoir comment connecter votre compte Azure DevOps à Workfront Fusion, voir Connecter Azure DevOps à Workfront Fusion dans cet article.
Attachment URL
Saisissez ou mappez l’URL de la pièce jointe que vous souhaitez télécharger.

Lier des éléments de travail

Ce module d’action lie deux éléments de travail et définit la relation entre eux.

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.

Connection
Pour savoir comment connecter votre compte Azure DevOps à Workfront Fusion, voir Connecter Azure DevOpsà Workfront Fusion dans cet article.
Work item ID
Saisissez ou mappez l’ID de l’élément de travail principal auquel vous souhaitez lier un autre élément de travail.
Linked work item ID
Saisissez ou mappez l’ID de l’élément de travail que vous souhaitez lier à l’élément de travail principal.
Link Type

Définissez la relation entre les éléments de travail que vous souhaitez lier.

Pour plus d’informations, voir Guide de référence pour les types de liens dans la documentation Azure DevOps.

Comment
Saisir ou mapper le texte d’un commentaire. Ceci est utile pour expliquer le raisonnement ou l’intention du lien.

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.

Connection
Pour savoir comment connecter votre compte Azure DevOps à Workfront Fusion, voir Connecter Azure DevOps à Workfront Fusion dans cet article.
Record type

Sélectionner si vous voulez lire un projet ou un élément de travail.

  • Project  : sélectionnez le projet que vous voulez 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.

Outputs
Sélectionnez les informations que vous souhaitez inclure dans le bundle de sortie pour ce module. Les champs disponibles dépendent du type d’élément de travail.
ID
Saisissez ou mappez l’identifiant de l’enregistrement que vous souhaitez lire.

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.

Connection
Pour savoir comment connecter votre compte Azure DevOps à Workfront Fusion, voir Connecter Azure DevOps à Workfront Fusion dans cet article.
Project
Sélectionnez le projet qui contient l’élément de travail que vous souhaitez mettre à jour.
Work Item Type
Sélectionnez le type d’élément de travail que vous souhaitez mettre à jour.
Other Fields
Dans chacun de ces champs, saisissez la valeur que vous souhaitez donner à l’élément de travail pour une propriété donnée. Les champs disponibles dépendent du type d’élément de travail.
Work item ID
Saisissez ou mappez l’ID de l’élément de travail que vous souhaitez mettre à 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.

Connection
Pour savoir comment connecter votre compte Azure DevOps à Workfront Fusion, voir Connecter Azure DevOps à Workfront Fusion dans cet article.
Project
Sélectionnez le projet dans lequel vous souhaitez charger une pièce jointe.
Work item ID
Saisissez ou mappez l’ID de l’élément de travail dans lequel vous souhaitez charger une pièce jointe.
Comment
Saisissez le texte d’un commentaire que vous souhaitez ajouter à la pièce jointe chargée.
Source file
Sélectionnez un fichier source à partir d’un module précédent, ou saisissez ou mappez le nom et le contenu du fichier source.

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.

Connection
Pour savoir comment connecter votre compte Azure DevOps à Workfront Fusion, voir Connecter Azure DevOps à Workfront Fusion dans cet article.
Project
Sélectionnez le projet dont vous souhaitez récupérer les éléments de travail.
Work item type
Sélectionnez le type d’élément de travail que vous souhaitez récupérer.
Outputs
Sélectionnez les propriétés à afficher dans la sortie du module. Les champs disponibles dépendent du type d’élément de travail que vous souhaitez récupérer. Vous devez sélectionner au moins une propriété.
Limit
Saisissez ou mappez le nombre maximum d’éléments de travail que Workfront Fusion renvoie au cours d’un cycle d’exécution.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43