Conventions de nommage des paramètres DAX
Les noms de paramètre sont normalisés dans la référence DAX pour faciliter l’utilisation et la compréhension des fonctions.
Noms de paramètre
Terme | Définition |
---|---|
expression | Toute expression DAX qui retourne une valeur scalaire unique où l’expression doit être évaluée plusieurs fois (pour chaque ligne/contexte). |
value | Toute expression DAX qui retourne une valeur scalaire unique où l’expression doit être évaluée une seule fois avant toutes les autres opérations. |
tableau | Toute expression DAX qui retourne une table de données. |
tableName | Nom d’une table existante, spécifié avec la syntaxe DAX standard. Il ne peut pas s’agir d’une expression. |
columnName | Nom, généralement complet, d’une colonne existante utilisant la syntaxe DAX standard. Il ne peut pas s’agir d’une expression. |
name | Constante de chaîne qui sera utilisée pour fournir le nom d’un nouvel objet. |
order | Énumération utilisée pour déterminer l’ordre de tri. |
ties | Énumération utilisée pour déterminer la gestion des valeurs d’égalité. |
type | Énumération utilisée pour déterminer le type de données pour PathItem et PathItemReverse. |
Attribution d’un préfixe aux noms de paramètre ou utilisation du préfixe seul
Terme | Définition |
---|---|
prefixing | Les noms de paramètre peuvent être qualifiés plus précisément avec un préfixe descriptif de la façon dont l’argument est utilisé et pour éviter toute lecture ambiguë des paramètres. Par exemple : Result_ColumnName : fait référence à une colonne existante utilisée pour obtenir les valeurs de résultat dans la fonction LOOKUPVALUE(). Search_ColumnName : fait référence à une colonne existante utilisée pour rechercher une valeur dans la fonction LOOKUPVALUE(). |
omitting | Les noms de paramètre sont omis si le préfixe est suffisamment clair pour décrire le paramètre. Par exemple, au lieu d’avoir la syntaxe suivante DATE (Year_Value, Month_Value, Day_Value), il est plus clair pour l’utilisateur de lire DATE (Year, Month, Day) ; la répétition par trois fois de la valeur du suffixe n’ajoute rien à une meilleure compréhension de la fonction et gêne la lecture inutilement. Toutefois, si le paramètre préfixé est Year_columnName, le nom du paramètre et le préfixe sont conservés pour s’assurer que l’utilisateur comprend que le paramètre requiert une référence à une colonne Years existante. |
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour