Crear funciones
 |
 |
 |
 |
Prerrequisitos
- Acceso al menú Registro > Formulario (FO005).
- Formulario adaptativo previamente registrado y modelado.
Introducción
Las funciones se utilizan para manipular y buscar valores en el formulario. Pueden asociarse a las reglas y expresiones aplicadas a los campos del formulario, así como asociarse a otras funciones.
Las funciones permiten redondear valores en un campo decimal, cambiar el texto incluido en un campo de minúsculas a mayúsculas, agregar días a campos de fecha, etc.
Como el estudio de caso se basa en un formulario de solicitud de viaje, para ejemplificar el uso de funciones, se creará y aplicará una función para que el nombre del solicitante se llene automáticamente con el nombre del usuario conectado en el sistema.
Vea cómo crear y aplicar la función:
Crear una función
• Para obtener más detalles sobre la creación de las reglas, consulte el artículo Configurar reglas en el formulario adaptativo.
• Para obtener más información sobre la asociación y el llenado del formulario en las actividades del proceso, consulte los artículos Asociar un formulario a la actividad de proceso y Llenar un formulario durante la ejecución de la actividad.
Opciones disponibles para el origen del valor
Campo del formulario
Permite utilizar el valor de un determinado campo del formulario en la condición.
Es posible verificar si el campo ha sido llenado o comparar el valor del campo con otro valor, que puede ser un valor fijo o el valor de otro campo del formulario.
Después de seleccionar la opción, complete los campos:
- Valor: seleccione el campo del formulario que se utilizará en la condición. Todos los campos del formulario que se pueden llenar estarán disponibles para su selección.
- Operación: si es necesario refinar o extraer una parte del valor del campo del formulario para utilizarlo en la condición, seleccione una operación. Las opciones de operación varían según el tipo de valor del campo de formulario.
Variable
Permite utilizar una variable de la tabla en la condición.
Después de seleccionar la opción, complete los campos:
- Valor: seleccione la variable que se utilizará en la condición. Todas las variables registradas en la tabla estarán disponibles para su selección.
- Operación: las opciones de operación varían según el tipo de valor de la variable de la tabla del formulario.
Expresión
Permite utilizar una expresión del formulario en la condición.
Después de seleccionar la opción, complete los campos:
- Valor: seleccione la expresión que se utilizará en la condición. Todas las expresiones registradas en el formulario estarán disponibles para su selección.
- Operación: las opciones de operación varían según el tipo de valor de la expresión del formulario.
Función
Permite utilizar una función del formulario en la condición.
Después de seleccionar la opción, complete los campos:
- Valor: seleccione la función que se utilizará en la condición. Todas las funciones registradas en el formulario estarán disponibles para su selección.
- Operación: las opciones de operación varían según el tipo de valor de la función del formulario.
Datos del usuario
Permite utilizar los datos del usuario para la condición. Los datos del usuario son provenientes del workflow donde el formulario será llenado.
Después de seleccionar la opción, complete los campos:
- Valor: seleccione el dato del usuario que se utilizará en la condición. Los datos disponibles para selección son: matrícula, nombre, área o función del usuario.
- Operación: están disponibles operaciones para manipular el valor del tipo Texto proveniente de los datos del usuario.
Datos de la instancia del proceso
Permite utilizar los datos de la instancia en la condición. Los datos de la instancia son provenientes del workflow donde el formulario será llenado.
Después de seleccionar la opción, complete los campos:
- Valor: seleccione el dato de la instancia que se utilizará en la condición. Los datos disponibles para selección son: identificador, título, descripción, situación, prioridad, datos de la actividad, datos del solicitante o del iniciador de la actividad.
- Operación: están disponibles operaciones para manipular el valor del tipo Texto proveniente de los datos de la instancia.
Datos de la tabla relacionada
Permite utilizar los datos de la tabla relacionada para la condición.
Después de seleccionar la opción, complete los campos:
- Tabla: seleccione la tabla donde se buscará la información.
- Campo de la tabla: seleccione el campo de la tabla donde se buscará la información.
- Operación: están disponibles operaciones para manipular los valores provenientes del campo de la tabla.
Fecha
Permite utilizar la fecha actual (hoy) en la condición.
Después de seleccionar la opción, complete los campos:
- Valor: la condición podrá utilizar la fecha de hoy (dd/mm/aaaa).
- Operación: están disponibles operaciones que permiten extraer un determinado valor de la fecha (dd/mm/aaaa). Es posible extraer el día (dd), el mes (mm) o el año (aaaa) de la fecha, obtener el día de la semana de la fecha (con relación al año) u obtener el día de la semana que corresponde a la fecha. Tenga en cuenta que todos los valores obtenidos con las operaciones serán valores del tipo Entero.
Hora
Permite utilizar la hora actual en la condición.
Después de seleccionar la opción, complete los campos:
- Valor: la condición podrá utilizar la hora actual (hh:mm).
- Operación: están disponibles operaciones que permiten extraer un determinado valor de la hora (hh:mm). Es posible extraer las horas (hh) o los minutos (mm) de la hora, convertir la hora a minutos o convertir la hora a segundos. Tenga en cuenta que todos los valores obtenidos con las operaciones serán valores del tipo Entero.
Fecha y hora
Permite utilizar la fecha y la hora actual en formato de texto en la condición.
Después de seleccionar la opción, complete los campos:
- Valor: la condición podrá utilizar la fecha (dd/mm/aaaa) y la hora actual (hh:mm).
Geolocalización
Permite utilizar los datos de geolocalización en la condición.
Después de seleccionar la opción, complete los campos:
- Valor: la condición podrá utilizar la longitud (grados) o la latitud (grados).
- Operación: están disponibles operaciones que permiten almacenar los valores de latitud y longitud. Estos valores pueden almacenarse en campos del formulario y usarse en las integraciones con APIs de mapas.
Riesgo
Permite utilizar los datos del riesgo en la condición.
Después de seleccionar la opción, complete los campos:
- Valor: la condición podrá utilizar datos provenientes del plan de riesgo, del riesgo, del control, de la oportunidad y de la evaluación del riesgo.
- Operación: están disponibles operaciones que permiten manipular el valor del tipo Texto, Entero o Decimal proveniente de los datos del riesgo.
Operaciones
Operaciones disponibles para selección
| Operación | Descripción | Campos |
| Mayúscula | Seleccione esta opción para utilizar el texto del campo en mayúsculas en la condición. | Texto, Párrafo, Grupo de opciones y Lista simple. |
| Minúscula | Seleccione esta opción para utilizar texto de campo en minúsculas en la condición. | Texto, Párrafo, Grupo de opciones y Lista simple. |
| Quitar espacios | Seleccione esta opción para utilizar el texto del campo sin espacios entre las palabras en la condición, si corresponde. | Texto, Párrafo, Grupo de opciones y Lista simple. |
| Año | Seleccione esta opción para utilizar en la condición únicamente el año (aaaa) de la fecha (dd/mm/aaaa) introducida en el campo. Por ejemplo, si el valor introducido es 31/12/2023, la condición utilizará el valor 2023. | Fecha. |
| Mes | Seleccione esta opción para utilizar en la condición únicamente el mes (mm) de la fecha (dd/mm/aaaa) introducida en el campo. Por ejemplo, si el valor introducido es 31/12/2023, la condición utilizará el valor 12. | Fecha. |
| Día | Seleccione esta opción para utilizar en la condición únicamente el día (dd) de la fecha (dd/mm/aaaa) introducida en el campo. Por ejemplo, si el valor introducido es 31/12/2023, la condición utilizará el valor 31. | Fecha. |
| Día de la semana | Seleccione esta opción para utilizar en la condición el día de la semana de la fecha informada en el campo. Los días de la semana se devolverán como números para la condición, comenzando el conteo por el lunes, o sea, lunes es 1, martes es 2, miércoles es 3, jueves es 4, viernes es 5, sábado es 6 y domingo es 7. | Fecha. |
| Número de la semana | Seleccione esta opción para utilizar el número de semana en relación con el año en la condición. Por ejemplo, 40 indica que la fecha se encuentra en la semana 40 del año. El conteo de la semana comienza el lunes, es decir, para el sistema una semana es de lunes a domingo. | Fecha. |
| Denegar | Seleccione esta opción si es necesario denegar el valor para utilizarlo en la condición. Por ejemplo, si el valor está marcado (verdadero), la condición utilizará el valor desmarcado (falso). | Checkbox. |
| Módulo | Seleccione esta opción para utilizar en la condición el módulo del número informado en el campo. Por ejemplo, si el valor introducido es -10, la condición utilizará el valor 10, es decir, |-10| = 10. | Decimal y Entero. |
| Raíz cuadrada | Seleccione esta opción para utilizar en la condición la raíz cuadrada del número informado en el campo. Por ejemplo, si el valor introducido es 25, la condición utilizará el valor 5, es decir, √25 = 5. | Decimal y Entero. |
| Factorial | Seleccione esta opción para utilizar en la condición el factorial del número informado en el campo. Por ejemplo, si el valor introducido es 5, la condición utilizará el valor 120, es decir, ¡5! = 5 * 4 * 3 * 2 * 1 = 120. | Decimal y Entero. |
| Redondear por encima | Seleccione esta opción para utilizar en la condición el valor entero redondeando por encima del número informado en el campo. Por ejemplo, si el valor introducido es 7,1, la condición utilizará el valor 8. | Decimal. |
| Redondear por debajo | Seleccione esta opción para utilizar en la condición el valor entero redondeando por debajo del número informado en el campo. Por ejemplo, si el valor introducido es 7,9, la condición utilizará el valor 7. | Decimal. |
| Redondear | Seleccione esta opción para utilizar en la condición el valor redondeado del número informado en el campo. Por ejemplo, si el valor introducido es 7,4, la condición utilizará el valor 7, pero si el valor introducido es 7,6, la condición utilizará el valor 8. | Decimal. |
| Truncar | Seleccione esta opción para utilizar en la condición solo la parte entera del número informado en el campo. Por ejemplo, si el valor introducido es 42,22, la condición utilizará el valor 42. | Decimal. |
| Horas | Seleccione esta opción para utilizar en la condición únicamente las horas (hh) del formato (hh:mm) informado en el campo. Por ejemplo, si el valor introducido es 15:26, la condición utilizará el valor 15. | Hora. |
| Minutos | Seleccione esta opción para utilizar en la condición únicamente los minutos (mm) del formato (hh:mm) informado en el campo. Por ejemplo, si el valor introducido es 15:26, la condición utilizará el valor 26. | Hora. |
| Convertir a minutos | Seleccione esta opción para utilizar el valor de hora ingresado en el campo convertido a minutos en la condición. | Hora. |
| Convertir a segundos | Seleccione esta opción para utilizar el valor de hora ingresado en el campo convertido a segundos en la condición. | Hora. |
| Traducción automática | Seleccione esta opción para traducir el texto insertado en el campo. | Texto, Párrafo, Grupo de opciones y Lista simple. |
Conclusión
¡Eso es todo! Ahora, usted ya sabe cómo crear funciones en el formulario. Vea cómo configurar expresiones y reglas en el formulario adaptativo.