Pokročilé techniky: Odkazovanie na uložené hodnoty v premenných

Môžete vytvoriť analýzu, v ktorej názve sa zobrazí meno aktuálneho používateľa. Môžete to vykonať odkazovaním na premennú.

V analýzach, akciách a na paneloch môžete odkazovať na rôzne typy premenných, ako sú: relácia, sémantický model (depozitár), prezentácia, požiadavka a globálne premenné. Autori obsahu môžu definovať premenné prezentácie, premenné požiadavky a globálne premenné sami, ale ostatné typy (relácia a sémantický model (depozitár)) sa definujú v sémantickom modeli.

Poznámka: Služba Oracle Analytics v dokladoch pripojenia dátového zdroja nepodporuje premenné :user a :password.

Typ premennej Miesto definovania Kto definuje Ďalšie informácie

Relácia

  • Systémová

  • Nesystémová

Sémantický model

Autori dátového modelu

 Premenné relácie

Sémantický model (depozitár)

  • Dynamická

  • Statická

Sémantický model

Autori dátového modelu

 Premenné sémantického modelu (depozitára)

Prezentácia

Výzvy pre analýzy a panely

Autor obsahu

 Premenné prezentácie

Požiadavka

Výzvy pre analýzy a panely

Autor obsahu

 Premenné požiadaviek

Globálne

Analýzy

Administrátori

 Globálne premenné a Vytváranie globálnych premenných

Premenné relácie

Premenné relácie sa inicializujú po prihlásení používateľa.

Tieto premenné existujú pre každého používateľa počas trvania relácie prehľadávania. Keď používateľ zavrie prehľadávač alebo keď sa odhlási, ich platnosť uplynie. Existujú dva typy premenných relácie: systémové a nesystémové.

Systémové premenné relácie

V zostavách a na paneloch môžete používať rôzne typy systémových premenných relácie.

Systémové premenné relácie majú vyhradené názvy, takže ich nemôžete použiť na žiadny iný druh premennej.

Systémová premenná relácie Popis Príklad hodnoty dopytu SQL (dialógové okno Premenná)

PORTALPATH

Určuje predvolený panel, ktorý sa zobrazí používateľovi po prihlásení (túto preferenciu môže používateľ po prihlásení prepísať).

Zobrazenie panela ‘mydashboard’ po prihlásení používateľa:

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

TIMEZONE

Určuje predvolené časové pásmo pre používateľa po prihlásení.

Časové pásmo používateľa sa zvyčajne vyplní podľa profilu používateľa. Používatelia môžu zmeniť predvolené časové pásmo v preferenciách (Moje konto).

Nastavenie časového pásma po prihlásení používateľa:

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

DATA_TZ

Určuje posun od pôvodného časového pásma pre dáta.

Táto premenná umožňuje konvertovať časové pásmo tak, aby sa používateľom zobrazovalo správne časové pásmo.

Konverzia časových dát na východný štandardný čas (EST):

select ‘GMT-05:00’ from dual;

Tento príklad znamená greenwichský čas (GMT) - 5 hodín

DATA_DISPLAY_TZ

Určuje časové pásmo na zobrazenie dát.

Zobrazenie východného štandardného času (EST):

select ‘GMT-05:00’ from dual;

Tento príklad znamená greenwichský čas (GMT) - 5 hodín

Nesystémové premenné relácie

Nesystémové premenné relácie sa pomenúvajú a vytvárajú v sémantickom modeli.

Napríklad modelár dát môže vytvoriť premennú SalesRegion, ktorá inicializuje názov oblasti predaja používateľa po prihlásení.

Premenné sémantického modelu (depozitára)

Premenná sémantického modelu (depozitára) je premenná, ktorá má vždy len jednu hodnotu.

Premenné sémantického modelu (depozitára) môžu byť statické alebo dynamické. Statická premenná sémantického modelu (depozitára) má hodnotu, ktorá sa zachováva a nemení, až kým ju nezmení administrátor. Dynamická premenná sémantického modelu (depozitára) má hodnotu, ktorá sa obnovuje na základe dát vrátených z dopytov.

Premenné prezentácie

