A személyre szabott dokumentumok – például jelentések, levelek és számlák – létrehozásának automatizálása jelentősen javíthatja a munkafolyamat hatékonyságát. Aspose.Words for .NET által működtetett C# Mail Merge segítségével könnyedén meg tudod érni ezt. Ez az útmutató a Aspose-Word Mail merge Plugin használatával jár el, hogy hatékony és skálázható szövegtermelést végezzen a .Net alkalmazásokon belül – MS Word vagy Office Interop igénye nélkül.

Tartalom

Mi az a Mail Merge?

A Mail Merge egy hatékony módszertan a dokumentumok dinamikus generálásához a különböző forrásokból származó adatokkal ellátott sablonok populációjával. Aspose.Words segítségével olyan feladatok automatizálhatók, mint:

  • személyre szabott levelek és számlák létrehozása.
  • A tömeges jelentések létrehozása strukturált formátumokkal, mint például XML, JSON vagy adatbázisok, lehetővé téve a dinamikus jelentési generációt C# és Aspose.Words segítségével.

Adatforrások Mail Merge

Az Aspose.Words számos adatforrást támogat, köztük:

  • Objects: Népszerű minták az osztály példák használatával.
  • XML: A strukturált adatok feltöltése dinamikus mezők számára.
  • JSON: Könnyen integrálható a modern API-kkal.
  • CSV: A tömeges dokumentumok generációjára szolgáló táblagép-adatok feltöltése.
  • DataTable / DataSet: Az adatbázis integrációhoz használja az ADO.NET-t.

Template for Mail Merge előkészítése

Az e-mail feldolgozási sablon az a dokumentum, amely a feldolgozási mezőket tartalmazza, amelyek a végrehajtás során az Ön által megadott adatforrásból származó adatokkal fognak elhelyezkedni. A sablon DOC vagy DOCX formátumban lehet, és nem igényel specifikus stílust.

  • Nyissa meg a dokumentumot, vagy hozzon létre egy újot az MS Word-ben.
  • Helyezze a kurzorot, ahol csatlakoztatni szeretne egy mezőt.
  • A Bevezetés menüből válassza ki a Felület opciót.
  • A Földnevek listából válassza ki a MergeField lehetőséget.
  • Jelölje meg a fúró mező nevét a Feltnév dobozban, és kattintson az OK gombra.
  • Mentse meg a dokumentumot!

A következő képernyőfelvétel illusztrálja a Template minták A dokumentum.

Mail Merge Template

.NET Mail Merge API - telepítés

A Aspose.Words for .NET különböző módszerekkel telepíthető:

A Word dokumentumban a C# használatával végezze el a levelezést.

Miután a sablon készen áll, végrehajthatja az e-mail fúrást, hogy dokumentumokat generáljon.Itt vannak a lépések, hogy végrehajtson az e-mail fúrást a kész sablonon:

Íme egy kódmintája, amely megmutatja, hogyan lehet automatikusan jelentést generálni a C#-ban az értékek sorozatával:

Word dokumentum az e-mail összekapcsolása után

Execute Mail Merge in C#

Működjön Mail Merge XML adatforrás használatával C#

Az XML fájlokat általában az adatok tárolására és továbbítására használják. Aspose.Words for .NET támogatja az XML adatforrást az e-mail egyesítési műveletekhez. DataSet objektum és végezze el az e-mail egyesülés. Az alábbiakban van egy XML-fájl mintája a használati esetünkre.

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

Az alábbi kódmintája az XML adatforrásból származó adatokat veszi át, és a C# használatával végrehajtja a levelezést.

Az alábbiakban az e-mail egyesülése Templomok Ezeket az adatokat a XML-fájlból fogja beolvasni.

Mail Merge Template for XML

Ez a kép az eredményes Word-dokumentum első oldala, amelyet az e-mail fúzió végrehajtása után kaptak.

Execute Mail Merge with XML in C#

Összehasonlító mezők személyre szabott formázása

Aspose.Words a .NET biztosítja a fokozott ellenőrzést az e-mail fúzió folyamat. MailMerge.FieldMergingCallback Szórakozás tulajdonság lehetővé teszi, hogy konfigurálja az e-mail fúró viselkedés, ahogy minden egyes mező találkozik. IFieldMergingCallback.FieldMerging és IFieldMergingCallback.ImageFieldMerging A módszerek lehetővé teszik az e-mail fúziós művelet személyre szabását.

Az alábbiakban egy kód mintája mutatja, hogyan kell alkalmazni a személyre szabott formázást az e-mail fúzió során a bemutatott példamódon keresztül:

Az alábbiakban a HandleMergeFieldAlternatingRows osztály szerepel.

Mail Merge a Régiókkal C# használatával

Bizonyos esetekben a Word-dokumentumon belül egy adott régiót kell elhelyezni és megismételni. Az ilyen forgatókönyvekhez használja az e-mail fúziót a régiókkal. A régió létrehozásához jelölje meg mind a térség kezdetét, mind pedig a végét; ezután ismétli meg ezt a területet az adatforrás minden rekordjára.Az alábbi mintázat példája két régióval rendelkezik - Rendek és Rendelési részletek - a „TableStart:Orders” mezőket használva.

Mail Merge Template with Regions

Itt van egy kódmintája, amely a korábban említett régiókra épülő e-mail egyesítést hajtja végre Templomok.

Az alábbi módszerek illusztrálják, hogyan olvashatunk adatokat egy adatbázisból.

A Nested Mail összekapcsolódik

Gyakran előfordul, hogy a forrásból származó adatok relatív formátumokban vannak szerkezetbe helyezve. Például a “Tárgyak” egy-más kapcsolatba kerülhetnek az “Details”, amely megtartja az elemek rekordját egy sorrendben. Ilyen forgatókönyvekben használja a nemes levelezést. Számlázási templom Ez jól illeszkedik a forgatókönyvhez.

Mail Merge Template with Regions

Az alábbiakban az XML adatforrás a mi nemes levelezési fúró példa.

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

Az erre az XML-re vonatkozó OrderSchema.xsd fájl a következő:

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

A következő kódmintát a C# használatával hajtja végre a nemes levelezést.

Word dokumentum az e-mail összekapcsolása után

Az alábbiakban az eredményes Word dokumentum első oldala található, miután végrehajtotta a nemes levelezést.

Word Document after Mail Merge

következtetések

Aspose.Words for .NET egy átfogó e-mail fúzió API, amely mind a standard és kiterjesztett funkciók alkalmasak .net alkalmazások. csak néhány vonal a kód, akkor dolgozhat ki egyszerű vagy összetett jelentések a különböző adatforrások anélkül. Dokumentáció. Ahhoz, hogy elkezdje a Aspose.Words for .NET, vizsgálja meg a rendelkezésre álló Fejlesztő útmutató A minta kódja a GitHubA Aspose Plugin továbbá fejlett funkciókat kínál a jelentések generációjára.

Próbálja ki Aspose.Words for .NET for Free

Ingyenes ideiglenes licencet kaphat, hogy a .NET-hez korlátozás nélkül megpróbálja Aspose.Words-t. Most kapja meg az ideiglenes licencét.

More in this category