Syntaxe odkazování na proměnné

V analýzách a panelech je možné odkazovat na proměnné.

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 popisuje následující tabulka.

Typ 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.

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

Sémantický model (ú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é, 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

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

kde:

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

(nepovinné) 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 se nepoužije na výchozí hodnotu.)

(nepovinné) 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.)

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

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

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.

Konvence pojmenování globálních proměnných musí splňovat specifikace skriptovacího jazyka ECMA pro jazyk 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í na proměnné ve výrazech naleznete v následujících tématech:

Proměnné relace

Následující pokyny můžete použít pro odkazování na proměnné relací ve výrazech.

  • 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.
  • Uveďte NQ_SESSION ve dvojitých uvozovkách.
  • Část NQ_SESSION i název proměnné relace uveďte v závorkách.

Například:

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

Proměnné prezentací

Následující pokyny můžete použít pro odkazování na proměnnou prezentace ve výrazech.

Pro odkazování proměnné prezentace použijte tuto syntax:

@{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 nebo přidat více proměnných, uzavřete celou proměnnou do jednoduchých uvozovek, například::

'@{user.displayName}'

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'})

Například:

'@{user.displayName}'

Proměnné sémantického modelu (úložiště)

Následující pokyny můžete použít pro odkazování na proměnné sémantického modelu (úložiště) ve výrazech.

  • Zahrnuje proměnnou jako argument funkce VALUEOF.
  • Název proměnné uveďte ve dvojitých uvozovkách.
  • Na proměnnou statického sémantického modelu (úložiště) odkazujte podle názvu.
  • Na proměnnou dynamického sémantického modelu (úložiště) odkazujte podle plně kvalifikovaného názvu.

Například:

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