Actions
Esta sección le permite:
- crear acciones para ejecutar código 4D desde su aplicación iOS.
- definir y añadir parámetros a sus acciones.
En el editor de proyectos
Cree su acción
Puede crear una nueva acción haciendo clic en el botón + en la parte inferior de la tabla Acciones. Aparecerá una nueva línea en la tabla.
A continuación, deberá definir lo siguiente:
- Nombres: define el nombre de la acción a utilizar en el método base On Mobile App Action para lanzar su código 4D.
- Iconos: seleccione un icono para su acción de su librería de iconos. También puede agregar su propio icono siguiendo este tutorial.
- **Etiquetas cortas y largas: **las etiquetas para las acciones que se mostrarán en su aplicación.
- Tabla: seleccione la tabla en la que desea aplicar la acción.
- Alcance: seleccione si desea aplicar la acción en una entidad o en una tabla.
Añada parámetros a su acción
Como en 4D v17R6, puede añadir los parámetros de acción y editar datos directamente desde su aplicación.
Para cada parámetro, puede editar las siguientes propiedades:
- Nombre
- Etiqueta larga
- Etiqueta corta
- Formato
- Restricciones de entrada (definir valores mínimos o máximos)
- Placeholder
- Definición de un campo obligatorio
- Valor por defecto
Puede cambiar el orden de los parámetros con solo arrastrar y soltar.
Estos son los diferentes formatos que puede seleccionar para un parámetro:
| TEXTO | |
|---|---|
| Formato | Descripción |
| Texto | Poner en mayúscula la primera letra de una cadena |
| Correo electrónico | Teclado iOS optimizado para la entrada de correo electrónico |
| Número de teléfono | Teclado iOS para ingresar números de teléfono. |
| Cuenta | Teclado iOS optimizado para la entrada de correo electrónico |
| Contraseña | Optimizado para manejar contraseñas |
| URL | Teclado iOS optimizado para la entrada del URL |
| Código postal | Teclado iOS optimizado para la entrada del código postal |
| Área de texto | Incluye varias líneas de texto en un solo campo |
| Código de barras | Extraer el valor asociado al código de barras. Formatos soportados: EAN8, EAN13, Code 39, Code 93, Code 128, QR Code, UPC, PDF417 |
| NÚMERO | |
| Formato | Descripción |
| Number | Números con décimales |
| Entero | Números sin decimales |
| Científica | Notación científica |
| Porcentaje | Notación en porcentaje |
| Nombre en letras | Convierte los números en cadenas |
| FECHA | |
| Formato | Descripción |
| Fecha | Nov 23, 1937 |
| Fecha corta | 11/23/37 |
| Fecha larga | Noviembre 23, 1937 |
| Fecha completa | Martes, 23 de noviembre 1937 |
| HORA | |
| Formato | Descripción |
| Hora | 3:30 PM |
| Duración | 2 horas 30 minutos |
| BOOLEANO | |
| Formato | Descripción |
| Booleano |  |
| Marca de verificación |  |
| IMÁGENES | |
| Firma | Permitir firmar con el dedo |
Acciones predefinidas
4D for iOS incluye tres acciones (predefinidas) para administrar el contenido de su aplicación:
- Editar
- Acción de añadir
- Acción de eliminar
- Share
- Sort
4D for iOS simplifica al máximo la creación de acciones de adición.
- los parámetros, agregando o eliminando un parámetro utilizando los botones + y - en la parte inferior de la lista de parámetros de acciones.
- las propiedades, definiéndolas como desee.
Acción de añadir
4D for iOS simplifica al máximo la creación de acciones de adición.
Lo único que debe hacer es seleccionar la opción Acción de adición para, accesible desde el **botón + ** en la parte inferior de la tabla Acciones.
Luego seleccione la tabla que quiere asociar a la acción añadir.
Esto creará automáticamente todos los parámetros en el Editor de proyectos. En la aplicación generada, esto le permitirá editar cada valor de campo.
Para ese tipo de acción, verá que todas las propiedades ya están completadas para su conveniencia al lado derecho de la lista de parámetros.
Acción de edición
La creación de acciones de edición sigue el mismo proceso que las acciones de adición, con la excepción de que no podrá definir valores predeterminados desde la sección Acciones.
Acción de eliminación
La creación de **acciones de eliminación ** sigue el mismo proceso que las acciones de edición. La única diferencia es que esta acción le permite eliminar una entidad.
Para crear una acción de eliminación, seleccione la opción Acción de eliminación para, accesible desde el **botón + ** en la parte inferior de la tabla Acciones.
Este tipo de acción debe utilizarse con precaución.
Formularios Lista en tabla
Selecting the Share action will allow your mobile users to share a content with other users. You just need to select the scope:
- Para su comodidad, el formulario de Edición incluye algunas funcionalidades especiales:
- Si ha creado una acción de edición o de adición, tan pronto como la seleccione de la lista de acciones, aparecerá un formulario de edición.
Después de crear todas sus acciones, simplemente haga clic en el botón Crear de la tabla Acciones para generar automáticamente un bloque de código Case of que incluya todos los nombres de sus acciones en el método On Mobile App Action.
Formularios Lista en colección
Un tutorial está disponible para guiarlo a través del proceso de definición de una acción.
- Acciones de tabla: un botón de acciones genéricas está disponible en la barra de navegación para mostrar una lista de acciones de tabla.
- allow your mobile users to choose a list sort order
When you create a sort action for a table, you need to select the first field on which the sort will be done:
The field is added to the Sort Criteria list. An ascending sort order is set by default, but you can change it using the Sort order menu.
You can sort entities in more than one field. Each field you sort is referred to as a sort level. For example, the results of a two-level ascending sort of the lastName and firstName fields would produce a list such as this:
Aardvark, Anthony
Aardvark, Artemis
Aardvark, Arthur
...
Zygote, Elena
Zymosian, Elmer
Para crear una acción de eliminación, seleccione la opción Acción de eliminación para, accesible desde el **botón + ** en la parte inferior de la tabla Acciones.
Sort order menu on the mobile app
When you define more than one sort action for a table, mobile users automatically benefit from a sort menu. It contains all the predefined sort actions:
When only one sort action is defined for a table, the sort menu is not displayed on the mobile app side.
On Mobile App Action
El método base On Mobile App Action está disponible para llamar a todos sus métodos 4D.
Después de crear todas sus acciones, simplemente haga clic en el botón Crear de la tabla Acciones para generar automáticamente un bloque de código Case of que incluya todos los nombres de sus acciones en el método On Mobile App Action.
- Puede refrescar la selección después de ejecutar una acción utilizando
$out.dataSynchro:=True.- Puede notificar al usuario de la aplicación cuando se ha ejecutado una acción utilizando
$out.statusText:="Message you want to display".- También puede decidir forzar el cierre del formulario de edición utilizando
$out.close:=True.
Acciones en modo sin conexión
The user of an iOS app can draft, store and queue action requests, even if he’s working offline (adding a customer's phone number, uploading a picture, printing an invoice or a quote, deleting an address, etc.). All these tasks are placed in the Pending actions list until the network is accessible. Once the user is online, all pending actions are consistently synchronized, executed and then visible in the Completed actions list.
Pending tasks can be visualized and opened from:
• The Settings screen
It displays a summary and a history of all pending and completed tasks.
• The List & Detail forms
They display all the tasks related to the table or to the entity that you are currently viewing.
Notes
- The "Share" predefined action is only executable online.
- Actions are editable while pending, but they can no longer be modified once they switch to the "Completed" mode.
Formularios de edición
Due to your server business logic, some tasks could be rejected. For mobile users, it is then possible to edit and to retry sending the relevant pending tasks. To do so, you can display a status text describing, in the "Complete" actions history, the reason of the failure. For example, you can reject an action sent by a mobile user to the server and inform him that the operation has failed. In that case, you can set the success value to False and provide a message in statusText, as follows:
$response:=New object("success"; False; "statusText"; "Operation failed"))
You can even add some errors by action parameters for the alphaField parameter, for example:
$response.errors:=New collection(New object("parameter"; "alphaField"; "message"; "Alpha field must contains a valide value")
Aplicación iOS
En su aplicación iOS, las acciones están disponibles de diferentes formas en sus formularios listados y detallados, según las plantillas que seleccione en la sección Formularios.
Formularios Lista en tabla
- Acción de entidad: deslice hacia la izquierda en una celda para mostrar las acciones disponibles en un formulario Lista. Se muestra un botón "+" si define más de 3 acciones por entidad.
- Acciones de tabla: un botón de acciones genéricas está disponible en la barra de navegación para mostrar una lista de acciones de tabla.
RECOMENDACIONES
Las acciones se mostrarán en el mismo orden definido en la sección Acción.
Formularios Lista en colección
- Acción de entidad:dependiendo de la plantilla seleccionada, las acciones se muestran al hacer clic en un botón genérico o al mantener el clic en una celda.
- Acciones de tabla: como para los formularios Lista en tablas, hay un botón de acciones genérico disponible en la barra de navegación para mostrar una lista de acciones de tabla.
Formularios detallados
Como para las acciones de tabla en los formularios detallados, un botón de acciones genéricas está disponible en la barra de navegación para mostrar todas sus acciones de entidad en una lista.
Formularios de edición
Si ha creado una acción de edición o de adición, tan pronto como la seleccione de la lista de acciones, aparecerá un formulario de edición.
Desde acá, puede:
- editar todos sus campos seleccionándolos y
- validar o cancelar sus modificaciones con los botones Listo o Cancelar (disponibles en la barra de navegación).
Para su comodidad, el formulario de Edición incluye algunas funcionalidades especiales:
- El tipo de teclado depende del tipo de parámetro seleccionado en la sección Actions.
- Puede ir al campo siguiente o anterior utilizando la flecha en la parte superior del teclado.
- El teclado iOS se puede cerrar tocando cualquier parte fuera de un campo.
- Se le indica al usuario cuando un valor no es válido.
- La vista se centra en los campos obligatorios vacíos cuando el usuario hace clic en el botón Done.