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 essa funcionalidade, 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

Activities in the Do block execute against the fields of the form, both reading and writing data. These activities are triggered any time a button is clicked or, optionally, when the form is opened. While activities are being executed, the form remains open and editable for the end-user.

Ativando o Bloco Do

To trigger the activities in the Do block of the form, use buttons.

By default, a button triggers the Do loop and then closes the form.

To trigger the Do loop and keep the form open with refreshed values, add a custom property to the Field Key tab on the desired button with the key-value pair closeOnSubmit-false.

To see which button was used on a form, parse the SelectedButton property of the output object.

Atualizando valores de formulário

Values on the form can be updated by changing the corresponding variables within the Do block.

Tutorial

Vamos criar um formulário simples contendo dois componentes: Nome de usuário e Cidade:

1. Drag and drop the Create Form activity in your sequence workflow.

2. Open the Variables panel and create two global variables, one for each component.

   

3. In the FormFieldsCollection property of the Create Form activity, add an In/Out argument of type String for each component, and reference them to the previously created global variables. In this way, the components are autogenerated in the form.

   

   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. Drag and drop a Button component.

6. Navegue até a guia Chave do campo do componente de botão. Em Propriedades personalizadas, adicione closeOnSubmit como Chave e defina o Valor como false. Preste atenção no nome que você definiu para a chave de campo. Esse nome é usado para associar o componente no formulário e diferencia maiúsculas de minúsculas. Após a criação desse botão, você pode 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 no qual o usuário comercial clica, crie uma variável para armazená-la: no painel Propriedades da atividade Create Form > categoria Output > campo SelectedButton , clique em Criar variável para o botão. Como alternativa, use o atalho do 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 , faça referência a eles 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. Drag and drop the If activity in the Do block of the Create Form activity.

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 :

    • In the If activity > Then section, drag and drop the Assign activity.
    • In the To field of the Assign activity, enter the global variable used to reference the Username field of the form.
    • In the Value field, enter "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 ter uma referência futura, baixe o exemploarquivado