Использование подстановочных переменных

Подстановочные переменные используются в сценариях расчета Essbase для хранения значений, которые могут изменяться. Динамические подстановочные переменные используются, когда необходимо, чтобы разные пользователи указывали разные значения для одного сценария.

Например, если в разнообразных сценариях расчета, формулах, фильтрах, сценариях отчетов и сценариях многоразмерных выражений необходимо сослаться на текущий месяц, не хотелось бы примерно каждые 30 дней искать и заменять месяц по всей своей библиотеке артефактов куба. Вместо этого можно определить подстановочную переменную CurrMonth и каждый месяц изменять назначенное ей значение на соответствующий месяц. Все артефакты куба, которые ссылаются на данную переменную будут ссылаться на соответствующий месяц.

Ниже приведен пример простой подстановочной переменной для представления текущего месяца:

Имя переменной: CurrMonth

Значение: Jan

Подстановочная переменная применяется ко всем пользователям, запускающим сценарий расчета, содержащий эту переменную. Например, если переменная CurrMonth имеет значение Jan, то все сценарии, содержащие &CurrMonth, будут выполняться для значения Jan. У подстановочной переменной могут быть разные области действия:

  • глобальная (для всех приложений и кубов на сервере)
  • приложение (для всех кубов в приложении)
  • куб (для одного куба)

Чтобы определить или обновить подстановочную переменную для конкретного куба, выполните указанные ниже действия.

  1. На странице "Приложения" откройте приложение, а затем откройте базу данных (куб).
  2. Нажмите Настройка, а затем нажмите Переменные.
  3. Чтобы создать новую переменную, нажмите Создать, введите ее имя и значение и нажмите СохранитьИзображение значка "Сохранить" (галочка) в диалоговом окне "Переменные"..
  4. Чтобы изменить значение существующей переменной, дважды нажмите на значение или нажмите Редактировать, введите новое значение и нажмите клавишу Enter или кнопку Сохранить.
  1. В веб-интерфейсе Essbase на странице Приложения разверните приложение, чтобы отобразился куб, который необходимо изменить.
  2. Из меню Действия справа от куба запустите инспектор.
  3. Выберите вкладку Переменные.
  4. Чтобы создать новую переменную, нажмите ДобавитьИзображение значка "Добавить", введите ее имя и значение и нажмите Сохранить.
  5. Чтобы изменить значение существующей переменной, дважды нажмите на поле Значение, введите новое значение и нажмите клавишу Enter.
  6. Нажмите Закрыть.

Чтобы определить или обновить подстановочную переменную для конкретного приложения, выполните указанные ниже действия.

  1. На странице "Приложения" откройте приложение.
  2. Нажмите Настройка, а затем нажмите Переменные.
  3. Чтобы создать новую переменную, нажмите Создать, введите ее имя и значение и нажмите СохранитьИзображение значка "Сохранить" (галочка) в диалоговом окне "Переменные"..
  4. Чтобы изменить значение существующей переменной, дважды нажмите на значение или нажмите Редактировать, введите новое значение и нажмите клавишу Enter или кнопку Сохранить.
  1. На странице "Приложения" из меню "Действия" справа от имени приложения запустите инспектор.
  2. Выберите вкладку Переменные.
  3. Чтобы создать новую переменную, нажмите ДобавитьИзображение значка "Добавить", введите ее имя и значение и нажмите Сохранить.
  4. Чтобы изменить значение существующей переменной, дважды нажмите на поле Значение, введите новое значение и нажмите клавишу Enter.
  5. Нажмите Закрыть.

Чтобы определить или обновить подстановочную переменную на глобальном уровне, выполните указанные ниже действия.

  1. На странице Приложения нажмите Консоль.
  2. Нажмите на плитку Переменные.
  3. Чтобы создать новую переменную, нажмите Создать, введите ее имя и значение и нажмите СохранитьИзображение значка "Сохранить" (галочка) в диалоговом окне "Переменные"..
  4. Чтобы изменить значение существующей переменной, дважды нажмите на значение или нажмите Редактировать, введите новое значение и нажмите клавишу Enter или кнопку Сохранить.
  1. В веб-интерфейсе Essbase нажмите Консоль.
  2. Выберите вкладку Переменные.
  3. Чтобы создать новую переменную, нажмите Добавить, введите ее имя и значение и нажмите Сохранить.
  4. Чтобы изменить значение существующей переменной, дважды нажмите на поле Значение, введите новое значение и нажмите клавишу Enter.

Если подстановочная переменная определена, ее можно использовать в сценариях расчета, формулах, фильтрах, сценариях MDX, правилах загрузки и отчетах. Чтобы сослаться на переменную, к ее имени необходимо добавить символ & в качестве префикса.

Пример сценария расчета, который ссылается на подстановочную переменную:

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

Пример формулы, которая ссылается на подстановочную переменную:

@ISMBR(&CurrMonth)

Подстановочные переменные среды выполнения позволяют объявлять переменные и их значения в контексте действия среды выполнения, такого как сценарий расчета, сценарий MaxL или запрос MDX. Подстановочные переменные среды выполнения могут иметь числовые значения или ссылаться на имена элементов. На случай, если пользователи не изменят входное значение, можно присвоить значение по умолчанию. Кроме того, в сценариях расчета переменная может получать значение во время выполнения от элементов измерения, представленного в сетке Smart View. Сценарии расчета со значениями переменных, которые присваиваются во время выполнения, необходимо запускать из Smart View, поскольку такие переменные не определены вне контекста сетки.

Подстановочные переменные среды выполнения можно определить в таком сценарии расчета с помощью пар "ключ-значение":

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

Или, чтобы определить подстановочные переменные среды выполнения со значениями, которые динамически изменяются в зависимости от POV, назначьте POV данное определение и с помощью синтаксиса XML включите контекстные подсказки Smart View.

Дополнительные сведения см. в разделах