DAX-namngivningskonventioner för parametrar

  • Artikel

Parameternamn är standardiserade i DAX-referensen för att underlätta användningen och förståelsen av funktionerna.

Parameternamn

Period Definition
Uttryck Alla DAX-uttryck som returnerar ett enda skalärt värde, där uttrycket ska utvärderas flera gånger (för varje rad/kontext).
värde Alla DAX-uttryck som returnerar ett enda skalärt värde där uttrycket ska utvärderas exakt en gång före alla andra åtgärder.
tabell Alla DAX-uttryck som returnerar en datatabell.
tableName Namnet på en befintlig tabell med standard-DAX-syntax. Det kan inte vara ett uttryck.
Columnname Namnet på en befintlig kolumn med standard-DAX-syntax, vanligtvis fullständigt kvalificerad. Det kan inte vara ett uttryck.
name En strängkonstant som ska användas för att ange namnet på ett nytt objekt.
order En uppräkning som används för att fastställa sorteringsordningen.
oavgjorda En uppräkning som används för att fastställa hanteringen av bindningsvärden.
type En uppräkning som används för att fastställa datatypen för PathItem och PathItemReverse.

Prefixera parameternamn eller endast använda prefixet

Period Definition
prefix Parameternamn kan ytterligare kvalificeras med ett prefix som beskriver hur argumentet används och för att undvika tvetydig läsning av parametrarna. Till exempel:

Result_ColumnName – Refererar till en befintlig kolumn som används för att hämta resultatvärdena i funktionen LOOKUPVALUE().

Search_ColumnName – Refererar till en befintlig kolumn som används för att söka efter ett värde i funktionen LOOKUPVALUE().
Utelämna Parameternamn utelämnas om prefixet är tillräckligt tydligt för att beskriva parametern.

I stället för att till exempel ha följande syntax DATE (Year_Value, Month_Value, Day_Value) är det tydligare för användaren att läsa DATUM (år, månad, dag); upprepa tre gånger suffixvärdet lägger inte till något till en bättre förståelse av funktionen och det rörigar läsningen i onödan.

Men om den prefixerade parametern är Year_columnName stannar parameternamnet och prefixet för att se till att användaren förstår att parametern kräver en referens till en befintlig kolumn med År.