Enviar o formulário
A última etapa ao trabalhar com um controle Form é enviar as edições. Para isso, usamos a função SubmitForm. Essa função geralmente é colocada em um controle Botão rotulado como Salvar ou Enviar. A fórmula para OnSelect é SubmitForm(YourFormName).
Essa função usará todos os dados inseridos nos controles dos cartões de dados e os salvará na fonte de dados do controle Form. Cada cartão de dados no controle Form tem uma propriedade Update especificando os dados, no formulário de fórmula que será gravado na fonte de dados quando SubmitForm for chamado. A fórmula poderá ser modificada, se você tiver desbloqueado seu cartão. Isso geralmente é desnecessário e feito apenas em circunstâncias especiais.
Importante
Quando você começa a modificar as fórmulas do cartão, precisa corresponder ao tipo de dados que a fonte espera, ou pode receber um erro, e a entrada de dados pode não ser salva corretamente.
Após enviar o formulário
O controle Form é fácil de usar porque, com a invocação da função SubmitForm, os dados são removidos e a fonte de dados é atualizada. O controle Form tem três propriedades que são processadas depois que os dados são enviados com base no resultado do envio. Essas propriedades são OnSuccess, OnFailure e OnReset. Além disso, a propriedade LastSubmit fornece um registro de quais dados foram enviados do formulário.
Observação
Se você deseja enviar o formulário para fazer algo diferente, como navegar para outra tela, adicione a codificação em uma dessas três propriedades de formulário. Não adicione código a qualquer botão, ícone ou função que invoque a ação SubmitForm.
É possível inserir uma fórmula para cada uma dessas propriedades. Por exemplo, se você quiser que o usuário vá para uma tela diferente depois que seus dados forem enviados com sucesso, em OnSuccess, você usaria a função Navigate(SuccessScreen, ScreenTransition.Cover) para enviá-los à tela chamada SuccessScreen.
Propriedade OnFailure
Use a propriedade OnFailure se não houver erros quando os dados forem enviados. Você pode usar uma fórmula para especificar uma mensagem de aviso que será exibida quando a falha ocorrer. A fórmula a seguir é um exemplo de como usar a função Notify para fornecer mais informações ao usuário.
Notify("Your data was not saved. Please try again or contact an administrator.", NotificationType.Error)
Essa função exibiria um aviso vermelho na parte superior da tela com a mensagem "Seus dados não foram salvos. Tente novamente ou entre em contato com um administrador." Esta mensagem facilita a resolução do problema pelo usuário.
Propriedade OnReset
Use a propriedade OnReset se o formulário for redefinido. Uma redefinição de formulário ocorre quando a função ResetForm é usada. A função ResetForm define o formulário com seus valores padrão e, em seguida, executa qualquer fórmula especificada na propriedade OnReset. Um exemplo seria se você quisesse redefinir um controle Variável ou Temporizador usado com a interação com o formulário.
Propriedade LastSubmit
Depois que seu formulário for enviado com sucesso, você poderá consultar diretamente o registro enviado. O último registro enviado fica disponível com a propriedade LastSubmit que contém o registro inteiro. Você pode acessar o registro usando a fórmula FormName.LastSubmit (substitua o nome do formulário por FormName). Você também pode acessar um elemento do registro LastSubmit inserindo um controle Rótulo no aplicativo e usando uma fórmula como: FormName.LastSubmit.ID que retorna a propriedade ID do último registro enviado. Compreender LastSubmit é um conceito poderoso quando você começa a criar dados relacionais em que precisa saber o valor de um envio de formulário anterior.
Na próxima unidade, discutiremos algumas propriedades especiais valiosas do controle Form.