Основные сведения о сценариях

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

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

Если куб поддерживает сценарии, в нем есть скрытое измерение, которое называется песочницей. Измерение песочницы плоское. Оно содержит один базовый элемент и до 1000 дополнительных элементов, которые называются элементами песочницы. Все элементы измерения песочницы представлены на уровне-0. Элементам песочницы присваиваются имена sb0, sb1 и т. д. Каждая песочница представляет отдельную рабочую область, в то время как базовый элемент имеет данные, в настоящее время содержащиеся в кубе. Сценарий связан только с одним элементом песочницы

Sandbox
        Base
        sb0
        sb1
        sb2

Базовые данные – это отправная точка перед моделированием возможных изменений в песочнице. Данные песочницы (также известные как данные сценария) фиксируются только после их применения владельцем сценария, и при этом перезаписываются базовые данные.

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

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

Изменения в песочнице не фиксируются в базе, если пользователь не применил их явно (как правило, после утверждения). См. раздел "Общие сведения о ролях пользователей и процедуре сценария".

После завершения работы с песочницей можно отправить ее на утверждение, пропустить эту процедуру и зафиксировать обновленные значения в базе или отклонить и отменить изменения.

Для управления с помощью сценариев необходимо включить гибридный режим. Для запросов он включен по умолчанию. Не отключайте его. Для расчетов также необходимо включить конфигурацию приложения HYBRIDBSOINCALCSCRIPT. См. HYBRIDBSOINCALCSCRIPT (или используйте команду расчета SET HYBRIDBSOINCALCSCRIPT для управления на основе расчетов).

Параметры безопасности и фильтры применяются к измерению песочницы.

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

Просмотр данных сценария и работа с ними

В Smart View есть две точки входа для просмотра и работы с данными сценария.

Можно запустить в Smart View сценарий из веб-интерфейса Essbase или использовать частное подключение Smart View и работать с данными сценария таким образом.

Для анализа данных в сценарии необходимо иметь все указанные ниже разрешения.

Быть пользователем, назначенным приложению.
Иметь минимальное разрешение на доступ к базе данных для приложения (и иметь фильтр записи, если требуется изменить данные в песочнице).
Быть участником сценария (созданного пользователем с более высоким уровнем прав).

Просмотр и работа с данными сценария из веб-интерфейса Essbase

Веб-интерфейс позволяет запускать Smart View из сценария.

Поскольку при этом осуществляется вход из сценария, Smart View позволяет работать только в элементе песочницы, который связан с этим сценарием. Это скрытый элемент песочницы. Не отображается в сетке Smart View.

В Essbase нажмите Сценарии.
Нажмите на значок Excel рядом со сценарием, который требуется просмотреть.
Откройте файл.
Запускается приложение Excel с подключением к сценарию Smart View.

При этом на листе отображается фрагмент данных для этого конкретного сценария. Запрос данных возможен только в этом сценарии. Если у вас есть минимальное разрешение на обновление базы данных в приложении, вы можете отправить данные в сценарий. (При отправке данных в сценарий данные передаются одному участнику песочницы).

Сценарий можно запустить в Smart View из веб-интерфейса только в Windows с помощью браузеров Firefox, Internet Explorer или Chrome.

Просмотр и работа с данными сценария из частного подключения Smart View

Можно открыть Excel и создать частное подключение к кубу, не открывая веб-интерфейс.

При этом на листе отображается измерение песочницы, и вы можете отправлять данные любому доступному вам элементу песочницы. Это полезно, если вы участвуете в нескольких сценариях, однако вы должны точно знать, в каком элементе песочницы вам нужно работать.

Чтобы узнать, какой элемент песочницы связан со сценарием, перейдите в веб-интерфейс, нажмите на Сценарии, нажмите на название сценария и просмотрите вкладку Общие сведения.

Откройте Excel.
Создайте частное подключение к кубу с поддержкой сценариев.
Проведите специализированный анализ.
Разверните структуру измерения песочницы, чтобы посмотреть элементы.

Примеры

Это сетка Smart View с базовым элементом и элементом песочницы. Значения песочницы не обновлены, поэтому они соответствуют значениям базового элемента. Эти значения хранятся только в базовом элементе, а не в элементах песочницы:

Изображение сетки Smart View с базовым элементом и одним элементом песочницы

Измененное значение песочницы ниже, 500, хранится в элементе песочницы. Оставшееся значение песочницы, 271, не обновлено и сохранено только в базовом элементе.

Изображение сетки Smart View с базовым элементом и элементом песочницы. Элемент песочницы содержит измененное значение

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

