Automatizirani izvješća s C# Mail Merge, Aspose.Words' Mail Merge Plugin

Automatizacija stvaranja prilagođenih dokumenata – kao što su izvješća, pisma i računa – može značajno poboljšati učinkovitost u vašem radnom toku. sa C# Mail Merge pohranjenom od strane Aspose.Words za .NET, možete to ostvariti besprijekorno. ovaj vodič će vas proći kroz korištenje Pluga za usklađivanje po pošti i pošte kako biste izvršili učinkovitu i skalabilnu generaciju dokumenta unutar vaših aplikacija.NET – bez potrebe za MS Word ili Office Interop.

sadržaji

• Što je Mail Merge?
• Izvori podataka za Mail Merge
• Priprema e-pošte sastavlja šablone
• Početak s Aspose.Words za .NET
• Izvođenje e-pošte Spajanje s uzornim podacima
• Pošta se miješa s XML podacima
• Korišteno formiranje polja
• Slijedeći članakSlijedeći članakSlijedeći članakSlijedeće
• Sljedeći članakNested Mail Merge
• zaključak

Što je Mail Merge? {what-is-mail-merge}

Mail Merge je moćna metodologija za dinamično generiranje dokumenata populiranjem predloga s podacima iz različitih izvora. Aspose.Words, možete automatizirati zadatke kao što su:

• Stvaranje osobnih pisama i računa.
• Stvaranje masovnih izvješća pomoću strukturiranih formata kao što su XML, JSON ili baze podataka, omogućavajući dynamsku generaciju izvještaja s C# i Aspose.Words.

Izvor podataka za Mail Merge

Aspose.Words podržava razne izvore podataka, uključujući:

• Objekti: Popularni predmeti koristeći razredne primjere.
• XML: Preuzimanje strukturiranih podataka za dinamična polja.
• JSON: Jednostavno se integrira s modernim API-ima.
• CSV: Preuzimanje tablica podataka za generiranje masovnih dokumenata.
• DataTable / DataSet: Koristite ADO.NET za integraciju baze podataka.

Priprema šablona za Mail Merge

Šablona za spajanje pošte je dokument koji sadrži polja za spajanje koje će biti popeljene s podacima iz vašeg određenog izvora podataka tijekom izvršenja. Šablona može biti u formatu DOC ili DOCX i ne zahtijeva određeni stil.

• Otvorite dokument ili stvorite novi u MS Wordu.
• Postavite kurzor gdje želite unijeti polje spajanja.
• Iz menija Upišite, odaberite opciju Polje.
• Iz popisa Ime polja, odaberite MergeField.
• Upišite ime za polje za spajanje u polju Ime polja i kliknite na OK.
• Sačuvajte ovaj dokument.

Sljedeći snimak prikazuje A uzorak template Dokumentacija je.

.NET Mail Merge API - Instaliranje

Možete instalirati Aspose.Words za .NET različitim metodama:

• Preuzimanje DLL
• Slijedeći članakNuGet Package Manager

Izvođenje Mail Merge u Word dokumentu pomoću C#

Nakon što je vaš predložak spreman, možete izvršiti mješavinu pošte kako biste generirali dokumente. Evo koraka kako biste izvršili mješavinu pošte na pripremljenom predložku:

• Preuzmite šablona dokumenata pomoću Dokumenti Klasa je.
• Sastavite potrebne opcije povezivanja pošte, kao što su Sljedeći članakDokument.MailMerge.TrimWhitespaces.
• Izvođenje e-pošte miješanjem pomoću Slijedeći članakDokument.MailMerge.Execute() Metoda, prenosi izvor podataka kao parametar.
• Sačuvajte proizvedenu dokumentaciju pomoću Slijedeći članakSave (String) Metoda je.

Ovdje je uzorak koda koji pokazuje kako automatizirati generaciju izvješća u C#-u pomoću niza vrijednosti:

Sljedeći članakSljedeći članakSljedeći članakSljedeći članakSljedeći članakSljedeće

Izvođenje Mail Merge pomoću XML izvora podataka u C#

XML datoteke se uobičajeno koriste za skladištenje i prijenos podataka. Aspose.Words za .NET podržava XML kao izvor podataka za operacije spajavanja pošte. DataSet Objekt i izvršiti e-mail spajanje. ispod je uzorak XML datoteke za naš slučaj korištenja.

<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>

Sljedeći uzorak koda povlači podatke iz izvora podataka XML-a i izvršava mješavinu pošte pomoću C#.

Sljedeći članakEmail merge Tempelj To će biti populirano s podacima iz XML datoteke.

Ova slika predstavlja prvu stranicu rezultativnog Word dokumenta dobivenog nakon izvršenja e-pošte.

