Ir para o conteúdo

Tipos de Ação de Evento

App Builder suporta muitos Tipos de Ação de Evento diferentes que podem ser definidos para Ações associadas a Eventos, dependendo do uso pretendido da Ação. Este artigo descreverá os diferentes Tipos de Ação e como você pode trabalhar com eles.

Para acessar os diferentes Tipos de Ação de Evento, navegue até a camada Lógica de Negócios de App Builder. A partir daí, você identificaria a Tabela (ou Regra) onde você vai definir a Ação e clicaria no ícone Eventos correspondente. Na tela de definição de Ação resultante, você verá opções para configurar Tipo de Ação.

Tipos de Ação Disponíveis:

  • Regra
  • Notificação
  • Chamada de API
  • Event
  • Export
  • Import
  • Plug-in
  • Procedimento
  • RFC

O valor padrão para Tipo é Regra, pois, com mais frequência, os Usuários pretendem alavancar uma Regra de Negócios junto com uma Ação. A regra é documentada em artigos e guias existentes e no Tipo de notificação também está documentado em outro lugar. Este artigo se concentrará nos Tipos de Ação para Chamada de API, Evento, Exportação, Importação, Plugin, Procedimento, RFC e Resposta de Workflow.

Chamada de API

O tipo de ação Chamada de API é usado para chamar um endpoint APIM ou REST como uma ação.

Para Configurar uma Ação de Chamada de API

  • Defina o valor Tipo como Chamada de API
  • Selecione o Endpoint nomeado para chamar com a Ação
  • Se apropriado, modifique o valor Ordem para controlar a ordem de execução quando executado no evento
  • Defina o valor When para determinar quando a Ação deve ser executada. Opções: Antes, Depois
  • Revise Vinculações explícitas e confirme se as informações estão corretas
  • Clique em Salvar

Nota

Da perspectiva REST, App Builder suporta ligações de entrada e saída. As colunas de entrada são enviadas para o endpoint, e as de saída se originam da resposta do endpoint e atualizam o registro na memória com o valor do REST. Usar a ligação de saída pode resultar em uma mensagem de erro se a resposta contiver vários registros, como App Builder não sabe qual registro usar neste cenário.

Event

O tipo de ação Evento é usado para executar outro evento nomeado.

Para Configurar uma Ação de Evento

  • Defina o valor Tipo como Evento
  • Selecione o Objeto de Negócios nomeado com o Evento associado a ser executado
  • Selecione o Evento nomeado a ser executado
  • Se apropriado, modifique o valor Ordem para controlar a ordem de Execução quando executado no Evento
  • Defina o valor Quando para determinar quando a Ação deve ser executada. Opções: Antes, Depois
  • Revise Vinculações Explícitas e confirme se as informações estão corretas
  • Clique em Salvar

Export

O tipo de ação Export é usado para exportar um relatório para um arquivo. Com base na configuração App Builder exportará um arquivo e o gravará como delimitado por vírgula, barra vertical ou aba e o armazenará no local indicado.

Para Configurar uma Ação de Exportação

  • Defina o valor Tipo como Exportar
  • Selecione a Regra nomeada correspondente para executar com a Ação
  • Defina Sistema de Arquivos para o local onde você deseja armazenar as informações que estão sendo exportadas. Este valor pode ser um sistema de arquivos local ou de rede.
  • Escolha o valor Delimitador usado para o arquivo. As opções são: Vírgula, Barra Vertical, Tabulação
  • Se o arquivo que está sendo exportado incluir a linha Cabeçalho, marque a caixa Cabeçalhos de Saída
  • Selecione a Coluna Nome do Arquivo da Regra de Negócios ou Tabela que está sendo referenciada
  • Se apropriado, modifique o valor Ordem para controlar a ordem de Execução quando executado no Evento
  • Defina o valor Quando para determinar quando a Ação deve ser executada. Opções: Antes, Depois
  • Revise Vinculações Explícitas e confirme se as informações estão precisas
  • Clique em Salvar

Import

O tipo de ação Importar é usado para importar dados de um sistema de arquivos para uma ou muitas tabelas. App Builder suporta a capacidade de importar um arquivo CSV ou Excel ou HL7 usando este método.

