Avant de pouvoir inclure des actions externes dans vos workflows d’actions, vous devez connecter le créateur d’actions au système externe.

Mon édition
Suite, toutes les versions Team, Growth, Professional, Enterprise ou Enterprise Plus
Support Team, Professional ou Enterprise

Résumé ◀▼

Vous pouvez connecter le créateur d’actions avec Microsoft Azure DevOps pour automatiser les workflows qui créent, mettent à jour et gèrent les éléments de travail, les demandes d’extraction, les projets et les pipelines. Utilisez des actions externes, comme la création d’éléments de travail, l’ajout de commentaires, le déclenchement des exécutions du pipeline et la récupération des statuts pour améliorer la collaboration et simplifier la gestion des tâches sur les deux plateformes. Utilisez un compte de service dédié pour une authentification sécurisée et des permissions appropriées.

En connectant le créateur d’actions à des systèmes externes, comme Microsoft Azure DevOps, les administrateurs peuvent intégrer Zendesk à des systèmes externes dans des workflows automatisés, ce qui améliore la collaboration et permet d’assurer une expérience fluide et cohérente sur plusieurs plateformes.
Remarque – Les étapes associées aux systèmes externes dans des workflows d’actions sont appelées collectivement des actions externes.
Cet article aborde les sujets suivants :
  • Connexion de Microsoft Azure DevOps au créateur d’actions
  • Utilisation des actions Microsoft Azure DevOps dans les workflows d’actions

Connexion de Microsoft Azure DevOps au créateur d’actions

Avant de pouvoir inclure des actions externes dans vos workflows d’actions, vous devez connecter le créateur d’actions au système externe.

Lorsque vous vous connectez à des systèmes externes pour les utiliser dans des workflows d’actions, nous vous conseillons de suivre ces meilleures pratiques :
  • Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.
  • Toutes les intégrations nécessitent des portées obligatoires. Cependant, il est important d’examiner et de valider les portées avant de valider l’accès au système externe.
  • Si vous gérez les identifiants pour les outils basés sur des clés API, comme OpenAI, nous vous conseillons de stocker les clés dans un gestionnaire d’identifiants ou un coffre-fort sécurisé.
Pour connecter le créateur d’actions à Microsoft Azure DevOps
  1. Dans le Centre d’administration, cliquez sur Applications et intégrations () dans la barre latérale, puis sélectionnez Actions > Workflows d’actions.
  2. Créez ou modifiez un workflow d’actions.
  3. Ouvrez la barre latérale.
  4. Sous Actions externes, cliquez sur Microsoft Azure DevOps.
  5. Cliquez sur Connexion.
  6. Suivez les prompts de Microsoft Azure DevOps pour vous authentifier et terminer la connexion.

    La connexion Microsoft Azure DevOps utilise OAuth 2.0 pour sécuriser l’authentification. Vous serez redirigé vers Microsoft afin d’autoriser l’accès à votre organisation Azure DevOps. Le connecteur gère automatiquement l’actualisation des tokens quand cela est nécessaire.

    Vérifiez que l’utilisateur qui s’authentifie dispose des permissions appropriées dans votre organisation Azure DevOps pour les opérations que vous projetez de réaliser via les workflows d’actions.

    Remarque – Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.

Une fois que vous vous êtes connecté au système, vous verrez un indicateur de connexion et des détails sur l’instance à laquelle vous êtes connecté, ainsi que les actions disponibles pour Microsoft Azure DevOps.

Utilisation des actions Microsoft Azure DevOps dans les workflows d’actions

Les actions de Microsoft Azure DevOps suivantes sont disponibles :
  • Créer un élément de travail
  • Mettre à jour l’élément de travail
  • Rechercher un élément de travail
  • Ajouter un commentaire à un élément de travail
  • Répertorier les éléments de travail
  • Créer une demande d’extraction
  • Mettre à jour la demande d’extraction
  • Rechercher une demande d’extraction
  • Répertorier les demandes d’extraction
  • Rechercher un projet
  • Répertorier les projets
  • Répertorier les pipelines
  • Déclencher une exécution du pipeline
  • Obtenir le statut d’exécution du pipeline
  • Répertorier les exécutions du pipeline

Création d’un élément de travail

Utilisez l’action Créer un élément de travail pour créer un nouvel élément de travail dans un projet Azure DevOps.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project, Work item type, Title

Le champ de type d’élément de travail est rempli dynamiquement en fonction de la configuration de votre projet et peut inclure les types Bug, Task, User Story, Epic, Feature ou des types personnalisés.

