Определение данных многомерных выражений — CREATE ACTION

Статья
05/23/2023

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

Синтаксис

  
CREATE ACTION CURRENTCUBE | Cube_Name  
   .Action_Name <action body>  
<action body> ::=   
FOR   
        CUBE   
    | Hierarchy_Name [MEMBERS]   
    | Level_Name [MEMBERS]   
    | CELLS   
    | SET }   
      AS 'MDX_Expression'   
        [, TYPE = '  
              { URL   
            | HTML   
            | STATEMENT   
               | DATASET   
            | ROWSET   
            | COMMANDLINE   
               | PROPRIETARY }   
         ']  
   [ , INVOCATION = 'INTERACTIVE | ON_OPEN | BATCH ' ]  
   [ , APPLICATION = String_Expression ]  
   [ , DESCRIPTION = String_Expression ]  
   [ , CAPTION = 'MDX_Expression' ]

Аргументы

Cube_Name
Допустимая строка, представляющая имя куба.

имя Action_
Допустимая строка, представляющая имя создаваемого действия.

Имя Hierarchy_
Допустимая строка, представляющая имя иерархии.

имя Level_
Допустимая строка, представляющая имя уровня.

Имя Member_
Допустимая строка, представляющая имя или ключ элемента.

MDX_Expression
Допустимое многомерное выражение.

String_Expression
Допустимое строковое выражение.

Замечания

Возможна ситуация, когда клиентские приложения создают и запускают небезопасные действия или используют ненадежные функции. Чтобы избежать этих ситуаций, используйте свойство "Параметры безопасности". Дополнительные сведения см. в разделе «Свойство параметров безопасности».

Заметка

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

Типы действий

В следующей таблице описаны различные типы действий, доступных в службах Analysis Services.

Тип действия	Description
URL-адрес	Возвращаемая строка действия представляет собой URL-адрес, который можно открыть с помощью интернет-обозревателя. Примечание. Если это действие не начинается или действие будет недоступно в браузере, если параметр SafetyOptionsне установлен на DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.`https://https://`
HTML	Возвращаемая строка действия является скриптом HTML. Строку следует сохранить в файле, который надо просматривать с помощью интернет-обозревателя. Тогда весь скрипт можно запускать как часть созданного кода HTML.
ЗАЯВЛЕНИЕ	Возвращаемая строка действия — это инструкция, которая должна выполняться путем задания метода ICommand::SetText объекта команды в строку и вызова метода ICommand::Execute. Если команда завершится неудачно, будет возвращено сообщение об ошибке.
НАБОРА ДАННЫХ	Возвращаемая строка действия — это инструкция многомерных выражений, которая должна выполняться путем задания метода ICommand::SetText объекта команды в строку и вызова метода ICommand::Execute . Запрошенный идентификатор интерфейса (IID) должен быть IDataset. Команда успешно выполнится, если набор данных уже был создан. Клиентское приложение должно обеспечить пользователю просмотр созданного набора данных.
НАБОРА СТРОК	Аналогично DATASET, но вместо запроса IID IDataset клиентское приложение должно запрашивать iiD IRowset. Команда успешно выполнится, если набор строк уже был создан. Клиентское приложение должно обеспечить пользователю просмотр созданного набора строк.
COMMANDLINE	Клиентское приложение должно выполнить строку действия. Эта строка является командной.
СОБСТВЕННОСТИ	Клиентское приложение не будет показывать или выполнять это действие, если только данное приложение не обладает заданными пользователем (а не общими) знаниями об этом конкретном действии. Частные действия не возвращаются клиентскому приложению, если клиентское приложение явно не запрашивает их, задав соответствующее ограничение на APPLICATION_NAME.

Типы инициации

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

Тип инициации	Description
ИНТЕРАКТИВНАЯ	Действие должно быть инициировано клиентским приложением через взаимодействие с пользователем.
ON_OPEN	Действие должно быть инициировано клиентским приложением при открывании целевого объекта. Тип инициации еще не реализован.
ПАКЕТА	Действие должно быть инициировано клиентским приложением, когда целевой объект используется в пакетной операции, определенной клиентским приложением. Тип инициации еще не реализован.

Область

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

Область — куб
Для действий, не зависящих от определенных измерений, элементов или ячеек; например: "Запуск эмуляции терминала для рабочей системы AS/400".

Область — измерение
Действие применимо к заданному измерению. Эти действия не зависят от конкретного выбора уровней и элементов.

Область — уровень
Действие применимо к заданному уровню измерения. Эти действия не зависят от выбора конкретного элемента в этом измерении.

Область — элемент
Это действие применимо к конкретным элементам уровня.

Область — ячейка
Это действие применимо только к конкретным ячейкам.

Область — набор
Действие применимо только к заданному набору. Имя ActionParameterSet зарезервировано для использования приложением внутри выражения действия.

См. также

Инструкции определения данных многомерных выражений (многомерные выражения)

Share via