Documentación

<?xml version="1.0" encoding="utf-8"?>
<Cliente>
  <ClienteID>1</ClienteID>
  <Nombre>José Rodríguez</Nombre>
  <ClienteVIP>True</ClienteVIP>
  <Pedidos>
    <Pedido Numero="1">
      <DescripcionProducto>Mi Producto Asombroso</DescripcionProducto>
      <Cantidad>10</Cantidad>
      <FechaPedido>20 de diciembre de 2025</FechaPedido>
    </Pedido>
    <Pedido Numero="2">
      <DescripcionProducto>Mi Producto Maravilloso</DescripcionProducto>
      <Cantidad>3</Cantidad>
      <FechaPedido>26 de diciembre de 2025</FechaPedido>
    </Pedido>
  </Pedidos>
</Cliente>

<Table Select="./Pedidos/Pedido" />

<Repeat Select="./Pedidos/Pedido"/>

<EndRepeat/>

<Conditional Select="./ClienteVIP" Match="True"/>

<EndConditional/>

🧩 Referencia de Comandos de Plantillas para el DocMaker

DocMaker usa comandos basados en XML incrustados en controles de contenido de texto rico para generar dinámicamente el contenido del documento. A continuación, se presentan los comandos reconocidos y cómo usarlos.

---

📌 1. <Content Select="..." />

Inserta un único valor desde el XML en el documento.

<Content  Select="./Nombre" />

• Propósito: Inserta el valor seleccionado en línea en la ubicación del control de contenido.
• Ejemplo de salida:
  Si el XML contiene <Nombre>Juan García</Nombre>, la etiqueta se reemplazará por “Juan García”.
• Uso: Ideal para nombres, IDs, cantidades u otros valores escalares.

---

📌 2. <Table Select="..." />

Genera filas de tabla dinámicas basadas en un conjunto repetido de nodos XML.

<Table  Select="./Pedidos/Pedido" />

• Propósito: Clona la fila que contiene la etiqueta para cada nodo que coincida.
• Requisito: La fila de la tabla debe estar ya formateada en el documento con marcadores de posición para los valores.
• Uso: Ideal para insertar listas de artículos, facturas, transacciones, etc.

---

📌 3. <Repeat Select="..."> ... <EndRepeat />

Repite un bloque de contenido para cada nodo XML coincidente.

<Repeat  Select="./Pedidos/Pedido">
  La descripción del pedido #<Content  Select="@Numero"/> es <Content  Select="./DescripcionProducto"/>. 
<EndRepeat/>

• Propósito:: Recorre el XPath especificado e inserta el contenido interior cada vez.
• Soporta: Elementos en línea como <Content /> dentro del bloque repetido.
• Uso: Adecuado para información estructurada pero no tabular repetida.

---

📌 4. <Conditional Select="..." Match="..."> ... <EndConditional />

Muestra contenido condicionalmente basado en el valor de una expresión XPath.

<Conditional  Select="./ClienteVIP"  Match="True">
  Como eres uno de nuestros clientes más grandes, te invitamos... 
<EndConditional/>

• Propósito: Incluye el bloque de contenido solo si el valor seleccionado coincide.
• Ejemplo: Útil para mensajes VIP, cláusulas legales o instrucciones variables.

---

🔧 Atributos opcionales

Attribute	Used In	Description
Select	Todos	Expresión XPath que selecciona el o los nodos XML a operar
Match	Conditional	Valor con el que el resultado de XPath debe coincidir para incluir el contenido

---

📝 Notas

• Todos los comandos deben estar dentro de controles de contenido de texto enriquecido.
• XPath debe seguir la sintaxis de XPath 1.0.
• Soportado tanto en Microsoft Word (con la Pestaña de Desarrollador) como en LibreOffice Writer.
• Puedes asignar un atajo de teclado en ambas aplicaciones para insertar rápidamente o convertir contenido en un control de contenido.

---

🖥️ Flujo de trabajo de la aplicación

1. Selecciona el archivo fuente .xml y la plantilla .docx.
2. Haz clic en el botón Ejecutar.
3. El archivo de salida se genera con los datos insertados automáticamente.

---

📷 Guías visuales

🎞️ Habilitar la pestaña de Desarrollador en Microsoft Word

Opciones > Personalizar Cinta > Agregar Desarrollador 

▶️ [Insertar animación mostrando cómo habilitar la pestaña de Desarrollador]

🎞️ Insertar un control de contenido

LibreOffice Formulario > Control de contenido > Texto Enriquecido 

▶️ [Insertar animación: LibreOffice – insertando control de contenido]

Microsoft Word Pestaña Desarrollador > Control de Contenido > Texto Enriquecido 

▶️ [Insertar animación: Microsoft Word – insertando control de contenido]

⌨️ Atajos

Asigna atajos de teclado para insertar controles más rápido.

LibreOffice

• Ve a Herramientas > Personalizar > Teclado.
• Selecciona un Atajo de la lista (por ejemplo: Alt+F1).
• En la sección Funciones al final del cuadro de diálogo, escribe Control de contenido de texto enriquecido.
• Haz clic en el botón Asignar.
• Haz clic en el botón Aceptar.

Microsoft Office

• Ve a Opciones > Personalizar Cinta > Atajos de teclado en la parte inferior > Personalizar.
• Selecciona Pestaña Desarrollador de la lista Categorías.
• Selecciona ContentControlRichText de la lista Comandos.
• Selecciona el cuadro Presionar nueva tecla de acceso rápido.
• Pulsa la combinación de teclas deseada (por ejemplo: Alt+F1).
• Haz clic en el botón Asignar.

Ahora puedes crear un control de contenido o seleccionar cualquier texto para convertirlo en un control de contenido presionando el atajo asignado.

---

✅ Casos de uso soportados

• Declaraciones de herencia
• Pre-llenado de contratos
• Generación de documentos fiscales
• Borradores legales a partir de datos de formularios existentes
• Informes de RRHH a partir de registros estructurados de empleados

---

🔒 ¿Por qué usar este módulo?

• Precisión: Evita la escritura redundante manual y los errores de copiar y pegar.
• Eficiencia: Ahorra horas de formato y edición.
• Flexibilidad: Funciona con la mayoría de editores .docx que soportan controles de contenido.
• Ahorro de costes: Automatiza documentos rutinarios a una fracción del costo.