Automatyczne raporty za pomocą programu C# Mail Merge, Aspose.Words' Mail Merge Plugin

Automatyzacja tworzenia dokumentów osobistych – takich jak raporty, listy i faktury – może znacząco zwiększyć efektywność twojego przepływu roboczego. C# Mail Merge zasilany przez Aspose.Words dla .NET, możesz to osiągnąć bez przerwy.Ten przewodnik przejdzie cię przez wykorzystanie pliku Aspose-Word Mail Merg Plugin do wydajnej i skalowalnej generacji dokumentu w Twoich aplikacjach.NET – bez potrzeby MS Word lub Office Interop.

Zawartość

• Czym jest Mail Merge?
• Źródła danych dla Mail Merge
• Przygotowanie poczty do połączenia szablonów
• Zacznij od Aspose.Words dla .NET
• Wykonanie poczty łączy się z przykładowymi danymi
• Mail łączy się z danymi XML
• Custom Merge Field Formatyzacja
• Mail łączy się z regionami
• Niepowtarzalny mail
• konkluzja

Co to jest Mail Merge?

Mail Merge jest potężną metodą dynamicznego generowania dokumentów poprzez populowanie szablonów z danymi z różnych źródeł. Aspose.Words umożliwia automatyzację zadań takich jak:

• Tworzenie osobistych listów i faktur.
• Tworzenie raportów masowych za pomocą strukturowanych formatów, takich jak XML, JSON lub baz danych, umożliwiając dynamiczną generację raportów za pomocą C# i Aspose.Words.

Źródła danych dla Mail Merge

Aspose.Words obsługuje wiele źródeł danych, w tym:

• Obiekty: Popularne szablony za pomocą instancji klas.
• XML: Pobierz strukturowane dane dla pola dynamicznego.
• JSON: Łatwo zintegrować się z nowoczesnymi API.
• CSV: Przekazywanie danych tabeli do generowania dokumentów masowych.
• DataTable/DataSet: Użyj ADO.NET do integracji baz danych.

Przygotowanie szablonu dla Mail Merge

szablon połączenia poczty jest dokumentem zawierającym pola połączenia, które będą zamieszczone z danymi z określonego źródła danych podczas wykonywania. szablon może być w formacie DOC lub DOCX i nie wymaga konkretnego stylu.

• Otwórz dokument lub utwórz nowy w programie MS Word.
• Umieść kursor, gdzie chcesz wprowadzić pole połączenia.
• Z menu Wprowadź wybierz opcję Własność.
• Z listy Imię obszarów, wybierz MergeField.
• Wyznacz nazwę pola połączenia w polu Nazwa pola i kliknij OK.
• Zachowaj dokument.

Poniższe zdjęcie wyświetla A próbki template w dokumencie .

.NET Mail Merge API - Instalacja

Możesz zainstalować Aspose.Words dla .NET za pomocą różnych metod:

• Pobierz DLL
• Instalacja przez NuGet Package Manager

Wykonaj Mail Merge w dokumencie Word za pomocą C#

Gdy Twój szablon jest gotowy, możesz wykonać fuzję poczty do generowania dokumentów. oto kroki, aby wykonać fuzję poczty na przygotowanym szablonie:

• Pobierz dokument szablonu za pomocą Dokumenty w klasie .
• Wybierz wymagane opcje połączenia poczty, takie jak: Dokumentacja.MailMerge.TrimWhitespaces.
• Wykonaj połączenie poczty za pomocą Dokumentacja.MailMerge.Execute() metodą, przekazując źródło danych jako parametr.
• Zachowaj utworzony dokument za pomocą Strona główna / String (String) metodą .

Oto próbka kodu, która pokazuje, jak automatycznie generować raporty w C# za pomocą szeregu wartości:

Wpisy po połączeniu poczty

Wykonaj Mail Merge za pomocą źródła danych XML w C#

Pliki XML są powszechnie używane do przechowywania i przekazywania danych. Aspose.Words dla .NET obsługuje XML jako źródło danych dla operacji połączenia poczty. DataSet Obiekt i wykonanie połączenia poczty. poniżej jest próbka pliku XML dla naszego przypadku użytkowania.

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

