Partager via

conventions d’affectation de noms de paramètres DAX

  • Article

Les noms de paramètres sont normalisés dans DAX référence pour faciliter l’utilisation et la compréhension des fonctions.

Noms de paramètres

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 exactement une fois avant toutes les autres opérations.
table Toute expression DAX qui retourne une table de données.
tableName Nom d’une table existante à l’aide de la syntaxe de 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.

Préfixage des noms de paramètres ou utilisation du préfixe seulement

Terme Définition
prefixing Les noms de paramètres peuvent être qualifiés avec un préfixe descriptif de la façon dont l’argument est utilisé et pour éviter la 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ètres 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 (Année, Mois, Jour) ; répéter trois fois la valeur de suffixe n’ajoute rien à une meilleure compréhension de la fonction et il encombre inutilement la lecture.

Toutefois, si le paramètre préfixé est Year_columnName, le nom du paramètre et le préfixe reste pour s’assurer que l’utilisateur comprend que le paramètre nécessite une référence à une colonne existante de Years.