Facultatives : Description, Assigned to, State, Priority, Tags, Area path, Iteration path, Repro steps, Acceptance criteria, Story points, Original estimate, Remaining work, Severity, Activity, Parent ID, Reason

Les champs facultatifs varient en fonction du type d’élément de travail (par exemple, Étapes de reproduction pour Bugs, Critères d’acceptation pour User Stories).
Sortie Objets d’élément de travail, notamment id, rev, work_item_type, title, description, state, assigned_to, created_date, changed_date, url et tous les détails des champs.

Mise à jour d’un élément de travail

Utilisez l’action Mettre à jour l’élément de travail pour modifier les champs d’un élément de travail existant.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Work item ID

Facultatives : Project, Title, Description, Assigned to, State, Priority, Tags, Reason, Area path, Iteration path, Remaining work, Completed work, Story points, Severity, Activity

Seuls les champs fournis sont modifiés. Les valeurs existantes pour les champs que vous ne spécifiez pas restent inchangées.

La sélection d’un projet active les options d’état, de chemin de zone et de chemin d’itération spécifiques au projet.
Sortie Objets d’élément de travail mis à jour, notamment id, rev, work_item_type, title, changed_date, url et tous les détails des champs mis à jour.

Recherche d’un élément de travail

Utilisez l’action Rechercher un élément de travail pour récupérer des informations détaillées sur un élément de travail spécifique par identifiant.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Work item ID

Facultatives : Expand relations, Expand comments

Configurez Développer les relations sur Oui pour inclure les éléments de travail parent, enfants, connexes, ainsi que les liens et les pièces jointes.

Configurez Développer les commentaires sur Oui pour inclure tous les commentaires et l’historique de discussion.
Sortie Objets d’éléments de travail, notamment tous les champs, avec facultativement les éléments de travail parent, enfants et connexes, ainsi que les pièces jointes et un tableau des commentaires.

Ajout d’un commentaire à un élément de travail

Utilisez l’action Ajouter un commentaire à un élément de travail pour publier un commentaire sur un élément de travail.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project, Work item ID, Comment text
Sortie Objets de commentaires, notamment comment_id, work_item_id, text, created_by, created_date, modified_date, url et comment_version.

Répertorier les éléments de travail

Utilisez l’action Répertorier les éléments de travail pour rechercher des éléments de travail en utilisant WIQL (Work Item Query Language) ou les champs de filtres.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project

Facultatives : Query, Title contains, Work item type, State, Assigned to, Tags contain, Area path, Max results, Sort field, Sort order

Vous pouvez utiliser le champ Requête pour rédiger des requêtes WIQL pour un filtrage avancé, ou le laisser vide pour utiliser les champs de filtres simples.

Par défaut, le nombre de résultats maximum est de 50 et il ne peut pas dépasser 200.

Vous pouvez trier les champs en fonction de la date de modification, la date de création, le titre ou la priorité.
Sortie Tableau de résultats des éléments de travail avec total_count et indicateur de pagination has_more.

Création d’une demande d’extraction

Utilisez l’action Créer une demande d’extraction pour créer une nouvelle demande d’extraction dans un référentiel Git.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project, Repository, Source branch, Target branch, Title

Facultatives : Description, Reviewers, Work item IDs, Is draft, Auto complete, Labels, Merge strategy, Delete source branch

Les noms de branches peuvent utiliser le format feature/branch-name ou refs/heads/feature/branch-name.

Les évaluateurs doivent être des adresses e-mail séparées par des virgules.

Les identifiants des éléments de travail doivent être des identifiants numériques séparés par des virgules.

Configurez Est un brouillon sur Oui pour créer un brouillon de demande d’extraction.
Sortie Objet de demande d’extraction, notamment pull_request_id, title, description, status, created_date, created_by, repository, source_branch, target_branch, reviewers array, tableau work_item_refs, url et web_url.

Mise à jour d’une demande d’extraction

Utilisez l’action Mettre à jour la demande d’extraction pour modifier une demande d’extraction existante.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project, Repository, Pull request ID

Facultatives : Title, Description, Status, Is draft, Auto complete enabled, Merge strategy

Seuls les champs fournis sont modifiés.

Le statut peut être Active, Completed ou Abandoned.

Configurez Remplissage automatique activé sur Oui pour fusionner automatiquement quand toutes les politiques sont appliquées..
Sortie Objet de demande d’extraction mis à jour, notamment pull_request_id, title, status, les détails de la fusion, last_merge_commit, closed_date, url et web_url.

