Tipos de ação de evento no Jitterbit App Builder

O App Builder suporta muitos tipos diferentes de ações de Evento que podem ser definidos para ações associadas a eventos, dependendo do uso pretendido da ação. Esta página descreve os diferentes tipos de ação e como você pode trabalhar com eles.

Para acessar os diferentes tipos de ação de Evento:

1. Selecione App Workbench > Regras.

2. Localize a tabela (ou regra) onde deseja definir uma ação e clique no ícone correspondente de Eventos. O diálogo Todos os Eventos é aberto.

3. Selecione o evento intrínseco ou personalizado que deve acionar a ação, clicando duas vezes em sua linha. Um diálogo é aberto.

4. No painel Ações, selecione Registrar e configure o tipo de ação no diálogo Ação resultante (mostrado na imagem).

   

Existem nove tipos de ação disponíveis, divididos em Básico e Caso Especial. O tipo de ação padrão é Regra, pois é o mais utilizado. Os tipos de ação básicos, regras e notificações, estão documentados separadamente, enquanto esta página documenta os tipos restantes.

Tipos de ação:

• Básico

  • Regra

  • Notificação

• Caso Especial

  • Chamada de API

  • Evento

  • Exportar

  • Importar

  • Plugin

  • Procedimento

  • RFC (Chamada de Função Remota)

Chamada de API

Use o tipo de ação Chamada de API para chamar um Gerenciador de API ou ponto de extremidade REST como uma ação. Para configurar uma ação de Chamada de API, acesse o diálogo Ação conforme descrito acima e configure os seguintes campos:

• Tipo: Defina como Chamada de API.

• Ponto de Extremidade: Selecione o ponto de extremidade nomeado a ser chamado com a ação.

• Rótulo: (Opcional) Insira um rótulo (máx. 30 caracteres) a ser exibido no diagrama de eventos. Se nenhum rótulo for fornecido, o nome do ponto de extremidade será usado.

• Posição

  • Ordem: Insira um valor para controlar a ordem de execução quando executado em um evento.

  • Ativo: Habilitado por padrão, esta opção determina se a ação será executada.

  • Quando: Defina como Antes ou Depois para determinar quando a ação deve ser executada.

• Ajuda Técnica: (Opcional) Insira uma descrição das responsabilidades e comportamentos da ação para ajudar outros desenvolvedores.

Para concluir a criação da ação, clique em Salvar.

Evento

Use o tipo de ação Evento para executar outro evento nomeado. Para configurar uma ação Evento, acesse o diálogo Ação conforme descrito acima e configure estes campos:

• Tipo: Defina como Evento.

• Regra: Selecione a regra que realizará a ação.

• Evento: Selecione o evento que a ação invocará.

• Tratar Avisos de Validação Como Erros: Habilitado por padrão. Desative esta opção se quiser permitir que o evento invocado receba quaisquer validações de aviso que o usuário escolheu prosseguir, mas quaisquer ações anteriores a esta serão executadas novamente. Para evitar isso, considere adicionar a mesma validação no evento atual (chamador).

• Rótulo: (Opcional) Insira um rótulo (máx. 30 caracteres) a ser exibido no diagrama do evento. Se nenhum rótulo for fornecido, o nome do evento de destino será usado.

• Posição

  • Ordem: Insira um valor para controlar a ordem de execução quando executado em um evento.

  • Ativo: Habilitado por padrão, esta opção determina se a ação será executada.

  • Quando: Defina como Antes ou Depois para determinar quando a ação deve ser executada.

• Ajuda Técnica: (Opcional) Insira uma descrição das responsabilidades e comportamentos da ação para ajudar outros desenvolvedores.

Para concluir a criação da ação, clique em Salvar.

Exportar

Use o tipo de ação Exportar para exportar um relatório para um arquivo. Esta ação exporta um arquivo, escreve-o usando vírgulas, pipes ou tabs como delimitadores e, em seguida, o armazena no local desejado. Para configurar uma ação de Exportar, acesse a caixa de diálogo Ação conforme descrito acima e configure os seguintes campos:

• Tipo: Defina como Exportar.

• Regra: Selecione a regra que realizará a ação.

• Sistema de Arquivos: Selecione onde armazenar as informações que estão sendo exportadas. Isso pode ser um sistema de arquivos local ou de rede.

• Delimitador: Selecione qual delimitador (vírgulas, pipes ou tabs) será usado para o arquivo.

• Cabeçalhos de Saída: Ative esta opção se o arquivo exportado incluir uma linha de cabeçalho. Desativado por padrão.

• Coluna do Nome do Arquivo: Selecione a coluna do nome do arquivo da regra de negócios ou tabela que está sendo referenciada.

• Rótulo: (Opcional) Insira um rótulo (máximo de 30 caracteres) a ser exibido no diagrama de eventos. Se nenhum rótulo for fornecido, o nome da regra será usado.

• Posição

  • Ordem: Insira um valor para controlar a ordem de execução quando executado em um evento.

  • Ativo: Habilitado por padrão, esta opção determina se a ação será executada.

  • Quando: Defina como Antes ou Depois para determinar quando a ação deve ser executada.

• Ajuda Técnica: (Opcional) Insira uma descrição das responsabilidades e comportamentos da ação para ajudar outros desenvolvedores.

Para concluir a criação da ação, clique em Salvar.

Importar

Use o tipo de ação Importar para importar dados de um sistema de arquivos para uma ou várias tabelas. Você pode importar arquivos CSV, Excel ou HL7. Para configurar uma ação de Importar, acesse a caixa de diálogo Ação conforme descrito acima e configure os seguintes campos:

