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 do Action_
Uma cadeia de caracteres válida que fornece o nome da ação que está sendo criada.

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

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

Nome do Member_
Uma cadeia de caracteres válida que fornece um nome de membro ou 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 não seguras; também é possível que os aplicativos cliente usem funções não seguras. Para evitar essas situações, use a propriedade Opções de Segurança . Para obter mais informações, consulte a Propriedade 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.

Observação: se essa ação não começar com https:// ou https://, a ação ficará indisponível para o navegador, a menos que SafetyOptions esteja 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 renderizado 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.
DATASET 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 . A IID (ID da interface) 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 Semelhante ao DATASET, mas em vez de solicitar uma IID do IDataset, o aplicativo cliente deve solicitar uma IID do 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.
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 solicite explicitamente essas ações 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 apenas pelo aplicativo cliente para ajudar a determinar quando invocar a ação. O tipo de invocação realmente 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.

Scope

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 do cubo
Para ações independentes de dimensões, membros ou células específicas; por exemplo: "Iniciar emulação de terminal para sistema de produção AS/400".

Escopo da dimensão
A ação se aplica a uma dimensão específica. Essas ações não dependem de uma 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 nessa dimensão.

Escopo do membro
A ação se aplica a membros de nível específicos.

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

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

Conteúdo relacionado

  • Last updated on