Las acciones permiten a los usuarios interactuar con la aplicación para cambiar la dirección del cliente, añadir un nuevo contacto y modificar una imagen.
En el lenguaje 4D, una acción permite añadir, editar y eliminar una entidad o una selección de entidades. Pero también, puede simplemente ejecutar un método de su servidor 4D.
Por qué una acción
Puede que se pregunte por qué debe definir una acción para efectuar operaciones simples tales como añadir, editar o borrar.
Recuerde que un dispositivo móvil puede estar desconectado y funcionar sin conexión a Internet. Al volver a conectarse a la red, el dispositivo móvil realiza la sincronización de datos. Pero, mientras tanto, el registro puede haber sido modificado por otra persona o, en un ejemplo profesional, un artículo puede estar agotado, un pago ya recibido, etc.
Por tanto, una acción permite que su lógica de negocio sea coherente y se pueda verificar. Antes de ejecutar la acción en el servidor 4D, puede comprobar si es válida y considerar otra solución, o rechazar la acción e informar al usuario móvil.
Definir su primera acción
En este tutorial, veremos como tratar una acción simple para cambiar el estado y el porcentaje de avance.
Hemos preparado el método base ‘On Mobile App Action’ y los métodos 4D como ‘modifyStatus’ llamados por el método base. En el vídeo, añada una acción en el proyecto para modificar una entidad o una selección de entidades, y le mostraremos cómo vincularlas al método base.
Uso de parámetros de acción
En este tutorial, vamos a ir más allá y crear acciones con los parámetros:
- una acción Add para crear una nueva tarea,
- una acción Edit que le permitirá modificar las tareas existentes desde la aplicación,
- una acción Delete para eliminar una entidad.
Y seguiremos paso a paso la modificación de una entidad.
Acciones fuera de línea
Un usuario de la aplicación puede modificar un registro en cualquier lugar, incluso cuando trabaja sin conexión. Todas estas tareas se colocan en la lista de las acciones pendientes hasta que se pueda acceder a la red. Una vez el usuario esté en línea, todas las acciones pendientes se sincronizan de forma coherente, se ejecutan y, a continuación, son visibles en la lista de acciones completadas.
Acciones rechazadas
Los usuarios móviles pueden rechazar una acción enviada al servidor por cualquier motivo. Por ejemplo, puede deberse a que los parámetros de la acción enviada no corresponden con los valores esperados del lado del servidor.
En ese caso, puede enviar una respuesta a los usuarios de su aplicación, indicándoles que algo ha salido mal en el servidor mediante las propiedades statusText y error. A continuación, el usuario actualiza la tarea pendiente y vuelve a enviar la acción.
LUEGO…
¡Listo! Ahora ya sabe cómo añadir, modificar o eliminar una entidad o selección de entidades en su aplicación móvil. También sabe que puede llamar a un método 4D para enviar un correo electrónico, por ejemplo.
Para ir más lejos, puede continuar con el blog o la documentación.