Benennungskonventionen für DAX-Parameter

  • Artikel

Die Parameternamen in der DAX-Referenz sind standardisiert, um die Verwendung und das Verständnis der Funktionen zu erleichtern.

Parameternamen

Begriff Definition
expression Ein DAX-Ausdruck, der einen einzelnen Skalarwert zurückgibt, bei dem der Ausdruck mehrmals ausgewertet wird (für jede Zeile/jeden Kontext).
value Jeder DAX-Ausdruck, der einen einzelnen skalaren Wert zurückgibt, bei dem der Ausdruck genau einmal vor allen anderen Vorgängen ausgewertet werden soll.
table Ein DAX-Ausdruck, der eine Tabelle mit Daten zurückgibt.
tableName Der Name einer vorhandenen Tabelle mit DAX-Standardsyntax. Es kann sich nicht um einen Ausdruck handeln.
columnName Der (in der Regel vollqualifizierte) Name einer vorhandenen Spalte mit DAX-Standardsyntax. Es kann sich nicht um einen Ausdruck handeln.
name Eine Zeichenfolgenkonstante, die verwendet wird, um den Namen eines neuen Objekts anzugeben.
order Eine Enumeration, mit der die Sortierreihenfolge bestimmt wird.
Ties Eine Enumeration, mit der die Verarbeitung gleichlautender Werte festgelegt wird.
type Eine Enumeration, mit der der Datentyp für PathItem und PathItemReverse bestimmt wird.

Parameternamen mit vorangestelltem Präfix oder ausschließliche Verwendung von Präfixen

Begriff Definition
prefixing Parameternamen können anhand eines Präfixes weiter qualifiziert werden, das die Verwendung des Arguments beschreibt und Mehrdeutigkeiten verhindert. Beispiel:

Result_ColumnName: Bezieht sich auf eine vorhandene Spalte, die zum Abrufen der Ergebniswerte in der LOOKUPVALUE()-Funktion verwendet wird.

Search_ColumnName: Bezieht sich auf eine vorhandene Spalte, die zum Suchen nach einem Wert in der LOOKUPVALUE()-Funktion verwendet wird.
omitting Parameternamen werden ausgelassen, wenn das Präfix klar genug ist, um den Parameter zu beschreiben.

Beispielsweise ist es für den Benutzer leichter, anstelle von „DATE (Year_Value, Month_Value, Day_Value)“ die Syntax „DATE (Year, Month, Day)“ zu lesen. Die dreimalige Wiederholung des Suffixwerts trägt nicht zu einem besseren Verständnis der Funktion bei und macht die Syntax unnötig unübersichtlich.

Wenn der Parameter einschließlich Präfix aber „Year_columnName“ lautet, werden der Parametername und das Präfix beibehalten. So ist für den Benutzer besser ersichtlich, dass der Parameter einen Verweis auf eine vorhandene Spalte von „Years“ erfordert.