Poniższa próbka kodu pobiera dane z źródła danych XML i wykonuje połączenie poczty za pomocą C#.

Poniżej znajduje się mail merge świątyni Będzie to populowane z danymi z pliku XML.

Ten obraz przedstawia pierwszą stronę wynikającego dokumentu Word uzyskanego po wykonaniu połączenia poczty.

Dostosowany formatowanie pól mieszanych

Aspose.Words dla .NET zapewnia zwiększoną kontrolę nad procesem połączenia poczty. Wiadomości MailMerge.FieldMergingCallback Właściwość pozwala na konfigurację postu połączenia zachowania, jak każde pole połączeń jest spotkać. IFieldMergingCallback.FieldMerging i IFieldMergingCallback.ImageFieldMerging Metody umożliwiają dostosowanie operacji połączenia poczty.

Poniżej znajduje się próbka kodu, która pokazuje, jak zastosować dostosowane formatowanie podczas połączenia poczty za pośrednictwem przedstawionego szablonu przykładowego:

Następujące wdraża klasę HandleMergeFieldAlternatingRows.

Mail Merge z Regionami za pomocą C#

W niektórych przypadkach może być konieczne zamieszczenie i powtarzanie określonego regionu w dokumencie Word. Dla takich scenariuszy użyj połączenia poczty z regionami. Aby utworzyć region, określ zarówno pocztę, jak i koniec regiona; połączenie pocztowe następnie powtórzy ten region dla każdego rejestru w źródle danych. Przykład poniżej zawiera dwa regiony — Porady i szczegóły porady — używając pola połączeń «TableStart:Orders», «Details tabeli:Order» i «Plan końcowy:Porady».

Oto próbka kodu, która wykonuje połączenie poczty pocztowej w oparciu o regiony dla wyżej wymienionych świątyni.

Poniższe metody ilustrują, jak czytać dane z bazy danych.

Nasted Mail Merge

Często dane z źródła są strukturowane w formatach relacyjnych. Na przykład, “Porady” mogą mieć związek jeden do wielu z “Detały zamówienia”, który utrzymuje rekordy elementów w ramach porządku. Moduł faktury To dobrze dopasowuje ten scenariusz.

Poniżej znajduje się źródło danych XML dla naszego przykładowego połączenia poczty.

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

Równoległy plik OrderSchema.xsd dla tego XML to:

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

Poniższa próbka kodu wykonuje fuzję przesyłanej poczty za pomocą C#.

Wpisy po połączeniu poczty

Poniżej znajduje się pierwsza strona wynikającego dokumentu Word uzyskanego po wykonaniu fuzji pocztowej.

konkluzja

Aspose.Words dla .NET to kompleksowa API połączenia poczty, która zapewnia zarówno standardowe, jak i rozszerzone funkcje odpowiednie dla aplikacji. za pomocą zaledwie kilku linii kodu, można bezpiecznie opracować proste lub złożone raporty z różnych źródeł danych. dokumentacjaAby rozpocząć od Aspose.Words dla .NET, odkryj dostępny Przewodnik dla deweloperów i kod próbki na GitHub. Plugin Aspose oferuje również zaawansowane funkcje generowania raportów.

Spróbuj Aspose.Words dla .NET za darmo

Możesz uzyskać darmową tymczasową licencję, aby spróbować Aspose.Words dla .NET bez ograniczeń. Uzyskaj licencję tymczasową już teraz.

More in this category

• Konwertuj Word DOC/DOCX do PDF w programie C# .NET Aspose.Words' Document Converter Plugin
• Generowanie kodu kreskowego w dokumentach Word (.NET, C#) | Odczyt kodu kreskowego z Worda (.NET)
• Ekstrakcja obrazów z dokumentów Word w C# Automatyczne przetwarzanie obrazu
• Znajdź i zastąp tekst w dokumentach Word za pomocą C#Automate Word Editing
• Tworzenie dostosowanych dokumentów Word za pomocą programu C# .NET Aspose.Words Mail Merge Plugin