Keď vytvárate výzvu stĺpca alebo výzvu premennej, vytvoríte premennú prezentácie.

Typ Popis

Výzva stĺpca

Premenná prezentácie vytvorená ako súčasť výzvy stĺpca je priradená k stĺpcu a hodnoty, ktoré môže mať, pochádzajú z hodnôt stĺpca.

Ak chcete vytvoriť premennú prezentácie ako súčasť výzvy stĺpca, v dialógovom okne Nová výzva je potrebné vybrať položku Premenná prezentácie v poli Nastaviť premennú. V poli Názov premennej zadajte názov premennej.

Výzva premennej

Premenná prezentácie vytvorená ako súčasť výzvy premennej nie je priradená k žiadnemu stĺpcu a vy definujete hodnoty, ktoré môže mať.

Ak chcete vytvoriť premennú prezentácie ako súčasť výzvy premennej, v dialógovom okne Nová výzva je potrebné vybrať položku Premenná prezentácie v poli Výzva pre. V poli Názov premennej zadajte názov premennej.

Hodnota premennej prezentácie sa vyplní na základe výzvy stĺpca alebo premennej, s ktorou bola vytvorená. To znamená, že vždy, keď používateľ vyberie jednu alebo viac hodnôt vo výzve stĺpca alebo premennej, hodnota premennej prezentácie sa nastaví na hodnotu alebo hodnoty vybrané používateľom.

Premenné požiadaviek

Premenná požiadavky umožňuje prepísať hodnotu premennej relácie, ale iba počas trvania požiadavky databázy iniciovanej z výzvy stĺpca. Premennú požiadavky môžete vytvoriť v rámci procesu vytvárania výzvy stĺpca.

Premennú požiadavky môžete vytvoriť v rámci procesu vytvárania niektorého z nasledujúcich typov výziev panelov.

  • Premenná požiadavky vytvorená v rámci výzvy stĺpca je priradená k stĺpcu a môže získať len hodnoty nachádzajúce sa v stĺpci.

    Ak chcete vytvoriť premennú požiadavky ako súčasť výzvy stĺpca, v dialógovom okne Nová výzva je potrebné vybrať hodnotu Premenná požiadavky v poli Nastaviť premennú. Zadajte názov premennej relácie na prepísanie v poli Názov premennej.

  • Premenná požiadavky vytvorená ako súčasť výzvy premennej nie je priradená k žiadnemu stĺpcu a vy definujete hodnoty, ktoré môže získať.

    Ak chcete vytvoriť premennú požiadavky ako súčasť výzvy premennej, v dialógovom okne Nová výzva (alebo v dialógovom okne Upraviť výzvu) je potrebné vybrať hodnotu Premenná požiadavky v poli Výzva pre. Do poľa Názov premennej potom zadajte názov premennej relácie na prepísanie.

Hodnota premennej požiadavky sa vyplní výzvou stĺpca, s ktorou bola vytvorená. Znamená to, že pri každom výbere hodnoty vo výzve stĺpca používateľom sa hodnota premennej požiadavky nastaví na hodnotu, ktorú používateľ vyberie. Táto hodnota je však platná len od okamihu stlačenia tlačidla Prejsť pre výzvu používateľom do vrátenia výsledkov analýzy do panela.

Určité systémové premenné relácií (napríklad USERGUID alebo ROLES) nie je možné prepísať premennými požiadaviek. Iné systémové premenné relácií, ako napríklad DATA_TZ a DATA_DISPLAY_TZ (časové pásmo), je možné prepísať, ak sú nakonfigurované v nástroji Model Administration Tool.

Viaceré hodnoty sú podporované iba v reťazcových a číselných premenných požiadaviek. Všetky ostatné dátové typy používajú iba prvú hodnotu.

Globálne premenné

Globálna premenná je stĺpec vytvorený kombinovaním konkrétneho dátového typu s hodnotou. Touto hodnotou môže byť Dátum, Dátum a čas, Číslo, Text a Čas.

Globálna premenná sa vyhodnocuje v čase spustenia analýzy a hodnota globálnej premennej sa primerane nahradí.

Globálne premenné môžu spravovať (pridávať, upravovať a odstraňovať) len používatelia s rolou administrátora služby BI.

