Automation for Jira : utiliser les smart values

Vous souhaitez aller plus loin dans la configuration de vos automatisations Jira ? Par exemple, envoyer des notifications personnalisées sur Teams ou sur des tickets Jira en commentaire. Il suffit d’utiliser des smart values.

Qu’est-ce qu’une smart value dans Jira ?

Les smart values permettent aux administrateurs Jira de personnaliser des messages afin de profiter d’informations supplémentaires : clé, titre ou encore lien vers le ticket pour inciter des utilisateurs peu habitués à utiliser Jira. Elles permettent d’ajouter pratiquement n’importe quelle valeur de Jira dans une règle d’automatisation.

⚙️ Créer sa première automatisation dans Jira

Comment créer une smart value ?

Commençons par comprendre comment créer une smart value. Pour faire référence à une valeur, il faut l’inclure entre des doubles accolades : {{issue.valeur}}.

Pour utiliser les champs personnalisés ou les custom fields dans ces smart values, il suffit d’inscrire :

• le nom du champ personnalisé : {{issue.nom du champ}}

• l’ID du champ personnalisé et la syntaxe suivante : {{issue.customfield_130}}

Si vous souhaitez créer vos propres smart values, veuillez vous référer à ce document.

Les smart values : les utilisations dans Jira

Les smart values s’utilisent pratiquement avec toutes les valeurs possibles de Jira. Découvrons ci-dessous différents cas d’utilisation.

Personnaliser des emails ou des notifications

Dans l’exemple suivant nous personnalisons une relance pour un ticket arrivé dans un état “à faire”.

Personnalisation Automation for Jira – Smart value

À copier/coller/adapter :

Bonjour {{issue.Testeur}}.

Le ticket {{issue.key}} est à tester

L’échéance pour le ticket {{issue.key}} est fixée au {{issue.duedate}}.

Ce ticket est pondéré à {{issue.Story Point}}.

Merci de procéder aux tests pour ce ticket.

Exemple de notification dans Teams

Créer une règle d’intégration avec Teams afin de prévenir, grâce à une notification, ses équipes dès qu’un nouveau ticket est créé.

Automatisation avec smart values

Pour ajouter plus de détails à cette automatisation et qu’elle soit comprise par tous les membres de votre équipe, voici ce que nous vous conseillons. À chaque fois qu’un ticket sera créé, une notification sera publiée sur Teams incluant :

• le titre du ticket ({{issue.summary}})

• sa clé ({{issue.key}})

• l’URL vers le ticket ({{issue.toUrl}})

Automatiser des calculs

Pour utiliser les smart values comme des nombres, vous devez ajouter {{#=}}.  Si vous souhaitez par exemple calculer le champ story points comme la somme de plusieurs champs, vous devrez procéder ainsi :

Automatisation des calculs dans Jira

À copier/coller/adapter : 

{{#=}}{{issue.Score développement}}+{{issue.Score impact interne}}{{/}}

Trouver la smart value adaptée à ma demande

Vous avez un besoin prédéfini mais ne savez pas quelle smart value utiliser. Il en existe énormément et c’est parfois difficile de trouver celle qui est parfaitement adaptée à notre contexte et à notre besoin. Dans la plupart des cas, les smart values les plus utiles se trouveront dans la liste ci-dessous :

• Pour les données liées aux tickets : Smart values – general.
• Pour les smart values relatives aux listes et aux propriétés qui contiennent des valeurs multiples : Smart values – lists.
• Pour les smart values relatives aux champs textes : Smart values – text fields.
• Pour les smart values relatives aux données utilisateurs : Smart values – users.
• Pour les smart values relatives aux logiciels et données de développement : Smart values – development.
• Pour les smart values relatives aux dates et au temps Smart values – date and time functions
• Pour les smart values relatives aux valeurs numériques Smart values – math expressions

• Pour les smart values relatives au JSON Smart values – JSON functions

Comment voir si ma smart value fonctionne ?

Vous avez réussi à mettre en place une notification automatique personnalisée dans Jira et souhaitez à présent tester si la smart value fonctionne correctement. Suivez les étapes ci-dessous pour la vérifier :

1️⃣ Créer une règle en utilisant le déclencheur Manually triggered avec l’action Log action.

Déclencheur manuel – Automatisation Jira

2️⃣ Allez ensuite sur un ticket et utiliser l’option Exécuter une règle (Rule executions) pour déclencher manuellement votre règle.

Rule executions dans Jira

3️⃣ Consultez les résultats dans le journal d’audit.

Journal d’audit Jira Cloud

Ma règle s’exécute mais les smart values sont vides

Si un champ ou une valeur n’existe pas, cela retournera une valeur vide. Vous pouvez spécifier une valeur par défaut si cela se produit.

• Le ticket n’est assigné à personne : Si le ticket pour lequel s’exécute la règle n’est assigné à personne, alors la règle retournera “Pas de responsable”

{{assignee.displayName|”Pas de responsable”}}

• Le champ ne comporte aucune valeur : Lors de la sommation de deux champs numériques, si vous souhaitez que la règle soit exécutée sans problème alors qu’un des champs ne comporte aucune valeur, vous pouvez le préciser.

Si nous reprenons l’exemple avec le calcul du champ story points suivant les champs Score développement et Score cause, nous pouvons procéder ainsi :

{{#=}}{{issue.Score développement|0}}+{{issue.Score cause|0}}{{/}}

Si l’un des deux champs Score développement ou Score cause n’est pas renseigné, la règle continuera de fonctionner.

En résumé les smart values vous permettront de :

✅

Limiter les erreurs humaines

Vous avez des questions sur les smart values ? Contactez nos consultants spécialisés sur les solutions Atlassian, Jira et Confluence.