Conventions de nommage des paramètres DAX

  • Article

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.