Globálnu premennú vytvárate počas procesu vytvárania analýzy pomocou dialógového okna Upraviť vzorec stĺpca. Globálna premenná sa potom uloží v katalógu a sprístupní sa pre všetky ostatné analýzy v konkrétnom klientskom systéme.

Vytváranie globálnych premenných

Výpočet môžete uložiť ako globálnu premennú a potom ho môžete znova použiť v iných analýzach.

  1. Otvorte analýzu na úpravu.
  2. V podokne Vybrané stĺpce kliknite na položku Voľby vedľa názvu stĺpca.
  3. Výberom položky Upraviť vzorec zobrazte kartu Vzorec stĺpca.
  4. Kliknite na položku Premenná a vyberte voľbu Globálne.
  5. Kliknite na položku Pridať novú globálnu premennú.
  6. Zadajte hodnotu do poľa Názov. Použite napríklad názov gv_region, date_and_time_global_variable alebo rev_eastern_region_calc_gv.
    Názov globálnej premennej musí byť pri odkazovaní na premennú plne kvalifikovaný, a preto sa pred názov pridáva prefix global.variables. Napríklad globálna premenná, ktorá je nastavená na výpočet výnosov, sa v dialógovom okne Vzorec stĺpca zobrazuje takto:

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

  7. Zadajte hodnoty do polí Typ a Hodnota.
    • Ak vyberiete dátový typ Dátum a čas, zadajte hodnotu ako v nasledujúcom príklade: 03/25/2004 12:00:00 AM
    • Ak ako hodnotu zadávate výraz alebo výpočet, je nutné použiť dátový typ Text (ako v nasledujúcom príklade): "Base Facts"."1- Revenue"*3.1415
  8. Kliknite na tlačidlo OK. Nová globálna premenná sa pridá do dialógového okna Vložiť globálnu premennú.
  9. Vyberte novú globálnu premennú, ktorú ste práve vytvorili, a kliknite na tlačidlo OK. Zobrazí sa dialógové okno Upraviť vzorec stĺpca s globálnou premennou vloženou do podokna Vzorec stĺpca. Políčko Vlastné záhlavia sa automaticky začiarkne.
  10. Zadajte nový názov pre stĺpec, ku ktorému ste priradili globálnu premennú, aby presnejšie vystihoval túto premennú.
  11. Kliknite na tlačidlo OK.

Syntax odkazov na premenné

Na premenné môžete odkazovať v analýzach a na paneloch.

Spôsob, akým odkazujete na premennú, závisí od vykonávanej úlohy. V prípade úloh, pri ktorých pracujete s poľami v dialógovom okne, je potrebné zadať len typ a názov premennej (nie úplnú syntax), napríklad pri odkazovaní na premennú v definícii filtra.

V prípade iných úloh, ako je napríklad odkazovanie na premennú v zobrazení nadpisu, zadávate syntax premennej. Použitá syntax závisí od typu premennej, ako je to opísané v nasledujúcej tabuľke.

Typ Syntax Príklad

Relácia

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

kde variablename je názov premennej relácie, napríklad DISPLAYNAME.

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

Sémantický model (depozitár)

@{biServer.variables.variablename}

alebo

@{biServer.variables['variablename']}

kde variablename je názov premennej, napríklad prime_begin

@{biServer.variables.prime_begin}

alebo

@{biServer.variables['prime_begin']}

Prezentácia alebo požiadavka

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

alebo

@{scope.variables['variablename']}

kde:

variablename je názov premennej prezentácie alebo požiadavky, napríklad MyFavoriteRegion.

(Voliteľné) format je maska formátu závislá od dátového typu premennej, napríklad #,##0, MM/DD/YY hh:mm:ss. (Formát sa nepoužije pre predvolenú hodnotu.)

(Voliteľné) defaultvalue je odkaz na konštantu alebo premennú. Označuje hodnotu, ktorá sa má použiť, ak premenná, na ktorú odkazuje variablename, nie je vyplnená.

scope identifikuje kvalifikátory pre premennú. Rozsah je potrebné zadať, ak sa premenná používa na viacerých úrovniach (analýzy, stránky panela a panely) a chcete použiť konkrétnu hodnotu. (Ak nezadáte rozsah, poradie priority je analýzy, stránky panela a panely.)

