Documentation › Les hooks

Lancer un process depuis Azure DevOps : les hooks

Un hook est une adresse que Azure DevOps appelle quand un élément de travail est créé (un bug, un PBI…). ProcNest trouve alors le bon process et lance automatiquement une instance de process, avec le titre de l’élément dans une variable si vous le souhaitez.

À quoi sert un hook ?

• Dans Azure DevOps, un abonnement (service hook) prévient ProcNest dès qu’un élément de travail est créé. Le hook décide quel process lancer.
• L’instance de process est lancée à votre nom, dans votre équipe, avec les personnes et les valeurs que vous avez choisies pour ce process. Elle apparaît dans Process instances comme les autres.
• Son nom vient d’un modèle, par exemple {Id} - {Title} : 1042 - Connexion impossible.

Comment le process est-il choisi ?

Réglez How is the process chosen? :

• One process : chaque élément de travail lance le même process.
• Rules : vous ajoutez plusieurs process, dans l’ordre. Chacun a des conditions (Work item types, Tags (at least one), Area path starts with). Le premier process dont l’élément remplit toutes les conditions est lancé ; une condition vide accepte tout. Si aucun ne convient, rien n’est lancé.
• AI : pour chaque process, vous décrivez en une phrase les éléments qui le concernent (When is this process the right one?). Une IA lit l’élément et choisit le process qui convient, ou aucun.

1. Créer un hook

1. Cliquez sur New hook

   Dans l’onglet Hooks. Le bouton n’apparaît que si vous pouvez gérer des hooks et voir les process.

2. Details

   Donnez un Name (obligatoire) et, si vous le souhaitez, un Name of the process instances avec les champs de l’élément : {Id}, {Type}, {Title}, {Description}, {State}, {Url}, {Tags}, {AreaPath}, {AssignedTo}, {Project}.

3. Process

   Choisissez le process publié, qui joue chaque participant, et les valeurs des variables. Avec Copy a field, un champ de l’élément de travail remplit une variable du process. Avec Add a process, ajoutez d’autres process (modes Rules et AI).

4. Cliquez sur Save

   ProcNest affiche l’adresse à donner à Azure DevOps et le secret.

2. Connecter Azure DevOps

Après la création (ou avec le bouton Connect to Azure DevOps d’un hook), ProcNest affiche les informations à recopier :

1. Dans Azure DevOps

   Ouvrez Project settings › Service hooks › Create subscription et choisissez Web Hooks.

2. Évènement

   Choisissez Work item created (vous pouvez filtrer sur le type ou l’area path).

3. Adresse et authentification

   Collez l’URL ; recopiez le nom d’utilisateur et le secret comme authentification de base (Basic authentication).

4. Testez

   Le résultat du dernier appel s’affiche sur le hook.

Le secret n’est montré qu’une seule fois : copiez-le tout de suite. Vous avez perdu le secret ? Utilisez Renew the secret : un nouveau secret est affiché et l’ancien cesse de fonctionner.

3. Suivre et gérer vos hooks

La page Hooks liste vos hooks : leur façon de choisir, leurs process, leur état (Active ou Paused), le dernier appel et son résultat :

• Process instance started : une instance a été lancée (le bouton Open the last process instance l’ouvre).
• No process found : aucune règle ne convenait (ou l’IA n’a rien trouvé) ; rien n’a été lancé.
• Ignored : l’évènement n’était pas une création d’élément de travail.
• Failed : l’instance n’a pas pu être lancée (process plus publié, IA indisponible…) ; le message est affiché sur le hook.

• Pause / Resume : un hook en pause refuse les appels d’Azure DevOps.
• Edit : changez le nom, la façon de choisir, les conditions et les descriptions. Le process, les personnes et les valeurs d’un process déjà dans le hook ne changent pas : retirez-le et ajoutez-le de nouveau.
• Delete : supprime le hook (Azure DevOps recevra une erreur). Les instances déjà lancées sont conservées.

À savoir

• Chaque hook garde la version publiée du process choisie à sa création : publier une nouvelle version n’y change rien tant que vous ne le modifiez pas.
• Le mode AI envoie à une IA le titre, la description, les tags et l’area path de l’élément de travail, ainsi que vos descriptions. Il n’est disponible que si l’administrateur de la plateforme l’a configuré ; sinon le hook affiche Failed.
• Le nom et les valeurs trop longs sont coupés (200 et 250 caractères).

Permissions

• Voir la page Hooks : View hooks. Chacun ne voit que ses hooks.
• Créer, modifier, mettre en pause, renouveler le secret et supprimer : Manage hooks (et View processes pour choisir les process). Utilisateurs et rôles explique comment les obtenir.