A változókra hivatkozás szintaxisa

Változókra hivatkozni az elemzésekben és az irányítópultokon lehet.

A végrehajtandó feladattól függ, hogy hogyan lehet hivatkozni változóra. Az olyan feladatoknál, amelyek párbeszédpanelen mezőkkel jelennek meg, csak a változó nevét és típusát kell megadni (nem a teljes szintaxist), például változóra hivatkozás a szűrő definíciójában.

Más feladatoknál, például változóra hivatkozás címnézetben, meg kell adni a változó szintaxisát. A használt szintaxis a változó típusától függ, ahogy azt a következő táblázat ismerteti.

Típus Szintaxis Példa

Munkamenet

@{biServer.variables['NQ_SESSION.változónév']}

ahol a változónév a munkameneti változó neve, például DISPLAYNAME.

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

Szemantikai modell (adattári)

@{biServer.variables.változónév}

vagy

@{biServer.variables['változónév']}

ahol a változónév a változó neve, például prime_begin

@{biServer.variables.prime_begin}

vagy

@{biServer.variables['prime_begin']}

Megjelenítés vagy kérelem

@{variables.változónév}[formátum]{alapérték}

vagy

@{scope.variables['változónév']}

ahol:

változónév a megjelenítési vagy kérelmi változó neve, például MyFavoriteRegion.

(nem kötelező) a formátum a változó adattípusától függő formátummaszk, például # ##0, ÉÉÉÉ/HH/NN óó:pp:mm. (Vegye figyelembe, hogy a formátum nem érvényes az alapértelmezett értékre.)

(nem kötelező) az alapérték olyan konstans vagy változó, amelyik azt az értéket képviseli, amelyik a változónév nevű változó értékéből nem töltődik ki.

a hatókör a változó minősítőjét azonosítja. A hatókör megadására akkor van szükség, ha a változó több szinten használható (elemzésekben, irányítópulti lapokon és irányítópultokon), és egy konkrét szint értékét kívánja elérni. (Ha nem adja meg a hatókört, akkor a precedencia szerinti sorrend: elemzések, irányítópulti lapok és irányítópultok.)

Amikor irányítópulti promptot használ olyan megjelenítési változóval, amely több értékkel rendelkezhet, a szintaxis az oszloptípustól függően eltérő lesz. A több érték vesszővel tagolt formátumban jelenik meg, ezért az egyes értékekre vonatkozó formázási utasításrész a vesszővel való összekapcsolás előtt érvényesül.

@{variables.MyFavoriteRegion}{EASTERN REGION}

vagy

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

vagy

@{dashboard.variables['MyFavoriteRegion']}

vagy

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

vagy

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

vagy

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

Globális

@{global.variables.változónév}

ahol változónév a globális változó neve, például gv_region. Globális változóra való hivatkozáskor a teljesen megadott nevet kell használni a példában jelzett módon.

A globális változók elnevezési módszerének meg kell felelnie a JavaScript ECMA parancsnyelvi előírásainak. A név nem lehet hosszabb 200 karakternél, nem tartalmazhat beágyazott szóközöket, foglalt szavakat és különleges karaktereket. Ha nem ismeri a JavaScripting nyelvi előírásait, nézzen utána a megfelelő dokumentumban

@{global.variables.gv_date_n_time}

Változókra hivatkozni kifejezésekben is lehet. Kifejezésekben a változókra hivatkozás a következő témakörökben leírtak szerint történik:

Munkamenet-változók

Kifejezésekben a munkamenet-változókra való hivatkozást a következő útmutatók használatával végezheti el.

  • A VALUEOF függvénynél argumentumként adja meg a munkameneti változót is.
  • A változó nevét tegye idézőjelek közé.
  • A munkameneti változó előtt legyen a NQ_SESSION és a pont.
  • Az NQ_SESSION kifejezést tegye idézőjelek közé.
  • Tegye a NQ_SESSION részt és munkameneti változó nevét is zárójelek közé.

Például:

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

Megjelenítési változók

Kifejezésekben a bemutatóváltozókra való hivatkozást a következő útmutatók használatával végezheti el.

Megjelenítési változóra a szintaxissal hivatkozhat:

@{variablename}{defaultvalue}

ahol a variablename a megjelenítési változó neve, és a (nem kötelező) defaultvalue olyan konstans vagy változó, amelyik azt az értéket képviseli, amelyik a variablename nevű változó értékéből nem töltődik ki.

A változó karakterlánc típusúra váltása (azaz a konvertálása), vagy több változó belefoglalása érdekében tegye az egész változót szimpla idézőjelek közé, például:

'@{user.displayName}'

Ha a kukacjelet (@) nem követi kapcsos zárójel ({), akkor az kukacjelnek tekintendő. Ha olyan megjelenítési változót használ, amely több értékkel rendelkezhet, a szintaxis az oszloptípustól függően eltérő lesz.

Érvényes SQL utasítás létrehozása érdekében az egyes oszloptípusoknál a következő szintaxist használja:

  • Szöveg — (@{változónév}['@']{'alapérték'})

  • Numerikus — (@{változónév}{alapérték})

  • Dátum-idő — (@{változónév}{timestamp 'alapérték'})

  • Dátum (csak a dátum) — (@{változónév}{date 'alapérték'})

  • Idő (csak az idő) — (@{változónév}{time 'alapérték'})

Például:

'@{user.displayName}'

Szemantikai modell (adattári) változók

Kifejezésekben az szemantikai modell (adattári) változókra való hivatkozást a következő útmutatók használatával végezheti el.

  • A VALUEOF függvénynél argumentumként adja meg a változót is.
  • A változó nevét tegye idézőjelek közé.
  • Statikus szemantikai modell (adattári) változóra névvel hivatkozzon.
  • Dinamikus szemantikai modell (adattári) változóra teljes minősítésű névvel hivatkozzon.

Például:

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