Instrução CREATE ACTION (MDX)
Cria uma ação que pode ser associada a um cubo, uma dimensão, uma hierarquia ou um objeto subordinado.
Sintaxe
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' ]
Argumentos
Cube_Name
Uma cadeia de caracteres válida que fornece um nome de cubo.Action_ Name
Uma cadeia de caracteres válida que fornece o nome da ação que está sendo criada.Hierarchy_ Name
Uma cadeia de caracteres válida que fornece um nome de hierarquia.Level_ Name
Uma cadeia de caracteres válida que fornece um nome de nível.Member_ Name
Uma cadeia de caracteres válida que fornece um nome ou chave de membro.MDX_Expression
Uma linguagem MDX válida.String_Expression
Uma expressão de cadeia de caracteres válida.
Comentários
Os aplicativos cliente podem criar e executar ações que não são seguras, além de usar funções que não são seguras. Para evitar essas situações, use a propriedade Safety Options. Para obter mais informações, consulte as Propriedade de Opções de Segurança.
Observação |
---|
Esta instrução é incluída para compatibilidade com versões anteriores. As novas ações para o SQL ServerAnalysis Services, como Detalhamento ou Relatório, não têm suporte. |
Tipos de ação
A tabela a seguir descreve os diferentes tipos de ação disponíveis no MicrosoftSQL ServerAnalysis Services.
Tipo de ação |
Descrição |
---|---|
URL |
A cadeia de caracteres de ação retornada é um URL que deve ser aberto usando um navegador de Internet.
Observação
Se essa ação não começar com http:// ou https://, a ação não ficará disponível para o navegador, a não ser que SafetyOptions seja definido como DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
|
HTML |
A cadeia de caracteres de ação retornada é um script HTML. A cadeia de caracteres deve ser salva em um arquivo e o arquivo deve ser processado com um navegador de Internet. Neste caso, um script inteiro pode ser executado como parte do HTML gerado. |
STATEMENT |
A cadeia de caracteres de ação retornada é uma instrução que precisa ser executada com a configuração do método ICommand::SetText de um objeto de comando para a cadeia de caracteres e a invocação do método ICommand::Execute. Se o comando não tiver êxito, um erro será retornado. |
DATASET |
A cadeia de caracteres de ação retornada é uma instrução MDX que precisa ser executada com a configuração do método ICommand::SetText de um objeto de comando para a cadeia de caracteres e a invocação do método ICommand::Execute. A ID de interface (IID) solicitada deve ser IDataset. O comando terá êxito se um conjunto de dados tiver sido criado. O aplicativo cliente deve permitir que o usuário navegue pelo conjunto de dados retornado. |
ROWSET |
Similar a DATASET, mas em vez de solicitar uma IID de IDataset, o aplicativo cliente deve solicitar uma IID de IRowset. O comando terá êxito se um conjunto de linhas tiver sido criado. O aplicativo cliente deve permitir que o usuário navegue pelo conjunto de linhas retornado. |
COMMANDLINE |
O aplicativo cliente deve executar a cadeia de caracteres de ação. A cadeia de caracteres é uma linha de comando. |
PROPRIETARY |
O aplicativo cliente não deve exibir nem executar a ação, a não ser que o aplicativo tenha um conhecimento personalizado e não genérico da ação específica. As ações de propriedade não são retornadas para o aplicativo cliente, a não ser que o aplicativo cliente solicite explicitamente essas ações através da configuração da restrição apropriada em APPLICATION_NAME. |
Tipos de invocação
A tabela a seguir descreve os diferentes tipos de invocação disponíveis no Analysis Services. O tipo de invocação é usado somente pelo aplicativo cliente para ajudar a determinar quando a ação deve ser invocada. O tipo de invocação não determina realmente o comportamento de invocação da ação.
Tipo de invocação |
Descrição |
---|---|
INTERACTIVE |
A ação deve ser invocada pelo aplicativo cliente por meio da interação do usuário. |
ON_OPEN |
A ação deve ser invocada pelo aplicativo cliente quando o objeto de destino é aberto. Esse tipo de invocação não é implementado atualmente. |
BATCH |
A ação deve ser invocada pelo aplicativo cliente quando o objeto de destino é envolvido em uma operação em lotes, conforme determinado pelo aplicativo cliente. Esse tipo de invocação não é implementado atualmente. |
Escopo
Cada ação é definida para um cubo específico e tem um nome exclusivo nesse cubo. Uma ação pode ter um dos escopos listados na tabela a seguir.
Escopo de cubo
Para ações independentes de dimensões, membros ou células específicos; por exemplo, “Lançar emulação terminal para o sistema de produção AS/400”.Escopo de dimensão
A ação se aplica a uma dimensão específica. Essas ações não dependem da seleção específica de níveis ou membros.Escopo de nível
A ação se aplica a um nível de dimensão específico. Essas ações não dependem da seleção específica de um membro dessa dimensão.Escopo de membro
A ação se aplica a membros de nível específicos.Escopo de célula
A ação se aplica somente a células específicas.Escopo de conjunto
A ação se aplica somente a um conjunto. O nome, ActionParameterSet, é reservado para ser usado pelo aplicativo dentro da expressão da ação.