Ação do processo do Application Engine

Executa um processo criado e publicado no Application Engine Process Editor.

É possível criar um processo, por exemplo, para copiar uma área de um cubo OLAP para outro cubo. Você também pode executar uma função matemática em dois valores. Todos os processos que foram publicados estão disponíveis somente na entrada Nome da ação. Os processos têm vários parâmetros, que são entradas da ação. Especifique um valor para cada parâmetro.

É possível especificar uma ação de processo do Application Engine nestes objetos:

  • Células
  • Botões
  • Visualizações de Lista
  • Relatórios

Os processos do Application Engine podem ser complexos, e sua execução pode levar vários minutos. Na entrada do Modo de execução, você pode especificar se um processo é executado de modo síncrono ou assíncrono. No modo assíncrono, os usuários podem continuar trabalhando no Application Studio sem aguardarem a conclusão do processo. Dessa forma, use o modo assíncrono para processos mais demorados em que os usuários não precisam ver o andamento de um processo ou aguardar até sua conclusão.

No modo Assíncrono, a ID do processo será retornada imediatamente para o relatório. A ID pode ser armazenada em uma variável de relatório, por exemplo, especificando a variável como um parâmetro e =Actions.Result.Text como seu valor.

A ID pode ser usada, com as funções Application EngineAsyncGetProcessStatus e AsyncGetProcessResult, para relatar o status e o resultado de um processo assíncrono.

Essas entradas e opções estarão disponíveis somente se o modo de execução da ação for Síncrono:

  • Mostrar progresso
  • Nível das mensagens de progresso
  • Título da caixa de diálogo de progresso
  • Data/hora da caixa de diálogo de progresso

É possível especificar que uma caixa de diálogo de progresso seja exibida enquanto um processo está em execução. Também é possível especificar que a caixa de diálogo só será exibida se houver um erro, um aviso ou um evento de informação. Para ajudar a depurar processos, você pode exibir todas as mensagens exibidas.

Para exibir a caixa de diálogo de progresso, selecione Sempre como o valor da opção Mostrar caixa de diálogo de progresso e um nível para a entrada Nível das mensagens de progresso. Caso contrário, a caixa de diálogo será exibida somente se ocorrer um erro.

Se você selecionar Depuração como o nível, o andamento do processo e todas as mensagens disponíveis serão exibidas. Para outros níveis, a caixa de diálogo exibe apenas o andamento, a menos que ocorra um evento no nível especificado.

Você pode especificar uma fórmula como o valor da entrada Mostrar progresso e da entrada Nível das mensagens de progresso. Isso permite controlar essas entradas de fora da caixa de diálogo Editar ação.

Para a entrada Mostrar caixa de diálogo de progresso, a fórmula deve ter um destes valores como resultado:

  • Somente erros
  • Sempre

Para a entrada Nível das mensagens de progresso, a fórmula deverá ter um destes resultados:

  • Erro
  • Aviso
  • Informações
  • Depurar
Nota

Os resultados da ação de processo Nível das mensagens de progresso não diferenciam maiúsculas e minúsculas e os erros são ignorados por padrão. Se a fórmula contiver um erro, o nível de Erro será aplicado automaticamente.

Para alterar o título da caixa de diálogo de progresso, especifique uma string definida pelo usuário ou uma fórmula como o valor da entrada Título na caixa de diálogo de progresso.

Como opção, selecione Data/hora da caixa de diálogo de progresso para exibir a hora de cada evento.
Nota

Nestes modos de ação, a caixa de diálogo de progresso é exibida somente no cliente do Application Studio:

  • Célula editada
  • Seleção alterada
  • Relatório carregado.