Atualização de dados do formulário

Clicking buttons in forms usually triggered the execution of the Do block. A new functionality called Use for Local Update is available for the Click action of a Button component. It allows you to update the form without executing the Do block.

Tutorial

O próximo tutorial explica como criar botões para navegar entre várias páginas de um formulário.

1. Open the Form Designer from the Create Form activity.

2. Drag and drop several Panel components or any other components of your choice. In this example, each panel component represents a different page of the form, collecting different information.

3. Drag and drop a Hidden component (from the Data category). This is used to track the current panel number.

   Para este exemplo, defina o Rótulo do componente como StepId. Por padrão, o nome da Chave de campo é definido como stepId.

   

4. Navegue até cada componente do Painel > guia Condicional e defina as condições para exibir o painel. Neste exemplo, cada painel é exibido apenas quando o stepId é igual ao número do painel. Para alcançar isto:

   • Na seção Condições simples > campo Este componente deve exibir , selecione True.

   • No campo Quando o componente do formulário , selecione StepId.

   • No campo Tem o valor , insira o número do painel (por exemplo, primeiro painel —1, segundo painel —2, e assim por diante).

     

5. Inside each Panel component, drag and drop Button components, as follows:

   • For the first panel, add one Button component to navigate to the second panel (e.g, Next Step).
   • For the last panel, add one Button component to navigate to the previous panel (e.g., Prev Step).
   • For the in-between panels, add two Button components: one to navigate to the previous panel, and one to navigate to the next one.

6. Navigate to each button Display tab. Set the button Action to Click. The Use for Local Update checkbox is displayed. This is the feature that allows the navigation between form panels on button click, without executing the Do block.

7. Check the Use for Local Update box. The Update Data Logic code editor is displayed.

8. Use o fragmento de JavaScript predefinido e insira os dados que você deseja atualizar entre as chaves. Certifique-se de usar os nomes de Chave de Campo dos componentes do formulário que você deseja atualizar (aquelas definidas na etapa 3). O fragmento de JavaScript tem o seguinte modelo: instance.emit('updateData', {[field_key_name]:[field_key_update_value]});, onde [field_key_name] representa a chave de campo do componente e [field_key_update_value] representa o novo valor para o componente. Para este exemplo, use os seguintes fragmentos:

   • Para botões Next Step instance.emit('updateData', {stepId:X});, e substitua X pelo número do próximo painel (por exemplo, para o botão no segundo painel, use instance.emit('updateData', {stepId:3});)
   • Para botões Prev Step instance.emit('updateData', {stepId:Y});, e substitua Y pelo número do painel anterior (por exemplo, para o botão no segundo painel, use instance.emit('updateData', {stepId:1});)

Fluxo de trabalho amostral

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