Associando Fluxos aos Eventos

Manual do Maker 2

Associando Fluxos aos Eventos

O fluxo pode ser associado aos Eventos dos Componentes ou ao Objeto Formulário.

Para associar um fluxo ao Evento, clique com o botão direito do mouse sobre o componente do formulário (ou na área do formulário) e pelo menu pop-up, selecione o Evento. Se a versão do Maker que estiver sendo utilizada for inferior à versão 2.5.0.0, aparecerá a tela Ações, caso contrário, aparecerá a tela Definir ações.

A tela Definir Ações possui duas abas: Executar Fluxo e Ação predefinida.

Aba Executar Fluxo

Os componentes pertencentes são:

  • botão criar fluxo - ao clicar neste botão, será aberta a tela Editor de Fluxo de Ações. Após o salvamento do fluxo de ação (tela Editor de Fluxo de Ações), o fluxo será selecionado automaticamente na caixa de seleção Fluxo associado;

  • botão criar fluxo vinculado ao componente - será aberta a tela Editor de Fluxo de Ações sugerindo que o nome do fluxo de ação seja a junção do nome do formulário com a expressão (FLUXO INTERNO). Após o salvamento do fluxo de ação (tela Editor de Fluxo de Ações), a caixa de seleção Fluxo associado ficará desabilitada e mostrará a mensagem "*** Fluxo interno". Fluxos criados com essa opção não poderão ser reutilizados por outros componentes nem serão listados na aba Fluxos do Gerenciador de Objetos, haja vista que sua utilização está restrita ao componente a partir do qual foi criado.

Observação: Ao associar um fluxo interno a um componente, a tela Editor de Fluxo de Ações terá o comportamento de uma tela modal para impedir que o usuário delete o componente antes de salvar o fluxo.

  • a caixa de seleção Fluxo associado - por meio deste componente, é possível a seleção de qualquer fluxo de ação. De imediato, após a seleção do fluxo de ação, aparecerão os parâmetros de entrada do fluxo na Área de Parâmetros de Entrada.
    Para otimizar a localização do nome do fluxo de ação, com o componente selecionado, pressione a tecla F3 para que seja aberta a tela Localizar. Nesta tela é possível executar a pesquisa pelo nome do fluxo de ação de maneira facilitada.

  • botão editar fluxo - ao clicar neste botão, tendo sido selecionado um fluxo de ação na caixa de seleção Fluxo associado anteriormente, será aberta a tela Editor de Fluxo de Ações já com o fluxo em edição;

  • Serão listados na área Parâmetros de entrada do fluxo todos os parâmetros de entrada do fluxo que foi selecionado na caixa de seleção "Fluxo associado". A área contém:

  • uma caixa de seleção (posicionada ao centro da área) titulada com o nome do parâmetro de entrada do fluxo de ação, a qual lista valores filtrados pela caixa de seleção disponível à direita dela.

  • uma caixa de seleção (posicionada à direita da área) contendo as opções:

    • campo - selecionada esta opção, serão disponibilizados os campos contidos nas "Definições do Formulário" ("Assistente SQL");

    • componente - selecionada esta opção, serão disponibilizados os componentes contidos no formulário;

    • constante - selecionada esta opção, é possível a digitação de um valor fixo na área da caixa de seleção citada no tópico anterior.

Observação: Ao clicar no campo Fluxo associado e pressionar a tecla F3, será exibida a tela Localizar. A tela (abaixo) mostrará a relação de todos os fluxos disponíveis no projeto:

localizar

O campo Localizar da tela acima é local no qual são digitadas as iniciais do nome do fluxo que o dispositivo de busca filtrará automaticamente.

Aba Ação Predefinida

definir ações

Os componentes pertencentes são:

  • Campo check Abrir Formulário - marcada esta opção, ficam habilitadas as caixas de seleção Formulário e Modo de abertura. A caixa de seleção Formulário contém a lista de todos os formulários contidos no sistema. Para otimizar a localização do nome do formulário, com o componente Formulário selecionado, pressione a tecla F3 para que seja aberta a tela Localizar. Nesta tela é possível executar a pesquisa pelo nome do formulário de maneira facilitada. Quando clicar no botão (ao lado), tendo sido selecionado anteriormente um formulário na caixa de seleção, o mesmo será aberto;

  • A caixa de seleção Modo de abertura - contém as opções de modo de abertura do formulário no Webrun; são elas:

    • Navegação - o formulário será aberto em modo normal;

    • Edição - o formulário será aberto em modo de edição;

    • Inserção - o formulário será aberto em modo de inserção.

  • O Campo check Abrir relatório - fica permitida a possibilidade de seleção de um relatório na caixa de seleção Relatório;

  • A caixa de seleção Relatório - contém a lista de todos os relatórios contidos no sistema. Para otimizar a localização do nome do relatório, com o componente Relatório selecionado, pressione a tecla F3 para que seja aberta a tela Localizar (citada anteriormente) Nessa tela, é possível executar a pesquisa pelo nome do relatório de maneira facilitada. O botão (ao lado) abre o relatório selecionado para edição. O botão (ao lado), ativará o Assistente de criação de relatório.

Observação: Para abrir ou editar um relatório pela tela, utilize o botão ou o botão , respectivamente.

  • Botão outras ações - ao clicar neste botão, abrirá a tela Ações:

Observações:

  • Ao clicar no campo Nome e pressionar a tecla F3, será exibida a tela Localizar. A tela mostrará a relação de todos os fluxos disponíveis no projeto (funcionalidade explicada anteriormente).

  • As ações Gravar do arquivo para o banco e Gravar do banco para o arquivo não fazem parte da lista para a versão 2.5 do Maker. Essas ações devem ser executadas por Fluxos

Para informações detalhadas sobre Ações do Formulário, clique aqui.

  • Botão remover todas as ações: todas as configurações feitas serão removidas;

  • Botão ok - todas as configurações feitas serão gravadas;

  • Botão cancelar - todas as configurações feitas serão desconsideradas.

A partir da versão 2.6 do Maker é possivel associar fluxos, a formulários e seus componentes através do método Drag and Drop (arrastar e soltar), como demonstra a figura abaixo:

Observações:

  • Quando o fluxo de ação está direcionado para a camada Servidor e vinculado a um componente de um formulário ou ao próprio formulário, não é necessário atualizá-lo quando a aplicação estiver no Modo de Projeto.

  • Não é possível vincular componentes a parâmetros de entrada caso o fluxo seja do tipo Servidor, pois o valor do mesmo não será obtido

  • Ao associar eventos aos componentes do tipo Caixa de Texto, Lista dinâmica e Lista os mesmos são marcados por indicadores, informando que o componente contém um evento, como demonstra a figura abaixo:

____________________________________________________________________________

Caso este tópico não tenha comentário satisfatório, envie e-mail para [email protected]