Configurar Eventos em Vinyl¶

Este artigo discute os diferentes tipos de eventos disponíveis no Vinyl (intrínseco e personalizado), opções de detalhes do evento e quando configurar eventos na camada de armazenamento de dados versus objeto de negócios.

Eventos Intrínsecos¶

O Vinyl possui os seguintes Eventos Intrínsecos disponíveis para serem configurados para ter Ações ou Validações associadas na Camada de Dados e na Camada de Lógica de Negócios:

• Excluir – As ações ou validações associadas serão acionadas quando um registro for excluído
• Inserir – As ações ou validações associadas serão acionadas quando um registro for inserido
• Salvar – As ações ou validações associadas serão acionadas quando um registro for salvo
• Atualização – As ações ou validações associadas serão acionadas quando um registro for atualizado

Opções de Detalhes do Evento¶

A seção a seguir descreve informações que podem ser configuradas para um Evento:

• Informações sobre o evento:

  • Nome: O nome usado para definir o evento.

  • Atualizar escopo:

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

    • Global: O evento pode afetar outros objetos de dados, recarregar 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.

• Mensagens:

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

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

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

• Propriedades de execução:

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

  • 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 (Background): O evento será executado em segundo plano quando invocado ou agendado.

    • Lançamento via Agendamento (Background): O evento será executado em segundo plano quando agendado.

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

    • Simultaneidade máxima: Número máximo de eventos simultâneos.

    • Bloqueio: (Para eventos chamados por ações de evento.) Se selecionado, o Vinyl aguarda a conclusão do evento antes de processar ações adicionais. (Desde Vinyl 3.3.x.)

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

    • Horário de funcionamento:

      • Pausar Execução: Hora de pausar a programação.

      • Retomar Execução: Hora de retomar a programação.

• Bloqueio:

  • Use Lock – ativa o bloqueio de eventos. Tenha cuidado com esta opção, consulte Simultaneidade e bloqueio de eventos

Eventos Personalizados¶

Além dos Eventos Intrínsecos disponíveis no Vinyl, você pode definir Eventos Personalizados que podem ter Ações ou Validações associadas a eles. Eventos personalizados podem ser acionados a partir 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 lógica de negócios e/ou na camada de dados. A prática recomendada é configurar quaisquer eventos na camada de dados, a menos que haja um motivo comercial para configurá-los na camada de lógica de negócios. As razões são discutidas neste artigo.

Camada de Dados¶

É mais rápido, fácil e simples manter e utilizar 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ê está configurando ações ou validações em eventos intrínsecos que deseja executar apenas em páginas específicas definidas
• A Ação/Validação associada requer vinculação que não está na Tabela

Por ambos os motivos listados acima, você preferiria configurar o evento na camada de lógica de negócios.

Para configurar um evento na camada de dados

As etapas a seguir descrevem onde navegar no Vinyl para 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 UI do aplicativo após esta etapa.

1. Navegue até 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 de 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 as informações adicionais necessárias 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 apenas em páginas específicas definidas.
• A Ação/Validação associada requer vinculação que não está na Tabela.

Configurar um evento em um objeto de negócios permite ignorar o pai (o objeto de dados).

Para configurar um evento na camada de lógica de negócios

As etapas a seguir descrevem onde navegar no Vinyl para configurar o evento na camada de lógica de negócios. Os eventos normalmente exigem que uma regra de negócios seja criada antes desta etapa e que você conecte o evento à camada de UI do aplicativo após esta etapa.

1. Navegue até App Workbench
2. Clique em Regras
3. Localize a Regra de Negócio 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 clique em Criar e Registrar no painel Ações ou Validações (dependendo do tipo de Evento 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 as informações adicionais necessárias e clique em Salvar.