• Tipo: Defina como Importar.

• Tipo de Importação: Selecione o tipo de arquivo a ser importado, seja CSV ou Excel ou HL7.

• Truncar: (Opcional) Ative esta opção se desejar que o App Builder exclua o conteúdo da tabela de destino durante a importação. Desativado por padrão.

• Sistema de Arquivos: Selecione onde armazenar as informações que estão sendo importadas. Isso pode ser um sistema de arquivos local ou de rede.

• Tabela de Destino: Selecione a tabela nomeada onde o arquivo importado será armazenado.

• Delimitador: Selecione qual delimitador (vírgulas, pipes ou tabs) será usado para o arquivo.

• Fonte de Dados Completa: Selecione o local do arquivo onde o arquivo de importação será movido. Deixe este campo em branco se for o mesmo que o Sistema de Arquivos.

• Rótulo: (Opcional) Insira um rótulo (máximo de 30 caracteres) que será exibido no diagrama de eventos. Se nenhum rótulo for fornecido, o nome da tabela será usado.

• Posição

  • Ordem: Insira um valor para controlar a ordem de execução quando executado em um evento.

  • Ativo: Habilitado por padrão, esta opção determina se a ação será executada.

  • Quando: Defina como Antes ou Depois para determinar quando a ação deve ser executada.

• Ajuda Técnica: (Opcional) Insira uma descrição das responsabilidades e comportamentos da ação para ajudar outros desenvolvedores.

Para concluir a criação da ação, clique em Salvar.

Plugin

Use o tipo de ação Plugin para invocar um plugin de ação no App Builder. Para configurar uma ação Plugin, acesse o diálogo de Ação conforme descrito acima e configure estes campos:

• Tipo: Defina como Plugin.

• Plugin: Selecione o plugin que realizará a ação. Os plugins disponíveis são:

  • Limpar Cache de Endpoint: Cancela qualquer cache de endpoint gerado por ações anteriores.

  • Commit Event Transactions: Comita qualquer transação aberta do evento pai (diretamente no evento ou em um de seus pais).

  • Create Row on Empty Table: Cria uma nova linha se o evento Filter não retornar nenhuma linha.

  • Http Retriever: Recupera conteúdo da coluna URL e o armazena na coluna Result.

  • JWT Generator: Gera um Token Web JSON (JWT).

  • Persistable – Refresh Row: Atualiza uma linha.

  • Persistable Salesforce – Refresh Rw: Atualiza uma linha.

  • Pluralize Name: Pluraliza e humaniza um campo Name.

  • Run Background Event: Executa o evento Background para o objeto de dados (em segundo plano).

  • Save Report: Salva o relatório no diretório PDF.

  • Security Provider Hash Password: Faz o hash do valor da coluna Password usando um provedor de segurança específico.

  • Security Provider Password Hash Verifier: Verifica uma senha hash usando um provedor de segurança específico.

  • Sleep: Pausa por um segundo ou por um período de Timeout personalizado (em milissegundos).

  • SMTP Mailer: Envia email usando os campos Email, Subject e opcionais Body e From. A substituição usando {{ field }} está disponível dentro do Body e Subject.

  • Throw Exception: Lança uma exceção.

• Label: (Opcional) Insira um rótulo (máximo de 30 caracteres) a ser exibido no diagrama do evento. Se nenhum rótulo for fornecido, o nome do plugin será utilizado.

• Position

  • Order: Insira um valor para controlar a ordem de execução quando executado em um evento.

  • Active: Habilitado por padrão, esta opção determina se a ação será executada.

  • When: Defina como Before ou After para determinar quando a ação deve ser executada.

• Technical Help: (Opcional) Insira uma descrição das responsabilidades e comportamentos da ação para ajudar outros desenvolvedores.

Para concluir a criação da ação, clique em Save.

Procedure

Use o tipo de ação Procedure para executar um procedimento armazenado em um RDBMS (Sistema de Gerenciamento de Banco de Dados Relacional). Para configurar uma ação Procedure, acesse o diálogo Action conforme descrito acima e configure estes campos:

• Tipo: Defina como Plugin.

• Procedimento: Selecione o procedimento armazenado que será executado.

• Rótulo: (Opcional) Insira um rótulo (máx. 30 caracteres) a ser exibido no diagrama de eventos.

• Posição

  • Ordem: Insira um valor para controlar a ordem de execução quando executado em um evento.

  • Ativo: Habilitado por padrão, esta opção determina se a ação será executada.

  • Quando: Defina como Antes ou Depois para determinar quando a ação deve ser executada.

• Ajuda Técnica: (Opcional) Insira uma descrição das responsabilidades e comportamentos da ação para ajudar outros desenvolvedores.

Para concluir a criação da ação, clique em Salvar.

RFC (Chamada de Função Remota)

Use o tipo de ação RFC 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 tabelas RFC. Para configurar uma ação RFC, acesse a caixa de diálogo Ação conforme descrito acima e configure os seguintes campos:

• Tipo: Defina como RFC.

• RFC: Selecione a função a ser chamada.

• Rótulo: (Opcional) Insira um rótulo (máx. 30 caracteres) a ser exibido no diagrama de eventos.

• Posição

  • Ordem: Insira um valor para controlar a ordem de execução quando executado em um evento.

  • Ativo: Habilitado por padrão, esta opção determina se a ação será executada.

  • Quando: Defina como Antes ou Depois para determinar quando a ação deve ser executada.

• Ajuda Técnica: (Opcional) Insira uma descrição das responsabilidades e comportamentos da ação para ajudar outros desenvolvedores.

Para concluir a criação da ação, clique em Salvar.