Recherche d’une demande d’extraction

Utilisez l’action Rechercher une demande d’extraction pour récupérer des informations détaillées au sujet d’une demande d’extraction spécifique.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project, Repository, Pull request ID

Facultatives : Include commits, Include work items

Configurez Inclure les commits sur Oui pour récupérer tous les commits inclus dans la demande d’extraction.

Configurez Inclure les éléments de travail sur Oui pour récupérer les élément de travail liés.
Sortie Objet de demande d’extraction détaillé, notamment tous les champs, un tableau des évaluateurs, un tableau des libellés, les commits facultatifs et les tableaux work_item_refs (facultatifs), completion_options, url et web_url.

Répertorier les demandes d’extraction

Utilisez l’action Répertorier les demandes d’extraction pour récupérer les demandes d’extraction d’un référentiel Git.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project, Repository

Facultatives : Status, Creator ID, Reviewer ID, Source branch, Target branch, Max results, Skip

Le statut peut être Tout (par défaut), Active, Completed ou Abandoned.

Le nombre maximum de résultats est 1-100 (par défaut : 50).

Utilisez Ignorer pour la pagination pour ignorer les N premiers résultats.
Sortie Tableau des demandes d’extraction avec les objets de demandes d’extraction plus les détails de pagination avec total_count et l’indicateur has_more.

Recherche d’un projet

Utilisez l’action Rechercher un projet pour récupérer les informations d’un projet Azure DevOps spécifique.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project

Facultatives : Include capabilities, Include history

Configurez Inclure les capacités sur Oui pour récupérer le contrôle de version et les détails du modèle de processus.

Configurez Inclure l’historique sur Oui pour récupérer l’historique des modifications du projet.
Sortie Objet de projet, notamment id, name, description, state, visibility, default_team, url, avec capacités et historique (facultatifs).

Répertorier les projets

Utilisez l’action Répertorier les projets pour récupérer tous les projets dans une organisation.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization

Facultatives : State filter, Continuation token, Max results

Le filtre d’état accepte All, WellFormed (projets actifs, par défaut), Deleting ou New.

Le nombre maximum de résultats est 1-100 (par défaut : 100).
Sortie Tableau des projets avec objets de projets, notamment id, name, description, state, visibility et url, plus total_count et continuation_token.

Répertorier les pipelines

Utilisez l’action Répertorier les pipelines pour récupérer les pipelines de version dans un projet.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project

Facultatives : Pipeline name, Folder path, Continuation token

Le nom du pipeline prend en charge les correspondances partielles. Le format du chemin du dossier est \Production ou \CI\Builds.
Sortie Tableau des pipelines avec objets de pipelines, notamment id, name, folder, revision, url et web_url, plus total_count et continuation_token.

Déclencher une exécution du pipeline

Utilisez l’action Déclencher une exécution du pipeline pour déclencher une exécution du pipeline manuellement.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project, Pipeline ID

Facultatives : Branch, Variables, Resources repositories, Stages to skip

Le format de branche est main ou refs/heads/feature/branch-name.

Les variables doivent être un objet JSON (par exemple, {"Environment": "Production"}).
Sortie Objets d’exécution, notamment run_id, run_number, pipeline details, state, result, created_date, finished_date, url et web_url.

Obtention du statut d’exécution du pipeline

Utilisez l’action Obtenir le statut d’exécution du pipeline pour récupérer le statut et les détails d’une exécution du pipeline.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project, Pipeline ID, Run ID
Sortie Objet d’exécution détaillé, notamment run_id, run_number, name, state, result, pipeline details, created_date et finished_date.

L’état indique le statut actuel (En cours, Terminé, Annulation, Annulé). Le résultat spécifie le résultat (Succeeded, Failed, Annulé, etc.)

Répertorier les exécutions du pipeline

Utilisez l’action Répertorier les exécutions du pipeline pour récupérer les exécutions récentes pour un pipeline spécifique.

Cette action a les entrées et les sorties suivantes :

  Variables
Entrées Obligatoires : Organization, Project, Pipeline ID

Facultatives : Result filter, State filter, Max results, Continuation token

Le filtre de résultat accepte Tout, Succeeded, Failed, etc. Le nombre maximum de résultats est 1-100 (par défaut : 50).
Sortie Tableau d’exécutions avec objets d’exécutions, notamment run_id, run_number, state, result et urls, plus total_count et continuation_token.
Réalisé par Zendesk