Compartilhar via


Lidar com formulários personalizados

Depois de criar um formulário personalizado, é comum verificar qual botão é pressionado e lidar com os dados coletados adequadamente.

Para se familiarizar com essa funcionalidade, crie um novo formulário personalizado contendo os seguintes elementos:

  • Uma entrada de texto com ID Nome que armazena o nome de um cliente
  • Uma entrada de texto com ID LastName que armazena o sobrenome de um cliente
  • Uma ação de envio com a ID Salvar
  • Uma ação de envio com a ID Cancelar e a opção Ignorar entradas fornecidas habilitada.

Captura de tela dos elementos adicionados no designer de formulários personalizados.

O objetivo do fluxo é verificar qual ação de formulário é pressionada. Quando a ação Salvar for pressionada, o fluxo armazenará os dados coletados em uma planilha do Excel. Quando a ação Cancelar for pressionada, o fluxo será interrompido e retornará um erro.

Como implementar este comportamento:

  1. Implantar uma ação Se e verifique se a variável ButtonPressed contém o valor Salvar.

    Captura de tela da ação

  2. Dentro do bloco "Se", inicie uma planilha do Excel. Para este exemplo, a planilha deve conter duas colunas para o nome e o sobrenome do cliente.

    Captura de tela da ação Iniciar o Excel.

  3. Use a ação Obter primeira coluna/linha livre na planilha do Excel para localizar a primeira linha disponível na planilha.

    Captura de tela da ação Obter primeira coluna/linha disponível na planilha do Excel.

  4. Implante uma ação Gravar em planilha do Excel e escreva o nome do cliente na primeira coluna da primeira linha disponível da planilha.

    Todas as entradas do formulário são armazenadas na variável de objeto personalizado CustomFormData. Para acessar o valor de um elemento específico do objeto personalizado, use a seguinte notação: %CustomFormData['ElementID']%.

    Observação

    Você pode encontrar mais informações sobre objetos personalizados em Tipos de dados avançados

    Captura de tela da ação Gravar na planilha do Excel que grava o nome do cliente.

  5. Use uma segunda ação Gravar em planilha do Excel para escrever o sobrenome do cliente na segunda coluna da primeira linha disponível da planilha.

    Captura de tela da ação Gravar na planilha do Excel que grava o sobrenome do cliente.

  6. Salve e feche o arquivo do Excel usando a ação Fechar o Excel.

    Captura de tela da ação Fechar o Excel.

  7. Adicione uma ação Outro dentro do bloco "Se" e use uma ação Interromper fluxo para interromper o fluxo quando a instrução "Se" for falsa.

    Captura de tela do bloco Outro que interrompe o fluxo.

  8. Ao executar o fluxo da área de trabalho, o formulário exibido será semelhante ao apresentado na captura de tela a seguir:

    Captura de tela do formulário personalizado exibido.