Formulários em tempo real

O recurso Formulários em tempo real permite modificar valores no formulário que você está usando sem fechar o formulário. Isso significa que as variáveis vinculadas aos campos do formulário que você está usando podem ser facilmente modificadas sem a necessidade de fechar o fluxo de trabalho e executá-lo novamente.

Para aproveitar esse recurso, arraste e solte as atividades desejadas dentro do bloco Do da atividade Create Form . Configure os campos e botões no formulário para serem vinculados às atividades no bloco Do.

Usando formulários em tempo real

As atividades no bloco Do são executadas nos campos do formulário, lendo e gravando dados. Essas atividades são acionadas sempre que um botão é clicado ou, opcionalmente, quando o formulário é aberto. Enquanto as atividades estão sendo executadas, o formulário permanece aberto e editável para o usuário final.

Ativando o Bloco Do

Para acionar as atividades no bloco Do do formulário, use os botões.

Por padrão, um botão aciona o loop Do e fecha o formulário.

Para acionar o loop Do e manter o formulário aberto com valores atualizados, inclua uma propriedade customizada na guia Chave de campo no botão desejado com o par chave-valor closeOnSubmit-false.

Para ver qual botão foi usado em um formulário, analise a propriedade BotãoSelecionado do objeto de saída.

Atualizando valores de formulário

Os valores no formulário podem ser atualizados alterando as variáveis correspondentes no bloco Do.

Tutorial

Vamos criar um formulário simples contendo dois componentes: Username e City:

1. Arraste e solte a atividade Criar formulário em seu fluxo de trabalho de sequência.

2. Abra o painel Variáveis e crie duas variáveis globais, uma para cada componente.

   
   

   

   
   

3. Na propriedade ColeçãoDeCamposDoFormulário da atividade Create Form , adicione um argumento In/Out do tipo String para cada componente e referencie-os às variáveis globais criadas anteriormente. Dessa maneira, os componentes são gerados automaticamente no formulário.

   
   

   

   
   
   Para usar o recurso Formulários em tempo real, crie botões no formulário que não fecham o formulário quando clicados (por exemplo, um botão de atualização):
4. Abra o Designer de formulário.
5. Arraste e solte um componente Button .
6. Navegue até a guia Chave de Campo do componente do botão. Em Propriedades personalizadas, adicione closeOnSubmit como uma Chave e defina o Valor como false.

   Preste atenção ao nome que você definiu para a chave de campo. Esse nome é usado para ligar o componente no formulário e diferencia maiúsculas de minúsculas.

   Depois que esse botão for criado, você poderá usar atividades como If para alterar valores em tempo real no formulário ou no banco de dados por trás do formulário.
7. Para rastrear o botão em que o usuário empresarial clica, crie uma variável para armazená-lo: No painel Propriedades da atividade Criar formulário > categoria Saída > campo SelectedButton , clique em Criar variável para o botão. Como alternativa, use o atalho de teclado CTRL + K para criar a variável. A variável também é adicionada ao painel Variáveis do fluxo de trabalho de sequência.
8. Nomeie sua variável de botão (por exemplo, btn).
   
   

   

   
   
   Para usar botões específicos de formulário na atividade If , referencie-os usando a expressão btn = " ... " . Certifique-se de usar a sintaxe correta, dependendo da linguagem de programação escolhida (C# ou VB.NET).

   Neste exemplo, para monitorar o botão Atualizar no formulário.

9. Arraste e solte a atividade If no bloco Do da atividade Create Form .
10. No campo Condição , insira a expressão: btn = "{button_field_key_name}" se estiver usando VB.NET e btn == "{button_field_key_name}" se estiver usando C#. Substitua o valor {button_field_key_name} por aquele que você definiu na etapa 6.

    Posteriormente, você pode criar regras para essa condição.

    Por exemplo, quando o botão Atualizar for clicado, você deseja exibir Database Updated no campo Nome de usuário :
    • Na seção Se atividade > Então , arraste e solte a atividade Atribuir .
    • No campo Para da atividade Atribuir , insira a variável global usada para referenciar o campo Username do formulário.
    • No campo Valor , digite "Database Updated".
      
      

      

      
      

    A execução do formulário agora permite que você faça alterações em tempo real, sem precisar fechar e reabrir o formulário.

Fluxo de trabalho amostral

Para verificar o fluxo de trabalho completo ou para ter uma referência futura, baixe o exemploarquivado