Règles de nommage

 

Table of Contents

Pourquoi est-ce important ?

Créer des flux Power Automate cohérents, performants et faciles à maintenir commence par la mise en place de règles de nommage standardisées.
Cette uniformisation permet de faciliter la collaboration entre les membres de l’équipe de développement, simplifier le diagnostic des erreurs et accélérer le la maintenance de vos automatisations.

Dans toutes les conventions de nommage, Microsoft recommande d'éviter d'utiliser les accents et les espaces en utilisant la notation camelCase ou un "_". Par exemple sendEmailNotification ou send_email_notification.

Personnellement je préfère utiliser une nomenclature assez standard pour les noms de flux et d'action, et utiliser le camelCase pour les noms de variable.

⚠️  Pensez toujours à nommer vos actions au moment de leur création. Car le renommage a postériori peut poser problème si vous utilisez ces actions dans des expressions Power Automate.

Noms des flux 

Le nom d’un flux doit commencer par un verbe (une action) et décrire le résultat attendu.

Si le flux appartient à une solution, il est recommandé d'ajouter en préfixe le nom de la solution.

Contract Database - approveContract


Noms des actions

Le nom d’une action doit toujours commencer par sa description d’origine (celle proposée par Power Automate). Cela aide les développeurs à identifier rapidement l’action utilisée sans avoir à la déplier.

Ensuite, ajoutez une description complémentaire sur ce que fait l’action dans le contexte du flux.

Utilisez les majuscules appropriées et séparez la description de l’action et son contexte avec un tiret.

Get items - openTickets

Send an email (V2) - dailyReportToManagers


Noms de déclencheurs 

Les noms de déclencheurs varient selon le type de flux. Je conseille encore une fois de conserver le nom d'origine du déclencheur et d'y ajouter des élements contextuels.

Flux automatisés

Inclure le nom de la liste ou de l’événement dans le nom du déclencheur.

When An Item Is Created - incidentTicket

Flux planifiés

Afficher la fréquence de récurrence.

Recurrence - everyMonthOn1st

Flux instantanés

Décrire l’événement qui déclenche le flux.

Manually Trigger A Flow - clickOnEscalationButton

Flux liés à Power Apps

Indiquer l’action dans l’application qui démarre le flux.

Power Apps (V2) - userSubmitsFile


Noms de variables 

Le nom d’une variable doit commencer par le préfixe “v”, suivi d’une description claire de son contenu ou objectif.
Utilisez le camelCase (pas d’espaces, chaque mot commence par une majuscule après le premier).
Soyez concis.

Bon exempleMauvais exempleRaison
vQuantityInBoxvarQuantityInBoxNe pas utiliser “var” comme préfixe
vEmployeeFullNamestrEmployeeFullNamePas besoin de préfixe pour le type de donnée
vIsPastDuevispastdueUtiliser le camelCase

Noms de références de connexion 

Le nom d’une référence de connexion doit commencer par un nom commun décrivant le compte de connexion.
Il est suivi par le type de connexion, le nom de la solution et un identifiant unique.
Ces éléments sont généralement générés automatiquement lorsque le flux est créé dans une solution.

Bon exempleMauvais exempleRaison
SvcAcct-SharePoint CurrencyExchangeRates-ac3d5SharePoint CurrencyExchangeRates-ac3d5Nom commun manquant au début
SvcAcct-Dataverse CurrencyExchangeRates-be005SvcAcct-DataverseNom de solution ou identifiant manquant
SystemAlerts-Office 365 Outlook CurrencyExchangeRates-32a0cDavidJohnson-Office 365 Outlook CurrencyExchangeRates-32a0cNom trop spécifique (pas générique)