Ir para o conteúdo

Configurar eventos no Jitterbit App Builder

Introdução

Os seguintes eventos intrínsecos podem ser configurados para ter ações ou validações associadas na camada de Dados e na camada de Lógica de Negócios:

  • Excluir: Ação(s) ou validação(ões) associada(s) serão acionadas quando um registro for excluído.

  • Inserir: Ação(s) ou validação(ões) associada(s) serão acionadas quando um registro for inserido.

  • Salvar: Ação(s) ou validação(ões) associada(s) serão acionadas quando um registro for salvo.

  • Atualizar: Ação(s) ou validação(ões) associada(s) serão acionadas quando um registro for atualizado.

Opções de detalhes do evento

As seguintes propriedades podem ser configuradas para um Evento para definir seu comportamento e experiência do usuário:

Informações do evento

  • Nome: O nome único usado para definir o evento.

  • Escopo de Atualização: Determina quais dados são recarregados após o evento:

    • Objeto de Dados: Afeta outras linhas neste objeto de dados.

    • Global: Afeta outros objetos de dados; recarrega a página inteira.

    • Nenhum: Valores de entrada não são afetados.

    • Linha: Afeta valores apenas na linha atual.

  • Ativo: Indica se o Evento está atualmente ativo.

Mensagens

  • Confirmação: Exibida para o Usuário para confirmar se deseja prosseguir.

  • Sucesso: Exibida após uma Ação bem-sucedida.

  • Falha: Exibida após uma Ação ter falhado.

Propriedades de execução

  • Pular Pai: Se habilitado, o evento irá pular Eventos pai e Ações associadas.

  • Transação: Processa as Ações do evento como uma transação de banco de dados.

  • Tipo de Execução: Determina quando o Evento é executado:

    • Em Primeiro Plano: Executa imediatamente na interface do usuário.

    • Executar Agora (Em Segundo Plano): Executado em segundo plano quando invocado.

    • Executar Agora ou via Agendamento (Em Segundo Plano): Execução em segundo plano via invocação ou agendamento.

    • Executar via Agendamento (Em Segundo Plano): Execução em segundo plano apenas via agendamento.

  • Opções Específicas de Contexto: Inclui Máxima Concorrência, Bloqueio (aguarda a conclusão do evento), Executar como Usuário e Horas de Funcionamento (Pausar/Retomar execução).

Bloqueio

  • Usar Bloqueio: Habilita o bloqueio de eventos para evitar problemas de concorrência.

Papel da vinculação em Eventos

Embora a configuração dos detalhes do evento acima seja essencial, a configuração da vinculação é um passo necessário que garante que o Evento tenha o contexto de dados correto. Ao registrar notificações, regras de migração, regras CRUD ou regras de validação em ações e validações, é necessário especificar a vinculação. Esse mapeamento conecta as colunas do painel (UI) às colunas da regra de destino (lógica), permitindo que o aplicativo passe os valores necessários para as ações associadas ao evento.

Eventos personalizados

Além dos eventos intrínsecos, você pode definir eventos personalizados associados a ações ou validações. Esses eventos podem ser acionados a partir da camada de UI por meio de controles como texto, imagens, botões e listas.

Onde os eventos são configurados

Os eventos são geralmente configurados na camada de Dados, mas podem ser movidos para a camada de Lógica de Negócios para requisitos específicos de nível de página.

Camada de Dados

É mais rápido e simples manter eventos na camada de Dados. Configure-os aqui, a menos que a lógica seja específica da página ou exija vinculação não disponível na tabela.

  1. Navegue até App Workbench > Tabelas.

  2. Localize a tabela e clique no ícone Eventos.

  3. Para eventos intrínsecos, clique no ícone de lápis e depois em Criar & Registrar no painel de ações ou validações.

  4. Para eventos personalizados, clique em + Evento de Tabela, nomeie-o e depois Criar & Registrar a ação/validação associada.

Camada de Lógica de Negócios

Use esta camada para configurar eventos intrínsecos para páginas específicas ou quando a ação requer vinculação fora do contexto padrão da tabela.

  1. Navegue até App Workbench > Regras.

  2. Localize a regra de negócios e clique no botão Eventos.

  3. Siga o mesmo processo de Criar & Registrar utilizado na camada de Dados.

Importante

O App Builder permite configurar ações/validações em ambas as camadas simultaneamente. Isso fará com que o evento seja acionado duas vezes. Sempre garanta que o evento esteja registrado no local correto e único.