---
title: Variables de documento y fuentes de datos
description: >-
  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.
sidebar:
  order: 4
  label: Variables de doc.
---

**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.

:::tip
Elija un usuario en **Como usuario:** y active **Mostrar datos de ejemplo** en la barra de herramientas. Así las variables muestran valores reales mientras escribe.
:::

## 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](/docs/es/fuxam-web/base/user-management/custom-columns) 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](/docs/es/fuxam-web/cms/programs-and-planning/study-programs-cohorts)) |
| **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](/docs/es/fuxam-web/cms/time-tracking)) |
| **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

1. Abra la plantilla en el editor y elija un usuario en **Como usuario:**.

2. Active **Mostrar datos de ejemplo** y lea cada variable.

3. Si hay valores vacíos, corrija los datos del perfil o defina **Cuando esté vacío** en la variable.

4. 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](/docs/es/fuxam-web/cms/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](/docs/es/fuxam-web/base/user-management/custom-columns) 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.

## Páginas relacionadas

**[Editar un documento](/docs/es/fuxam-web/cms/smart-documents/edit-a-document)**

Inserte variables en el editor.

**[Columnas personalizadas](/docs/es/fuxam-web/base/user-management/custom-columns)**

Añada sus propios campos de datos.

**[Registro de tiempo](/docs/es/fuxam-web/cms/time-tracking)**

De dónde proceden los datos de registro de tiempo.

**[Usar una plantilla de documento](/docs/es/fuxam-web/cms/smart-documents/use-a-document-template)**

Genere documentos.
