Sintassi per fare riferimento alle variabili

È possibile fare riferimento alle variabili in analisi e dashboard.

La modalità di riferimento a una variabile dipende dal task che si sta eseguendo. Per i task in cui vengono visualizzati campi in una finestra è necessario specificare solo il tipo e il nome della variabile (non la sintassi completa), ad esempio quando si fa riferimento a una variabile in una definizione di filtro.

Per altri task, ad esempio il riferimento a una variabile in una vista del titolo, è necessario specificare la sintassi della variabile. La sintassi che si utilizza dipende dal tipo di variabile, come descritto nella tabella riportata di seguito.

Tipo Sintassi Esempio

Sessione

@{biServer.variables['NQ_SESSION.variablename']}

dove variablename è il nome della variabile di sessione, ad esempio DISPLAYNAME.

@{biServer.variables['NQ_SESSION.SalesRegion']}

Modello semantico (repository)

@{biServer.variables.variablename}

oppure

@{biServer.variables['variablename']}

dove variablename è il nome della variabile, ad esempio prime_begin

@{biServer.variables.prime_begin}

oppure

@{biServer.variables['prime_begin']}

Presentazione o richiesta

@{variables.variablename}[format]{defaultvalue}

oppure

@{scope.variables['variablename']}

dove:

variablename è il nome della variabile di presentazione o di richiesta, ad esempio MyFavoriteRegion.

(facoltativo) format è una maschera di formato che dipende dal tipo di dati della variabile, ad esempio #,##0, MM/DD/YY hh:mm:ss. Il formato non viene applicato al valore predefinito.

(facoltativo) defaultvalue è una costante o un riferimento di variabile che indica un valore da utilizzare se la variabile alla quale fa riferimento variablename non contiene dati.

scope identifica i qualificatori per la variabile. Specificare l'ambito se si utilizza una variabile in più livelli (analisi, pagine del dashboard e dashboard) e si desidera accedere a un valore specifico. Se non si specifica l'ambito, l'ordine di precedenza sarà analisi, pagine del dashboard e dashboard.

Quando si usa un prompt del dashboard con una variabile di presentazione che può assumere più valori, la sintassi varia a seconda del tipo di colonna. In presenza di più valori, questi vengono formattati in valori separati da virgole, di conseguenza qualsiasi clausola FORMAT viene applicata a ogni valore prima di essere unito dalle virgole.

@{variables.MyFavoriteRegion}{EASTERN REGION}

oppure

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

oppure

@{dashboard.variables['MyFavoriteRegion']}

oppure

(@{myNumVar}[#,##0]{1000})

oppure

(@{variables.MyOwnTimestamp}[YY-MM-DD hh:mm:ss]{)

oppure

(@{myTextVar}{A, B, C})

Globale

@{global.variables.variablename}

dove variablename è il nome della variabile globale, ad esempio gv_region. Quando si fa riferimento a una variabile globale, è necessario utilizzare il nome completamente qualificato come indicato nell'esempio.

La convenzione di denominazione per le variabili globali deve essere conforme alle specifiche del linguaggio di script ECMA per JavaScript. Il nome non deve superare i 200 caratteri, né contenere spazi incorporati, parole riservate e caratteri speciali. Se non si ha familiarità con i requisiti del linguaggio JavaScripting, consultare i manuali di terze parti

@{global.variables.gv_date_n_time}

È inoltre possibile fare riferimento alle variabili nelle espressioni. Le istruzioni per fare riferimento alle variabili nelle espressioni sono descritte negli argomenti seguenti:

Variabili di sessione

Per fare riferimento alle variabili di sessione nelle espressioni, attenersi alle istruzioni riportate di seguito.

  • Includere la variabile di sessione come argomento della funzione VALUEOF.
  • Racchiudere il nome della variabile tra virgolette.
  • Precedere la variabile di sessione da NQ_SESSION e un punto.
  • Racchiudere NQ_SESSION tra virgolette.
  • Racchiudere la parte NQ_SESSION e il nome della variabile di sessione tra parentesi.

Ad esempio:

"Market"."Region"=VALUEOF("NQ_SESSION"."SalesRegion")

Variabili di presentazione

Per fare riferimento alle variabili di presentazione nelle espressioni, attenersi alle istruzioni riportate di seguito.

Per fare riferimento a una variabile di presentazione, utilizzare questa sintassi:

@{variablename}{defaultvalue}

dove variablename è il nome della variabile di presentazione e defaultvalue (facoltativo) è una costante o un riferimento di variabile che indica un valore da utilizzare se la variabile alla quale fa riferimento variablename non contiene dati.

Per convertire la variabile in una stringa o includere più variabili, racchiudere l'intera variabile fra apici. Esempio:

'@{user.displayName}'

Il simbolo @, se non è seguito da una parentesi graffa ({), viene considerato come simbolo @. Quando si utilizza una variabile di presentazione che può assumere più valori, la sintassi varia a seconda del tipo di colonna.

In SQL, utilizzare la sintassi riportata di seguito per il tipo di colonna specificato in modo da generare istruzioni SQL valide.

  • Testo: (@{variablename}['@']{'defaultvalue'})

  • Numerico: (@{variablename}{defaultvalue})

  • Data-ora: (@{variablename}{timestamp 'defaultvalue'})

  • Data (solo la data): (@{variablename}{date 'defaultvalue'})

  • Ora (solo l'ora): (@{variablename}{time 'defaultvalue'})

Ad esempio:

'@{user.displayName}'

Variabili di modello semantico (repository)

Per fare riferimento alle variabili di modello semantico (repository) nelle espressioni, attenersi alle istruzioni riportate di seguito.

  • Includere la variabile come argomento della funzione VALUEOF.
  • Racchiudere il nome della variabile tra virgolette.
  • Fare riferimento a una variabile di modello semantico (repository) statica per nome.
  • Fare riferimento a una variabile di modello semantico (repository) dinamica con il rispettivo nome completamente qualificato.

Ad esempio:

CASE WHEN "Hour" >= VALUEOF("prime_begin") AND "Hour" < VALUEOF("prime_end") THEN 'Prime Time' WHEN ... ELSE...END