Definição de dados MDX - CREATE ACTION

Cria uma ação que pode ser associada a um cubo, dimensão, hierarquia ou 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.

Nome Action_
Uma cadeia de caracteres válida que fornece o nome da ação que está sendo criada.

Hierarchy_ Nome
Uma cadeia de caracteres válida que fornece um nome de hierarquia.

Nome Level_
Uma cadeia de caracteres válida que fornece um nome de nível.

Nome Member_
Uma cadeia de caracteres válida que fornece um nome de membro ou uma chave de membro.

MDX_Expression
Uma expressão MDX válida.

String_Expression
Uma expressão de cadeia de caracteres válida.

Observações

É possível que os aplicativos cliente criem e executem ações que não são seguras; Também é possível que os aplicativos cliente usem funções inseguras. Para evitar essas situações, use a propriedade Opções de segurança . Para obter mais informações, consulte Propriedade de opções de segurança.

Observação

Esta declaração está incluída para compatibilidade retroativa. Não há suporte para ações novas no Analysis Services, como ações de detalhamento ou relatório.

Tipos de ação

A tabela a seguir descreve os diferentes tipos de ações disponíveis no Analysis Services.

Tipo de ação Descrição
URL A cadeia de caracteres de ação retornada é uma URL que deve ser aberta usando um navegador da Internet.

Nota: Se esta ação não começar com https:// ou https://, a ação não estará disponível para o navegador, a menos que SafetyOptions esteja definido para 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 usando um navegador da Internet. Nesse caso, um script inteiro pode ser executado como parte do HTML gerado.
DECLARAÇÃO A cadeia de caracteres de ação retornada é uma instrução que precisa ser executada definindo o método ICommand::SetText de um objeto de comando para a cadeia de caracteres e chamando o método ICommand::Execute . Se o comando não for bem-sucedido, um erro será retornado.
CONJUNTO DE DADOS A cadeia de caracteres de ação retornada é uma instrução MDX que precisa ser executada definindo o método ICommand::SetText de um objeto de comando para a cadeia de caracteres e chamando o método ICommand::Execute . O ID de interface solicitado (IID) 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.
CONJUNTO DE LINHAS Semelhante a DATASET, mas em vez de solicitar um IID de IDataset, o aplicativo cliente deve solicitar um 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.
LINHA DE COMANDO O aplicativo cliente deve executar a cadeia de caracteres de ação. A cadeia de caracteres é uma linha de comando.
PROPRIETÁRIO Um aplicativo cliente não deve exibir, nem executar a ação, a menos que o aplicativo tenha um conhecimento personalizado e não genérico da ação específica. As ações proprietárias não são retornadas ao aplicativo cliente, a menos que o aplicativo cliente as solicite explicitamente, definindo a restrição apropriada no APPLICATION_NAME.

Tipos de invocação

A tabela a seguir descreve os diferentes tipos de invocações disponíveis no Analysis Services. O tipo de invocação é usado somente pelo aplicativo cliente para ajudar a determinar quando invocar a ação. Na verdade, o tipo de invocação não determina o comportamento de invocação da ação.

Tipo de invocação Descrição
INTERATIVO 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 está implementado no momento.
LOTE A ação deve ser invocada pelo aplicativo cliente quando o objeto de destino estiver envolvido em uma operação em lote, conforme determinado pelo aplicativo cliente. Esse tipo de invocação não está implementado no momento.

Âmbito de aplicação

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.

Âmbito do cubo
Para ações independentes de dimensões, membros ou células específicas; por exemplo: "Emulação de terminal de lançamento para o sistema de produção AS/400".

Âmbito da dimensão
A ação aplica-se a uma dimensão específica. Estas ações não dependem de uma seleção específica de níveis ou membros.

Nível de âmbito
A ação aplica-se a um nível de dimensão específica. Estas ações não dependem da seleção específica de um membro nessa dimensão.

Âmbito do membro
A ação aplica-se a membros de nível específico.

Âmbito da célula
A ação aplica-se apenas a células específicas.

Definir âmbito
A ação aplica-se apenas a um conjunto. O nome, ActionParameterSet, é reservado para uso pelo aplicativo dentro da expressão da ação.

Conteúdo relacionado

  • Última atualização a