Používání substitučních proměnných

K uložení hodnot, které se mohou změnit, používejte ve výpočetních skriptech Essbase substituční proměnné. Substituční proměnné běhového prostředí použijte, pokud potřebujete, aby různí uživatelé zadali různé hodnoty pro stejný skript.

Například pokud různé výpočetní skripty, vzorce, filtry, skripty sestavy a skripty MDX potřebují odkazovat na aktuální měsíc, jistě nebudete chtít přibližně každých 30 dnů v celé knihovně artefaktů krychle hledat a nahrazovat měsíc. Místo toho můžete definovat substituční proměnnou nazvanou CurrMonth a každý měsíc změnit její přiřazenou hodnotu na příslušný měsíc. Všechny artefakty krychle, které na tuto proměnnou odkazují, budou pak odkazovat na správný měsíc.

Zde je ukázka jednoduché substituční proměnné, která představuje aktuální měsíc:

Název proměnné: CurrMonth

Hodnota: Led

Hodnoty substitučních proměnných jsou k dispozici pro všechny uživatele, kteří spouštějí skript pro výpočet obsahující proměnnou. Pokud má například proměnná CurrMonth hodnotu Jan, spustí se pro hodnotu Jan všechny skripty obsahující &CurrMonth. Rozsah substituční proměnné může být následující:

  • globální (pro všechny aplikace a krychle na serveru)
  • aplikace (pro všechny krychle v aplikaci)
  • krychle (pro jednu krychli)

Chcete-li definovat nebo aktualizovat substituční proměnnou pro konkrétní krychli,

  1. Na stránce Aplikace otevřete aplikaci a poté otevřete databázi (krychli).
  2. Klikněte na položku Přizpůsobení a poté na volbu Proměnné.
  3. Chcete-li vytvořit novou proměnnou, klikněte na volbu Vytvořit, zadejte název a hodnotu proměnné a klikněte na tlačítko UložitObrázek ikony Uložit (zatržítko) v dialogovém okně Proměnné..
  4. Pokud upravujete hodnotu již vytvořené proměnné, dvakrát klikněte na hodnotu (nebo klikněte na tlačítko Upravit), zadejte aktualizovanou hodnotu a stiskněte klávesu Enter (nebo klikněte na tlačítko Uložit).
  1. Ve webovém rozhraní Essbase rozbalte na stránce Aplikace aplikaci obsahující krychli, kterou chcete upravit.
  2. Z nabídky Akce napravo od krychle spusťte inspektor.
  3. Vyberte kartu Proměnné.
  4. Chcete-li vytvořit novou proměnnou, klikněte na volbu PřidatObrázek ikony Přidat., zadejte název a hodnotu proměnné a klikněte na tlačítko Uložit.
  5. Pokud upravujete hodnotu již vytvořené proměnné, dvakrát klikněte na pole Hodnota, zadejte aktualizovanou hodnotu a stiskněte klávesu Enter.
  6. Klikněte na tlačítko Zavřít.

Chcete-li definovat nebo aktualizovat substituční proměnnou pro konkrétní aplikaci,

  1. Na stránce Aplikace otevřete aplikaci.
  2. Klikněte na položku Přizpůsobení a poté na volbu Proměnné.
  3. Chcete-li vytvořit novou proměnnou, klikněte na volbu Vytvořit, zadejte název a hodnotu proměnné a klikněte na tlačítko UložitObrázek ikony Uložit (zatržítko) v dialogovém okně Proměnné..
  4. Pokud upravujete hodnotu již vytvořené proměnné, dvakrát klikněte na hodnotu (nebo klikněte na tlačítko Upravit), zadejte aktualizovanou hodnotu a stiskněte klávesu Enter (nebo klikněte na tlačítko Uložit).
  1. z nabídky Akce napravo od názvu aplikace na stránce Aplikace spusťte inspektor.
  2. Vyberte kartu Proměnné.
  3. Chcete-li vytvořit novou proměnnou, klikněte na volbu PřidatObrázek ikony Přidat., zadejte název a hodnotu proměnné a klikněte na tlačítko Uložit.
  4. Pokud upravujete hodnotu již vytvořené proměnné, dvakrát klikněte na pole Hodnota, zadejte aktualizovanou hodnotu a stiskněte klávesu Enter.
  5. Klikněte na tlačítko Zavřít.

Chcete-li globálně definovat nebo aktualizovat substituční proměnnou,

  1. Na stránce Aplikace klikněte na volbu Konzola.
  2. Klikněte na dlaždici Proměnné.
  3. Chcete-li vytvořit novou proměnnou, klikněte na volbu Vytvořit, zadejte název a hodnotu proměnné a klikněte na tlačítko UložitObrázek ikony Uložit (zatržítko) v dialogovém okně Proměnné..
  4. Pokud upravujete hodnotu již vytvořené proměnné, dvakrát klikněte na hodnotu (nebo klikněte na tlačítko Upravit), zadejte aktualizovanou hodnotu a stiskněte klávesu Enter (nebo klikněte na tlačítko Uložit).
  1. Ve webovém rozhraní aplikace Essbase klikněte na volbu Konzola.
  2. Klikněte na kartu Proměnné.
  3. Chcete-li vytvořit novou proměnnou, klikněte na volbu Přidat, zadejte název a hodnotu proměnné a klikněte na tlačítko Uložit.
  4. Pokud upravujete hodnotu již vytvořené proměnné, dvakrát klikněte na pole Hodnota, zadejte aktualizovanou hodnotu a stiskněte klávesu Enter.

Jakmile definujete substituční proměnnou, můžete ji použít ve výpočetních skriptech, vzorcích, filtrech, skriptech MDX, pravidlech načítání a sestavách. Chcete-li odkazovat na proměnnou, přidejte k ní předponu se symbolem &.

Zde je příklad výpočetního skriptu, který odkazuje na substituční proměnnou:

FIX(&CurrMonth)
   CALC DIM (Measures, Product);
ENDFIX

Zde je příklad vzorce, který odkazuje na substituční proměnnou:

@ISMBR(&CurrMonth)

Substituční proměnné běhového prostředí umožňují deklarovat proměnné a jejich hodnoty v kontextu akce běhového prostředí, například skriptu výpočtu, skriptu MaxL nebo dotazu MDX. Substitučním proměnným běhového prostředí lze přiřadit číselné hodnoty nebo odkaz na názvy prvků. Výchozí hodnota může být přiřazena v případě, kdy uživatel nemění vstupní hodnotu. Pro výpočetní skripty může hodnota proměnné navíc vyplnit běhové prostředí z prvků nebo dimenzí nacházejících se v mřížce Smart View. U výpočetních skriptů s hodnotami proměnných, které se vyplňují během běhu, je nutné spustit výpočetní skript z funkce Smart View, protože proměnná nemá mimo kontext mřížky žádnou definici.

Substituční proměnné běhového prostředí mohou být definovány ve výpočetní skriptu pomocí párů klíč–hodnota:

SET RUNTIMESUBVARS
{
   myMarket = "New York";
   salesNum = 100;
   pointD = "Actual"->"Final";
}

Případně lze substituční proměnné běhového prostředí s hodnotami, které se dynamicky mění v závislosti na bod náhledu, přiřadit definici pro bod náhledu a použít syntax XML k aktivaci kontextuální nápovědy funkce Smart View.

Další informace naleznete v následující části