Sintaksa za navođenje varijabli

Varijable možete navoditi u analizama i dashboardima.

Način navođenja varijable ovisi o zadatku koji izvršavate. Za zadatke za koje se u dijaloškom okviru prikazuju polja morate definirati samo vrstu i naziv varijable (ne cijelu sintaksu), na primjer, navesti varijablu u definiciji filtra.

Za ostale zadatke, primjerice za navođenje varijable u naslovnom pregledu, trebate definirati sintaksu varijable. Sintaksa koju koristite ovisit će o vrsti varijable, kao što je opisano u tablici u nastavku.

Vrsta Sintaksa Primjer

Sesija

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

pri čemu je variablename naziv varijable sesije, na primjer, DISPLAYNAME.

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

Semantički model (repozitorij)

@{biServer.variables.variablename}

ili

@{biServer.variables['variablename']}

pri čemu je variablename naziv varijable, na primjer, prime_begin

@{biServer.variables.prime_begin}

ili

@{biServer.variables['prime_begin']}

Prezentacija ili zahtjev

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

ili

@{scope.variables['variablename']}

pri čemu je:

variablename naziv varijable prezentacije ili zahtjeva, na primjer, MyFavoriteRegion.

(nije obavezno) format je maska formata koja ovisi o vrsti podataka varijable, na primjer, #,##0, MM/DD/YY hh:mm:ss. (Napominjemo da se format ne primjenjuje na zadanu vrijednost.)

(nije obavezno) defaultvalue je referenca konstante ili varijable koja naznačava vrijednost koja će se koristiti ako varijabla koju navodi variablename nije unesena.

scope identificira kvalifikatore varijable. Raspon morate definirati kad se varijabla koristi na više razina (analize, stranice dashboarda i dashboardi), a želite pristupiti određenoj vrijednosti. (Ako ne definirate raspon, redoslijed prioriteta je analiza, stranice dashboarda i dashboardi.)

Kad upotrebljavate parametar dashboarda s varijablom prezentacije koja može imati više vrijednosti, sintaksa će se razlikovati ovisno o vrsti stupca. Višestruke vrijednosti formatiraju se kao vrijednosti razdvojene zarezima te se svaki uvjet formata primjenjuje na svaku vrijednost prije no što se pridruže zarezima.

@{variables.MyFavoriteRegion}{EASTERN REGION}

ili

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

ili

@{dashboard.variables['MyFavoriteRegion']}

ili

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

ili

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

ili

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

Globalno

@{global.variables.variablename}

pri čemu je variablename naziv globalne varijable, na primjer, gv_region. Kad navodite globalnu varijablu, morate koristiti potpuni kvalificirani naziv kao što je navedeno u primjeru.

Pravila imenovanja globalnih varijabli moraju biti u skladu sa specifikacijama ECMA jezika za skriptiranje za JavaScript. Naziv ne smije biti dulji od 200 znakova niti sadržavati ugrađene razmake, rezervirane riječi i posebne znakove. Ako niste upoznati sa zahtjevima JavaScript jezika, provjerite vanjske reference

@{global.variables.gv_date_n_time}

Varijable možete navesti i u izrazima. Smjernice za navođenje varijabli u izrazima opisane su u sljedećim temama:

Varijable sesije

Možete se poslužiti sljedećim smjernicama za navođenje varijabli sesije u izrazima.

  • Varijablu sesije uključite kao argument funkcije VALUEOF.
  • Naziv varijable navedite unutar dvostrukih navodnika.
  • Ispred varijable sesije navedite NQ_SESSION i točku.
  • NQ_SESSION navedite unutar dvostrukiv navodnika.
  • Dio NQ_SESSION i naziv varijable navedite unutar zagrada.

Na primjer:

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

Varijable prezentacije

Možete se poslužiti sljedećim smjernicama za navođenje varijable prezentacije u izrazima.

Kad navodite varijablu prezentacije, koristite sljedeću sintaksu:

@{variablename}{defaultvalue}

pri čemu je variablename naziv varijable prezentacije, a defaultvalue (nije obavezno) je referenca konstante ili varijable koja naznačava vrijednost koja će se koristiti ako varijabla koju navodi variablename nije unesena.

Ako varijablu želite pretvoriti u niz ili ako želite uključiti više varijabli, cijelu varijablu umetnite unutar jednostrukih navodnika, na primjer:

'@{user.displayName}'

Ako iza znaka @ nije {, to će se tretirati kao znak @. Ako koristite varijablu prezentacije koja može imati više vrijednosti, sintaksa će se razlikovati ovisno o vrsti stupca.

Sljedeću sintaksu koristite u SQL-u za navedenu vrstu stupca kako biste generirali valjane SQL naredbe:

  • Tekst — (@{variablename}['@']{'defaultvalue'})

  • Numerički — (@{variablename}{defaultvalue})

  • Datum-vrijeme — (@{variablename}{timestamp 'defaultvalue'})

  • Datum (samo datum) — (@{variablename}{date 'defaultvalue'})

  • Vrijeme (samo vrijeme) — (@{variablename}{time 'defaultvalue'})

Na primjer:

'@{user.displayName}'

Varijable semantičkog modela (repozitorija)

Možete se poslužiti sljedećim smjernicama za navođenje varijabli semantičkog modela (repozitorija) u izrazima.

  • Varijablu uključite kao argument funkcije VALUEOF.
  • Naziv varijable navedite unutar dvostrukih navodnika.
  • Statičke varijable semantičkog modela (repozitorija) pozivajte prema nazivu.
  • Dinamičke varijable semantičkog modela (repozitorija) pozivajte prema punom kvalificiranom nazivu.

Na primjer:

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