Condividi tramite

Convenzioni di denominazione dei parametri DAX

  • Articolo

Nelle informazioni di riferimento di DAX i nomi dei parametri sono standardizzati per semplificare l'uso e la comprensione delle funzioni.

Nomi dei parametri

Termine Definizione
expression Qualsiasi espressione DAX che restituisce un singolo valore scalare, dove l'espressione deve essere valutata più volte (per ogni riga/contesto).
value Qualsiasi espressione DAX che restituisce un singolo valore scalare, dove l'espressione deve essere valutata esattamente una volta prima di tutte le altre operazioni.
table Qualsiasi espressione DAX che restituisce una tabella di dati.
tableName Nome di una tabella esistente con la sintassi DAX standard. Non può essere un'espressione.
columnName Nome di una colonna esistente con la sintassi DAX standard, di solito completo. Non può essere un'espressione.
name Costante di tipo stringa che verrà usata per fornire il nome di un nuovo oggetto.
order Enumerazione usata per determinare l'ordinamento.
tà Enumerazione usata per determinare la gestione dei valori equivalenti.
Tipo Enumerazione usata per determinare il tipo di dati per PathItem e PathItemReverse.

Aggiunta di un prefisso ai nomi di parametro o uso del solo prefisso

Termine Definizione
prefixing I nomi dei parametri possono essere ulteriormente qualificati con un prefisso descrittivo per indicare la modalità d'uso dell'argomento ed evitare la lettura ambigua dei parametri. Ad esempio:

Result_ColumnName: fa riferimento a una colonna esistente usata per ottenere i valori dei risultati nella funzione LOOKUPVALUE().

Search_ColumnName: fa riferimento a una colonna esistente usata per cercare un valore nella funzione LOOKUPVALUE().
omitting I nomi dei parametri verranno omessi se il prefisso è sufficientemente chiaro per descrivere il parametro.

Ad esempio, rispetto a DATE (Year_Value, Month_Value, Day_Value), la sintassi DATE (Year, Month, Day) risulta di più facile lettura per l'utente. La ripetizione del valore del suffisso non contribuisce in alcun modo alla comprensione della funzione e disturba inutilmente lettura.

Se tuttavia il parametro con prefisso è Year_columnName, il nome del parametro e il prefisso rimarranno invariati affinché l'utente sia in grado di comprendere che il parametro richiede un riferimento a una colonna Years esistente.