Korištena formatacija polja sastavljanja {#korištena formatacija polja sastavljanja}

Aspose.Words za .NET pruža poboljšanu kontrolu nad procesom spajanja pošte. Sljedeći Članak MailMerge.FieldMergingCallback imovina vam omogućuje da konfigurirate ponašanje spajanja pošte kao što se susreće svako polje. Sljedeći članakSljedeći članakSljedeći članakSljedeći članakSljedeći članakSljedeće i Sljedeći članakIFieldMergingCallback.ImageFieldMerging Metode omogućuju prilagodbu operacije spajanja pošte.

Ispod je uzorak koda koji pokazuje kako primijeniti prilagođenu formataciju tijekom mješavine putem predviđenog uzorka:

Sljedeći implementira HandleMergeFieldAlternatingRows razred.

Mail Merge s Regijama pomoću C#

U nekim slučajevima, možda ćete morati popuniti i ponoviti određenu regiju unutar Word dokumenta. Za takve scenarije, koristite e-mail spajanje s regijama. Da biste stvorili regiji, navodite i početak i kraj regije; poštovanje će se zatim ponavljati za svaki zapis u izvoru podataka. Prikaz sledećeg predloga sadrži dva regija – narudžbe i narudžbeni detalji – koristeći polja „TabelaStart:Ordine”, „tabelaEnd:OrderDetails”, i „tabljestaend:Razlozi“.

Ovdje je uzorak koda koji izvršava mješavinu pošte na temelju regija za prethodno spomenute Tempelj.

Sljedeće metode ilustriraju kako pročitati podatke iz baze podataka.

Slijedeći članakNested Mail Merge

Često, podaci iz izvora su strukturirani u relativnim formatima. Na primjer, “Naručaji” mogu imati jedan-na-mnogi odnos s “Razgovori”, koji čuva zapise predmeta unutar narudžbe. Šablona računa To dobro odgovara tom scenariju.

Sljedeći je XML izvor podataka za naš primjer mješavine pošte.

<?xml version="1.0" encoding ="utf-8"?>
<Orders xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="OrdersSchema.xsd">
    <Order>
        <Number>23</Number>
        <Address>Nelson Street</Address>
        <Suburb>Howick</Suburb>
        <City>Auckland</City>
        <Phonenumber>543 1234</Phonenumber>
        <Date>03/01/2010</Date>
        <Total>14.00</Total>
        <Item>
            <Name>BBQ Chicken Pizza</Name>
            <Price>6.00</Price>
            <Quantity>1</Quantity>
            <ItemTotal>6.00</ItemTotal>
        </Item>
        <Item>
            <Name>1.5 Litre Coke</Name>
            <Price>4.00</Price>
            <Quantity>2</Quantity>
            <ItemTotal>8.00</ItemTotal>
        </Item>
    </Order>
    <Order>
        <Number>10</Number>
        <Address>Parkville Avenue</Address>
        <Suburb>Pakuranga</Suburb>
        <City>Auckland</City>
        <Phonenumber>548 7342</Phonenumber>
        <Date>05/03/2010</Date>
        <Total>6.00</Total>
        <Item>
            <Name>Hawaiian Pizza</Name>
            <Price>4.00</Price>
            <Quantity>1</Quantity>
            <ItemTotal>4.00</ItemTotal>
        </Item>
        <Item>
            <Name>Fries</Name>
            <Price>1.00</Price>
            <Quantity>2</Quantity>
            <ItemTotal>2.00</ItemTotal>
        </Item>
    </Order>
</Orders>

Odgovarajuća datoteka Smith.xsd za ovaj XML je:

<?xml version="1.0" encoding ="utf-8"?>
<xs:schema id="OrdersSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="Orders">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="Order">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="Number"/>
                            <xs:element name="Address"/>
                            <xs:element name="Suburb"/>
                            <xs:element name="City"/>
                            <xs:element name="Phonenumber"/>
                            <xs:element name="Date"/>
                            <xs:element name="Total"/>
                            <xs:element name="Item">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element name="Name"/>
                                        <xs:element name="Price"/>
                                        <xs:element name="Quantity"/>
                                        <xs:element name="ItemTotal"/>
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

Sljedeći kodni uzorak izvršava mješavinu pošte s pomoću C#.

Sljedeći članakSljedeći članakSljedeći članakSljedeći članakSljedeći članakSljedeće

Ispod je prva stranica rezultativnog Word dokumenta dobivenog nakon izvršavanja mješavine pošte.

zaključak

Aspose.Words za .NET je sveobuhvatna API povezivanja pošte koja pruža i standardne i proširene značajke prikladne za aplikacije. sa samo nekoliko linija koda, možete razviti jednostavne ili složene izvješća iz različitih izvora podataka bespomoćno. dokumentacijaZa početak s Aspose.Words za .NET, istražite dostupne Priručnici razvijatelja i kod uzoraka na GitHubPlugin Aspose također nudi napredne funkcije za generaciju izvješća.

Pokušajte Aspose.Words za .NET za besplatno

Možete dobiti besplatnu privremenu licenciju kako biste pokušali Aspose.Words za .NET bez ograničenja. Uzmite privremenu dozvolu sada.

More in this category

• Konvertirati Word DOC/DOCX u PDF u C# .NET Aspose.Words' Document Converter Plugin
• Generirajte kodove trake u Word dokumentima (.NET, C#) i čitajte kodove trake iz Word (.NET)
• Uklanjanje slika iz Word dokumenata u C#-u za automatsku obradu slika
• Pronađite i zamijenite tekst u Word dokumentima pomoću C#Automate Word Editing
• Stvaranje prilagođenih Word dokumenata pomoću C# .NET Aspose.Words Mail Merge Plugin