Combinació de correu

El Aspose.Words Mail Merge for .NET El complement permet als desenvolupadors generar documents personalitzats—com ara correus electrònics, factures, directoris, etiquetes i informes—definint una única plantilla i poblant-la amb dades dinàmiques. Basat en el motor central de processament de documents de Aspose.Words, ofereix una solució potent, escalable i personalitzable per a la creació massiva de documents en aplicacions .NET.

Instal·lació i configuració

  1. Instal·la el Aspose.Words for .NET paquet a través de NuGet o la Consola del Gestor de Paquets. ( Guia d’instal·lació )
  2. Configura Llicència per consum abans d’executar operacions de combinació de correu. Llicència per consum ).
  3. Referència Aspose.Words.dll en el teu projecte.

Compatible amb Windows, Linux, macOS i plataformes mòbils utilitzant .NET Framework, .NET o Mono. Els IDE compatibles inclouen Visual Studio (2010–2026), Xamarin i MonoDevelop 2.4+.

IDE: Visual Studio 2017–2026, JetBrains Rider, MonoDevelop.

Formats de plantilla / sortida compatibles: DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML i Word 2007 XML.

Característiques i funcionalitats clau

Generació de documents basada en plantilles

  • Creeu plantilles en qualsevol format compatible.
  • Inserir camps de combinació (p. ex., «FieldName») per representar marcadors de dades dinàmiques.
  • Mantingueu les plantilles reutilitzables i mantenibles en diversos casos d’ús.

Població de dades a nivell de camp

  • Omple els camps de combinació amb text, imatges, codis de barres o contingut formatat.
  • Controleu la numeració, les vinyetes i els estils perquè el contingut combinat coincideixi amb el disseny corporatiu.

Regions imbricades i regions condicionals

  • Repeteix taules, llistes o paràgrafs per a cada registre de dades utilitzant regions.
  • Utilitzeu regions condicionals per incloure/excloure seccions dinàmicament (p. ex., mostreu una adreça d’enviament només si és necessària).

Connectivitat de la font de dades

  • Enllaça a qualsevol font compatible amb ADO.NET com ara DataTable, DataReader, DataSet, matrius o objectes personalitzats.
  • Implementa IMailMergeDataSource per a un control total sobre el recorregut de dades.
  • Gestioneu fonts de dades jeràrquiques i combinacions pare-filla amb facilitat.

Gestió d’esdeveniments personalitzada

  • Gestiona esdeveniments com MergeField, MergeImageField, i MergeRegion.
  • Aplica transformacions (p. ex., formata dates, genera codis QR o substitueix marcadors de posició dinàmicament).

Rendiment i escalabilitat

  • Optimitzat per a fusions a gran escala, d’alt volum.
  • Emet resultats directament a disc o a respostes HTTP per minimitzar l’ús de memòria.
  • El processament per lots, l’avaluació diferida de camps i la reutilització de regions augmenten el rendiment.

Localització i internacionalització

  • Genereu informes multilingües vinculant valors localitzats.
  • Aplica formatació específica de la cultura per a nombres, monedes i dates.
  • Admet llengües de dreta a esquerra i una gestió adequada de la codificació.

Compatibilitat i suport de formats

  • Admet tots els formats principals de Word (DOCX, DOC, RTF) i exporta al mateix o a altres formats mitjançant les API de conversió Aspose.Words.
  • Processa posteriorment els resultats fusionats amb les funcions estàndard Aspose.Words: conversió, comparació, funcions d’IA, i més.

Com crear un informe amb Mail Merge 

// Load template
doc = new Document("InvoiceTemplate.docx");

// Example DataTable as data source
DataTable orders = new DataTable("Orders");
orders.Columns.Add("CustomerName");
orders.Columns.Add("Item");
orders.Columns.Add("Quantity");
orders.Rows.Add("John Doe", "Laptop", "1");
orders.Rows.Add("Jane Smith", "Phone", "2");

// Execute Mail Merge
doc.MailMerge.ExecuteWithRegions(orders);

// Save the result
doc.Save("InvoiceReport.docx");

Casos d’ús comuns

  • Cartes i correus electrònics massius: Automatitza la correspondència personalitzada.
  • Factures i rebuts: Fusiona les dades de clients i transaccions en plantilles de factures.
  • Informes: Genera informes estructurats amb dades agrupades o condicionals.
  • Etiquetes i sobres: Crea actius preparats per al correu en massa.
  • Directoris i catàlegs: Compila dades jeràrquiques o tabulars en documents estructurats.

Consells i bones pràctiques

  • Utilitza convencions de nomenclatura clares per a merge fields per millorar la mantenibilitat.
  • Minimitza les regions profundament anidades—aplana les dades quan sigui possible.
  • Defineix i aplica estils de format en la plantilla per garantir la coherència.
  • Valideu les fonts de dades abans de l’execució per evitar errors d’execució.
  • Utilitza gestors d’esdeveniments per a lògica personalitzada com ara incrustació d’imatges o formatació condicional.
  • Controleu la versió de les plantilles i proveu-les amb dades d’exemple regularment.
  • Registra el progrés de la fusió i els errors per a auditoria i monitoratge del rendiment.

Preguntes freqüents

  1. Què és Mail Merge per a .NET? Un marc per generar documents personalitzats a partir de plantilles amb merge fields, omplerts per fonts de dades com bases de dades o col·leccions.
  2. Quines fonts de dades són compatibles? DataTable, DataSet, IDataReader, matrius i objectes personalitzats a través de IMailMergeDataSource.
  3. Funciona amb dades jeràrquiques? Sí. Les regions imbricades permeten combinar estructures de dades pare-filla.
  4. Es poden inserir imatges dinàmicament? Sí. Utilitza MergeImageField esdeveniments per injectar imatges (p. ex., fotos de perfil, codis QR).
  5. Admet combinacions a gran escala? Sí. Optimitzat per al processament per lots d’alt volum amb una petita empremta de memòria.
 Català