Syntax odkazov na premenné

Na premenné môžete odkazovať v analýzach a na paneloch.

Spôsob, akým odkazujete na premennú, závisí od vykonávanej úlohy. V prípade úloh, pri ktorých pracujete s poľami v dialógovom okne, je potrebné zadať len typ a názov premennej (nie úplnú syntax), napríklad pri odkazovaní na premennú v definícii filtra.

V prípade iných úloh, ako je napríklad odkazovanie na premennú v zobrazení nadpisu, zadávate syntax premennej. Použitá syntax závisí od typu premennej, ako je to opísané v nasledujúcej tabuľke.

Typ Syntax Príklad

Relácia

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

kde variablename je názov premennej relácie, napríklad DISPLAYNAME.

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

Sémantický model (depozitár)

@{biServer.variables.variablename}

alebo

@{biServer.variables['variablename']}

kde variablename je názov premennej, napríklad prime_begin

@{biServer.variables.prime_begin}

alebo

@{biServer.variables['prime_begin']}

Prezentácia alebo požiadavka

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

alebo

@{scope.variables['variablename']}

kde:

variablename je názov premennej prezentácie alebo požiadavky, napríklad MyFavoriteRegion.

(Voliteľné) format je maska formátu závislá od dátového typu premennej, napríklad #,##0, MM/DD/YY hh:mm:ss. (Formát sa nepoužije pre predvolenú hodnotu.)

(Voliteľné) defaultvalue je odkaz na konštantu alebo premennú. Označuje hodnotu, ktorá sa má použiť, ak premenná, na ktorú odkazuje variablename, nie je vyplnená.

scope identifikuje kvalifikátory pre premennú. Rozsah je potrebné zadať, ak sa premenná používa na viacerých úrovniach (analýzy, stránky panela a panely) a chcete použiť konkrétnu hodnotu. (Ak nezadáte rozsah, poradie priority je analýzy, stránky panela a panely.)

Pri používaní výzvy panela s premennou prezentácie, ktorá môže mať viac hodnôt, sa syntax líši v závislosti od typu stĺpca. Viaceré hodnoty sú formátované na hodnoty oddelené čiarkami, a preto sa klauzula formátovania použije pre každú hodnotu skôr, ako budú spojené čiarkami.

@{variables.MyFavoriteRegion}{EASTERN REGION}

alebo

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

alebo

@{dashboard.variables['MyFavoriteRegion']}

alebo

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

alebo

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

alebo

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

Globálne

@{global.variables.variablename}

kde variablename je názov globálnej premennej, napríklad gv_region. Pri odkazovaní na globálnu premennú je potrebné použiť plne kvalifikovaný názov, ako je to uvedené v príklade.

Konvencia tvorby názvov pre globálne premenné musí spĺňať špecifikácie skriptovacieho jazyka ECMA pre jazyk JavaScript. Názov nesmie prekročiť 200 znakov ani obsahovať vnorené medzery, rezervované slová a špeciálne znaky. Ak nepoznáte požiadavky jazyka JavaScript, pozrite si ďalšiu dokumentáciu.

@{global.variables.gv_date_n_time}

Môžete tiež odkazovať na premenné vo výrazoch. Zásady pre odkazovanie na premenné vo výrazoch sú opísané v nasledujúcich témach:

Premenné relácie

Nasledujúce pokyny môžete používať pri odkazovaní na premenné relácie vo výrazoch.

  • Premennú relácie pridajte ako argument funkcie VALUEOF.
  • Názov premennej umiestnite do dvojitých úvodzoviek.
  • Pred premennú relácie umiestnite NQ_SESSION a bodku.
  • Časť NQ_SESSION umiestnite do dvojitých úvodzoviek.
  • Časť NQ_SESSION aj názov premennej relácie umiestnite do zátvoriek.

Príklad:

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

Premenné prezentácie

Môžete použiť nasledujúce zásady pre odkazovanie na premennú prezentácie vo výrazoch.

Pri odkazovaní na premennú prezentácie použite túto syntax:

@{variablename}{defaultvalue}

variablename je názov premennej prezentácie a defaultvalue (voliteľné) je odkaz na konštantu alebo premennú označujúci hodnotu, ktorá sa má použiť, ak premenná s odkazom variablename nie je vyplnená.

Ak chcete previesť (t. j. konvertovať) premennú na reťazec alebo zahrnúť viacero premenných, umiestnite celú premennú medzi jednoduché úvodzovky, napríklad:

'@{user.displayName}'

Ak za znakom @ nenasleduje zátvorka {, považuje sa za zavináč. Pri používaní premennej prezentácie, ktorá môže mať viac hodnôt, sa syntax líši v závislosti od typu stĺpca.

Na generovanie platných príkazov SQL použite nasledujúcu syntax v jazyku SQL pre zadaný typ stĺpca:

  • Text – (@{variablename}['@']{'defaultvalue'})

  • Numerické hodnoty – (@{variablename}{defaultvalue})

  • Dátum-čas – (@{variablename}{timestamp 'defaultvalue'})

  • Dátum (len dátum) – (@{variablename}{date 'defaultvalue'})

  • Čas (len čas) – (@{variablename}{time 'defaultvalue'})

Príklad:

'@{user.displayName}'

Premenné sémantického modelu (depozitára)

Môžete používať nasledujúce zásady odkazovania na premenné sémantického modelu (depozitára) vo výrazoch.

  • Premennú pridajte ako argument funkcie VALUEOF.
  • Názov premennej umiestnite do dvojitých úvodzoviek.
  • Na statickú premennú sémantického modelu (depozitára) odkazujte jej názvom.
  • Na dynamickú premennú sémantického modelu (depozitára) odkazujte plne kvalifikovaným názvom.

Príklad:

CASE WHEN "Hodina" >= VALUEOF("prime_begin") AND "Hodina" < VALUEOF("prime_end") THEN 'Hlavný vysielací čas' WHEN ... ELSE...END