Una regla de dependencia adapta un formulario a las respuestas del usuario: mostrar un campo solo cuando tiene sentido, hacerlo obligatorio en ciertos casos. Las variables proporcionan a las reglas valores que no proceden del formulario: el usuario actual, la fecha del día, un valor leído en la CMDB…
Estos ajustes se hacen en la pantalla Formularios (véase «Diseñar un formulario»), abierta a los Administradores y a los Administradores de formularios.
Añadir una regla
En un borrador, la tarjeta Reglas de dependencia enumera las reglas de la versión (Cuando … → efecto → campos afectados) en el idioma de la pantalla: etiquetas de los campos, condiciones y combinación («y», «o»…) en palabras, valores comparados en etiquetas. Luego viene el formulario para añadir una:
- Combinar las condiciones con: Y (todas), O (al menos una), O EXCLUSIVO (solo una), Y NO (solo la primera, ninguna otra) u O NO (la primera, o ninguna otra);
- Efecto: mostrar, ocultar, hacer obligatorio o hacer opcional;
- Campos afectados: marca el campo o los campos concernidos; cuando el formulario tiene muchos, una búsqueda filtra la lista;
- una o varias condiciones (+ Condición para añadir una):
- Campo desencadenante: un campo del formulario, o Grupos del usuario actual. Para un campo que designa a un usuario, Comparar los grupos del usuario designado por este campo compara sus grupos en lugar de su valor;
- Condición: es igual a, no es igual a, contiene, no contiene, empieza por, termina en, es uno de, no es uno de, contiene todos los valores, está relleno, no está relleno, y para un número o una fecha es mayor que, es menor que (o igual), está entre (dos límites), no está entre;
- Valores: separados por punto y coma. Un valor puede ser una variable (véase más abajo).
Haz clic en Añadir. Una condición que espera un valor (es igual a, contiene, es uno de…) y no tiene ninguno se señala bajo el campo Valores, y la regla no se añade; una fila de condición dejada en blanco (nunca tocada) no se envía. Una condición se quita con el icono de papelera de su fila. Una regla no se modifica: elimínala (icono de papelera) y vuelve a crearla.
Prueba tus reglas en la Vista previa: introduce valores y observa cómo aparecen o desaparecen los campos. No se guarda nada.
La publicación se rechaza si una regla es incoherente: campo desencadenante o campo afectado ausente de la versión, condición sin valor cuando espera uno, grupo de condiciones vacío, comparación de orden en un campo que no es ni un número ni una fecha, comparación de grupos en un campo que no designa a un usuario, o campo obligatorio que nunca puede mostrarse. Un motivo sobre una regla la cita con todas sus palabras (condiciones → efecto → campos afectados) y lleva a su fila en la tarjeta de reglas; un motivo sobre un campo cita su etiqueta. Cuando dos campos tienen la misma etiqueta, su identificador sigue a la etiqueta, en discreto, entre paréntesis; un campo eliminado desde entonces se lee «campo eliminado».
Las variables incluidas
En los Valores de una condición se proponen siempre estas variables: El usuario actual, El solicitante, El servicio del catálogo solicitado (el que abrió este formulario), Ahora, Hoy, Inicio del mes, Fin del mes, Primer lunes del mes e Inicio de la semana. En una regla, el valor de otro campo del formulario se escribe {{field:identificador}} (con dos puntos, mientras que la plantilla de visualización y los límites de un número usan {{field.identificador}}).
Definir tus propias variables
El botón Variables de la lista de formularios abre la pantalla Variables (/dynamicforms/admin/variables). Cada variable tiene un Token (minúsculas, dígitos, _ y : únicamente; el prefijo field: está reservado), una Etiqueta y una Naturaleza:
- Fecha calculada: una Base (Ahora o Hoy), un Ancla opcional (inicio o fin del mes, inicio de la semana, primer lunes del mes) y un Desplazamiento (días);
- Consulta SQL: una sola instrucción SELECT, en solo lectura; la primera columna de la primera fila es el valor. Solo las columnas enumeradas bajo el campo pueden citarse como
@columna. Esta naturaleza está reservada a los Administradores: a un administrador de formularios no se le propone; en una variable SQL existente, solo puede cambiar el token y la etiqueta, no la consulta, ni la naturaleza, ni eliminar la variable; - Ruta CMDB: un Punto de partida (Usuario actual, Solicitante, o un Campo del formulario de tipo Selector de objeto CMDB), una Ruta de saltos sucesivos (tipo de relación, Saliente o Entrante) y el Valor a comparar (Usuario vinculado, Identificador del activo o Etiqueta mostrada). No disponible si el módulo CMDB está desactivado.
En la ficha de una variable, Probar calcula su valor. Para una consulta SQL o una ruta CMDB que dependen de un envío real, indica el identificador de un Envío existente.
Una variable usada por al menos una regla no puede eliminarse.
Ver también
- «Diseñar un formulario»: los campos, las versiones y la publicación.