Generar Word a partir de plantilla en C#

Automatizar la generación de documentos es crucial para que las empresas creen informes dinámicos, facturas y cartas. Con Aspose.Words Mail Merge para .NET, puede llenar eficientemente plantillas de Word con datos de diversas fuentes, incluidos objetos, CSV, JSON y XML. Esta guía demuestra cómo utilizar Mail Merge en C# para flujos de trabajo de documentos automatizados y simplificados, enfocándose específicamente en la creación dinámica de documentos Word en C# .NET.

Temas Cubiertos:

Descripción general de Mail Merge para .NET

Aspose.Words Mail Merge para .NET permite a los desarrolladores generar documentos personalizados a partir de plantillas predefinidas que contienen campos de combinación. El plugin está diseñado para una integración fluida dentro de los entornos .NET, ofreciendo capacidades para:

  • Llenar plantillas con datos de manera dinámica, apoyando la generación de documentos Word en el marco .NET.
  • Realizar la generación masiva de documentos de manera eficiente, aprovechando la solución de mail merge de .NET para grandes conjuntos de datos.
  • Mantener un formato consistente en las salidas, mejorando de manera efectiva las mejores prácticas en plantillas de documentos Word en C#.

Características Clave:

  1. Soporte Multifuente: Utilice datos de objetos, bases de datos, XML, JSON y CSV para crear documentos Word personalizados con C#.
  2. Alto Rendimiento: Maneje eficientemente grandes conjuntos de datos y operaciones masivas para generación dinámica de documentos Word con .NET Core.
  3. Plantillas Personalizables: Cree plantillas con marcadores de posición para la inserción de datos, aprovechando las capacidades de automatización de mail merge en Word con .NET.

Configureción

Instale Aspose.Words usando NuGet:

PM> Install-Package Aspose.Words

Generar Documento Word de una Plantilla Usando Objetos C#

Primero, veamos cómo poblar una plantilla de Word usando objetos C#. Para ilustrar esto, crearemos un documento Word (DOC/DOCX) con los siguientes marcadores de posición como contenido del documento:

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

Aquí, sender es una instancia de una clase que utilizaremos para poblar la plantilla utilizando el enfoque de C# para generar un documento Word de una base de datos.

Ahora, podemos utilizar el motor de informes de Aspose.Words para generar el documento Word a partir de la plantilla y la instancia de la clase Sender siguiendo estos pasos:

  • Cree una instancia de la clase Document e inicialícela con la ruta de la plantilla de Word.
  • Cree e inicialice un objeto de la clase Sender.
  • Instancie la clase ReportingEngine.
  • Llene la plantilla utilizando ReportingEngine.BuildReport(), que toma la instancia del Documento, la fuente de datos y el nombre de la fuente de datos como parámetros.
  • Guarde el documento Word generado utilizando el método Document.Save().

El siguiente ejemplo de código muestra cómo generar un documento Word a partir de una plantilla en C#.

Salida

Generar Documento Word de una Fuente de Datos XML en C#

Para generar un documento 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 Word a partir de una fuente de datos XML, siga estos pasos:

  • Cree una instancia de la clase Document e inicialícela con la ruta de la plantilla de Word.
  • Cree una instancia de la clase XmlDataSource e inicialícela con la ruta del archivo XML.
  • Instancie la clase ReportingEngine.
  • Use el método ReportingEngine.BuildReport() como antes para poblar la plantilla de Word.
  • Guarde el documento Word generado utilizando el método Document.Save().

Aquí está el ejemplo de código que demuestra cómo generar un documento Word desde una fuente de datos XML en C#.

Salida

Generar Documento Word de una Fuente de Datos JSON en C#

A continuación, exploremos cómo generar un documento Word utilizando una fuente de datos JSON. En este ejemplo, crearemos una lista de clientes segmentada 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 usaremos para poblar la plantilla es la siguiente:

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

Salida

Generar Documento Word de una Fuente de Datos CSV en C#

Para generar el documento 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 llenará 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 Word a partir de una fuente de datos CSV.

Salida

Pruebe Aspose.Words para .NET de forma gratuita

Puede probar Aspose.Words para .NET usando una licencia temporal gratuita.

Conclusión

En este artículo, ha aprendido cómo generar documentos Word a partir de plantillas usando C#. Ha descubierto cómo aprovechar diversas fuentes de datos como objetos, XML, JSON y CSV para generación dinámica de documentos en .NET. Profundice en las capacidades del procesamiento de plantillas Word en .NET explorando la documentación, y no dude en comunicarse a través de nuestro foro.

Vea También