Documentation › Créer un élément Azure DevOps

Créer un élément Azure DevOps depuis une étape

Une étape Azure DevOps crée un élément de travail (un élément du backlog, un bug, une tâche…) dans votre projet Azure DevOps. Le concepteur remplit l’élément une seule fois dans l’éditeur ; la personne qui fait l’étape clique sur un bouton, et l’élément existe, avec son numéro et son adresse gardés dans le process.

À quoi sert cette étape ?

• Vous ne quittez pas ProcNest pour écrire l’élément dans Azure DevOps : le titre, la description, les chemins de zone et d’itération, les étiquettes et les autres champs sont remplis pour vous.
• Le type d’élément se choisit dans l’étape : Product Backlog Item, User Story, Bug, Task, Feature, Epic… Prenez le type dans une variable pour que les personnes le choisissent pendant le déroulement du process (par exemple avec une question posée avant l’étape).
• L’étape garde aussi le numéro et l’adresse du nouvel élément dans des variables, que les étapes suivantes peuvent utiliser.

1. Dessiner l’étape dans l’éditeur

1. Ajouter l’étape

   Glissez Azure DevOps depuis la palette de l’éditeur de process, puis cliquez sur son bouton de modification. Dans l’onglet Properties, donnez un nom à l’étape et choisissez qui la fait, comme pour toute tâche.

2. Connexion

   Dans l’onglet Azure DevOps, écrivez l’Organization address (par exemple https://dev.azure.com/contoso), le Project et le Personal access token. Le jeton doit avoir le droit de créer des éléments de travail.

3. Élément de travail

   Choisissez l’Item type, puis écrivez le Title (obligatoire), la Description et les Acceptance criteria. Le HTML est permis dans les deux derniers.

4. Planification

   Remplissez ce dont vous avez besoin : Area path, Iteration path, Assigned to, Tags (séparées par des points-virgules), Priority (1 à 4), Effort et Parent item number. Un champ laissé vide n’est pas envoyé.

5. Autres champs

   Ajoutez tout autre champ de l’élément par son nom de référence, par exemple Custom.Team, et désactivez une ligne pour la garder sans l’envoyer.

6. Ce qu’il faut garder

   Choisissez la variable qui garde le numéro de l’élément et celle qui garde son adresse. Elles reçoivent un résultat (outcome) dans l’étape.

Partout, écrivez ${NomDeLaVariable} pour insérer la valeur qu’a une variable au moment de la création de l’élément, par exemple Corriger la connexion de ${Client}. Le projet, le type d’élément et le jeton peuvent aussi venir d’une variable. Si une variable n’a pas encore de valeur, rien n’est envoyé et ProcNest dit laquelle manque.

2. Créer l’élément

1. Ouvrir la tâche

   Dans My tasks, ouvrez la tâche créée à partir de l’étape. La section Azure DevOps item liste les variables qui garderont le numéro et l’adresse de l’élément.

2. Cliquer sur Create the item

   Azure DevOps crée l’élément. La réponse s’affiche sous le bouton, et le numéro et l’adresse de l’élément apparaissent dans les résultats de la tâche.

Si Azure DevOps refuse, Failed s’affiche avec la raison, et rien ne change dans les variables. Les causes habituelles : un jeton faux ou expiré (Azure DevOps répond par une page de connexion), un projet ou un type d’élément qui n’existe pas, un champ obligatoire dans votre process Azure DevOps.

Bon à savoir

• L’étape crée un élément à chaque clic : cliquez une fois, et vérifiez le numéro de l’élément avant de cliquer de nouveau.
• L’Effort va dans Story points pour une User Story et dans Effort pour les autres types. Utilisez Autres champs pour tout autre champ de votre process.
• Le Parent item number rattache le nouvel élément sous un élément existant (une fonctionnalité, une épopée).
• Pour appeler un autre service, ou faire autre chose dans Azure DevOps, utilisez un appel d’API dans une tâche.

Droits

• Dessiner l’étape : le droit de modifier les process. Utilisateurs et rôles explique comment l’obtenir.
• Créer l’élément : le droit de modifier vos tâches, comme pour toute tâche.