Utilizarea variabilelor de înlocuire

Utilizaţi variabile de substituţie în script-urile de calcul Essbase pentru a stoca valori care se pot modifica. Utilizaţi variabile de înlocuire la runtime când este nevoie ca diferiţi utilizatori să specifice diferite valori pt. acelaşi script.

De exemplu, dacă diverse script-uri de calcul, formule, filtre, script-uri pt. rapoarte şi MDX trebuie să facă referire la luna curentă, probabil că nu doriţi să căutaţi şi să înlocuiţi luna la fiecare 30 de zile, în toată biblioteca de artefacte din cub. Puteţi în schimb să definiţi o variabilă de substituţie numită CurrMonth (luna curentă) şi să-i schimbaţi în fiecare lună valoarea. Toate artefactele cubului care fac referire la această variabilă vor face referire la luna corectă.

Iată un exemplu de variabilă de substituţie simplă care să reprezinte luna curentă:

Numele variabilei: CurrMonth

Valoare: Jan

Valorile variabilelor de înlocuire se aplică tuturor utilizatorilor care rulează un script de calcul ce conţine variabila. De exemplu, dacă CurrMonth are valoarea Jan, toate script-urile ce conţin &CurrMonth se vor executa pt. Jan. Domeniul unei variabile de înlocuire poate fi:

  • global (pentru toate aplicaţiile şi cuburile de pe server)
  • aplicaţie (pt. toate cuburile din aplicaţie)
  • cub (pt. un singur cub)

Pentru a defini sau actualiza o variabilă de substituţie pentru un anumit cub,

  1. Pe pagina Aplicaţii, deschideţi aplicaţia, apoi deschideţi baza de date (cubul).
  2. Faceţi clic pe Personalizare şi apoi pe Variabile.
  3. Pentru a crea o variabilă nouă, faceţi clic pe Creare, introduceţi numele şi valoarea variabilei şi faceţi clic pe SalvareImagine cu pictograma Salvare (bifă) în caseta de dialog Variabile..
  4. Dacă editaţi valoarea unei variabile existente, faceţi dublu clic pe valoare (sau faceţi clic pe Editare), tastaţi valoarea actualizată şi apăsaţi pe Enter (sau faceţi clic pe Salvare).
  1. În interfaţa web Essbase, pe pagina Aplicaţii, extindeţi aplicaţia pentru a afişa cubul pe care doriţi să-l modificaţi.
  2. Din meniul Acţiuni, din dreapta numelui cubului, porniţi inspectorul.
  3. Selectaţi fila Variabile.
  4. Pentru a crea o variabilă nouă, faceţi clic pe AdăugareImaginea pictogramei Adăugare., introduceţi numele şi valoarea variabilei şi faceţi clic pe Salvare.
  5. Dacă editaţi valoarea unei variabile existente, faceţi dublu clic câmpul Valoare, tastaţi valoarea actualizată şi apăsaţi pe Enter.
  6. Faceţi clic pe Închidere.

Pentru a defini sau actualiza o variabilă de substituţie pentru o anumită aplicaţie,

  1. Pe pagina Aplicaţii, deschideţi aplicaţia.
  2. Faceţi clic pe Personalizare şi apoi pe Variabile.
  3. Pentru a crea o variabilă nouă, faceţi clic pe Creare, introduceţi numele şi valoarea variabilei şi faceţi clic pe SalvareImagine cu pictograma Salvare (bifă) în caseta de dialog Variabile..
  4. Dacă editaţi valoarea unei variabile existente, faceţi dublu clic pe valoare (sau faceţi clic pe Editare), tastaţi valoarea actualizată şi apăsaţi pe Enter (sau faceţi clic pe Salvare).
  1. Din pagina Aplicaţii, din meniul Acţiuni din dreapta aplicaţiei, lansaţi Inspectorul.
  2. Selectaţi fila Variabile.
  3. Pentru a crea o variabilă nouă, faceţi clic pe AdăugareImaginea pictogramei Adăugare., introduceţi numele şi valoarea variabilei şi faceţi clic pe Salvare.
  4. Dacă editaţi valoarea unei variabile existente, faceţi dublu clic câmpul Valoare, tastaţi valoarea actualizată şi apăsaţi pe Enter.
  5. Faceţi clic pe Închidere.

Pentru a defini sau actualiza o variabilă de substituţie la nivel global,

  1. În pagina Aplicaţii, faceţi clic pe Consolă.
  2. Faceţi clic pe vinieta Variabile.
  3. Pentru a crea o variabilă nouă, faceţi clic pe Creare, introduceţi numele şi valoarea variabilei şi faceţi clic pe SalvareImagine cu pictograma Salvare (bifă) în caseta de dialog Variabile..
  4. Dacă editaţi valoarea unei variabile existente, faceţi dublu clic pe valoare (sau faceţi clic pe Editare), tastaţi valoarea actualizată şi apăsaţi pe Enter (sau faceţi clic pe Salvare).
  1. În interfaţa web Essbase, faceţi clic pe Consolă.
  2. Faceţi clic pe fila Variabile.
  3. Pentru a crea o variabilă nouă, faceţi clic pe Adăugare, introduceţi numele şi valoarea variabilei şi faceţi clic pe Salvare.
  4. Dacă editaţi valoarea unei variabile existente, faceţi dublu clic câmpul Valoare, tastaţi valoarea actualizată şi apăsaţi pe Enter.

După ce a fost definită variabila de înlocuire, o puteţi utiliza în script-uri de calcul, formule, filtre, script-uri MDX, reguli de încărcare şi rapoarte. Pentru a face referire la variabilă, adăugaţi prefixul &.

Iată un exemplu de script de calcul ce face referire la o variabilă de înlocuire:

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

Iată un exemplu de formulă ce face referire la o variabilă de înlocuire:

@ISMBR(&CurrMonth)

Variabilele de înlocuire la runtime vă permit să declaraţi variabilele şi valorile lor în contextul unei acţiuni la runtime, cum ar fi un script de calcul, un script MaxL sau o interogare MDX. Variabilele de substituţie la runtime pot avea asignate valori numerice sau pot face referire la nume de membri. Se poate asigna o valoare prestabilită dacă niciun utilizator nu va schimba valoarea de intrare. De asemenea, pt. script-urile de calcul, valoarea variabilei poate fi completată la runtime din membrii unei dimensiuni prezentate într-o grilă Smart View. În cazul script-urilor de calcul unde valorile variabilei sunt completate automat la runtime, trebuie să lansaţi scriptul din Smart View, deoarece variabila nu are nicio definiţie în afara contextului grilei.

Variabilele de substituţie la runtime pot fi definite în scriptul de calcul cu ajutorul perechilor de chei şi valori.

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

Sau pt. a defini variabile substituite la runtime cu valori care se schimbă dinamic în funcţie de perspectivă, asignaţi definiţia la perspectivă şi utilizaţi sintaxa XML pt. a activa prompturile contextuale din Smart View.

Pentru informaţii suplimentare, consultaţi