Изображение сетки Smart View с несколькими элементами песочницы.

Общие сведения о расчетах с помощью сценариев

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

Исключение из этого правила — измерение песочницы. Если элементы измерения песочницы не включены в инструкцию FIX для вычисления, по умолчанию вычисляется только базовый элемент измерения песочницы. Для расчета небазовых элементов измерения песочницы включите их в инструкцию FIX (дополнительно можно включить базовый элемент).

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

Это поведение отличается от вычислений для измерений, не относящихся к песочнице, исключенных из исправления. Если вы исключите измерение из инструкции исправления, Essbase рассчитывает все элементы из неявного измерения. Измерения песочницы рассчитываются по-другому, так как обычно требуется вычислить базовые или конкретные песочницы в заданный момент времени. Essbase вычисляет значения базового элемента, а не рабочие значения песочницы. Исключение:

Когда вычисление фиксируется на определенных элементах песочницы.
Когда вычисление выполняется из листа, запущенного из сценария в веб-интерфейсе (это называется листом, запущенным из сценария). См. раздел "Просмотр и работа с данными сценария из веб-интерфейса Essbase".
Если значение ячейки песочницы выбрано на листе Smart View с частным подключением и запущен сценарий расчета.

Если выполнить сценарий расчета из запущенного из сценария рабочего листа, вычисление выполняется в песочнице, связанной со сценарием, если в сценарии явно не упомянута песочница.

Если лист открыт с помощью частного подключения Smart View и на нем отображаются значения песочницы и базы, при выделении любой ячейки данных из песочницы и запуске сценария расчета без явного исправления песочницы, песочница будет рассчитана неявным образом, а Smart View покажет, что песочница была рассчитана. Если выделить ячейку из базового элемента (или не выделить ячейку), то при запуске сценария расчета база будет рассчитана, и Smart View покажет, что база была рассчитана.

Можно вычислить элементы песочницы с помощью существующих сценариев MAXL, используя имя резервной переменной подстановки времени выполнения: ess_sandbox_mbr.

Эта инструкция может быть реализована (для песочницы) в любом сценарии MAXL без создания переменной подстановки на сервере или в приложении.

execute calculation appname.dbname.calcname with runtimesubvars ‘ess_sandbox_mbr=sb0;’;

О загрузке данных в кубы с поддержкой сценариев

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

Если вы не использовали экспорт столбцов, то у вас не будет изменений в элементах структуры, которые могли бы сделать вашу загрузку данных недействительной. Если вы использовали экспорт столбца, но структура изменилась, для загрузки данных может потребоваться файл .rul.

Об экспорте данных из кубов с поддержкой сценариев

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

При экспорте данных из кубов с поддержкой сценариев необходимо учитывать указанные ниже факторы.

Если страница Задания веб-интерфейса используется для экспорта данных из куба с поддержкой сценария, результирующий файл данных содержит все три элемента из измерения CellProperties (EssValue, EssStatus и EssTID). Не удаляйте ни один из этих столбцов.
Файл данных из экспорта включает данные, физически хранящиеся в кубе, в зависимости от сделанного выбора: данные нулевого уровня, все данные или входные данные.
Если значения были изменены в песочницах, то значения песочницы будут включены в экспорт.
Для загрузки экспортированных данных в песочницы значения для всех трех элементов CellProperties (EssValue, EssStatus и EssTID) должны находиться в файле данных.

О прозрачных и реплицированных разделах в кубах с поддержкой сценариев

Прозрачные и реплицированные разделы соединяют срезы из двух кубов Essbase. Это происходит, если ни один из кубов не поддерживает сценарии, а также если один или оба куба поддерживают сценарии.

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

Если источник прозрачного раздела поддерживает сценарии, целевые запросы всегда будут извлекать данные из исходного базового элемента песочницы.
Обратная запись между исходными и целевыми кубами с поддержкой сценариев разрешена только между базовыми элементами в кубах, от базы целевого куба до базы исходного куба.
Пример: обратная запись в источник, который обычно включен из прозрачных целевых кубов раздела, отключена для элементов песочницы, не являющихся базовыми, в целевых кубах с поддержкой сценариев. Это нарушение разрешений, позволяющее удаленному пользователю песочницы выполнять запись непосредственно в базу исходного куба.
Для реплицированных разделов репликация возможна только между базой исходного куба и базой целевого куба.

См. раздел "Общие сведения о прозрачных и реплицированных секциях".

О XREF/XWRITE в кубах с поддержкой сценариев

В кубах с поддержкой сценариев можно использовать XREF и XWRITE для ссылки или записи данных в другом кубе.

