A változókra való hivatkozás szintaxisa

Változókra hivatkozni az elemzésekben, az irányítópultokon, a fő teljesítménymutatókban és az ügynököknél 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 táblázat ismerteti.

Megjegyzés:

A szintakszis szerint, ha a kukacjelet (@) nem követi kapcsos zárójel ({), akkor az kukacjelnek tekintendő.

Változó típusa	Szintakszis	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. Az Ön által is használható munkameneti rendszerváltozók listáját lásd: Tudnivalók a munkameneti rendszerváltozókról, ebben: Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition.	@{biServer.variables['NQ_SESSION.USER']}
Adattár	@{biServer.variables.változónév} vagy @{biServer.variables['változónév']} ahol a változónév az adattári 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. (Tudjon róla, 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.) Megjegyzés: 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 záradék a vesszővel való összekapcsolás előtt érvényesül.	@{variables.MyFavoriteRegion}{EASTERN REGION} vagy @{MyFavoriteRegion} 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. Megjegyzés: a globális változók elnevezési módszerének meg kell felelnie a JavaScript EMCA 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áblázatban leírtak szerint történik.

Változó típusa	Irányelvek	Példa
Munkamenet	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. Tegye a NQ_SESSION részt és munkameneti változó nevét is zárójelek közé.	"Piac"."Régió"=VALUEOF(NQ_SESSION."ÉrtékesítésiRégió")
Adattár	A VALUEOF függvénynél argumentumként adja meg az adattári változót is. A változó nevét tegye idézőjelek közé. Statikus adattári változóra névvel hivatkozzon. Dinamikus adattári változóra a teljes minősítésű névvel hivatkozzon. Dinamikus adattári változók használatakor az inicializáló blokk és az adattári változó nevét tegye idézőjelbe ( " ), válassza el őket ponttal, és tegye őket zárójelbe. Ha például a Region Security (Régióbiztonság) elnevezésű inicializáló blokkban lévő REGION dinamikus adattári változó értékét szeretné használni, az alábbi szintakszist kell használnia: VALUEOF("Region Security"."REGION") A további tudnivalókat lásd: Tudnivalók az adattárváltozókról, ebben: Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition.	CASE WHEN "Hour" >= VALUEOF("prime_begin") AND "Hour" < VALUEOF("prime_end") THEN 'Prime Time' WHEN ... ELSE...END
Bemutató	Ez a szintakszis használandó: @{változónév}{alapérték} ahol a változónév a megjelenítési változó neve, és a (nem kötelező) alappé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 változó karakterlánc típusúra váltása (azaz a konvertálása) érdekében tegye az egészet szimpla idézőjelek közé, például: '@{user.displayName}' Megjegyzés: 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'})	"Market"."Region"=@{MyFavoriteRegion}{EASTERN REGION} vagy "Products"."P4 Brand"=(@{myTextVar}['@']{BizTech}) vagy "Products"."PO Product Number"=(@{myNumVar}{1000}) vagy "Sales Person"."E7 Hire Date"=(@{myDateTimeVar}{timestamp '2013-05-16 00:00:01'}) vagy "Time"."Total Fiscal Time"=(@{myDateVar}{date '2013-05-16'}) vagy "Time"."Time Right Now"=(@{myTimeVar}{time '00:00:01'}) Több érték esetén (adott adattípusnál) SQL használatakor: Ha az oszloptípus Szöveg, és a változónév a val1, val2 és val3 értéket adja át, az eredmény ('val1', 'val2', 'val3') lesz. vagy Ha az oszloptípus Dátum, és a változónév a 2013-08-09 és a 2013-08-10 értéket adja át, az eredmény (date '2013-08-09', date '2013-08-10') lesz. vagy Ha az oszloptípus Dátum-idő, és a változónév a 2013-08-09 00:00:00 és a 2013-08-10 00:00:00 értéket adja át, az eredmény (timestamp '2013-08-09 00:00:00', timestamp '2013-08-10 00:00:00') lesz.

Változó típusa

Irányelvek

Példa

Munkamenet

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.
Tegye a NQ_SESSION részt és munkameneti változó nevét is zárójelek közé.

"Piac"."Régió"=VALUEOF(NQ_SESSION."ÉrtékesítésiRégió")

Adattár

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

Dinamikus adattári változók használatakor az inicializáló blokk és az adattári változó nevét tegye idézőjelbe ( " ), válassza el őket ponttal, és tegye őket zárójelbe. Ha például a Region Security (Régióbiztonság) elnevezésű inicializáló blokkban lévő REGION dinamikus adattári változó értékét szeretné használni, az alábbi szintakszist kell használnia:

VALUEOF("Region Security"."REGION")

A további tudnivalókat lásd: Tudnivalók az adattárváltozókról, ebben: Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition.

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

Bemutató

Ez a szintakszis használandó:
```
@{változónév}{alapérték}
```
ahol a változónév a megjelenítési változó neve, és a (nem kötelező) alappé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 változó karakterlánc típusúra váltása (azaz a konvertálása) érdekében tegye az egészet szimpla idézőjelek közé, például:
```
'@{user.displayName}'
```

Megjegyzés: 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'})

"Market"."Region"=@{MyFavoriteRegion}{EASTERN REGION}

vagy

"Products"."P4 Brand"=(@{myTextVar}['@']{BizTech})

vagy

"Products"."PO Product Number"=(@{myNumVar}{1000})

vagy

"Sales Person"."E7 Hire Date"=(@{myDateTimeVar}{timestamp '2013-05-16 00:00:01'})

vagy

"Time"."Total Fiscal Time"=(@{myDateVar}{date '2013-05-16'})

vagy

"Time"."Time Right Now"=(@{myTimeVar}{time '00:00:01'})

Több érték esetén (adott adattípusnál) SQL használatakor:

Ha az oszloptípus Szöveg, és a változónév a val1, val2 és val3 értéket adja át, az eredmény ('val1', 'val2', 'val3') lesz.

vagy

Ha az oszloptípus Dátum, és a változónév a 2013-08-09 és a 2013-08-10 értéket adja át, az eredmény (date '2013-08-09', date '2013-08-10') lesz.

vagy

Ha az oszloptípus Dátum-idő, és a változónév a 2013-08-09 00:00:00 és a 2013-08-10 00:00:00 értéket adja át, az eredmény (timestamp '2013-08-09 00:00:00', timestamp '2013-08-10 00:00:00') lesz.

Azokról a helyekről ahol lehet változókra hivatkozni a tudnivalókat lásd: Változókra való hivatkozás helyei