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 exemple | Mauvais exemple | Raison |
|---|---|---|
| vQuantityInBox | varQuantityInBox | Ne pas utiliser “var” comme préfixe |
| vEmployeeFullName | strEmployeeFullName | Pas besoin de préfixe pour le type de donnée |
| vIsPastDue | vispastdue | Utiliser 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 exemple | Mauvais exemple | Raison |
|---|---|---|
| SvcAcct-SharePoint CurrencyExchangeRates-ac3d5 | SharePoint CurrencyExchangeRates-ac3d5 | Nom commun manquant au début |
| SvcAcct-Dataverse CurrencyExchangeRates-be005 | SvcAcct-Dataverse | Nom de solution ou identifiant manquant |
| SystemAlerts-Office 365 Outlook CurrencyExchangeRates-32a0c | DavidJohnson-Office 365 Outlook CurrencyExchangeRates-32a0c | Nom trop spécifique (pas générique) |