XREF запрашивает удаленный куб из локального куба (куб, содержащий инструкцию XREF). Если удаленный куб включен в сценарии, XREF извлекает только базовые данные из удаленного куба.

XWRITE обновляет удаленный куб из локального куба (куб, содержащий инструкцию XWRITE). Поскольку XWRITE записывает данные в удаленный куб, область действия инструкции XWRITE имеет значение.

Для различных комбинаций кубов с поддержкой сценариев и без поддержки сценариев XWRITE ведет себя следующим образом:

Если локальный куб с поддержкой сценария ссылается на удаленный куб, не поддерживающий сценарий,

исправление на базовом элементе локального куба с помощью XWRITE для удаленного куба записывает локальную базу куба в удаленный куб.
Отсутствие исправлений для любого элемента песочницы в локальном кубе с XWRITE в удаленный куб записывает локальную базу куба в удаленный куб. Если элемент песочницы не включен в исправление, база включается автоматически.
Исправление песочницы в локальном кубе с XWRITE в удаленном кубе возвращает ошибку. Запись из элемента песочницы, не являющегося базовым элементом, в удаленный куб не поддерживается.

Если локальный куб с поддержкой сценария ссылается на удаленный куб с поддержкой сценария,

исправление на базовом элементе локального куба с помощью XWRITE для удаленного куба записывает локальную базу куба в базу удаленного куба.
Отсутствие исправлений для любого элемента песочницы в локальном кубе с XWRITE в удаленный куб записывает локальную базу куба в базу удаленного куба. Если не включить элемент песочницы, база включается автоматически.
Исправление песочницы в локальном кубе с XWRITE в удаленном кубе возвращает ошибку. Запись из элемента песочницы, не являющегося базовым элементом, в удаленный куб не поддерживается.

Если локальный куб, не поддерживающий сценарий, ссылается на удаленный куб с поддержкой сценария, XWRITE всегда обновляет удаленный элемент базы куба.

См. раздел "Общие сведения о @XREF/@XWRITE".

О журнале аудита в кубах с поддержкой сценариев

В журнале аудита данных отслеживаются обновления, внесенные в данные в кубе. Для работы с журналом аудита в кубах с поддержкой сценариев необходимо понимать, что определяет "старые" и "новые" значения данных, а также две разные точки входа для работы с данными "песочницы" в Smart View.

В этом разделе предполагается, что читатели знакомы с различными точками входа для просмотра данных сценария. См. разделы:

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

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

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

При обновлении значений в песочнице эти значения сохраняются в песочнице (не в базе). В целях ведения журнала аудита эти значения считаются "новыми".

Если позднее обновить эти "новые" значения, журнал аудита будет отслеживать последние изменения. Предыдущие значения будут считаться "старыми", а обновленные значения "новыми".

В итоге,

Старые значения — это базовые значения, отраженные в новой песочнице.
Изначально, новые значения — это обновленные сохраненные значения в песочнице.
Впоследствии обновленные значения будут новыми, а замененные значения старыми.

Есть две возможные точки входа для работы с данными сценария в Smart View:

где вы открываете Excel и создаете частное подключение к кубу, не открывая веб-интерфейс Essbase;
где вы запускаете Smart View из сценария в веб-интерфейсе.

Если открыть Excel и установить частное соединение с кубом, журнал аудита работает так же, как и любой другой набор данных.

Если запустить Smart View из сценария в веб-интерфейсе Essbase, журнал аудита работает по-другому.

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

Об ограничениях сценариев

Эти ограничения применяются к сценариям и измерениям песочницы.

В кубах агрегатного хранения сценарии не поддерживаются.
Команда расчета DATAEXPORT не поддерживается для элементов песочницы. Она поддерживается только для базового элемента.
При подключении к сценарию из запущенного из сценария рабочего листа, запрос, вставка и экспорт многоразмерных выражений будут работать с базовым элементом, а не с элементом песочницы для этого сценария.
Подстановочные переменные среды выполнения с параметром svLaunch не поддерживаются при запуске сценария в Smart View с помощью веб-интерфейса Essbase. См. раздел "Просмотр и работа с данными сценария из веб-интерфейса Essbase".

Подстановочные переменные среды выполнения с параметром svLaunch срабатывают правильно при подключении к сценарию непосредственно по частному подключению. Это связано с тем, что на листе присутствует элемент песочницы.

Некоторое количество функций не поддерживается в гибридном режиме, который используется в кубах с поддержкой сценариев. См. раздел "Поддерживаемые в гибридном режиме функции".