Generar Word a partir de plantilla en C#

Automatizar la generación de documentos es crucial para las empresas que buscan crear informes, facturas y cartas dinámicas. Con Aspose.Words Mail Merge para .NET, puedes poblar eficientemente plantillas de Word con datos de diversas fuentes, incluidos objetos, CSV, JSON y XML. Esta guía te llevará a través de la utilización de Mail Merge en C# para flujos de trabajo de documentos automatizados y optimizados, centrándose en la creación dinámica de documentos de Word con C# .NET.

Tabla de Contenidos

Descripción general de Mail Merge para .NET

El plugin Aspose.Words Mail Merge para .NET permite a los desarrolladores crear documentos personalizados a partir de plantillas predefinidas que contienen campos de combinación. Esta integración está diseñada para un uso fluido dentro de entornos .NET, ofreciendo capacidades para:

  • Población dinámica de plantillas con datos, soportando generación de documentos de Word en .NET framework.
  • Realización eficiente de generación masiva de documentos, aprovechando la solución de combinación de correspondencia de .NET para documentos de Word.
  • Asegurar un formato consistente en las salidas, mejorando las mejores prácticas de plantillas de documentos de Word en C#.

Características clave:

  1. Soporte Multi-Fuente: Utiliza datos de objetos, bases de datos, XML, JSON y CSV para crear documentos de Word personalizados con C#.
  2. Alto Rendimiento: Maneja eficientemente grandes conjuntos de datos y operaciones masivas para generación dinámica de documentos de Word con .NET Core.
  3. Plantillas Personalizables: Crea plantillas con marcadores de posición para la inserción de datos, utilizando las capacidades de automatización de combinación de correspondencia de Word en .NET.

Configuración

Para comenzar, instala Aspose.Words usando NuGet:

PM> Install-Package Aspose.Words

Generar documento de Word a partir de plantilla usando objetos C#

Comencemos poblando una plantilla de Word usando objetos C#. Crearemos un documento de Word (DOC/DOCX) con los siguientes marcadores de posición:

<<[sender.Name]>> dice: "<<[sender.Message]>>."

En este ejemplo, sender es una instancia de una clase que utilizaremos para poblar la plantilla usando el enfoque de C# para generar documentos de Word a partir de bases de datos.

A continuación, utilizaremos el motor de informes de Aspose.Words para generar el documento de Word a partir de la plantilla y la instancia de la clase Sender siguiendo estos pasos:

  1. Crea una instancia de la clase Document e inicialízala con la ruta de la plantilla de Word.
  2. Crea e inicializa un objeto de la clase Sender.
  3. Instancia la clase ReportingEngine.
  4. Población de la plantilla usando ReportingEngine.BuildReport(), que toma la instancia del Documento, la fuente de datos y el nombre de la fuente de datos como parámetros.
  5. Guarda el documento de Word generado usando Document.Save().

Aquí tienes el ejemplo de código que demuestra cómo generar un documento de Word a partir de una plantilla en C#.

Salida

Generar documento de Word a partir de una fuente de datos XML en C#

Para generar un documento de Word a partir de una fuente de datos XML, utilizaremos una plantilla de Word más compleja con los siguientes marcadores de posición:

<<foreach [in persons]>>Nombre: <<[Name]>>, Edad: <<[Age]>>, Fecha de Nacimiento: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Edad promedio: <<[persons.Average(p => p.Age)]>>

La fuente de datos XML utilizada en este ejemplo se muestra a continuación.

Para crear un documento de Word a partir de una fuente de datos XML, sigue estos pasos:

  1. Crea una instancia de la clase Document e inicialízala con la ruta de la plantilla de Word.
  2. Crea una instancia de la clase XmlDataSource e inicialízala con la ruta del archivo XML.
  3. Instancia la clase ReportingEngine.
  4. Usa el método ReportingEngine.BuildReport() para poblar la plantilla de Word.
  5. Guarda el documento de Word generado usando el método Document.Save().

Aquí tienes el ejemplo de código que demuestra cómo generar un documento de Word a partir de una fuente de datos XML en C#.

Salida

Generar documento de Word a partir de una fuente de datos JSON en C#

A continuación, exploremos cómo generar un documento de Word utilizando una fuente de datos JSON. En este ejemplo, crearemos una lista de clientes segmentados por sus gerentes. La plantilla de Word se verá así:

<<foreach [in managers]>>Gerente: <<[Name]>>
Contratos:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>

La fuente de datos JSON correspondiente que utilizaremos para poblar la plantilla es la siguiente:

Para generar el documento de Word a partir de JSON, utilizaremos la clase JsonDataSource para cargar la fuente de datos, y los pasos restantes seguirán la estructura anterior. Aquí tienes el ejemplo de código que demuestra cómo generar un documento de Word a partir de la plantilla JSON en C#.

Salida

Generar documento de Word a partir de una fuente de datos CSV en C#

Para generar el documento de Word a partir de una fuente CSV, utilizaremos la siguiente plantilla de Word:

<<foreach [in persons]>>Nombre: <<[Column1]>>, Edad: <<[Column2]>>, Fecha de Nacimiento: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Edad promedio: <<[persons.Average(p => p.Column2)]>>

La plantilla se poblará utilizando los siguientes datos CSV:

Ahora, revisemos el código C#. Los pasos permanecen iguales excepto por una diferencia clave: utilizaremos la clase CsvDataSource para cargar los datos CSV. El siguiente ejemplo de código ilustra cómo generar el documento de Word a partir de una fuente de datos CSV.

Salida

Prueba Aspose.Words para .NET gratis

Puedes probar Aspose.Words para .NET utilizando una licencia temporal gratuita.

Conclusión

En este artículo, has aprendido cómo generar documentos de Word a partir de plantillas usando C#. Has explorado cómo aprovechar diversas fuentes de datos como objetos, XML, JSON y CSV para generación dinámica de documentos en .NET. Para obtener más información sobre las capacidades del procesamiento de plantillas de Word en .NET, sumérgete en la documentación, y no dudes en ponerte en contacto a través de nuestro foro.