Używanie zmiennych substytucyjnych

Zmienne substytucyjne są używane w skryptach obliczeń Essbase do składowania wartości, które mogą się zmieniać. Zmiennych substytucyjnych trybu wykonawczego należy używać, gdy różni użytkownicy podają różne wartości dla tego samego skryptu.

Na przykład jeśli różne skrypty obliczeń, formuły, filtry, skrypty raportów i skrypty MDX muszą się odnosić do bieżącego miesiąca, nie byłoby wskazane wyszukiwanie i zastępowanie miesiąca co mniej więcej 30 dni w całej bibliotece artefaktów. Zamiast tego można zdefiniować zmienną CurrMonth, której wartość będzie się odpowiednio zmieniała co miesiąc. Wszystkie artefakty kostki, które się odwołują do tej zmiennej, będą się odnosić do odpowiedniego miesiąca.

Oto przykład prostej zmiennej substytucyjnej, reprezentującej bieżący miesiąc:

Nazwa zmiennej: CurrMonth

Wartość: Sty

Wartości zmiennej substytucyjnej są stosowane dla wszystkich użytkowników, którzy uruchamiają skrypt obliczeń zawierający zmienną. Na przykład, jeśli zmienna &CurrMonth ma wartość Jan (styczeń), to wszystkie skrypty zawierające zmienną &CurrMonth będą wykonywane dla stycznia. Zakres zmiennej substytucyjnej może być:

  • zakresem globalnym (dla wszystkich aplikacji i kostek na serwerze)
  • zakresem aplikacji (dla wszystkich kostek w aplikacji)
  • zakresem kostki (dla jednej kostki)

Aby zdefiniować lub zaktualizować zmienną substytucyjną dla konkretnej kostki, należy:

  1. Na stronie "Aplikacje" otworzyć aplikację, a następnie otworzyć bazę danych (kostkę).
  2. Kliknąć Dostosowanie, a następnie Zmienne.
  3. Aby utworzyć nową zmienną, kliknąć Utwórz, wprowadzić nazwę i wartość zmiennej, a następnie kliknąć Zapisz Ikona "Zapisz" (znacznik) w oknie dialogowym "Zmienne"..
  4. W przypadku edycji wartości istniejącej zmiennej dwukrotnie kliknąć wartość (lub kliknąć Edytuj), wpisać zaktualizowaną wartość i nacisnąć klawisz Enter (lub kliknąć Zapisz).
  1. W interfejsie internetowym Essbase na stronie "Aplikacje" rozwinąć aplikację, tak aby została pokazana kostka, która będzie modyfikowana.
  2. Z menu Czynności, z prawej strony kostki, uruchomić inspektor.
  3. Wybrać kartę Zmienne.
  4. Aby utworzyć nową zmienną, kliknąć Dodaj Ikona "Dodaj", wprowadzić nazwę i wartość zmiennej, a następnie kliknąć Zapisz.
  5. W przypadku edycji wartości istniejącej zmiennej dwukrotnie kliknąć pole Wartość, wpisać zaktualizowaną wartość i nacisnąć klawisz Enter.
  6. Kliknąć Zamknij.

Aby zdefiniować lub zaktualizować zmienną substytucyjną dla konkretnej aplikacji, należy:

  1. Na stronie "Aplikacje" otworzyć aplikację.
  2. Kliknąć Dostosowanie, a następnie Zmienne.
  3. Aby utworzyć nową zmienną, kliknąć Utwórz, wprowadzić nazwę i wartość zmiennej, a następnie kliknąć Zapisz Ikona "Zapisz" (znacznik) w oknie dialogowym "Zmienne"..
  4. W przypadku edycji wartości istniejącej zmiennej dwukrotnie kliknąć wartość (lub kliknąć Edytuj), wpisać zaktualizowaną wartość i nacisnąć klawisz Enter (lub kliknąć Zapisz).
  1. Na stronie "Aplikacje" uruchomić z menu "Czynności" (z prawej strony aplikacji) inspektor.
  2. Wybrać kartę Zmienne.
  3. Aby utworzyć nową zmienną, kliknąć DodajIkona "Dodaj", wprowadzić nazwę i wartość zmiennej, a następnie kliknąć Zapisz.
  4. W przypadku edycji wartości istniejącej zmiennej dwukrotnie kliknąć pole Wartość, wpisać zaktualizowaną wartość i nacisnąć klawisz Enter.
  5. Kliknąć Zamknij.

Aby zdefiniować lub zaktualizować zmienną substytucyjną globalnie, należy:

  1. Na stronie "Aplikacje" wybrać opcję Konsola.
  2. Kliknąć kafelek Zmienne.
  3. Aby utworzyć nową zmienną, kliknąć Utwórz, wprowadzić nazwę i wartość zmiennej, a następnie kliknąć Zapisz Ikona "Zapisz" (znacznik) w oknie dialogowym "Zmienne"..
  4. W przypadku edycji wartości istniejącej zmiennej dwukrotnie kliknąć wartość (lub kliknąć Edytuj), wpisać zaktualizowaną wartość i nacisnąć klawisz Enter (lub kliknąć Zapisz).
  1. W internetowym interfejsie Essbase wybrać opcję Konsola.
  2. Kliknąć kartę Zmienne.
  3. Aby utworzyć nową zmienną, kliknąć Dodaj, wprowadzić nazwę i wartość zmiennej, a następnie kliknąć Zapisz.
  4. W przypadku edycji wartości istniejącej zmiennej dwukrotnie kliknąć pole Wartość, wpisać zaktualizowaną wartość i nacisnąć klawisz Enter.

Po zdefiniowaniu zmiennej substytucyjnej można jej używać w skryptach obliczeń, formułach, filtra, skryptach MDX, regułach ładowania i raportach. Odwołując się do zmiennej, należy poprzedzić ją prefiksem &.

Przykład skryptu obliczeń odwołującego się do zmiennej substytucyjnej:

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

Przykład formuły odwołującej się do zmiennej substytucyjnej:

@ISMBR(&CurrMonth)

Zmienne substytucyjne trybu wykonawczego umożliwiają deklarowanie zmiennych i ich wartości w kontekście czynności wykonawczej, takiej jak wykonywanie skryptu obliczeń, skryptu MaxL czy zapytania MDX. Zmienne substytucyjne trybu wykonawczego mogą mieć przypisywane wartości liczbowe oraz mogą się odwoływać do nazw elementów. Gdy użytkownik nie zmienia wartości wejściowej, można przypisać wartość domyślną. W przypadku skryptów obliczeń wartość zmiennej może być przyjmowana w trybie wykonawczym z elementów wymiaru prezentowanego w tabeli Smart View. Skrypty obliczeń ze zmiennymi, których wartości są ustalane w trybie wykonawczym, muszą być uruchamiane z aplikacji Smart View, ponieważ definicja zmiennej nie istnieje poza kontekstem tabeli.

W skrypcie obliczeń zmienne substytucyjne trybu wykonawczego mogą być definiowane z użyciem par "klucz-wartość":

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

Aby zdefiniować zmienną substytucyjną trybu wykonawczego z wartościami zmieniającymi się dynamicznie w zależności od punktu widzenia (POV), należy przypisać jej definicję do POV, a następnie — używając składni XML — włączyć kontekstowe filtry monitujące Smart View.

Więcej informacji