Introduzione

Automatizzare la creazione di documenti personalizzati—come rapporti, lettere e fatture—può farti risparmiare tempo e fatica. Con C# Mail Merge alimentato da Aspose.Words per .NET, puoi ottenere questo in modo semplice. Questa guida ti accompagnerà nell’uso del Plugin Mail Merge di Aspose.Words per effettuare una generazione di documenti efficiente e scalabile all’interno delle tue applicazioni .NET—senza bisogno di MS Word o Office Interop. Alla fine, sarai pronto per integrare C# mail merge per l’automazione dei rapporti e semplificare il tuo flusso di lavoro di reporting.

Contenuti:

Cos’è il Mail Merge? {#cos’è-il-mail-merge}

Il Mail Merge è una metodologia potente per generare documenti dinamicamente popolando modelli con dati provenienti da varie fonti. Con Aspose.Words, puoi automatizzare compiti come:

  • Generare lettere e fatture personalizzate.
  • Creare rapporti in blocco utilizzando formati strutturati come XML, JSON o database, abilitando generazione dinamica di rapporti con C# e Aspose.Words.

Fonti di Dati per il Mail Merge

Aspose.Words supporta una varietà di fonti di dati, tra cui:

  • Oggetti: Popola i modelli utilizzando istanze di classe.
  • XML: Carica dati strutturati per campi dinamici.
  • JSON: Integra facilmente con API moderne.
  • CSV: Sfrutta dati tabulari per la generazione di documenti in blocco.
  • DataTable/DataSet: Utilizza ADO.NET per l’integrazione con il database.

Preparazione del Modello per il Mail Merge

Il modello di mail merge è il documento contenente i campi di merge che saranno popolati con i dati dalla tua fonte di dati specificata durante l’esecuzione. Il modello può essere in formato DOC o DOCX e non richiede uno stile specifico. Segui questi passaggi per creare un modello di mail merge:

  1. Apri il tuo documento o creane uno nuovo in MS Word.
  2. Posiziona il cursore dove vuoi inserire un campo di merge.
  3. Dal menu Inserisci, seleziona l’opzione Campo.
  4. Dall’elenco Nomi dei campi, seleziona MergeField.
  5. Specifica un nome per il campo di merge nella casella Nome campo e fai clic su OK.
  6. Salva il documento.

Lo screenshot seguente illustra un modello di esempio documento.

Modello Mail Merge

API Mail Merge .NET - Installazione

Puoi installare Aspose.Words per .NET attraverso vari metodi:

Eseguire il Mail Merge in un Documento Word utilizzando C#

Una volta che il tuo modello è pronto, puoi eseguire il mail merge per generare documenti. Ecco i passaggi per eseguire il mail merge sul tuo modello preparato:

  1. Carica il documento modello utilizzando la classe Document.
  2. Imposta le opzioni di mail merge richieste, come Document.MailMerge.TrimWhitespaces.
  3. Esegui il mail merge utilizzando il metodo Document.MailMerge.Execute(), passando la fonte di dati come parametro.
  4. Salva il documento generato utilizzando il metodo Document.Save(String).

Ecco un esempio di codice che dimostra come automatizzare la generazione di rapporti in C# utilizzando un array di valori:

Documento Word dopo il Mail Merge

Esegui Mail Merge in C#

Eseguire il Mail Merge utilizzando una Fonte di Dati XML in C#

I file XML sono comunemente utilizzati per memorizzare e trasferire dati. Aspose.Words per .NET supporta XML come fonte di dati per le operazioni di mail merge. Basta leggere l’XML in un oggetto DataSet e eseguire il mail merge. Di seguito è riportato un file XML di esempio per il nostro caso d’uso.

<customers>
    <customer Name="John Ben Jan" ID="1" Domain="History" City="Boston"/>
    <customer Name="Lisa Lane" ID="2" Domain="Chemistry" City="LA"/>
    <customer Name="Dagomir Zits" ID="3" Domain="Heraldry" City="Milwaukee"/>
    <customer Name="Sara Careira Santy" ID="4" Domain="IT" City="Miami"/>
</customers>