Freigeben über

DAX Konventionen zur Parameterbenennung

  • Artikel

Parameternamen werden in der DAX-Referenz standardisiert, um die Nutzung und das Verständnis der Funktionen zu erleichtern.

Parameternamen

Begriff Definition
expression Jeder DAX Ausdruck, der einen einzelnen skalaren Wert zurückgibt, wobei der Ausdruck mehrmals ausgewertet werden soll (für jede Zeile/jeden Kontext).
value Jeder DAX-Ausdruck, der einen einzelnen Skalarwert zurückgibt, bei dem der Ausdruck genau einmal vor allen weiteren Vorgängen ausgewertet werden soll.
table Ein beliebiger DAX Ausdruck, der eine Datentabelle zurückgibt.
tableName Der Name einer vorhandenen Tabelle mit DAX-Standardsyntax. Es darf sich nicht um einen Ausdruck handeln.
columnName Der (in der Regel vollqualifizierte) Name einer vorhandenen Spalte mit DAX-Standardsyntax. Es darf sich nicht um einen Ausdruck handeln.
name Eine Zeichenfolgenkonstante, die verwendet wird, um den Namen eines neuen Objekts anzugeben.
order Eine Aufzählung, die verwendet wird, um die Sortierreihenfolge zu bestimmen.
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 mit einem Präfix weiter qualifiziert werden, das beschreibt, wie das Argument verwendet wird, um ein mehrdeutiges Verständnis der Parameter zu vermeiden. Beispiel:

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

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

Anstatt zum Beispiel die folgende Syntax DATE (Year_Value, Month_Value, Day_Value) zu verwenden, ist es für den Benutzer klarer, DATE (Jahr, Monat, Tag) zu lesen. Die dreimalige Wiederholung des Suffixwerts trägt nicht zu einem besseren Verständnis der Funktion bei und erschwert das Lesen unnötig.

Wenn der präfixierte Parameter jedoch Year_columnName ist, bleibt der Parametername und das Präfix erhalten, um sicherzustellen, dass der Benutzer weiß, dass der Parameter einen Verweis auf eine vorhandene Spalte von Jahren erfordert.