Automatiniai pranešimai su „C# Mail Merge“ ir „Aspose.Words“ pašto merge papildas

Automatizuojant pritaikytų dokumentų kūrimą, pvz., ataskaitų, laiškų ir sąskaitų kūrimas gali žymiai padidinti jūsų darbo srauto efektyvumą. **C# Mail Merge ** , kurį palaiko **Aspose.Words .NET ** , galite tai pasiekti be jokios priežasties. Šis vadovas jums pasieks naudodamasis Aspoze.Vardas Mail merge Plugin veiksmingai ir sklandžiai sukurti dokumentus jūsų .Net programose - be MS Word ar Office Interop poreikio.

Contents

• Kas yra Mail Merge?
• Duomenų šaltiniai Mail Merge
• Paruošti Pašto jungimo šablonus
• Pradėti su Aspose.Words .NET
• Atlikti pašto jungtis su pavyzdžiu duomenis
• Laiškas sujungtas su XML duomenimis
• Kūrybinė įtraukimo lauko formatuotė
• Paštas sujungtas su regionais
• „Nested Mail“ susijungimas
• Conclusion

Kas yra „Mail Merge“?

Mail Merge yra galinga metodika, skirta dinamiškai generuoti dokumentus, populiuojant šablonus su duomenimis iš įvairių šaltinių. Aspose.Words leidžia automatizuoti tokias užduotis kaip:

• Sukurti asmeninius laiškus ir sąskaitas.
• Sukurkite daugiafunkcinius ataskaitas naudojant struktūrizuotus formatus, tokius kaip XML, JSON ar duomenų bazes, leidžiančias dinaminę ataskaitų gamybą su C# ir Aspose.Words .

Duomenų šaltiniai Mail Merge

Aspose.Words palaiko įvairius duomenų šaltinius, įskaitant:

• Objektai : Populiarių šablonų naudojant klasės pavyzdžius.
• XML : Atsisiųskite struktūrizuotus duomenis dinaminiais laukais.
• JSON : lengvai integruojamas su šiuolaikiniais API.
• CSV : Tabulinių duomenų išleidimas daugiapakopio dokumentų gamybai.
• DataTable / DataSet : Naudokite ADO.NET duomenų bazės integracijai.

Paruošimas Šablonas Mail Merg

Pašto jungimo šablonas yra dokumentas, kuriame yra jungimų laukai, kurie bus populizuojami su duomenimis iš jūsų nurodytos duomenų šaltinio vykdymo metu. šablona gali būti DOC arba DOCX formatu ir nereikalauja konkretaus stiliaus.

• Atidarykite dokumentą arba sukurkite naują MS Word.
• Įdėkite kursorių ten, kur norite įvesti jungimo lauką.
• Iš ** Įveskite ** meniu, pasirinkite Šalis parinktį.
• Iš sąrašo **Feld pavadinimai ** , pasirinkite MergeField .
• Įveskite sąsajos lauko pavadinimą langelyje **Feld name ** ir spustelėkite OK .
• Išsaugokite dokumentą.

Toliau pateikta ekrano nuotrauka rodo, kad A Šablonų pavyzdys ir dokumentų.

.NET Mail sujungti API - Įdiegimas

Galite įdiegti Aspose.Words .NET įvairiais būdais:

• Atsisiųsti DLL
• Įdiegti naudojant NuGet Package Manager

Perform Mail Merge Word dokumentu naudojant C#

Kai jūsų šablonas yra paruoštas, galite atlikti pašto derinimą, kad gautumėte dokumentus. Čia pateikiami žingsniai, kuriais atliksite savo parengtoje šablone:

• Atsisiųskite šablonų dokumentą naudojant Document ir klasės.
• Nustatykite reikalingus pašto derinimo variantus, pavyzdžiui, Dokumentas.MailMerge.TrimWhitspaces.
• Išsiųsti laišką sujungti naudojant Dokumentas.MailMerge.Execute() metodas, perduodamas duomenų šaltinį kaip parametrą.
• Išsaugoti sukurtą dokumentą naudojant Išsaugoti (Save String) ir metodą.

Čia pateikiamas kodo pavyzdys, parodantis, kaip automatizuoti ataskaitų generavimą C# naudojant vertės rinkinį :

Žodis dokumentas po pašto sujungimo

Perform Mail Merge naudojant XML duomenų šaltinį C#

