Описание данных MDX — CREATE ACTION

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

Синтаксис

  
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.

Тип действия Описание
URL-адрес Возвращаемая строка действия — это URL-адрес, который должен быть открыт с помощью браузера Интернета.

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

Типы вызовов

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

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

Область действия

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

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

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

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

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

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

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

См. также

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