Používanie substitučných premenných

Substitučné premenné v skriptoch výpočtov Essbase slúžia na ukladanie hodnôt, ktoré sa môžu zmeniť. Keď chcete, aby rôzni používatelia mohli zadávať rôzne hodnoty pre rovnaký skript, použite substitučné premenné runtime.

Ak napríklad chcete, aby rôzne vaše skripty výpočtov, vzorce, filtre, skripty zostáv a skripty MDX odkazovali na aktuálny mesiac, nebolo by praktické každých 30 dní prehľadávať knižnicu artefaktov kociek a meniť mesiac. Namiesto toho môžete definovať substitučnú premennú CurrMonth a meniť jej priradenú hodnotu každý mesiac na príslušný mesiac. Všetky artefakty kocky, ktoré odkazujú na premennú, tak budú odkazovať na príslušný mesiac.

Tu je príklad jednoduchej substitučnej premennej reprezentujúcej aktuálny mesiac:

Názov premennej: CurrMonth

Hodnota: Jan

Hodnoty substitučných premenných sa vzťahujú na všetkých používateľov, ktorí spúšťajú skript výpočtu obsahujúci príslušnú premennú. Ak napríklad premenná CurrMonth má hodnotu Jan, všetky skripty obsahujúce výraz &CurrMonth sa vykonajú pre hodnotu Jan. Rozsah substitučnej premennej môže byť nasledujúci:

  • globálna (pre všetky aplikácie a kocky na serveri),
  • aplikácia (pre všetky kocky v aplikácii),
  • kocka (pre jednu kocku).

Ako definovať alebo aktualizovať substitučnú premennú pre konkrétnu kocku:

  1. Na stránke Aplikácie otvorte aplikáciu a potom otvorte databázu (kocka).
  2. Kliknite na položku Prispôsobenie a potom kliknite na položku Premenné.
  3. Ak chcete vytvoriť novú premennú, kliknite na položku Vytvoriť, zadajte názov a hodnotu premennej a kliknite na tlačidlo UložiťObrázok ikony Uložiť (znaku začiarknutia) v dialógovom okne Premenné..
  4. Ak upravujete hodnotu existujúcej premennej, dvakrát kliknite na hodnotu (alebo kliknite na položku Upraviť), zadajte aktualizovanú hodnotu a stlačte kláves Enter (alebo kliknite na tlačidlo Uložiť).
  1. Vo webovom rozhraní Essbase na stránke Aplikácie rozbaľte aplikáciu, aby sa zobrazila kocka, ktorú chcete modifikovať.
  2. V ponuke Akcie napravo od kocky spustite inšpektora.
  3. Vyberte kartu Premenné.
  4. Ak chcete vytvoriť novú premennú, kliknite na tlačidlo PridaťObrázok ikony Pridať., zadajte názov a hodnotu premennej a kliknite na tlačidlo Uložiť.
  5. Ak upravujete hodnotu existujúcej premennej, dvakrát kliknite na pole Hodnota, zadajte aktualizovanú hodnotu a stlačte kláves Enter.
  6. Kliknite na tlačidlo Zavrieť.

Ako definovať alebo aktualizovať substitučnú premennú pre konkrétnu aplikáciu:

  1. Na stránke Aplikácie otvorte aplikáciu.
  2. Kliknite na položku Prispôsobenie a potom kliknite na položku Premenné.
  3. Ak chcete vytvoriť novú premennú, kliknite na položku Vytvoriť, zadajte názov a hodnotu premennej a kliknite na tlačidlo UložiťObrázok ikony Uložiť (znaku začiarknutia) v dialógovom okne Premenné..
  4. Ak upravujete hodnotu existujúcej premennej, dvakrát kliknite na hodnotu (alebo kliknite na položku Upraviť), zadajte aktualizovanú hodnotu a stlačte kláves Enter (alebo kliknite na tlačidlo Uložiť).
  1. Na stránke Aplikácie v ponuke Akcie napravo od aplikácie spustite inšpektora.
  2. Vyberte kartu Premenné.
  3. Ak chcete vytvoriť novú premennú, kliknite na tlačidlo PridaťObrázok ikony Pridať., zadajte názov a hodnotu premennej a kliknite na tlačidlo Uložiť.
  4. Ak upravujete hodnotu existujúcej premennej, dvakrát kliknite na pole Hodnota, zadajte aktualizovanú hodnotu a stlačte kláves Enter.
  5. Kliknite na tlačidlo Zavrieť.

Ako definovať alebo aktualizovať substitučnú premennú globálne:

  1. Na stránke Aplikácie kliknite na položku Konzola.
  2. Kliknite na dlaždicu Premenné.
  3. Ak chcete vytvoriť novú premennú, kliknite na položku Vytvoriť, zadajte názov a hodnotu premennej a kliknite na tlačidlo UložiťObrázok ikony Uložiť (znaku začiarknutia) v dialógovom okne Premenné..
  4. Ak upravujete hodnotu existujúcej premennej, dvakrát kliknite na hodnotu (alebo kliknite na položku Upraviť), zadajte aktualizovanú hodnotu a stlačte kláves Enter (alebo kliknite na tlačidlo Uložiť).
  1. Vo webovom rozhraní Essbase kliknite na položku Konzola.
  2. Kliknite na kartu Premenné.
  3. Ak chcete vytvoriť novú premennú, kliknite na tlačidlo Pridať, zadajte názov a hodnotu premennej a kliknite na tlačidlo Uložiť.
  4. Ak upravujete hodnotu existujúcej premennej, dvakrát kliknite na pole Hodnota, zadajte aktualizovanú hodnotu a stlačte kláves Enter.

Keď ste definovali substitučnú premennú, môžete ju použiť v skriptoch výpočtov, vzorcoch, filtroch, skriptoch MDX, pravidlách zavedenia a zostavách. Ak chcete vytvoriť odkaz na premennú, pridajte k nej prefix vo forme symbolu &.

Príklad skriptu výpočtu, ktorý odkazuje na substitučnú premennú:

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

Príklad vzorca, ktorý odkazuje na substitučnú premennú:

@ISMBR(&CurrMonth)

Substitučné premenné runtime umožňujú deklarovať premenné a ich hodnoty v kontexte akcie v čase runtime, napríklad skript výpočtu, skript MaxL alebo dopyt MDX. Substitučným premenným runtime možno priradiť numerické hodnoty alebo môžu odkazovať na názvy členov. Predvolenú hodnotu možno priradiť v prípade, že používateľ nezmení vstupnú hodnotu. Takisto aj v prípade skriptov výpočtov možno hodnotu premennej vyplniť v čase runtime pre členy dimenzie zobrazené na mriežke aplikácie Smart View. V prípade skriptov výpočtu s hodnotami premenných, ktoré sa vypĺňajú v čase runtime, je potrebné spustiť skript výpočtu z aplikácie Smart View, pretože premenná nemá žiadnu definíciu mimo kontextu mriežky.

Substitučné premenné runtime možno definovať v skripte výpočtu pomocou párov kľúča a hodnoty.

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

Na definovanie substitučných premenných runtime s hodnotami, ktoré sa dynamicky menia podľa uhla pohľadu, je takisto možné priradiť definíciu uhlu pohľadu a použiť syntax XML na aktivovanie kontextových výziev aplikácie Smart View.

Ďalšie informácie nájdete v častiach