Guía de Diseño
Guía de Diseño
Si tu hoja tiene un Flujo de Aprobación, puedes aplicar las siguientes fórmulas para obtener ciertos valores relacionados con el proceso de aprobación.
Actualmente, se admiten dos tipos de fórmulas de aprobación:
1. Relacionado Con Todo el Flujo de Aprobación
2. Relacionado Con un Paso Específico del Flujo de Aprobación
Para obtener más información y ejemplos de fórmulas de aprobación, consulta esta página.
Para obtener información sobre el recálculo de fórmulas, consulta este artículo.
| Fórmula | Descripción |
|---|---|
| APPROVAL.COUNT() | Devuelve el número de pasos de aprobación. |
| APPROVAL.STATUS() | Devuelve el estado de aprobación.
N: Nuevo, indica que el proceso de aprobación aún no ha comenzado o se ha cancelado. P: En proceso, indica que el proceso de aprobación está en curso y pendiente de finalización. REJ: Rechazado, indica que ha sido rechazado por cualquier aprobador. F: Finalizado, indica que se ha completado cuando todos los aprobadores están de acuerdo. |
| APPROVAL.SUBMITTER() | Devuelve la dirección de correo electrónico del usuario que inicia el proceso de aprobación. Compatible con campos de tipo Seleccionar Usuario. |
| APPROVAL.SUBMITTERNAME() | Devuelve el nombre del usuario que inicia el proceso de aprobación. |
| APPROVAL.SUBMITDATE([true]) | Devuelve la fecha y hora de inicio de un proceso de aprobación. Compatible con Campos de fecha.
El argumento [true] es opcional; al aplicarlo, el valor de la hora se mostrará en UTC+0. De lo contrario, se mostrará en la zona horaria de la cuenta. Para más detalles, consulta esta sección. |
| APPROVAL.FINISHDATE([true]) | Devuelve la fecha y hora de finalización de un proceso de aprobación. Una aprobación finaliza cuando todos los aprobadores la aprueban o cuando uno de ellos la rechaza. Compatible con Campos de fecha.
El argumento [true] es opcional; al aplicarlo, la hora se mostrará en UTC+0. De lo contrario, se mostrará en la zona horaria de la cuenta. Para más detalles, consulta esta sección. |
| Fórmula | Descripción |
|---|---|
| APPROVAL.CURRENTSTEPINDEX | Devuelve el valor del índice que representa el paso actual del proceso de aprobación.
Índice 0 significa que el proceso de aprobación aún no se ha iniciado. Índice 1 significa que el proceso de aprobación se ha iniciado, pero ningún aprobador lo ha aprobado aún. Cada vez que un aprobador aprueba, se añade "1" al índice. Al finalizar el proceso de aprobación (todos aprobados/1 rechazado/cancelados), el índice vuelve a "0". |
Las siguientes fórmulas deben tener como prefijo APPROVAL.STEP([stepIndex]), que indica un paso específico del proceso de aprobación mediante un valor de índice. Esta no es una fórmula independiente, pero puede usarse con otras fórmulas de aprobación. El argumento [stepIndex] es opcional; si no se proporciona, se usará APPROVAL.CURRENTSTEPINDEX como valor predeterminado, representando el paso actual. Los argumentos se explican a continuación:
APPROVAL.STEP(-1): Último paso.
APPROVAL.STEP(): Paso actual. Equivalente a APPROVAL.STEP(APPROVAL.CURRENTSTEPINDEX)).
APPROVAL.STEP(0): Uso incorrecto.
APPROVAL.STEP(1): Primer paso.
APPROVAL.STEP(2): Segundo paso.
| Fórmula | Descripción |
|---|---|
| APPROVAL.STEP([stepIndex]).NAME() | Devuelve el nombre de este paso. |
| APPROVAL.STEP([stepIndex]).STATUS() | Devuelve el estado de este paso.
N: Nuevo, indica que el proceso de aprobación aún no ha comenzado o se ha cancelado. F: Finalizado. Si este paso implica un solo aprobador, indica la aprobación o el rechazo de la solicitud. Si hay varios aprobadores, indica que el número de aprobadores que han dado su aprobación iguala o supera el umbral designado, o que alguien ha rechazado la solicitud. |
| APPROVAL.STEP([stepIndex]).USERS() | Devuelve todos los aprobadores.
P. ej., Ana García|José López|Juan Morales Compatible con Campos de Usuarios de Selección Múltiple. (Dado que actualmente no se pueden aplicar fórmulas a los Campos de Selección Múltiple, configure primero la fórmula y luego seleccione la configuración de Selección Múltiple). |
| APPROVAL.STEP([stepIndex]).UNSIGNEDUSERS() | Devuelve los aprobadores que no aprobaron en este paso. Por ejemplo, Ana García|José López|Juan Morales.
Compatible con Campos de Usuarios de Selección Múltiple. (Dado que actualmente no se pueden aplicar fórmulas a los Campos de Selección Múltiple, configure primero la fórmula y luego seleccione la configuración de Selección Múltiple) |
| APPROVAL.STEP([stepIndex]).SIGNEDUSERS() | Devuelve los aprobadores que ya aprobaron este paso.
P. ej., Ana García|José López|Juan Morales Compatible con Campos de Usuarios de Selección Múltiple. (Dado que actualmente no se pueden aplicar fórmulas a los Campos de Selección Múltiple, configure primero la fórmula y luego seleccione la configuración de Selección Múltiple) |
| APPROVAL.STEP([stepIndex]).ISMULTI() | Devuelve "TRUE" si este paso tiene "múltiples aprobadores".. |
| APPROVAL.STEP([stepIndex]).THRESHOLD() | Devuelve el número de umbral de este paso, o "-1" si este paso solo tiene un aprobador o no se estableció ningún umbral. |
| APPROVAL.STEP([stepIndex]).SIGNEDCOUNT() | Devuelve el número de aprobadores que ya han aprobado este paso. |
En la siguiente fórmula, [email] es un argumento opcional (obligatorio en escenarios específicos) que se puede usar de dos maneras para recuperar los datos de aprobación de una persona específica en un paso de aprobación con múltiples usuarios.
1. Como la cadena de correo electrónico (entre ""), p. ej., APPROVAL.STEP([stepIndex]).RESP("ejemplo@ragic.com")
2. Utilizando directamente el campo de correo electrónico o el campo Seleccionar usuario, por ejemplo, APPROVAL.STEP([stepIndex]).RESP(A2)
Nota:
1. El argumento [email] en la fórmula solo aplica a los pasos de aprobación creados después del 13/07/2021.
2. Cuando una fórmula de aprobación incluye varios argumentos, si el argumento [email] no es necesario, debe introducir null.
Por ejemplo, la siguiente fórmula contiene los argumentos [email] y [true]: APPROVAL.STEP([stepIndex]).ACTIONDATE([email], [true]).
(1) Si no se utiliza el argumento [true], el argumento [email] puede dejarse vacío: APPROVAL.STEP(2).ACTIONDATE().
(2) Si se usa el argumento [true], pero no se necesita el argumento [email], debe ingresar null: APPROVAL.STEP(1).ACTIONDATE(null, true).
Si no se ingresa null, como en: APPROVAL.STEP(1).ACTIONDATE(true), entonces true se confundirá con el argumento [email], lo que provocará un error en la fórmula.
| Fórmula | Descripción |
|---|---|
| APPROVAL.STEP([stepIndex]).RESP([email]) |
Devuelve la respuesta de este paso. (1) Un aprobador en un paso de aprobación: No se requiere el argumento [email]. N: Aún no, lo que indica que este paso aún no se ha aprobado ni rechazado y sigue pendiente de aprobación. A: Aceptado, lo que indica que el aprobador ha aceptado la aprobación. A_D: Aceptado por el delegado, lo que indica que el delegado del aprobador ha aceptado la aprobación. REJ: Rechazado, lo que indica que el aprobador ha rechazado la aprobación. REJ_D: Rechazado por el delegado, lo que indica que el delegado del aprobador ha rechazado la aprobación. (2) Varios aprobadores en un paso de aprobación: Sin el argumento [email]: N: Todavía no, lo que indica que el número de aprobadores que han aceptado la aprobación es menor que el número designado de aprobadores. A: Aceptado, indica que el número de aprobadores que han aceptado la aprobación es mayor o igual al número designado de aprobadores. REJ: Rechazado, indica que alguien ha rechazado la aprobación. Con el argumento [email]: unsigned: El aprobador aún no ha aceptado ni rechazado la aprobación. firmado: El aprobador ha aceptado la aprobación. signed_by_deputy: La aprobación ha sido aceptada por el delegado del aprobador. rejected: El aprobador ha rechazado la aprobación. rejected_by_deputy: La aprobación ha sido rechazada por el delegado del aprobador. Para conocer los detalles del argumento del correo electrónico, consulta aquí. |
| APPROVAL.STEP([stepIndex]).COMMENT([email]) | Devuelve los comentarios del/de los aprobador(es), o nulo si no hay comentarios.
(1) Un aprobador en un paso de aprobación: No se requiere el argumento [email]. Devuelve el comentario del aprobador. (2) Varios aprobadores en un paso de aprobación: Se requiere el argumento [email]. Devuelve el comentario de un aprobador específico. Para obtener más información sobre el argumento de correo electrónico, consulta aquí. |
| APPROVAL.STEP([stepIndex]).SIG([email]) | Devuelve la firma del aprobador en este paso.
Por ejemplo, URL de imagen base64. Compatible con Campos de imagen adjunta. (1) Un aprobador en un paso de aprobación: No se necesita el argumento [email]. Devuelve la firma del aprobador en este paso. (2) Varios aprobadores en un paso de aprobación: El argumento [email] es obligatorio. Devuelve la firma de un aprobador específico. Para obtener detalles sobre los argumentos de correo electrónico, consulta aquí. |
| APPROVAL.STEP([stepIndex]).SIGIMG([email], [width], [height]) | Devuelve la firma del aprobador en este paso en un tamaño de imagen predeterminado. Los argumentos [ancho] y [alto] son opcionales; los valores predeterminados son 300 px x 150 px. Esta fórmula se puede aplicar a las descripciones de campo con BBCode [fórmula].
Nota: 1. Para devolver una firma para un solo aprobador en un proceso de aprobación con dimensiones de 600 px de largo y 300 px de ancho, utilice APPROVAL.STEP([stepIndex]).SIGIMG(null, 600, 300), donde null no debe estar entre " ". 2. El tipo de campo no puede ser un campo de imagen/firma; debe ser un campo de texto (por ejemplo, Texto libre). Para conocer los detalles del argumento del correo electrónico, consulta aquí. |
| APPROVAL.STEP([stepIndex]).ACTIONDATE([email],[true]) |
Devuelve la hora de aprobación o rechazo de un paso de aprobación específico. Esta fórmula debe aplicarse a un campo de fecha. El argumento [true] es opcional; al aplicarlo, la hora se mostrará en UTC+0. De lo contrario, se mostrará en la zona horaria de la cuenta. Para más detalles, consulte esta sección. (1) Un aprobador en un paso de aprobación: No se requiere el argumento [email]. Devuelve la fecha y hora de aprobación o rechazo del aprobador. (2) Varios aprobadores en un paso de aprobación: Sin el argumento [email]: El sistema devolverá la fecha y hora en que un aprobador rechazó esta aprobación o cuando el paso se aprobó por completo (el número de aprobadores aprobados alcanza el umbral de aprobación establecido). Con el argumento [email]: El sistema devolverá la hora de aprobación o rechazo del usuario correspondiente. Para obtener más información sobre el argumento de correo electrónico, consulte aquí. |
| APPROVAL.STEP([stepIndex]).COMMENTDATE([email], [true]) | Devuelve la fecha y la hora en que el/los aprobador(es) dejaron comentarios.
El argumento [true] es opcional; al aplicarlo, el valor de la hora se mostrará en UTC+0. De lo contrario, se mostrará en la zona horaria de la cuenta. Para más detalles, consulte esta sección. (1) Un aprobador en un paso de aprobación: No se requiere el argumento [email]. Devuelve la fecha y la hora en que el aprobador dejó el comentario. (2) Varios aprobadores en un paso de aprobación: Se requiere el argumento [email]. Devuelve la fecha y la hora en que un aprobador dejó el comentario. Para obtener más información sobre el argumento de correo electrónico, consulte aquí. |
Fórmulas de aprobación que devuelven una marca de tiempo: APPROVAL.SUBMITDATE([true]), APPROVAL.FINISHDATE([true]), APPROVAL.STEP([stepIndex]).ACTIONDATE([email],[true]), APPROVAL.STEP([stepIndex]).COMMENTDATE([email],[true]). Se recomienda incluir el argumento [true] al usar estas fórmulas y habilitar la opción "Mostrar usando la zona horaria del navegador" en la configuración del campo de fecha.
Si tu hoja ya ha iniciado o completado el proceso de aprobación y posteriormente agregas un campo que aplica una fórmula de aprobación que devuelve tiempo, como APPROVAL.SUBMITDATE([true]) o APPROVAL.STEP([stepIndex]).ACTIONDATE([email],[true]), a una hoja que ya contiene valores de fecha con la configuración "Mostrar usando la zona horaria del navegador", es posible que la hora mostrada se ajuste en función de la "zona horaria de su navegador".
Por ejemplo, si ya aprobó una hoja el 1 de agosto de 2023 a las 12:00 p. m. y el campo de hora de aprobación no estaba configurado en "Mostrar con la zona horaria del navegador", la hora registrada se corresponde con la zona horaria de la empresa. Al añadir posteriormente el campo "Nueva hora de aprobación" y habilitar "Mostrar con la zona horaria del navegador", la fórmula de aprobación se calculará primero según la zona horaria de la empresa. A continuación, se añadirá el valor mostrado con la zona horaria del navegador (p. ej., UTC+8). En consecuencia, la hora del campo "Nueva hora de aprobación" se incrementará en 8 horas y se mostrará como "20:00 del 1 de agosto de 2023".
Por lo tanto, si encuentra discrepancias horarias en la hora de aprobación, simplemente desmarque la opción "Mostrar usando la zona horaria del navegador" para ese campo. Esto garantizará que la hoja calcule la hora según la zona horaria de la empresa.
Al marcar o desmarcar la opción "Mostrar usando la zona horaria del navegador", el sistema mostrará un recordatorio indicando que se convertirán los valores de fecha del campo. Por lo tanto, preste atención a esta configuración y evite marcarla o desmarcarla para campos que ya contienen valores de fecha.
¡Gracias por sus valiosos comentarios!