XML failai dažniausiai naudojami duomenų saugojimui ir perdavimui. Aspose.Words for .NET palaiko XML kaip duomenų šaltinį pašto derinimo operacijoms. DataSet objektas ir atlikti pašto derinys. žemiau yra XML failo pavyzdys mūsų naudojimo atveju.

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

Toliau pateikiamas kodo pavyzdys gauna duomenis iš XML duomenų šaltinio ir atlieka pašto derinimą naudojant C#.

Žemiau yra pašto sąrašas Temperatūra Tai bus populuota su duomenimis iš XML failo.

Ši paveikslėlyje pateikiama pirmoji išvestinio Word dokumento puslapis, gautas po pašto derinimo.

Pritaikytos formatuojamos susieti laukai

Aspose.Words for .NET suteikia patobulintą el. pašto derinimo procesą. MailMerge.FieldMergingKalbėjimas turtas leidžia jums konfigūruoti pašto derinimo elgesį, kaip kiekvienas derinimas laukas susiduria. IFieldMergingCallback.FilmasSkaityti daugiau ir IFieldMergingCallback.ImageFeldSkaityti daugiau metodai leidžia pritaikyti pašto derinimo operaciją.

Žemiau pateikiamas kodo pavyzdys, parodantis, kaip taikyti pritaikytą formatavimą siuntimo metu per pateiktą pavyzdžio šabloną:

Toliau pateikiama HandleMergeFieldAlternatingRows klasė.

Pašto jungimas su regionais naudojant C#

Kai kuriais atvejais jums gali prireikti lokalizuoti ir pakartoti tam tikrą regioną žodžio dokumente. tokiems scenarijams naudokite pašto derinimą su regionais. Norėdami sukurti regione, nurodykite tiek regiono pradžią, tiek pabaigą; po to, kai siunčiamas paštas pakartos kiekvieną įrašą duomenų šaltinyje. žemiau pateiktame pavyzdžio pavyzdyje yra dvi regionai – užsakymai ir užsakymų detalės – naudojant derinimo laukus „TableStart:Orders“, „ TableEnd:OrderDetails“ ir „ Tablo End: OrderDatails“.

Čia pateikiamas kodo pavyzdys, kuris atlieka pašto derinimą remiantis anksčiau minėtais regionais Temperatūra.

Šie metodai iliustruoja, kaip skaityti duomenis iš duomenų bazės.

„Nested Mail“ susijungia

Dažnai duomenys iš šaltinio yra struktūrizuojami santykiniais formatais. Pavyzdžiui, “Prašymai” gali turėti vienos į kelis santykius su “OrderDetails”, kuris saugo elementų įrašus per užsakymą. sąskaitos template Tai puikiai tinka šiam scenarijui.

Toliau pateikiamas mūsų „Nested Mail“ derinimo pavyzdžio XML duomenų šaltinis.

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

Atitinkamas OrderSchema.xsd failas šiam XML yra:

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

Toliau pateikiamas kodo pavyzdys atlieka nestuotą pašto jungimą naudojant C#.

Žodis dokumentas po pašto sujungimo

Žemiau pateikiama pirmoji išvestinio „Word“ dokumento puslapis, gautas po to, kai vykdomas netiesioginis pašto derinys.

Conclusion

Aspose.Words for .NET yra išsamus pašto derinimo API, kuris suteikia tiek standartines, tiek išplėstines funkcijas, tinkamas .Net programoms. Su tik keliomis kodo eilutėmis galite nesąmoningai kurti paprastus ar sudėtingus pranešimus iš įvairių duomenų šaltinių. dokumentacijaNorėdami pradėti su Aspose.Words .NET, ištirkite turimą Kūrėjo vadovas Pavyzdžiui, kodas ant GitHubAspose Plugin taip pat siūlo pažangias ataskaitų generavimo funkcijas.

Išbandykite Aspose.Words už .NET nemokamai

Galite gauti nemokamą laikiną licenciją pabandyti Aspose.Words .NET be apribojimų. Gaukite laikiną licenciją dabar.

More in this category

• Konvertuoti Word DOC/DOCX į PDF į C# .NET Aspose.Words' Document Converter Plugin
• Gaminti juostų kodą Word dokumentuose (.NET, C#) Skaityti žymenį iš Word ( .NET)
• Nuotraukų ekstraktas iš „Word“ dokumentų „C#“ Automatinis vaizdo apdorojimas
• Rasti ir pakeisti tekstą "Word" dokumentuose naudojant C# "Automatic Word Editing"
• Sukurkite pritaikytus žodžio dokumentus naudojant C# .NET Aspose.Words Mail Merg Plugin