Enviar el formulario
El último paso para trabajar con un control Form es enviar las modificaciones. Para ello, vamos a utilizar la función SubmitForm. Esta función a menudo se coloca en un control Botón con la etiqueta Guardar o Enviar. La fórmula para OnSelect es SubmitForm(YourFormName).
Esta función recopila todos los datos que se introduzcan en los controles de las tarjetas de datos y los guardará en el origen de datos del control Form. Cada tarjeta de datos en el control Form tiene una propiedad Update que especifica los datos, en forma de fórmula, que se escribirán en el origen de datos cuando se llama a SubmitForm. Si ha desbloqueado la tarjeta, puede modificar dicha fórmula. Esto no suele ser necesario y solo se hace en circunstancias especiales.
Importante
Cuando comience a modificar las fórmulas de las tarjetas, debe hacer coincidir el tipo de datos que espera el origen o puede recibir un error y es posible que la entrada de datos no se guarde correctamente.
Tras el envío del formulario
El control Form es fácil de usar porque con la invocación de la función SubmitForm los datos se trasladan y el origen de datos se actualiza. El control Form tiene tres propiedades que se procesan después del envío de los datos en función del resultado del envío. Estas propiedades son OnSuccess, OnFailure y OnReset. Además, la propiedad LastSubmit le proporciona un registro de los datos que se enviaron desde el formulario.
Nota
Si desea enviar el formulario para que haga otra cosa, como, por ejemplo, navegar a otra pantalla, agregue la codificación en una de estas tres propiedades del formulario. No agregue ningún código adicional a cualquier botón, icono o función que invoque la acción SubmitForm.
Para cada una de estas propiedades, puede escribir una fórmula. Por ejemplo, si desea que el usuario vaya a otra pantalla después de que los datos se envíen correctamente, en OnSuccess debe usar la función Navigate(SuccessScreen, ScreenTransition.Cover) para enviarlos a la pantalla denominada SuccessScreen.
Propiedad OnFailure
Use la propiedad OnFailure si se produce un error al enviar los datos. Puede utilizar una fórmula para especificar un mensaje de advertencia que aparecerá cuando se produzca el error. La fórmula siguiente es un ejemplo del uso de la función Notify para proporcionar más información al usuario.
Notify("Your data was not saved. Please try again or contact an administrator.", NotificationType.Error)
Esta función mostraría una advertencia de color rojo en la parte superior de la pantalla con el mensaje "No se han guardado los datos. Vuelva a intentarlo o póngase en contacto con un administrador". Este mensaje facilita que el usuario resuelva el problema.
Propiedad OnReset
Use la propiedad OnReset si se restablece el formulario. Se produce un restablecimiento del formulario cuando se utiliza la función ResetForm. La función ResetForm establece el formulario en sus valores predeterminados y luego ejecuta cualquier fórmula especificada en la propiedad OnReset. Un ejemplo podría ser si deseara restablecer un control Variable o Temporizador que se usa junto con la interacción con el formulario.
Propiedad LastSubmit
Después de que el formulario se envíe correctamente, puede hacer referencia directamente al registro enviado. El último registro enviado está disponible con la propiedad LastSubmit que contiene el registro completo. Puede obtener acceso al registro mediante la fórmula FormName.LastSubmit (sustituya el nombre del formulario por FormName). También se puede obtener acceso a un elemento del registro LastSubmit mediante la inserción de un control Etiqueta en la aplicación y luego con una fórmula, como, por ejemplo: FormName.LastSubmit.ID que devuelve la propiedad ID del último registro enviado. Comprender cómo funciona LastSubmit es eficaz cuando empiece a compilar los datos relacionales en los que necesita saber el valor de un envío de formulario anterior.
En la próxima unidad veremos algunas propiedades especiales y útiles del control Form.