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
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Package Adobe Workfront |
Tout package de workflow Adobe Workfront et tout package d’automatisation et d’intégration Adobe Workfront Workfront Ultimate Packages Workfront Prime et Select, avec l’achat supplémentaire de Workfront Fusion. |
| Licences Adobe Workfront |
Standard Travail ou supérieur |
| Licence Adobe Workfront Fusion |
Basé sur les opérations : disponible pour les organisations disposant de licences basées sur les opérations Basé sur un connecteur (hérité) : Workfront Fusion pour l’automatisation et l’intégration du travail |
| Produit | Si votre organisation dispose d’un package Workfront Select ou Prime qui n’inclut pas l’automatisation et l’intégration de Workfront, elle doit acquérir Adobe Workfront Fusion. |
Pour plus d’informations sur le contenu de ce tableau, consultez Conditions d’accès requises dans la documentation.
Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez 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 DevOps d’Azure utilise les éléments suivants :
Connecter Azure DevOps à Workfront Fusion connect-azure-devops-to-workfront-fusion
Connexion d’Azure DevOps à Workfront Fusion à l’aide d’EntraApp
-
Ajoutez un module Azure DevOps à votre scénario.
-
Cliquez sur Ajouter à côté du champ Connexion.
-
Dans le champ Type de connexion, sélectionnez le type de connexion à utiliser.
note NOTE Le Azure DevOps (EntraApp) vous permet de demander toutes les portées de la connexion. -
Remplissez les champs suivants :
table 0-row-2 1-row-2 2-row-2 3-row-2 4-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. App ID Saisissez l’identifiant de l’application DevOps à laquelle vous vous connectez. Client Secret Saisissez le secret client pour les applications DevOps auxquelles vous vous connectez. Demander toutes les portées Si vous utilisez le type de connexion Azure DevOps (EntraApp) , activez cette option pour demander toutes les portées de la connexion. -
Pour saisir un ID d’application DevOps Azure 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.
Connecter les opérations de développement Azure à Workfront Fusion à l’aide d’un principal de service
Vous pouvez créer une connexion qui utilise un principal de service (une connexion API d’application) au lieu d’un compte personnel. Cela s’avère utile lorsque vous souhaitez que la connexion s’exécute en tant qu’identité d’application ou de service plutôt qu’en tant que personne spécifique. Cela peut s’avérer utile pour que l’intégration ne se rompe pas si, par exemple, cette personne quitte l’entreprise ou modifie son mot de passe.
Ce type de connexion est disponible pour tous les modules DevOps d’Azure.
- Conditions préalables à la connexion d’Azure DevOps à Workfront Fusion à l’aide d’un principal de service
- Création de l’enregistrement de l’application dans l’ID Microsoft Entra
- Créer un secret client
- Collecter les détails de votre connexion
- Ajoutez le principal de service à votre organisation DevOps Azure
- Créer la connexion
Conditions préalables à la connexion d’Azure DevOps à Workfront Fusion à l’aide d’un principal de service
Pour créer cette connexion, vous avez besoin des éléments suivants :
- Accès administrateur global ou administrateur de l’application dans l’ID d’entrée Microsoft, pour enregistrer l’application. Si vous ne disposez pas de cet accès, demandez à un membre de votre équipe informatique ou d’identité de terminer cette étape pour vous.
- Administrateur de la collecte de projets accédez à votre organisation DevOps Azure pour ajouter le principal de service en tant que membre. Il s’agit souvent d’une personne différente de celle qui gère l’identifiant Microsoft Entra.
- Nom de votre organisation Azure DevOps. Vous pouvez le retrouver dans votre URL DevOps Azure :
dev.azure.com/<your organization name>.
Création de l’enregistrement de l’application dans l’ID Microsoft Entra
- Connectez-vous au centre d’administration Microsoft Entra.
- Accédez à Enregistrements des applications > Nouvel enregistrement.
- Donnez à l’application un nom clair et reconnaissable. Par exemple,
Workfront Fusion Azure DevOps Integration. - Laissez le champ URI de redirection vide. Cette connexion n’implique pas de connexion via un navigateur.
- Sélectionnez Enregistrer.
- Passez à Créer un secret client.
Créer un secret client
- Dans l’enregistrement de votre nouvelle application, accédez à Certificats et secrets.
- Sélectionnez Nouveau secret client, ajoutez une description, puis choisissez une période d’expiration.
- Sélectionnez Ajouter.
- Copiez immédiatement la valeur du secret. Il s’affiche une seule fois. Si vous quittez cette page avant de la copier, vous devez en créer une nouvelle.
- Continuez pour Collecter les détails de votre connexion.
Collecter les détails de votre connexion
-
Sur la page Aperçu de l’enregistrement de l’application, notez les valeurs suivantes. Vous les saisissez lors de la création de la connexion dans le module .
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Tenant ID Sur la page Aperçu , intitulé ID de répertoire (client). Client ID Sur la page Aperçu , intitulé ID d’application (client). Client Secret Valeur copiée dans Créer un secret client. Organization Nom de votre organisation Azure DevOps. Par exemple, si votre URL est dev.azure.com/yourorg, saisissezyourorg.note NOTE Vous pouvez ignorer la zone Autorisations API de l’enregistrement de l’application. Si vous y ajoutez des opérations de développement Azure, seules les autorisations déléguées sont disponibles. Les Autorisations d’application apparaissent grisées. Cela est normal, car les opérations de développement Azure ne prennent pas en charge l’octroi d’accès de cette manière. Au lieu de cela, l’accès est accordé directement dans les DevOps Azure, dans la partie suivante. -
Passez à Ajouter le principal de service à votre organisation DevOps Azure.
Ajoutez le principal de service à votre organisation DevOps Azure
L’enregistrement de l’application dans Microsoft Entra ID crée uniquement son identité. L’application n’a pas encore accès à vos données DevOps Azure. Cette procédure permet d’accorder cet accès.
-
Connectez-vous à votre organisation Azure DevOps à l’adresse
dev.azure.com/<your organization name>. -
Sélectionnez Paramètres de l’organisation dans le coin inférieur gauche, puis sélectionnez Utilisateurs.
-
Sélectionnez Ajouter des utilisateurs.
-
Dans la zone de recherche, effectuez une recherche en fonction du nom d’affichage de l’application, qui est le nom que vous lui avez donné lors de son enregistrement. Ne pas effectuer de recherche par ID client.
-
Sélectionner un niveau d’accès :
- De base est généralement suffisant pour lire et écrire des éléments de travail, des tableaux et des référentiels.
- Si votre workflow doit parcourir les processus disponibles, tels que les modèles Agile, Scrum ou personnalisés, dans le cadre de la configuration, ajoutez plutôt le principal de service au groupe Administrateurs de collection de projets. Il s’agit d’un niveau d’accès plus large, donc n’accordez-le que si vous avez besoin de cette fonctionnalité.
-
Attribuez le principal de service au ou aux projets spécifiques dont il a besoin, en suivant les pratiques d’accès habituelles de votre entreprise.
-
Sélectionnez Ajouter.
-
Passez à Créer la connexion .
Créer la connexion
-
Dans l’écran de configuration de la connexion du module, sélectionnez le type de connexion Principal de service.
-
Saisissez les informations suivantes :
- ID de client
- Identifiant du client
- Secret du client
- Organisation
-
Enregistrez la connexion.
Si tout est correctement configuré, la connexion est validée avec succès.
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, consultez Mappage d’informations d’un module à l’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.
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éé.
Appel API personnalisé
Ce module d’action vous permet d’effectuer un appel personnalisé et authentifié vers 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.
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.
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.
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.