Pri používaní výzvy panela s premennou prezentácie, ktorá môže mať viac hodnôt, sa syntax líši v závislosti od typu stĺpca. Viaceré hodnoty sú formátované na hodnoty oddelené čiarkami, a preto sa klauzula formátovania použije pre každú hodnotu skôr, ako budú spojené čiarkami.

@{variables.MyFavoriteRegion}{EASTERN REGION}

alebo

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

alebo

@{dashboard.variables['MyFavoriteRegion']}

alebo

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

alebo

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

alebo

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

Globálne

@{global.variables.variablename}

kde variablename je názov globálnej premennej, napríklad gv_region. Pri odkazovaní na globálnu premennú je potrebné použiť plne kvalifikovaný názov, ako je to uvedené v príklade.

Konvencia tvorby názvov pre globálne premenné musí spĺňať špecifikácie skriptovacieho jazyka ECMA pre jazyk JavaScript. Názov nesmie prekročiť 200 znakov ani obsahovať vnorené medzery, rezervované slová a špeciálne znaky. Ak nepoznáte požiadavky jazyka JavaScript, pozrite si ďalšiu dokumentáciu.

@{global.variables.gv_date_n_time}

Môžete tiež odkazovať na premenné vo výrazoch. Zásady pre odkazovanie na premenné vo výrazoch sú opísané v nasledujúcich témach:

Premenné relácie

Nasledujúce pokyny môžete používať pri odkazovaní na premenné relácie vo výrazoch.

  • Premennú relácie pridajte ako argument funkcie VALUEOF.
  • Názov premennej umiestnite do dvojitých úvodzoviek.
  • Pred premennú relácie umiestnite NQ_SESSION a bodku.
  • Časť NQ_SESSION umiestnite do dvojitých úvodzoviek.
  • Časť NQ_SESSION aj názov premennej relácie umiestnite do zátvoriek.

Príklad:

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

Premenné prezentácie

Môžete použiť nasledujúce zásady pre odkazovanie na premennú prezentácie vo výrazoch.

Pri odkazovaní na premennú prezentácie použite túto syntax:

@{variablename}{defaultvalue}

variablename je názov premennej prezentácie a defaultvalue (voliteľné) je odkaz na konštantu alebo premennú označujúci hodnotu, ktorá sa má použiť, ak premenná s odkazom variablename nie je vyplnená.

Ak chcete previesť (t. j. konvertovať) premennú na reťazec alebo zahrnúť viacero premenných, umiestnite celú premennú medzi jednoduché úvodzovky, napríklad:

'@{user.displayName}'

Ak za znakom @ nenasleduje zátvorka {, považuje sa za zavináč. Pri používaní premennej prezentácie, ktorá môže mať viac hodnôt, sa syntax líši v závislosti od typu stĺpca.

Na generovanie platných príkazov SQL použite nasledujúcu syntax v jazyku SQL pre zadaný typ stĺpca:

  • Text – (@{variablename}['@']{'defaultvalue'})

  • Numerické hodnoty – (@{variablename}{defaultvalue})

  • Dátum-čas – (@{variablename}{timestamp 'defaultvalue'})

  • Dátum (len dátum) – (@{variablename}{date 'defaultvalue'})

  • Čas (len čas) – (@{variablename}{time 'defaultvalue'})

Príklad:

'@{user.displayName}'

Premenné sémantického modelu (depozitára)

Môžete používať nasledujúce zásady odkazovania na premenné sémantického modelu (depozitára) vo výrazoch.

  • Premennú pridajte ako argument funkcie VALUEOF.
  • Názov premennej umiestnite do dvojitých úvodzoviek.
  • Na statickú premennú sémantického modelu (depozitára) odkazujte jej názvom.
  • Na dynamickú premennú sémantického modelu (depozitára) odkazujte plne kvalifikovaným názvom.

Príklad:

CASE WHEN "Hodina" >= VALUEOF("prime_begin") AND "Hodina" < VALUEOF("prime_end") THEN 'Hlavný vysielací čas' WHEN ... ELSE...END