Modules Azure DevOps

Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Azure DevOps et les connecter à plusieurs applications et services tiers.

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

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

Conditions d’accès

Pour utiliser les fonctionnalités décrites dans cet article, vous devez disposer des éléments suivants :

Adobe Workfront forfait*
Pro ou un forfait supérieur
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelle : aucune exigence de licence Workfront Fusion

Ou

Exigence de licence héritée : Workfront Fusion for Work Automation and Integration

Produit

Exigences du produit actuel : si vous disposez du forfait Adobe Workfront Select ou Prime, votre entreprise doit acheter Adobe Workfront Fusion et Adobe Workfront pour utiliser les fonctionnalités décrites dans cet article. Workfront Fusion est inclus dans le forfait Workfront Ultimate.

Ou

Exigences du produit hérité : votre entreprise doit acheter Adobe Workfront Fusion et Adobe Workfront pour utiliser les fonctionnalités décrites dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez vote administrateur ou administratrice Workfront.

Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez les Adobe Workfront Fusion licences.

Conditions préalables

Pour utiliser les modules Azure DevOps, vous devez disposer d’un compte Azure DevOps.

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

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

  2. Cliquez sur Ajouter en regard 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. Par conséquent, nous vous déconseillons de l’utiliser.
  4. Renseignez 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 sous laquelle vous avez créé votre application Azure DevOps.
  5. Cliquez sur Continuer pour terminer la configuration de la connexion et continuer la création de votre scénario.

Modules Azure DevOps et leurs champs

Lorsque vous configurez des modules Azure DevOps, Workfront Fusion affiche les champs répertoriés ci-dessous. Des champs Azure DevOps supplémentaires peuvent également s’afficher, en fonction 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 de mappage situé au-dessus d’un champ ou d’une fonction s’affiche, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, consultez Mapper les informations d’un module à un autre dans Adobe Workfront Fusion.

Déclencheurs

