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”.

envoyer mail smart values jira

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éé.

Règle d'automatisation simple

Automatisation sans smart values

Règle d'automatisation avec smart values

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 calcul jira

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 :

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.

manuel trigger jira

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 execution jira

Rule executions dans Jira

 

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

audit log jira

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 :

Aller plus vite sur vos projets

📖

Ne rater aucune information

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.

Actualité Atlassian Cloud : Mars 2021

L’équipe d’Atlassian améliore en permanence ses logiciels en se focalisant sur l’expérience des utilisateurs : Jira, Confluence, JSM – actualités du mois de mars.

Les 10 apps Jira à connaître en 2021

Que ce soit Jira Software, Core ou Service Management, chacun d’entre eux se personnalise à l’infini : gestion de projet, test, CMDB. Découvrez nos 10 apps préférées pour décupler les fonctionnalités de vos instances.

Contactez-nous

Share This