Para Configurar uma Ação de Importação

  • Defina o Tipo como Importar
  • Defina o Tipo de importação para corresponder ao tipo de arquivo usado para importar. As opções são CSV ou Excel, HL7
  • Se você quiser App Builder para excluir o conteúdo da tabela de destino na importação, marque a caixa Truncar
  • Defina Sistema de Arquivos para o local onde você deseja armazenar as informações que estão sendo importadas. Este valor pode ser um sistema de arquivos local ou de rede.
  • Defina o valor Tabela de Destino para a Tabela nomeada onde o arquivo importado residirá
  • Escolha o valor Delimitador usado para o arquivo. As opções são: Vírgula, Barra Vertical, Tabulação
  • Defina o valor Fonte de Dados Concluída para representar o local do arquivo para onde o arquivo de importação será movido OU este valor pode ser deixado em branco. Geralmente, este é o mesmo que o valor do Sistema de Arquivos.
  • Se apropriado, modifique o valor Ordem para controlar a ordem de Execução quando executado em Evento
  • Defina o valor Quando para determinar quando a Ação deve ser executada. Opções: Antes, Depois
  • Revise Vinculações Explícitas e confirme se as informações estão corretas
  • Clique em Salvar

Nota

Ligações explícitas não têm impacto na importação.

Plug-in

O tipo de ação Plugin é usado para invocar um plugin de ação em App Builder.

Para Configurar uma Ação de Plugin

  • Defina o tipo como Plugin
  • Selecione o Plugin value apropriado com base em sua necessidade. Plugins:
    • Criar linha em tabela vazia – cria uma nova linha se o evento Filter não retornar nenhuma linha
    • Gerar ETag de imagem – gera um ETag para uma imagem na tabela Be_Image
    • Hash Password – Faz hash do valor do campo 'Senha'
    • Http Retriever – Recupera conteúdo da coluna 'url' e armazena na coluna 'result'
    • Mover controle – Move o índice de todos os controles irmãos
    • Persistente – Limpar cache – Limpar cache usando Row
    • Filtro Persistente – Define padrões a partir do valor – Define padrões a partir do valor
    • Persistente – Atualizar linha – Atualizar linha
    • Salesforce persistente – Atualizar linha – Atualizar linha
    • Pluralize Name – Pluralize e humanize um campo 'Nome'
    • Executar evento em segundo plano – executar o evento 'Background' para o objeto de dados (em segundo plano)
    • Salvar relatório – salva o relatório no diretório PDF
    • Sleep – dorme até um tempo limite determinado
    • SMTP Mailer – envia email usando Email, Assunto e campos opcionais Corpo e De. Substituição usando {{field}} está disponível no Corpo.
    • Lançar Exceção – lança uma mensagem de exceção
    • Temporizador – pausa por 5 ou 'WaitTime' segundos
  • Se apropriado, modifique o valor Order para controlar a ordem de Execução quando executado no Evento
  • Defina o valor When para determinar quando a Ação deve ser executada. Opções: Antes, Depois
  • Revise Vinculações Explícitas e confirme se as informações estão corretas
  • Clique em Salvar

Nota

As opções de plugin disponíveis podem ser atualizadas via App Builder lançamentos.

Procedimento

O tipo de ação Procedure é usado para executar um procedimento armazenado RDBMS.

Para Configurar uma Ação de Procedimento

  • Defina o Tipo como Procedimento
  • Selecione o Procedimento armazenado RDBMS nomeado
  • Se apropriado, modifique o valor Ordem para controlar a ordem de Execução quando executado no Evento
  • Defina o valor Quando para determinar quando a Ação deve ser executada. Opções: Antes, Depois
  • Revise Vinculações Explícitas e confirme se as informações estão corretas
  • Clique em Salvar

RFC

O tipo de ação RFC é usado para executar uma chamada de função remota. RFCs são usados principalmente ao trabalhar com SAP externamente e configurar chamadas RFC BABI e leituras de tabela RFC.

Para Configurar uma Ação RFC

  • Defina o Tipo como RFC
  • Selecione o RFC nomeado
  • Se apropriado, modifique o valor Order para controlar a ordem de Execução quando executado no Evento
  • Defina o valor When para determinar quando a Ação deve ser executada. Opções: Antes, Depois
  • Revise Explicit Bindings e confirme se as informações estão corretas
  • Clique em Save