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:
- Campo del formulario: seleccione el campo del formulario que será utilizado 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 provienen del workflow en el que se llenará el formulario.
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 en el que se llenará el formulario.
Después de seleccionar la opción, complete los campos:
- Valor: seleccione el dato de la instancia que se utilizará en la condición. Pueden ser seleccionados datos de la instancia, de la actividad, del usuario solicitante, del cliente solicitante o del iniciador de la instancia.
- 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 (en relación con el año) u obtener el número de la semana que corresponde a la fecha. También es posible agregar días, agregar horas y considerar solo días laborables. 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).
- Operación: están disponibles operaciones que permiten extraer un determinado valor de la fecha (dd/mm/aaaa) y de la hora (hh:mm). 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 (en relación con el año) u obtener el número de la semana que corresponde a la fecha. También es posible extraer las horas (hh) o los minutos (mm) de la hora, convertir la hora en minutos, convertir la hora en segundos, agregar días, agregar horas, considerar solo días laborables y convertir los valores de la fecha y de la hora en texto.
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 de riesgo y control.
- 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 semanas 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. |
| Día laborable | Seleccione esta opción para utilizar en la condición solo los días laborables en el cálculo de fechas. El sistema considera el calendario configurado, sin considerar fines de semana y feriados. | Fecha y Fecha y hora. |
| Agregar días |
Seleccione esta opción para sumar días a la fecha informada en el campo. El cálculo utiliza el calendario del sistema; puede considerar solo los días laborables, conforme la configuración aplicada. El origen del valor para la cantidad de días agregados puede ser un valor fijo o una variable configurada en el formulario. |
Fecha y Fecha y hora. |
| Agregar horas |
Seleccione esta opción para sumar horas al horario informado en el campo. El cálculo respeta la jornada de trabajo definida en el calendario del sistema, permitiendo ajustes precisos de tiempo, según el expediente configurado. El origen del valor para las horas agregadas puede ser un valor fijo o una variable configurada en el formulario. |
Fecha y Fecha y hora. |
| Valor del campo de la tabla | Seleccione esta opción para utilizar el valor del campo de la tabla de la lista avanzada en la condición. | Lista avanzada. |
| Texto |
Seleccione esta opción para utilizar el valor del campo como texto en la condición. Esta operación convierte el dato numérico o de fecha y hora en texto formateado, sin respetar el separador decimal y el número de posiciones decimales configurado para el idioma del usuario. En campos del tipo decimal o fecha y hora, la opción Texto es útil cuando el objetivo es mostrar el valor formateado. Por ejemplo, presentar “0,02” en lugar de “0.02”, o una fecha legible en lugar del número correspondiente al timestamp. Si el valor será utilizado en cálculos, se recomienda mantener la operación como decimal, pero cuando sea necesario mostrar el valor formateado, se debe utilizar la operación Texto. |
Decimal y Fecha y hora. |
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.