Speciális módszerek: Hivatkozás a változókban tárolt értékekre

Előfordulhat, hogy olyan elemzést szeretne létrehozni, amelyik címe az aktuális felhasználó nevét jeleníti meg. Ekkor használhatja a változóra hivatkozást.

Az elemzéseiben, irányítópultjain vagy műveleteiben számos különböző változótípusra hivatkozhat: munkameneti, szemantikai modell (adattári), bemutatói, kérelmi és globális. A tartalom szerzői maguk is definiálhatják a bemutatói, kérelmi és globális változókat, azonban a többi típus (munkameneti és szemantikai modell (adattári) a szemantikai modellben van definiálva.

Megjegyzés:Az Oracle Analytics nem támogatja a :user és :password változókat az adatforrás-kapcsolat hitelesítő adataiban.

Változó típusa	Definiálás helye	Definiálta	További információk
Munkamenet Rendszerbeli Nem a rendszerhez tartozó	Szemantikai modell	Adatmodellszerzők	Tudnivalók a munkameneti változókról
Szemantikai modell (adattári) Dinamikus Statikus	Szemantikai modell	Adatmodellszerzők	A szemantikai modell (adattári) változókról
Bemutató	Promptok elemzésekhez és irányítópultokhoz	Tartalom szerzői	Tudnivalók a megjelenítési változókról
Kérelem	Promptok elemzésekhez és irányítópultokhoz	Tartalom szerzői	Tudnivalók a kérelmi változókról
Globális	Elemzések	Rendszergazdák	Tudnivalók a globális változókról és Globális változók létrehozása

Tudnivalók a munkameneti változókról

A munkameneti változók a felhasználók bejelentkezésekor inicializálódnak.

Ezek a változók az egyes felhasználók böngészési munkamenetének időtartama alatt léteznek, és akkor járnak le, amikor a felhasználó bezárja a böngészőt vagy kijelentkezik a rendszerből. A munkameneti változóknak két típusa van: rendszerkezelt és nem rendszerkezelt.

Rendszerkezelt munkameneti változók

Számos rendszerkezelt munkameneti változó létezik, amelyeket Ön is használhat kimutatásaiban és irányítópultjain.

A rendszerkezelt munkameneti változók foglalt neveket használnak, ezért azok nem használhatók semmilyen más változóhoz.

Rendszerkezelt munkameneti változó	Leírás	Példa az SQL-lekérdezés értékére (Változó beszúrása párbeszédpanel)
PORTALPATH	Meghatározza azt az alapértelmezett irányítópultot, amelyik a felhasználók bejelentkezésekor megjelenik (a felhasználók a bejelentkezés után felülírhatják ezt a beállítást).	A ‘mydashboard’ megjelenítése a felhasználó bejelentkezésekor: select ‘/shared/_portal/mydashboard’ from dual;
TIMEZONE	Megadja az adott felhasználó bejelentkezésekor használandó időzónát. A felhasználóhoz tartozó időzóna általában a felhasználó profiljából töltődik fel. A felhasználók a beállításokban (Saját fiók) módosíthatják az alapértelmezett időzónájukat.	Az időzóna beállítása a felhasználó bejelentkezésekor: select ‘(GMT-08:00) Pacific Time (US & Canada)’ from dual;
DATA_TZ	Megadja az adatokhoz tartozó eredeti időzónától való eltérést. Ezzel a változóval átalakíthatja úgy az időzónát, hogy a felhasználók a számukra megfelelő időzónát lássák.	Az idő átalakítása keleti zónaidőre (EST): select ‘GMT-05:00’ from dual; Ez a példa a greenwichi középidőtől (GMT) való -5 órás eltérést jelent
DATA_DISPLAY_TZ	Megadja az adatok megjelenítéséhez használandó időzónát.	A keleti zónaidő (EST) megjelenítése: select ‘GMT-05:00’ from dual; Ez a példa a greenwichi középidőtől (GMT) való -5 órás eltérést jelent

Nem rendszerkezelt munkameneti változók

A rendszerkezelt munkameneti változók elnevezése és létrehozása az Ön szemantikai modelljében történik.

Az adatmodellezője létrehozhat például egy SalesRegion nevű nem rendszerkezelt változót, amelyik a felhasználó értékesítési régiójának nevét inicializálja a bejelentkezésekor.

A szemantikai modell (adattári) változókról

A szemantikai modell (adattári) változó olyan változó, amelyik bármely adott időpontban egyetlen értékkel rendelkezik.

A szemantikai modell (adattári) változók statikusak vagy dinamikusak lehetnek. A statikus szemantikai modell (adattári) változó értéke mindaddig megmarad, amíg a rendszergazda meg nem változtatja. A dinamikus szemantikai modell (adattári) változó értéke mindig a lekérdezésekből visszakapott adatokkal frissül.

Tudnivalók a megjelenítési változókról

Oszlopprompt és változóprompt létrehozásakor megjelenítési változót is létrehoz.

Típus	Leírás
Oszlop promptja	Az olyan megjelenítési változó, amelyik egy oszlop-prompt részeként lett létrehozva, oszlophoz társul, és a felvehető értékei az oszlop értékeiből származnak. Megjelenítési változó oszlopprompt részeként történő létrehozásához az Új prompt párbeszédpanelen ki kell jelölnie a Megjelenítési változó elemet a Változó beállítása mezőben. A Változó neve mezőben adja meg a változó nevét.
Változó promptja	Az olyan megjelenítési változó, amelyik egy változóprompt részeként lett létrehozva, oszlophoz nem társul, és a felvehető értékét a létrehozó (Ön) határozhatja meg. Megjelenítési változó változóprompt részeként történő létrehozásához az Új prompt párbeszédpanelen ki kell jelölnie a Megjelenítési változó elemet a Prompt a következőhöz: mezőben. A Változó neve mezőben adja meg a változó nevét.

Típus

Leírás

Oszlop promptja

Az olyan megjelenítési változó, amelyik egy oszlop-prompt részeként lett létrehozva, oszlophoz társul, és a felvehető értékei az oszlop értékeiből származnak.

Megjelenítési változó oszlopprompt részeként történő létrehozásához az Új prompt párbeszédpanelen ki kell jelölnie a Megjelenítési változó elemet a Változó beállítása mezőben. A Változó neve mezőben adja meg a változó nevét.

Változó promptja

Az olyan megjelenítési változó, amelyik egy változóprompt részeként lett létrehozva, oszlophoz nem társul, és a felvehető értékét a létrehozó (Ön) határozhatja meg.

Megjelenítési változó változóprompt részeként történő létrehozásához az Új prompt párbeszédpanelen ki kell jelölnie a Megjelenítési változó elemet a Prompt a következőhöz: mezőben. A Változó neve mezőben adja meg a változó nevét.

A megjelenítési változó értékét annak az oszlopnak vagy változónak a promptja tölti fel, amelyikkel létre lett hozva. Azaz valahányszor a felhasználó az oszlop vagy a változó promptjában kijelöl egy vagy több értéket, a megjelenítési változó értéke az vagy azok lesznek, amelyet a felhasználó kijelölt.

Tudnivalók a kérelmi változókról

A kérelmi változó lehetővé teszi a munkameneti változó felülírását, de csak arra az időre, amikor az adatbázisi kérelem az oszlop promptjából inicializálódik. A kérelmi változó az oszlopprompt létrehozási folyamatának részeként hozható létre.

A kérelmi változó olyan valamelyik következő típusú irányítópulti promptok létrehozási folyamatának részeként hozható létre:

A kérelmi változó, amelyik egy oszlop-prompt részeként lett létrehozva, oszlophoz társul, és a felvehető értékei az oszlop értékeiből származnak.

Kérelmi változó oszlopprompt részeként történő létrehozásához az Új prompt párbeszédpanelen ki kell jelölnie a Kérelmi változó elemet a Változó beállítása mezőben. A Változó neve mezőben adja meg a felülírandó munkameneti változó nevét.
Az olyan kérelmi változó, amelyik egy változóprompt részeként lett létrehozva, oszlophoz nem társul, és a felvehető értékét a létrehozó (Ön) határozhatja meg.

Kérelmi változó változóprompt részeként történő létrehozásához az Új prompt párbeszédpanelen (vagy a Prompt szerkesztése párbeszédpanelen) ki kell jelölnie a Kérelmi változó elemet a Prompt a következőhöz: mezőben. Ezután a Változó neve mezőben adja meg a felülírni kívánt munkameneti változó nevét.

A kérelmi változó értékét annak az oszlopnak a promptja tölti fel, amelyikkel létre lett hozva. Azaz valahányszor a felhasználó az oszlop promptjában kiválaszt egy értéket, a kérelmi változó értéke az lesz, amit a felhasználó kiválasztott. Az érték azonban csak arra az időre van érvényben, ami aközött van, hogy a felhasználó megnyomja a prompt Indítás gombját, és az elemzési eredmények visszatérítődnek az irányítópultra.

Bizonyos rendszerkezelt munkameneti változókat (például: USERGUID vagy ROLES) a kérelmi változók nem írhatják felül. Más rendszerkezelt változókat, mint például a DATA_TZ és a DATA_DISPLAY_TZ (időzóna) akkor lehet felülírni, ha a modell adminisztrációs eszközében úgy vannak konfigurálva.

Csak karakterlánc és numerikus kérelmi változónál használható több érték. Az összes többi adattípus csak az első értéket adja át.

Tudnivalók a globális változókról

A globális változó adott adattípus és érték összekapcsolásával létrehozott oszlop. Az érték lehet Dátum, Dátum és idő, Szám, Szöveg és Idő.

A globális változó kiértékelésére az elemzés végrehajtásakor kerül sor, és a globális változó értéke ennek megfelelőre változik.

Csak a BI szolgáltatás rendszergazdája szerepkörrel rendelkező felhasználók kezelhetik a globális változókat (hozzáadás, szerkesztés, illetve törlés).

A globális értéket az elemzés létrehozási folyamatában hozza létre az Oszlopképlet szerkesztése párbeszédpanel használatával. A globális változót ezután a katalógusba menti a rendszer, és adott bérleti rendszeren belül az összes többi elemzés számára is elérhető.

Globális változók létrehozása

Egy számítást elmenthet globális változóként, s aztán különböző elemzésekben újra felhasználhatja azt.

Nyissa meg az elemzést szerkesztésre.
A Kijelölt oszlopok ablaktáblán kattintson az oszlopnév oldalánál lévő Beállítások gombra.

.gif ábra leírása
Az Oszlopképlet lap megjelenítéséhez válassza ki a Képlet szerkesztése lehetőséget.
Kattintson a Változó elemre, majd válassza ki a Globális lehetőséget.
Kattintson az Új globális változó hozzáadása elemre.

.gif ábra leírása
Adja meg a Név mező értékét. Példák: gv_region, date_and_time_global_variable vagy rev_eastern_region_calc_gv.
A változókra való hivatkozásnál a globális változó nevének teljesen megadottnak kell lennie, így a „global.variables” szövegű előtagnak is szerepelnie kell. Például az árbevétel kiszámításához szükséges globális változókészlet a következőképpen jelenik meg az Oszlopképlet párbeszédpanelen:
"Tényadatok"."1- Árbevétel"*@{global.variables.gv_qualified}
Adja meg a Típus és az Érték mező értékét.
- Ha adattípusként a „Dátum és idő” típust választja, akkor az értéket a következő példa szerint adja meg: 03/25/2004 12:00:00 AM
- Ha értékként kifejezést vagy számítást ír be, akkor a Szöveg adattípust kell használnia a következő példa szerint: "Tényadatok"."1- Árbevétel"*3.1415
Kattintson az OK gombra. Az új globális változó felkerül a Globális változó beszúrása párbeszédpanelre.
Jelölje ki az imént létrehozott globális változót, majd kattintson az OK gombra. Az Oszlopképlet szerkesztése párbeszédpanel jelenik meg, amelyen a globális változó be van szúrva az Oszlopképlet ablaktáblában. Az Egyéni fejlécek négyzetet automatikusan bejelöli a rendszer.
A változó rendeltetésének pontosabb leírásához adjon új nevet annak az oszlopnak, amelyhez globális változót rendelt.
Kattintson az OK gombra.

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