Rechercher des tâches

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 les champs standard associés à l’enregistrement, ainsi que les champs et valeurs personnalisés auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de 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 Instant Triggers (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 authentifié personnalisé à l’API Azure DevOps. Ainsi, vous pouvez créer une automatisation du flux de données qui ne peut pas être réalisée par les autres modules Azure DevOps.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre compte Azure DevOps à Workfront Fusion, voir Connexion de Azure DevOps à Workfront Fusion dans cet article.
Base URL
Sélectionnez ou mappez l’URL de base que vous utilisez pour vous connecter à votre compte Azure DevOps.
URL relative

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 aucune version n’est sélectionnée, 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.

Remarque :

lors de l’utilisation d’instructions conditionnelles telles que if dans votre JSON, placez les guillemets en dehors de l’instruction conditionnelle.

Lecture d’enregistrement

Ce module d’action lit les données d’un seul enregistrement dans Azure DevOps.

Vous spécifiez l’identifiant 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 mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre compte Azure DevOps à Workfront Fusion, voir Connexion de Azure DevOps à Workfront Fusion dans cet article.
Type d’enregistrement

Indiquez si vous souhaitez lire un projet ou un élément de travail.

  • Project : sélectionnez le projet à lire.

  • Élément de travail : sélectionnez le projet contenant l’élément de travail à lire, puis sélectionnez le type d’élément de travail.

Outputs
Sélectionnez les informations que vous souhaitez inclure dans le lot 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.

Créer un enregistrement

Ce module d’action crée un projet ou une tâche.

Le module génère l’identifiant d’objet pour l’élément de travail nouvellement créé, ou l’URL et le code d’état d’un projet nouvellement créé.

Connection
Pour plus d’informations sur la connexion de votre compte Azure DevOps à Workfront Fusion, voir Connexion de Azure DevOps à Workfront Fusion dans cet article.
Type d’enregistrement

Indiquez si vous souhaitez créer un élément de travail ou un projet.

  • Project

    Renseignez les champs suivants :

    • Name : saisissez ou mappez un nom pour le nouveau projet.

    • Description : entrez ou mappez une description pour le nouveau projet.

    • Visibilité : choisissez si vous souhaitez que votre projet soit public ou privé. Les utilisateurs doivent être connectés à votre organisation et avoir accès au projet pour pouvoir interagir avec un projet privé. Les projets publics sont visibles par les utilisateurs qui ne sont pas connectés à votre entreprise.

    • Contrôle de version : choisissez si vous souhaitez que le projet utilise Git ou Team Foundation Version Control (TFCV) pour le contrôle de version.

    • Processus de l’élément de travail : sélectionnez le processus de travail à 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 Choose a Process dans la documentation Azure DevOps.

  • Élément de travail

    Renseignez les champs suivants :

    • Project : sélectionnez le projet dans lequel vous souhaitez créer l’élément de travail.

    • Type d’élément de travail : sélectionnez le type d’élément de travail à créer.

    • Autres champs : dans ces champs, saisissez la valeur que l’élément de travail doit avoir pour une propriété donnée. Les champs disponibles dépendent du 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.

Connection
Pour plus d’informations sur la connexion de votre compte Azure DevOps à Workfront Fusion, voir Connexion de Azure DevOps à Workfront Fusion dans cet article.
Project
Sélectionnez le projet qui contient l’élément de travail que vous souhaitez mettre à jour.
Type d’élément de travail
Sélectionnez le type d’élément de travail que vous souhaitez mettre à jour.
Autres champs
Dans chacun de ces champs, saisissez la valeur que l’élément de travail doit avoir pour une propriété donnée. Les champs disponibles dépendent du type d’élément de travail.
ID de l’élément de travail
Saisissez ou mappez l’identifiant de l’élément de travail que vous souhaitez mettre à jour.

Télécharger une pièce jointe

Ce module d’action télécharge un fichier et le joint à un élément de travail.

Le module renvoie l’identifiant de la pièce jointe et une URL de téléchargement pour la pièce jointe.

Connection
Pour plus d’informations sur la connexion de votre compte Azure DevOps à Workfront Fusion, voir Connexion de Azure DevOps à Workfront Fusion dans cet article.
Project
Sélectionnez le projet dans lequel vous souhaitez charger une pièce jointe.
ID de l’élément de travail
Saisissez ou mappez l’identifiant de l’élément de travail dans lequel vous souhaitez charger une pièce jointe.
Comment
Saisissez le texte d’un commentaire à 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.

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 plus d’informations sur la connexion de votre compte Azure DevOps à Workfront Fusion, voir Connexion de Azure DevOps à Workfront Fusion dans cet article.
URL de la pièce jointe
Saisissez ou mappez l’URL de la pièce jointe à télécharger.

Lier les éléments de travail

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

Le module renvoie l’identifiant de l’élément de travail principal et des champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre compte Azure DevOps à Workfront Fusion, voir Connexion de Azure DevOps à Workfront Fusion dans cet article.
ID de l’élément de travail
Saisissez ou mappez l’identifiant de l’élément de travail principal auquel vous souhaitez lier un autre élément de travail.
ID d’élément de travail lié
Saisissez ou mappez l’identifiant de l’élément de travail que vous souhaitez lier à l’élément de travail principal.
Type de lien

Définissez la relation entre les tâches que vous souhaitez lier.

Pour plus d’informations, voir Référence du type de lien dans la documentation Azure DevOps.

Comment
Saisissez ou mappez le texte d’un commentaire. Cela s’avère utile pour expliquer le raisonnement ou l’intention du lien.

Recherches

Liste des éléments de travail

Ce module d’action récupère toutes les tâches d’un type spécifique dans un projet Azure DevOps.

Le module renvoie l’identifiant de l’élément de travail principal et des champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre compte Azure DevOps à Workfront Fusion, voir Connexion de Azure DevOps à Workfront Fusion dans cet article.
Project
Sélectionnez le projet duquel vous souhaitez récupérer les tâches.
Type d’élément de travail
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 maximal d’éléments de travail renvoyés par Workfront Fusion au cours d’un cycle d’exécution.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43