Napredne tehnike: Navođenje spremljenih vrijednosti u varijablama

Možda ćete htjeti napraviti analizu u čijem se naslovu prikazuje ime aktivnog korisnika. To možete učiniti navođenjem varijable.

U analizama, dashboardima i akcijama možete navesti nekoliko različitih vrsta varijabli: one za sesiju, semantički model (repozitorij), prezentaciju, zahtjev i globalne. Autori sadržaja sami mogu definirati varijable za prezentacije i zahtjev te globalne varijable, no ostale vrste (one za sesiju i semantički model (repozitorij) unaprijed su definirane u semantičkom modelu.

Napomena: Oracle Analytics ne podržava varijable :user i :password u sigurnosnim podacima za povezivanje s izvorom podataka.

Vrsta varijable Definira se u Definira je Dodatne informacije

Sesija

  • Sistemska

  • Nesistemska

Semantički model

Autori podatkovnih modela

Više o varijablama sesije

Semantički model (repozitorij)

  • Dinamički

  • Statično

Semantički model

Autori podatkovnih modela

Više o varijablama semantičkog modela (repozitorija)

Prezentacija

Parametri u analizama i dashboardima

Autor sadržaja

Više o prezentacijskim varijablama

Zahtjev

Parametri u analizama i dashboardima

Autor sadržaja

Više o varijablama zahtjeva

Globalno

Analize

Administratori

Više o globalnim varijablama i Stvaranje globalnih varijabli

Više o varijablama sesije

Varijable sesije inicijaliziraju se kad se korisnik prijavi.

Te varijable postoje za svakog korisnika za cijelo trajanje sesije pregleda, a istječu kad korisnik zatvori preglednik ili se odjavi. Postoje dvije vrste varijabli sesije: sistemske i nesistemske.

Sistemske varijable sesija

Postoji nekoliko sistemskih varijabli sesije koje možete upotrijebiti u izvješćima i dashboardima.

Sistemske varijable sesija imaju rezervirane nazive, tako da ih ne možete upotrebljavati za druge vrste varijabli.

Sistemska varijabla sesije Opis Primjer vrijednosti SQL upita (dijaloški okvir Varijabla)

PORTALPATH

Definira zadani dashboard koji će se korisniku prikazati pri prijavi (korisnik tu preferencu može promijeniti nakon što se prijavi).

Prikaz dashboarda ‘mydashboard’ kad se korisnik prijavi:

 select ‘/shared/_portal/mydashboard’ from dual;

TIMEZONE

Definira zadanu vremensku zonu korisnika pri prijavi.

Korisnikova vremenska zona obično se popunjava sukladno korisnikovom profilu. Korisnici zadanu vremensku zonu mogu promijeniti u preferencama (Moj račun).

Promjena vremenske zone kad se korisnik prijavi:

select ‘(GMT-08:00) Pacific Time (US & Canada)’ from dual;

DATA_TZ

Definira odmak od izvorne vremenske zone koji će se upotrijebiti za podatke.

Ta varijabla omogućuje vam konverziju vremenske zone kako bi se korisnicima prikazivala točna vremenska zona.

Konverzija podataka o vremenu na Istočno standardno vrijeme (EST):

select ‘GMT-05:00’ from dual;

Primjer navodi Srednje vrijeme po Greenwichu (GMT) – 5 sati

DATA_DISPLAY_TZ

Definira vremensku zonu za prikaz podataka.

Prikaz Istočnog standardnog vremena (EST):

select ‘GMT-05:00’ from dual;

Primjer navodi Srednje vrijeme po Greenwichu (GMT) – 5 sati

Nesistemske varijable sesije

Nesistemske varijable sesije stvarate i imenujete u semantičkom modelu.

Na primjer, dizajner podataka može stvoriti varijablu ProdajnaRegija koja se inicijalizira na naziv korisnikove prodajne regije kad se korisnik prijavi.

Više o varijablama semantičkog modela (repozitorija)

Varijabla semantičkog modela (repozitorija) je varijabla koja u bilo kojem trenutku u vremenu ima jednu vrijednost.

Varijable semantičkog modela (repozitorija) mogu biti statičke ili dinamičke. Statička varijabla semantičkog modela (repozitorija) ima trajne vrijednosti koje se neće promijeniti sve dok ih administrator ne promijeni. Dinamička varijabla semantičkog modela (repozitorija) ima vrijednosti koje se osvježavaju podacima koje su vratili upiti.

Više o prezentacijskim varijablama

Varijablu prezentacije stvarate pri stvaranju parametra stupca ili varijable.

Vrsta Opis

Parametar stupca

Prezentacijska varijabla koja se stvara u sklopu parametra stupca povezuje se sa stupcem, a vrijednosti koje može preuzeti dolaze iz vrijednosti stupca.

Želite li prezentacijsku varijablu napraviti u sklopu parametra stupca, u dijaloškom okviru Novi parametar morate odabrati Varijabla prezentacije u polju Postavi varijablu. Unesite naziv varijable u polje Naziv varijable.

Parametar varijable

Prezentacijska varijabla koja se stvara u sklopu parametra varijable neće se povezati ni sa jednim stupcem, a sami ćete definirati vrijednosti koje može preuzeti.

Želite li prezentacijsku varijablu napraviti u sklopu parametra varijable, u dijaloškom okviru Novi parametar morate odabrati Varijabla prezentacije u polju Parametar za. Unesite naziv varijable u polje Naziv varijable.

Vrijednost prezentacijske varijable ispunjava parametar stupca ili varijable s kojim je ona stvorena. Svaki put kad korisnik odabere jednu ili više vrijednosti u parametru stupca ili varijable, vrijednost prezentacijske varijable postavit će se na vrijednost ili vrijednosti koje korisnik odabere.

Više o varijablama zahtjeva

Varijabla zahtjeva omogućuje vam da nadjačate vrijednost varijable sesije samo tijekom trajanja zahtjeva baze podataka koji je pokrenut putem parametra stupca. Varijablu zahtjeva možete napraviti tijekom stvaranja parametra stupca.

Varijablu zahtjeva možete napraviti tijekom stvaranja jedne od sljedećih vrsta parametara dashboarda:

  • Varijabla zahtjeva koja se stvara u sklopu parametra stupca povezuje se sa stupcem, a vrijednosti koje može preuzeti dolaze iz vrijednosti stupca.

    Želite li varijablu zahtjeva napraviti u sklopu parametra stupca, u dijaloškom okviru Novi parametar morate odabrati Varijabla zahtjeva u polju Postavi varijablu. U polje Naziv varijable unesite naziv varijable sesije koju želite nadjačati.

  • Varijabla zahtjeva koja se stvara u sklopu parametra varijable neće se povezati ni sa jednim stupcem, a sami ćete definirati vrijednosti koje može preuzeti.

    Želite li varijablu zahtjeva napraviti u sklopu parametra varijable, u dijaloškom okviru Novi parametar (ili dijaloškom okviru Uređivanje parametra) morate odabrati Varijabla zahtjeva u polju Parametar za. Zatim u polje Naziv varijable unesite naziv varijable sesije koju želite nadjačati.

Vrijednost varijable zahtjeva ispunjava parametar stupca pomoću kojeg je ona stvorena. Svaki put kad korisnik odabere vrijednost u parametru stupca, vrijednost varijable zahtjeva postavit će se na vrijednost koju je korisnik odabrao. Ta vrijednost primjenjivat će se, međutim, samo od trenutka kad korisnik za parametar pritisne gumb Idi do trenutka kad se rezultati analize vrate u dashboard.

Određene varijable sesije sustava (na primjer, USERGUID i ROLES) ne mogu se nadjačati varijablama zahtjeva. Ostale varijable sesije sustava, kao što su DATA_TZ i DATA_DISPLAY_TZ (vremenska zona) mogu se nadjačati ako su konfigurirane u alatu za administriranje modela.

Višestruke vrijednosti podržane su samo u nizovnim i numeričkim varijablama zahtjeva. Sve ostale vrste podataka prenijet će samo prvu vrijednost.

Više o globalnim varijablama

Globalna varijabla stupac je izrađen kombiniranjem određene vrste podataka i vrijednosti. Vrijednost može biti datum, datum i vrijeme, broj, tekst i vrijeme.

Globalna varijabla ocjenjuje se u trenutku provođenja analize, a u skladu s tim nadomješta se vrijednost globalne varijable.

Samo korisnici s ulogom Administrator BI servisa mogu upravljati (dodavati, uređivati i brisati) globalnim varijablama.

Tijekom stvaranja analize putem dijaloškog okvira Uređivanje formule stupca, stvarate globalnu vrijednost. Globalna varijabla zatim se sprema u katalog i postaje dostupna svim drugima analizama unutar određenog klijentskog sustava.

Stvaranje globalnih varijabli

Izračun možete spremiti kao globalnu varijablu, a zatim ga ponovo upotrijebiti u drugoj analizi.

  1. Otvorite analizu koju želite urediti.
  2. U prozoru Odabrani stupci pritisnite Opcije uz naziv stupca.
  3. Odaberite Uredi formulu kako bi se prikazala kartica Formula stupca.
  4. Pritisnite Varijabla i odaberite Globalno.
  5. Pritisnite Dodaj novu globalnu varijablu.
  6. Unesite vrijednost za Naziv. Na primjer, gv_region, date_and_time_global_variable ili rev_eastern_region_calc_gv.
    Naziv globalne varijable mora biti u potpunosti kvalificiran kad navodite varijablu te je zbog toga ispred njega naveden tekst "global.variables". Na primjer, globalna varijabla za izračun prihoda prikazuje se u dijaloškom okviru Formula stupca na sljedeći način:

    "Base Facts"."1- Revenue"*@{global.variables.gv_qualified}

  7. Unesite vrijednosti za Vrstu i Vrijednost.
    • Ako ćete za vrstu podataka odabrati "Datum i vrijeme", vrijednost unesite kao što je navedeno u sljedećem primjeru: 03/25/2004 12:00:00 AM
    • Ako kao vrijednost unosite izraz ili izračun, morate upotrijebiti vrstu podataka Tekst, kao što je navedeno u sljedećem primjeru: "Base Facts"."1- Revenue"*3.1415
  8. Pritisnite U redu. Nova globalna varijabla dodat će se u dijaloški okvir Umetanje globalne varijable.
  9. Odaberite novu globalnu varijablu koju ste upravo napravili i pritisnite U redu. Dijaloški okvir Uređivanje formule stupca prikazuje se uz globalnu varijablu koja je umetnuta u prozor Formula stupca. Automatski je uključen potvrdni okvir Prilagođeni naslovi.
  10. Unesite novi naziv stupca kojemu ste dodijelili globalnu varijablu kako bi on preciznije ukazivao na varijablu.
  11. Pritisnite U redu.

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