---
title: Editar un documento
description: >-
  Recorrido por el editor TipTap: menú Insertar, vista previa como usuario,
  configuración de página, Guardar (publica una versión) y restauración desde
  Versiones.
sidebar:
  order: 2
---

**Editar un smart document** se hace en el editor TipTap. Lo abre en **Configuraciones → Comunicación & Documentos → Documentos**, en el menú ⋯ de una plantilla, con **Editar**. Allí escribe el texto, inserta variables y campos de formulario, revisa el resultado en la vista previa y publica una versión nueva con **Guardar**.

:::tip
Use la **Vista previa** con un usuario real antes de cada guardado. Las variables, condiciones y tablas inteligentes muestran datos reales, así que los huecos se ven enseguida.
:::

## Por qué es importante

En el editor una plantilla se convierte en un documento utilizable. Editar con cuidado evita campos vacíos, textos incorrectos y diseños que se rompen entre páginas al generar documentos para muchas personas.

## Antes de empezar

| Requisito | Detalle |
|---|---|
| **Función** | **Smart Documents** en el paquete FuxamCMS. |
| **Permiso** | `read-write:settings-service-contracts`. |
| **Plantilla** | Una plantilla existente. Cree una primero si no tiene ninguna. |
| **Un usuario de prueba** | En plantillas de Usuario, un usuario cuyo perfil tenga datos típicos. En plantillas de Módulo, una versión de módulo. |

## El editor de un vistazo

| Zona | Qué hace |
|---|---|
| **Título del documento** (arriba a la izquierda) | Renombra el documento en el propio lugar. Un indicador muestra «Guardando...» y «Guardado». |
| **Como usuario:** / **Elegir usuario** | Elige el usuario cuyos datos rellenan las variables en la vista previa. Las plantillas de Módulo muestran en su lugar un selector de módulo. |
| Interruptor **Vista previa** | Alterna entre edición y vista previa. Un aviso indica «Ahora está en modo de vista previa.» |
| **Versiones** | Lista las versiones guardadas, marca la **Actual** y permite **Restaurar** una anterior. |
| **Guardar** | Comprueba el documento, lo publica como versión nueva y le devuelve a la configuración de Documentos. |
| ⋯ **Más acciones** | **Mostrar esquema**, **Importar desde Word** y **Vista previa de impresión**. |
| Barra de herramientas | Deshacer, Rehacer, Negrita, Cursiva, Subrayado, listas, alineación, **Insertar**, color del texto, tamaño de fuente, formato de bloque, familia tipográfica, **Mostrar datos de ejemplo**, Zoom y **Configuración de página**. |

## Cómo editar un documento

1. Vaya a **Configuraciones → Comunicación & Documentos → Documentos** y abra el menú ⋯ de la plantilla. Elija **Editar**.

2. Escriba y dé formato al texto. Use la barra de herramientas para encabezados, listas, alineación y fuentes.

3. Abra **Insertar** para añadir contenido: **Variable**, **Elementos de formulario**, **Tabla inteligente**, **Tabla**, **Imagen**, **Salto de página**, **Sección condicional** o **Firma**. En el texto también puede escribir `/` para el menú de bloques o `@` para variables.

4. Abra **Configuración de página** para definir formato, orientación, márgenes, encabezado y pie de página y numeración.

5. Elija **Elegir usuario** (o un módulo) y active la **Vista previa**. Revise cada variable, condición y tabla. Con **Vista previa de impresión** en ⋯ **Más acciones** ve la página como PDF.

6. Seleccione **Guardar**. Fuxam comprueba el documento y luego lo publica como versión nueva. Si la comprobación falla, el mensaje «Guardado bloqueado» (o «Publicación bloqueada») le pide corregir primero las fuentes de datos de tablas inteligentes y las fuentes incrustadas. Corríjalas e inténtelo de nuevo.

Para traer más contenido de Word más adelante, use ⋯ **Más acciones → Importar desde Word**. Elija **Insertar en el cursor** o **Reemplazar documento**.

Para volver a un estado anterior, abra **Versiones** y elija **Restaurar** junto a la versión. El mensaje «Versión restaurada» lo confirma.

:::info
Las plantillas anteriores al editor TipTap son plantillas **PDF**. **Editar** abre para ellas el antiguo editor PDF. Esta página describe el editor TipTap.
:::

## Buenas prácticas

- **Pruebe la vista previa con más de un usuario.** Revise un usuario con datos completos y otro con huecos.
- **Defina «Cuando esté vacío» en las variables.** Elija **Ocultar**, un guion o **Texto alternativo** para que los huecos no parezcan errores.
- **Use secciones condicionales para texto opcional.** Añada una regla en lugar de mantener varias plantillas casi idénticas.
- **Configure primero la página.** Los márgenes y encabezados cambian dónde se corta cada página.
- **Guarde antes de salir.** El guardado automático protege su borrador, pero **Guardar** crea la versión que usarán los demás.

## Errores frecuentes

| Error | Cómo evitarlo |
|---|---|
| Escribir un valor que debería ser una variable | Inserte una **Variable** para que cambie según el usuario. |
| Revisar solo un usuario | Pruebe varios usuarios en la vista previa. |
| Ignorar «Guardado bloqueado» | Corrija las fuentes de datos de tablas inteligentes y las fuentes incrustadas y vuelva a guardar. |
| Restaurar la versión equivocada | Compruebe antes el número de versión y la marca **Actual** en **Versiones**. |
| Esperar el diseño de Word tras importar | Solo se conserva la estructura del texto. Reconstruya el diseño en el editor. |

## Preguntas frecuentes

**¿El guardado automático publica mis cambios?**

Protege su borrador mientras trabaja. Solo **Guardar** publica el documento como versión nueva que otras personas pueden usar.

**¿Puedo deshacer un guardado?**

Sí. Abra **Versiones** y restaure una versión anterior.

**¿Puedo renombrar una plantilla sin abrir el editor?**

Sí. Use **Renombrar** en el menú ⋯ de la tabla de plantillas. Consulte [Gestionar documentos](/docs/es/fuxam-web/cms/smart-documents/manage-documents).

**¿Por qué no veo datos en la vista previa?**

El usuario o módulo elegido no tiene datos para esa variable. Elija otro usuario o revise los datos en [Administración de usuarios](/docs/es/fuxam-web/base/user-management).

## Páginas relacionadas

**[Variables de documento y fuentes de datos](/docs/es/fuxam-web/cms/smart-documents/document-variables-and-data-sources)**

Variables, formatos y tablas inteligentes.

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

Genere documentos para usuarios.

**[Gestionar documentos](/docs/es/fuxam-web/cms/smart-documents/manage-documents)**

Renombre, defina predeterminadas y elimine plantillas.

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

Añada una plantilla nueva.
