Configurar Eventos

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ções ou Validações Associadas serão acionadas quando um registro for Excluído.

• Inserir – Ações ou Validações Associadas serão acionadas quando um registro for Inserido.

• Salvar – Ações ou Validações Associadas serão acionadas quando um registro for Salvo.

• Atualizar – Ações ou Validações Associadas serão acionadas quando um registro for Atualizado.

Opções de Detalhes do Evento

O seguinte pode ser configurado para um Evento:

• Informações do Evento:

  • Nome: O nome usado para definir o evento.

  • Escopo de Atualização:

    • Objeto de Dados: O evento pode afetar outras linhas neste objeto de dados.

    • Global: O evento pode afetar outros objetos de dados, recarregue tudo.

    • Nenhum: Os valores de entrada não são afetados pelo evento.

    • Linha: O evento pode afetar os valores nesta linha.

  • Ativo: Indica se o evento está ativo ou não no momento.

• Mensagens:

  • Confirmação: A mensagem configurada aqui é exibida ao usuário para confirmar se ele deseja prosseguir com a ação.

  • Sucesso: A mensagem será exibida ao usuário após uma ação bem-sucedida ter sido realizada.

  • Falha: A mensagem será exibida ao usuário após uma ação falhar.

• Propriedades de execução:

  • Ignorar pai: Se habilitado, o evento ignorará quaisquer eventos pai e ações associadas.

  • Transação: Processa as ações do evento como uma [transação][ab transactions].

  • Tipo de execução: Determina quando o evento será executado. As opções incluem:

    • Primeiro plano: O evento é executado em primeiro plano.

    • Iniciar agora (segundo plano): O evento será executado em segundo plano quando invocado.

    • Iniciar agora ou via agendamento (segundo plano): O evento será executado em segundo plano quando invocado ou agendado.

    • Iniciar via agendamento (segundo plano): O evento será executado em segundo plano quando agendado.

    Alguns ou todos os seguintes aparecem ao selecionar uma opção diferente de Primeiro plano:

    • Concorrência máxima: Número máximo de eventos simultâneos.

    • Bloqueio: (Para eventos chamados por ações de eventos.) Se selecionado, App Builder aguarda a conclusão do evento antes de processar outras ações.

    • Executar como usuário: Usuário com o qual o evento agendado é executado.

    • Horário de funcionamento:

      • Pausar execução: Hora de pausar o agendamento.

      • Retomar execução: Hora de retomar o agendamento.

• Bloqueio:

  • Usar bloqueio – habilita o bloqueio de eventos. Tenha cuidado com esta opção, veja Concorrência e bloqueio de eventos

Eventos Personalizados

Além dos Eventos Intrínsecos, você pode definir Eventos Personalizados que podem ter Ações ou Validações associadas a eles. Eventos Personalizados podem ser disparados da Camada de UI do Aplicativo a partir dos seguintes Tipos de Controle: Texto, Imagens, Botões, Listas.

Onde os Eventos São Configurados

Os eventos podem ser configurados na Camada de Lógica de Negócios e/ou na Camada de Dados. A melhor prática é configurar quaisquer Eventos na Camada de Dados, a menos que haja um motivo comercial para configurá-lo na Camada de Lógica de Negócios. Os motivos são discutidos neste artigo.

Camada de Dados

É mais rápido, fácil e simples manter e usar Eventos quando eles são configurados na Camada de Dados. A melhor prática ao configurar Eventos é sempre configurar Eventos na Camada de Dados, a menos que:

• Você esteja configurando Ações ou Validações em Eventos Intrínsecos que você deseja executar somente em páginas definidas específicas
• A Ação/Validação associada requer vinculação que não está na Tabela

Por ambos os motivos listados acima, você desejaria configurar o Evento na Camada de Lógica de Negócios.

Para Configurar um Evento na Camada de Dados

As etapas a seguir descrevem como configurar o Evento na Camada de Dados. Os eventos normalmente exigem que uma Regra de objeto de Negócios seja criada antes desta etapa e que você conecte o Evento à Camada de IU do Aplicativo após esta etapa.

1. Navegue até o App Workbench
2. Clique em Tabelas
3. Localize a Tabela para a qual deseja configurar o Evento e clique no ícone Eventos

4. Configure o Evento e as informações de Ação ou Validação associadas

   1. Se estiver usando um Evento Intrínseco, selecione-o no painel Eventos de Armazenamento de Dados, clique no ícone de edição de lápis e, em seguida, clique em Criar e Registrar no painel Ações ou Validações (dependendo do tipo de Evento que está sendo configurado)
   2. Se estiver usando um Evento Personalizado, clique em + Evento de Tabela no painel Eventos de Armazenamento de Dados e atribua um Nome exclusivo e Salvar. Em seguida, clique em Criar e Registrar no painel Ações ou Validações (dependendo do tipo de Evento que está sendo configurado). Selecione a Regra criada para associar ao Evento, atribua qualquer informação adicional necessária e clique em Salvar.

Camada de Lógica de Negócios

Conforme discutido na seção Camada de Dados, os Eventos geralmente devem ser configurados na Camada de Dados. Existem poucas exceções a isso, os motivos pelos quais você deseja configurar um Evento em uma Camada de Lógica de Negócios incluem:

• Você está configurando Ações ou Validações em Eventos Intrínsecos que deseja executar somente em páginas definidas específicas.
• A Ação/Validação associada requer uma vinculação que não está na Tabela.

Configurar um Evento em um Objeto de Negócios permite que você pule o pai (o Objeto de Dados).

Para Configurar um Evento na Camada de Lógica de Negócios

As etapas a seguir descrevem como configurar o Evento na Camada de Lógica de Negócios. Os eventos geralmente exigem que uma Regra de Negócios seja criada antes desta etapa e que você conecte o Evento à Camada de IU do Aplicativo após esta etapa.

1. Navegue até o App Workbench
2. Clique em Regras
3. Localize a Regra de Negócios para a qual deseja configurar o Evento e clique no botão Eventos correspondente. Por exemplo: Funcionário (Fonte)

4. Configure o Evento e as informações de Ação ou Validação associadas

   1. Se estiver usando um Evento Intrínseco, selecione-o no painel Todos os Eventos, clique no ícone de edição de lápis e, em seguida, clique em Criar e Registrar no painel Ações ou Validações (dependendo do tipo de Evento que está sendo configurado)
   2. Se estiver usando um Evento Personalizado, clique em + Evento de Regra no painel Todos os Eventos e atribua um Nome exclusivo. Em seguida, clique em Criar e Registrar no painel Ações ou Validações (dependendo do tipo de Evento que está sendo configurado). Selecione a Regra criada para associar ao Evento, atribua qualquer informação adicional necessária e clique em Salvar.