Автоматичні звіти з C# Mail Merge, Aspose.Words' Mail Merge Plugin

Автоматизація створення персоналізованих документів, таких як звіти, листи та рахунки, може значно підвищити ефективність у вашому робочому потоці. з C# Mail Merge за допомогою Aspose.Words для .NET, ви можете досягти цього безперервно. Цей посібник пройде через вас, використовуючи Aspose-Word Mail merge Plugin для ефективного і масштабного генерування документів в ваших додатках .NET — без необхідності MS Word або Office Interop.

Контент

• Що таке Mail Merge?
• Джерела даних для Mail Merge
• Підготовка поштових шаблонів
• Починаючи з Aspose.Words для .NET
• Виконання пошти поєднується з даними зразка
• Пошта поєднується з даними XML
• Створення Custom Merge Field Formatting
• Пошта поєднується з регіонами
• Створення Nested Mail Merge
• Заключення

Що таке Mail Merge?

Mail Merge є потужною методологією для динамічного генерування документів шляхом популяризації шаблонів з даними з різних джерел. Aspose.Words дозволяє автоматизувати такі завдання, як:

• Створення персоналізованих листів і рахунків.
• Створення масових звітів за допомогою структурованих форматів, таких як XML, JSON, або баз даних, що дозволяє динамічну генерацію звітів з C# і Aspose.Words.

Джерела даних для Mail Merge

Aspose.Words підтримує різні джерела даних, в тому числі:

• Об’єкти: Популярні шаблони за допомогою класових прикладів.
• XML: Завантажити структуровані дані для динамічних полів.
• JSON: легко інтегрується з сучасними АПІ.
• CSV: Завантажити табличні дані для генерації масових документів.
• DataTable/DataSet: Використовуйте ADO.NET для інтеграції баз даних.

Підготовка шаблону для Mail Merge {# Підготовка-пошта-поєднання шаблонів}

Шаблон поєднання електронної пошти - це документ, що містить поля поєднання, які під час виконання будуть розміщені з даними з зазначеного джерела даних. Шаблон може бути у форматі DOC або DOCX і не вимагає конкретного стилю.

• Відкрийте документ або створюйте новий в MS Word.
• Помістіть курсор там, де ви хочете вставити поле поєднання.
• З меню Введіть, виберіть опцію Поля.
• З списку Назва поля виберіть MergeField.
• Введіть ім’я для полів з’єднання в поле Назва поля і натисніть OK.
• Зберегти документ.

Наступна фотографія показує, що Шаблон шаблону Документ .

.NET Mail Merge API - Інсталяція

Ви можете встановити Aspose.Words для .NET за допомогою різних методів:

• Завантажити DLL
• Створення NuGet Package Manager

Виконання Mail Merge в Word Document за допомогою C#

Після того, як ваш шаблон готовий, ви можете виконати поштовх поштовху, щоб генерувати документи. ось кроки, щоб виконати поштовх поштовху на підготовленому шаблоні:

• Завантажити документ шаблону за допомогою Документ У класі.
• Налаштуйте необхідні варіанти поєднання електронної пошти, такі як Документ.MailMerge.TrimWhitespaces.
• Використання електронної пошти за допомогою Документ.MailMerge.Execute() Метод передачі джерела даних як параметра.
• Зберегти генеруваний документ за допомогою Створення Save (String) Метод є.

Ось зразка коду, що показує, як автоматично генерувати звіти в C# за допомогою ряду цінностей:

Реферат на тему: Word Document After Mail Merge

Використовуйте XML Data Source в C#

Файли XML найчастіше використовуються для зберігання та передачі даних. Aspose.Words для .NET підтримує XML як джерело даних для операцій по електронній пошті. DataSet об’єкт і виконувати пошту поєднання. нижче є зразка XML-файлу для нашого випадку використання.

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

Наступна шаблон коду отримує дані з джерела даних XML і виконує поштовх поєднання за допомогою C#.

Нижче знаходиться поштовий поштовх Храм Це буде популяризовано з даними з XML-файлу.

Ця картина являє собою першу сторінку вихідного Word-документу, отриманого після виконання пошти.

Налаштування полів поєднання

Aspose.Words для .NET забезпечує підвищений контроль над процесом поєднання електронної пошти. Завантажити MailMergingCallback Власність дозволяє налаштувати поведінку поєднання поштового зв’язку так, як зустрічається кожне поле. Завантажити Callback.FieldMerging і Створення IFieldMergingCallback.ImageFieldMerging Методи дозволяють налаштувати операцію поєднання електронної пошти.

Нижче є шаблон коду, що показує, як застосовувати персоналізований форматинг під час пошти поєднання через наданий шаблон прикладу:

Нижче наведено клас HandleMergeFieldAlternatingRows.

Mail Merge with Regions за допомогою C#

У деяких випадках вам може знадобитися розмістити і повторювати певний регіон в документі Word. Для таких сценаріїв використовуйте поштовх поєднання з регіонами. Щоб створити регіону, вкажіть як початок, так і кінець регіону; пошта поєднує потім повторить цю область для кожного запису в джерелі даних. Приклад шаблону нижче містить два регіони — Замовлення та Детальніше про замовлення — за допомогою полів поєднання «TableStart:Orders», «ТаблицяПочаток:OrderDetails», і «ТableEnd: OrderDatails».

Ось шаблон коду, який виконує поштовх поєднання на основі регіонів для вищезазначеного Храм.

Наступні методи ілюструють, як читати дані з бази даних.

Створення Nested Mail Merge

Часто дані з джерела структуровані у відносному форматі. Наприклад, Замовлення можуть мати одно-до-многих відносин з Детальніше про замовлення, що зберігає записи предметів в рамках замовлень. У таких сценаріях використовуйте ніснений поштовх. Файловий шаблон Це добре підходить для цього сценарію.

Нижче наведено джерело даних XML для нашого прикладу поєднання поштового зв’язку.

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

Додатковий файл OrderSchema.xsd для цього XML є:

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

Наступна зразка коду виконує з’єднання пошти за допомогою C#.

Реферат на тему: Word Document After Mail Merge

Нижче знаходиться перша сторінка вихідного Word-документу, отриманого після виконання поштанної пошти.

Заключення

Aspose.Words для .NET - це всеосяжний API пошти, що забезпечує як стандартні, так і розширені функції, які підходять для додатків .net. з декількома рядками коду, ви можете безперервно розробляти прості або складні звіти з різних джерел даних. ДокументаціяЩоб почати з Aspose.Words для .NET, перегляньте доступні Руководство розробника Кодекс зразка на GitHub. Aspose Plugin також пропонує передові функції для генерації звітів.

Спробуйте Aspose.Words для .NET безкоштовно

Ви можете отримати безкоштовну тимчасову ліцензію, щоб спробувати Aspose.Words для .NET без обмежень. Отримати своє тимчасове ліцензію зараз.

More in this category

• Конвертувати Word DOC/DOCX в PDF в C# .NET і Aspose.Words' Document Converter Plugin
• Генерація штрих-коду в документах Word (.NET, C#) | Зчитування штрих-коду з Word (.NET)
• Витяг зображень з Word-документів в C#, автоматична обробка зображень
• Знайти та замінити текст у Word-документах за допомогою C#, автоматичне редагування
• Створення персоналізованих Word-документів за допомогою C# .NET Aspose.Words Mail Merge Plugin