Jaká je syntaxe odkazování na proměnné?

Na proměnné je možné odkazovat v analýzách, panelech, klíčových ukazatelích výkonu a agentů. Způsob odkazování na proměnnou závisí na úloze, kterou provádíte.

U úloh, kde jsou vám předložena pole v dialogovém okně, musíte zadat pouze jeden typ a název proměnné (nikoli celou syntaxi), například odkazování na proměnnou v definici filtru.

U ostatních úloh, jako je odkazování na proměnnou v zobrazení názvů, zadáváte syntaxi proměnné. Použitá syntaxe závisí na typu proměnné, jak je popsáno v tabulce.

Poznámka:

Pokud není znak „zavináč“ (@) v syntaxi následován závorkou ({), je považován za znak „zavináč“.
Typ proměnné Syntaxe Příklad

Relace

@{biServer.variables['NQ_SESSION.název_proměnné']}

kde název_proměnné je název proměnné relace, například DISPLAYNAME.

Seznam proměnných relace systému, které můžete použít, najdete v části Informace o proměnných relace systému v dokumentu Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition.

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

Úložiště

@{biServer.variables.název_proměnné}

nebo

@{biServer.variables['název_proměnné']}

kde název_proměnné je název proměnné úložiště, například prime_begin.

@{biServer.variables.prime_begin}

nebo

@{biServer.variables['prime_begin']}

Prezentace nebo požadavek

@{variables.název_proměnné}[formát]{výchozí_hodnota}

nebo

@{scope.variables['název_proměnné']}

kde:

  • název_proměnné je název proměnné prezentace nebo požadavku, například MyFavoriteRegion.

  • (volitelné) formát je maska formátu závislá na datovém typu proměnné, například #,##0, MM/DD/RR hh:mm:ss. (Formát není použit u výchozí hodnoty.)

  • (volitelné) výchozí_hodnota je odkaz na konstantu nebo proměnnou označující hodnotu, která se má použít v případě, že proměnná, na kterou hodnota název_proměnné odkazuje, není zadána.

  • rozsah označuje kvalifikátory proměnné. Rozsah je třeba zadat, když se proměnná používá na více úrovních (analýzy, stránky panelu a panely) a chcete získat přístup ke konkrétní hodnotě. (Pokud rozsah nezadáte, je pořadí přednosti následující: analýzy, stránky panelu a panely.)

Poznámka: Při použití výzvy panelu s proměnnou prezentace, která může mít více hodnot, se syntaxe liší podle typu sloupce. Více hodnot se formátuje v podobě hodnot oddělených čárkou; klauzule FORMAT se proto před spojením hodnot čárkou použije na jednotlivé hodnoty.

@{variables.MyFavoriteRegion}{EASTERN REGION}

nebo

@{MyFavoriteRegion}

nebo

@{dashboard.variables['MyFavoriteRegion']}

nebo

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

nebo

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

nebo

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

Globální

@{global.variables.název_proměnné}

kde název_proměnné je název globální proměnné, například gv_region. Když se odkazujete na globální proměnnou, vždy musíte použít úplný název, jako v uvedeném příkladu.

Poznámka: Konvence pojmenování globálních proměnných musí splňovat specifikace skriptovacího jazyka ECMA Script pro JavaScript. Maximální délka názvu je 200 znaků, přičemž součástí názvu nesmějí být mezery, vyhrazená slova a speciální znaky. Neznáte-li požadavky skriptovacího jazyka JavaScript, prostudujte si zdroje třetích stran.

@{global.variables.gv_date_n_time}

Na proměnné je možné odkazovat také ve výrazech. Pokyny pro odkazování proměnných ve výrazech jsou popsány v následující tabulce.

Typ proměnné Pokyny Příklad

Relace

  • Zahrnuje proměnnou relace jako argument funkce VALUEOF.

  • Název proměnné uveďte ve dvojitých uvozovkách.

  • Před názvem relace uveďte text NQ_SESSION a tečku.

  • Část NQ_SESSION i název proměnné relace uveďte v závorkách.

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

Úložiště

  • Zahrnuje proměnnou úložiště jako argument funkce VALUEOF.

  • Název proměnné uveďte ve dvojitých uvozovkách.

  • Na proměnnou statického úložiště odkazujte podle názvu.

  • Na proměnnou dynamického úložiště odkazujte podle plně kvalifikovaného názvu.

    Pokud používáte proměnnou dynamického úložiště, musí být názvy bloku inicializace a proměnné úložiště uvedeny v dvojitých uvozovkách (") oddělených tečkou a uzavřeny v závorkách. Chcete-li například používat hodnotu proměnné dynamického úložiště s názvem REGION obsažené v bloku inicializace nazvané Zabezpečení regionu, použijte tuto syntaxi:

    VALUEOF("Zabezpečení regionu"."REGION")

    Další informace najdete v části O proměnných úložiště v dokumentu 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

Prezentace

  • Použijte tuto syntaxi:

    @{název_proměnné}{výchozí_hodnota}

    kde název_proměnné je název proměnné prezentace a výchozí_hodnota (volitelná) je konstantní nebo proměnlivý odkaz označující hodnotu, která se má použít, pokud není zadána proměnná, na kterou odkazuje název_proměnné.

  • Chcete-li převést proměnnou na řetězec, uzavřete celou syntaxi do jednoduchých uvozovek, například:

    '@{user.displayName}'

Poznámka: Pokud znak @ není následován znakem {, je považován za znak @.

Při použití proměnné prezentace, která může mít více hodnot, se syntaxe liší podle typu sloupce.

Pro uvedený typ sloupce použijte v dotazu SQL následující syntaxi, aby se vygenerovaly platné příkazy SQL:

  • Text — (@{název_proměnné}['@']{'výchozí_hodnota'})

  • Číselná hodnota - (@{název_proměnné}{výchozí_hodnota})

  • Datum-čas - (@{název_proměnné}{timestamp 'výchozí_hodnota'})

  • Datum (pouze datum) - (@{název_proměnné}{date 'výchozí_hodnota'})

  • Čas (pouze čas) - (@{název_proměnné}{time 'výchozí_hodnota'})

 
"Trh"."Region"=@{MyFavoriteRegion}{VÝCHODNÍ REGION}

nebo

"Produkty"."P4 Značka"=(@{myTextVar}['@']{BizTech})

nebo

"Produkty"."PO Číslo produktu"=(@{myNumVar}{1000})

nebo

"Pracovník prodeje"."E7 Datum pronajmutí"=(@{myDateTimeVar}{timestamp '2013-05-16 00:00:01'})

nebo

"Čas"."Celkový fiskální čas"=(@{myDateVar}{date '2013-05-16'})

nebo

"Čas"."Čas právě teď"=(@{myTimeVar}{time '00:00:01'})

V případě více hodnot (v uvedených typech dat) při použití SQL:

  • Je-li typem sloupce Text a název_proměnné předává val1, val2 a val3, výsledkem je ('val1', 'val2', 'val3').

nebo

  • Je-li typem sloupce Datum a název_proměnné předává 2013-08-09 a 2013-08-10, výsledkem je (datum '2013-08-09', datum '2013-08-10').

nebo

  • Je-li typem sloupce Datum a čas a název_proměnné předává 2013-08-09 00:00:00 a 2013-08-10 00:00:00, výsledkem je (časová značka '2013-08-09 00:00:00', časová značka '2013-08-10 00:00:00').

Informace o konkrétních oblastech, kde lze odkazovat na proměnné, najdete v části Kde mohu odkazovat na proměnné?.