Variables de documento y fuentes de datos
Cómo las variables, tablas inteligentes, formatos y reglas de valor vacío rellenan un Smart Document con datos de estudiante, programa, cohorte, registro de tiempo e institución.
Las variables de documento son marcadores que inserta en el editor TipTap con Insertar → Variable (o escribiendo @ o /). Al generar el documento, Fuxam sustituye cada variable por datos reales del usuario, módulo, carrera, sala o certificado.
Por qué es importante
Las variables mantienen una plantilla válida para todos. Si los datos que hay detrás están completos y correctos, los documentos generados no necesitan retoques manuales. Si no, aparecen huecos en cartas y contratos.
Antes de empezar
| Requisito | Detalle |
|---|---|
| Función y permiso | Smart Documents (paquete FuxamCMS) y read-write:settings-service-contracts. |
| Datos mantenidos | Los campos que quiere usar están rellenados en perfiles de usuario o registros. |
| Columnas personalizadas | Cree las columnas personalizadas antes de usarlas como variables. |
| Usuario de prueba | Un usuario o una versión de módulo para la vista previa. |
Qué pueden mostrar las variables
Las variables se agrupan según el origen de sus datos. Los grupos que ve dependen del tipo de objeto.
| Origen | Ejemplos |
|---|---|
| Estudiante asignado | Nombre, datos de contacto y las columnas personalizadas de su institución |
| Institución | Nombre y datos de la institución |
| Programa de estudios | Datos de programa y cohorte (Programas de estudios y cohortes) |
| Admisión | Datos de la postulación |
| Matrícula y tarifas | Datos de tarifas y aranceles |
| Firma | Bloques de firma |
| Registro de tiempo | Valores de un período de registro de tiempo (Registro de tiempo) |
| Módulo, Carrera, Sala | Campos del registro elegido para esos tipos de objeto |
| Certificado | Datos de finalización de curso en plantillas de certificado |
| Documento legal de examen | Datos de documentos legales de examen |
Formato y valores vacíos
Seleccione una variable en el texto para abrir Configuración de variable.
- Formato: Texto, MAYÚSCULAS o uno de varios formatos de fecha y de fecha y hora.
- Cuando esté vacío: Ocultar el valor, mostrar un guion (—) o mostrar un Texto alternativo que usted escribe.
- Estilo: mostrar el valor en negrita cuando hay datos.
Tablas inteligentes
Insertar → Tabla inteligente rellena una tabla automáticamente desde una fuente de datos y se adapta a cada usuario al generar el documento. Las fuentes de datos incluyen Plan de estudios, Cursos del usuario, Resumen de citas, Carga de trabajo y Registro de tiempo. Las plantillas de Módulo ofrecen Módulo padre y submódulos. Si ninguna fuente encaja con el tipo de documento, el cuadro de diálogo lo indica.
El guardado se bloquea mientras una fuente de datos de tabla inteligente necesite corrección.
Períodos de registro de tiempo
Las plantillas con variables de registro de tiempo necesitan un período. Defínalo con Registro horario en el menú ⋯ de la plantilla. Al agregar el documento, la persona elige el período si es obligatorio.
Cómo revisar sus datos
Abra la plantilla en el editor y elija un usuario en Como usuario:.
Active Mostrar datos de ejemplo y lea cada variable.
Si hay valores vacíos, corrija los datos del perfil o defina Cuando esté vacío en la variable.
Repita con un segundo usuario cuyos datos estén incompletos.
Buenas prácticas
- Defina «Cuando esté vacío» en cada variable opcional.
- Use columnas personalizadas para datos propios de la institución y désles nombres claros.
- Mantenga un solo formato de fecha en sus documentos.
- Pruebe con varios usuarios, incluido uno con huecos.
- Incluya solo datos que la persona lectora pueda ver. Consulte la protección de datos en Smart documents.
Errores frecuentes
| Error | Cómo evitarlo |
|---|---|
| Valor vacío en el resultado | Rellene el campo del perfil o defina Cuando esté vacío. |
| La variable no aparece en la lista | Revise el Tipo de objeto de la plantilla. |
| Formato de fecha incorrecto | Ajuste el Formato en Configuración de variable. |
| Una tabla inteligente bloquea el guardado | Elija una fuente de datos válida para la tabla. |
| Valores de registro de tiempo vacíos | Elija el período en Registro horario o al agregar el documento. |
Preguntas frecuentes
¿Puedo usar mis propias columnas personalizadas?
Sí. Las columnas personalizadas de Administración de usuarios aparecen como variables en las plantillas de Usuario.
¿Qué diferencia hay entre una variable y un campo de formulario?
Una variable se rellena automáticamente con datos. Un campo de formulario es una entrada en la que alguien escribe al completar el documento.
¿Por qué la lista de variables cambia entre plantillas?
La lista depende del Tipo de objeto de cada plantilla.
¿Puede un campo de formulario empezar con un valor?
Sí. Use Prellenar desde variable en el campo de formulario. Se rellena al abrir el documento la persona asignada, si su borrador está vacío.