Automatisk rapportering med C# Mail Merge, Aspose.Words' Mail merge Plugin

Med **C# Mail Merge ** drives av **Aspose.Words for .NET ** , kan du oppnå dette uten problemer. Denne guiden vil gå deg gjennom ved å bruke **Aspose-Word-Melge Plugin ** for å utføre effektiv og skalaerbar dokumentgenerering i .Net-applikasjonene dine – uten behov for MS Word eller Office Interop. Ved slutten av denne guidet, vil du være utstyrt med å integrere Speed-Merge for rapporteringsautomatisering ** og stramme rapportering arbeidsflyten din ved hjelp av funksjonalitetenSpose C# Cells.

Contents

• Hva er Mail Merge?
• Data kilder for Mail Merge
• Forberedelse av Mail Merge Templates
• Start med Aspose.Words for .NET
• Perform Mail Mile med Sample Data
• Mail kombinerer med XML-data
• Tilpasset fusjonsfeltformatering
• Mail går sammen med regioner
• Nested Mail går sammen
• Conclusion

Hva er Mail Merge?

Mail Merge er en kraftig metodikk for dynamisk generering av dokumenter ved å populere maler med data fra ulike kilder. Aspose.Words , kan du automatisere oppgaver som:

• Generere personlig brev og fakturaer.
• Skaper bulkrapporter ved hjelp av strukturerte formater som XML, JSON eller databaser, slik at dynamisk rapportering kan genereres med C# og Aspose.Words .

Data kilder for Mail Merge

Aspose.Words støtter en rekke datakilder, inkludert:

• Objekter : Populære maler som bruker klasserinstanser.
• XML : Last strukturerte data for dynamiske felt.
• JSON : Enkelt å integrere med moderne APIs.
• CSV : Levering av tabelldata for generering av massedokument.
• DataTable / DataSet : Bruk ADO.NET for databaseintegrasjon.

Forbered Template for Mail Merge

E-postmølingstemplet er dokumentet som inneholder fusjonsfelt som vil bli populert med data fra din angitte datakilde under utførelsen. Templet kan være i DOC eller DOCX-format og krever ikke en spesifikk stil. Følg disse trinnene for å opprette en e-posta fusjonstempel:

• Åpne dokumentet ditt eller opprette en ny i MS Word.
• Plasser kursoren der du vil legge inn et fusjonsfelt.
• Fra **Insert ** -menyen velger du alternativet Felt .
• Fra **Feltnavn ** -listen velger du MergeField .
• Angi et navn for fusjonsfeltet i **Feltnavn ** -boksen og klikk OK .
• Lagre dokumentet.

Følgende skjermbilde illustrerer en Eksempler på template dokumentasjon .

.NET Mail Merge API - Installasjon

Du kan installere Aspose.Words for .NET ved hjelp av ulike metoder:

• Nedlasting av DLL
• Installasjon via NuGet Package Manager

Perform Mail Merge i Word Dokument ved hjelp av C#

Når malen din er klar, kan du kjøre e-postmøling for å generere dokumenter. Her er trinnene til å utføre mailmøkning på den forberedt mallen:

• Last ned templatedokumentet ved hjelp av Document og klasse.
• Sett de nødvendige e-post fusjonsalternativene, for eksempel Dokument.MailMerge.TrimWhitespaces.
• Utfør e-postmøtet ved hjelp av Dokumentasjon.MailMerge.Execute() Metoden passerer data kilden som en parameter.
• Lagre det genererte dokumentet ved hjelp av Dokumentasjon.Save (String) Metoden er.

Her er et kodemønster som viser hvordan man automatisk rapporterer generasjon i C# ved hjelp av en rekke verdier :

Word-dokumentet etter at posten går sammen

Perform Mail Merge ved hjelp av XML Data Source i C#

