Automatické zprávy s C# Mail Merge a Aspose.Words Mail Merge Plugin

Automatizace vytváření personalizovaných dokumentů – jako jsou zprávy, písmena a faktury – může výrazně zvýšit efektivitu vašeho pracovního toku. C# Mail Merge napájený Aspose.Words pro .NET, můžete to dosáhnout bezproblémově. Tento průvodce vám umožní používat Plugin Aspoze.Slovo Mail Merging k výkonu efektivní a skalovatelné generace dokumentu v rámci vašich aplikací.NET – bez nutnosti MS Word nebo Office Interop.

Obsah

• Co je Mail Merge?
• Datové zdroje pro Mail Merge
• Připravování Mail Merge Templates
• Začněte s aplikací Aspose.Words pro .NET
• Poskytování e-mailu se shromažďováním vzorových dat
• Pošta se slouží s XML daty
• Přizpůsobené formátování pole
• Poštovní spojení s regiony
• Nested Mail se připojí
• závěr

Co je to Mail Merge}

Mail Merge je výkonná metodika pro dynamické generování dokumentů populací šablon s daty z různých zdrojů. Aspose.Words umožňuje automatizovat úkoly, jako jsou:

• Vytváření personalizovaných dopisů a faktur.
• Vytváření hromadných zpráv pomocí strukturovaných formátů, jako jsou XML, JSON nebo databáze, které umožňují dynamické generování zpráv s C# a Aspose.Words.

Datové zdroje pro Mail Merge

Aspose.Words podporuje různé zdroje dat, včetn:

• Objekty: Populární šablony pomocí třídních příklad.
• XML: Nabíjejte strukturované údaje pro dynamické pole.
• JSON: Snadno se integruje s moderními API.
• CSV: Odstranění tabulárních údajů pro generování dokumentů v množstv.
• DataTable/DataSet: Použijte ADO.NET pro integraci databáze.

Připravování šablony pro Mail Merge {#připravování mail-merge-templates}

ablona fúzí pošty je dokument obsahující fúzí polí, které budou populovány s daty z vašeho specifikovaného zdroje dat během provozu. Šablona může být ve formátu DOC nebo DOCX a nevyžaduje specifický styl:

• Otevřete dokument nebo vytvořte nový v MS Word.
• Položte kurzor tam, kde chcete vložit fúzní pole.
• V nabídce Vložte vyberte možnost Pole.
• Z seznamu Názvy pole vyberte MergeField.
• Zadejte název pro fúzní pole v okně Pole název a klikněte na OK.
• Zachraňte dokument.

Následující screenshot zobrazuje Šablona vzorku a dokumentů.

.NET Mail Merge API - Instalace

Můžete nainstalovat Aspose.Words pro .NET různými způsoby:

• Stáhnout DLL
• Instalace prostřednictvím NuGet Package Manager

Výkon Mail Merge v Word dokumentu pomocí C#

Jakmile je váš šablona hotová, můžete provést fúzi e-mailu k vytváření dokumentů. zde jsou kroky k provedení fúze e-mailu na vaší připravené šablone:

• Vložte šablónu dokumentu pomocí Dokumenty a třídy.
• Nastavení požadovaných možností fúze pošty, jako je Documentace.MailMerge.TrimWhitespaces.
• Využijte e-mailové spojení pomocí Dokument.MailMerge.Exekutovat() Metoda přenosu datového zdroje jako parametru.
• Shromažďujte vytvořený dokument pomocí Záchranářská strana (String) a metody .

Zde je vzorek kódu, který ukazuje, jak automatizovat generování zpráv v C# pomocí řady hodnot:

Text po přidání e-mailu

Výkon Mail Merge pomocí XML Data Source v C#

Soubory XML se běžně používají k ukládání a přenosu dat. Aspose.Words pro .NET podporuje XML jako zdroj dat pro operace fúze pošty. DataSet Objekt a spustit e-mail fus. níže je vzorek XML souboru pro náš případ použití.

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

Následující vzorek kódu získává data z datového zdroje XML a provádí fúzi e-mailu pomocí C#.

Níže je e-mailová schránka Templář To bude populováno s daty z souboru XML.

Tento obrázek představuje první stránku výsledného dokumentu Word získaného po spuštění e-mailové fúze.

Přizpůsobené formátování Merge pole

Aspose.Words pro .NET poskytuje zvýšenou kontrolu nad procesem fúze e-mailu. Společnost MailMerge.FieldMergingCallback vlastnost vám umožní nastavit e-mailové fúrování chování, jak se každé fúzní pole potkává. Přehrávač: IFieldMergingCallback a IFieldMergingCallback.ImageFieldMerging Metody umožňují přizpůsobení operace fúze pošty.

Níže je vzorek kódu, který ukazuje, jak aplikovat přizpůsobené formátování během e-mailového fúze prostřednictvím předloženého vzorku:

Následující provádí třídu HandleMergeFieldAlternatingRows.

Mail Merge s Regiony pomocí C#

V některých případech může být nutné populovat a opakovat konkrétní oblast v dokumentu Word. Pro takové scénáře použijte e-mailovou fúzi s regiony. Chcete-li vytvořit region, specifikujte jak začátek, tak konec regionu; e‐mailová fúzí pak opakuje tuto oblast pro každý záznam v zdroji dat. Příklad šablony níže obsahuje dvě oblasti – Objednávky a podrobnosti o objednávce – používající pole „TableStart:Ordce“, „tabuleEnd:OrderDetails“ a „tabulový konec:Data objednávky“.

Zde je vzorek kódu, který provádí e-mailovou fúzi na základě regionů pro výše uvedené Templář.

Následující metody ilustrují, jak číst data z databáze.

Nested Mail se shromažďuje}

Často jsou údaje ze zdroje strukturovány ve vztahových formátech. Například, “Návody” mohou mít jeden-z mnoha vztahy s “Detail objednávky”, který uchovává záznamy o položkách v rámci příkazu. fakturační šablona Tím se tento scénář dobře hodí.

Následující je příklad datového zdroje XML pro naše spojení pošty.

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

Příslušný soubor OrderSchema.xsd pro tento 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>

Následující vzorek kódu provádí fúzi nahromaděné pošty pomocí C#.

Text po přidání e-mailu

Níže je první stránka výsledného dokumentu Word získaného po spuštění splynutí pošty.

závěr

Aspose.Words pro .NET je komplexní mail fusion API, který poskytuje jak standardní, tak rozšířené funkce vhodné pro aplikace. s pouhými řadami kódu, můžete vyvíjet jednoduché nebo složité zprávy z různých datových zdrojů bez problémů. Dokumentace. Chcete-li začít s Aspose.Words pro .NET, prozkoumejte dostupné Návod vývojáře a vzorkový kód na GitHub. Plugin Aspose také nabízí pokročilé funkce pro generování zpráv.

Vyzkoušejte Aspose.Words pro .NET zdarma

Můžete získat bezplatnou dočasnou licenci k vyzkoušení Aspose.Words pro .NET bez omezení. Získejte svou dočasnou licenci nyní.

More in this category

• Konvertovat Word DOC/DOCX do PDF v C# .NET a Aspose.Words' Document Converter Plugin
• Generovat čárový kód v dokumentech Word (.NET, C#) | Číst čárový kód z Wordu (.NET)
• Extrakt snímků z Word dokumentů v C# Automatické zpracování snímků
• Najít a nahradit text v Word dokumentech pomocí C# Automatické úpravy slov
• Vytvořte přizpůsobené Wordové dokumenty pomocí C# .NET Aspose.Words Mail Merge Plugin