XML-filer brukes vanligvis for lagring og overføring av data. Aspose.Words for .NET støtter XML som en datakilde for e-post fusjonsoperasjoner. DataSet objekt og kjøre e-post fusjon. nedenfor er et XML-filer for vårt brukssaker.

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

Følgende kodemønster tar inn data fra en XML-data kilde og utfører e-postmøling ved hjelp av C#.

Nedenfor er posten fusjon Templer Det vil bli populert med data fra XML-filen.

Dette bildet representerer den første siden av det resulterende Word-dokumentet som er oppnådd etter å ha utført e-postmøtet.

Tilpasset formatering av mergefelt

Aspose.Words for .NET gir forbedret kontroll over e-post fusjonsprosessen. MailMerge.FieldMergingCallback eiendommen lar deg konfigurere e-post fusjon oppførsel som hvert fusjonsfelt er møtt. IFieldMergingCallback.FildMeging og IFieldMergingCallback.ImageFild Metodene gjør det mulig å tilpasse e-post fusjonsoperasjonen.

Nedenfor er et kodemønster som viser hvordan du skal bruke tilpasset formatering under e-postmøling gjennom den foreslåtte eksemplet:

Følgende implementerer HandleMergeFieldAlternatingRows klasse.

Mail Merge med Regjoner ved hjelp av C#

I noen tilfeller må du populere og gjenta en bestemt region i Word-dokumentet. For slike scenarier, bruk e-postmøling med regioner.For å opprette en region, angi både start og slutt av regionen; mail-monteringen vil deretter gjentatte dette området for hver rekord i datakilde. Templet eksemplet nedenfor inneholder to områder - Ordre og OrderDetails - ved hjelp av fusjonsfeltet «TableStart:Ordre», “TabellEnd:OrderDatails”, og «Taulukend:orderdetaljer».

Her er et kodemønster som utfører mail fusjon basert på regioner for de tidligere nevnt Templer.

Følgende metoder illustrerer hvordan du leser data fra en database.

«Nested Mail Merge»

Ofte er data fra kilden strukturert i relasjonelle formater. For eksempel, “Orders” kan ha en enkelt-til-mange forhold med “OrderDetails”, som holder opplysninger om elementer innenfor en ordre. I slike scenarier, bruk nested mail fusjon. Regnskap template Det passer bra til dette scenariet.

Følgende er en XML-data kilde for vårt nestede e-postminnes eksempel.

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

Den tilsvarende OrderSchema.xsd filen for denne XML er:

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

Følgende kodemønster utfører den nestede mail fusjonen ved hjelp av C#.

Word-dokumentet etter at posten går sammen

Nedenfor er den første siden av det resulterende Word-dokumentet som er oppnådd etter å ha utført den nestede e-postmøllen.

Conclusion

Aspose.Words for .NET er en omfattende mail fusjon API som gir både standard og utvidede funksjoner egnet for ,NET-applikasjoner. Med bare noen få linjer av kode, kan du utvikle enkle eller komplekse rapporter fra ulike datakilder uten problemer. DokumentasjonFor å begynne med Aspose.Words for .NET, utforske tilgjengelig Utviklerens veiledning Prøve koden på GitHubAspose Plugin tilbyr også avanserte funksjoner for rapportering.

Prøv Aspose.Words for .NET for gratis

Du kan få en gratis midlertidig lisens til å prøve Aspose.Words for .NET uten begrensninger. Få din midlertidige lisens nå.

More in this category

• Convert Word DOC/DOCX til PDF i C# .NET og Aspose.Words' Document Converter Plugin
• Generere barkoder i Word-dokumenter (.NET, C#) og les barkoden fra Word ( .NET)
• Utvinning av bilder fra Word-dokumenter i C# Automatisk bildebehandling
• Finn og erstatte tekst i Word-dokumenter ved hjelp av C# Automate Word Editing
• Skap tilpassede Word-dokumenter ved hjelp av C# .NET Aspose.Words Mail Merge Plugin