---
title: "Mail Merge та звіт у Python"
---

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

Поле Mail Merge - це поле, яке можна вставити в шаблон mail merge для включення певних значень із запису джерела даних у вихідні документи. Наприклад, ви можете вставити об'єднуюче поле в шаблон електронної пошти, щоб у привітанні було вказано ім'я одержувача, а не звичайне " Привіт!". Aspose.Words у ці поля розміщуються дані із зовнішнього джерела, такі як база даних або файл, і вони форматуються. Отриманий документ зберігається в зазначеній папці.

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

- Створюйте звіти в Microsoft Word за допомогою стандартних Mail Merge полів
- Визначте зростаючі області в документі, такі як рядки детального замовлення (наразі не підтримується у версії Python)
- Вставка зображень під час mail merge
- Виконуйте будь-яку логіку користувача, керуйте форматуванням або вставляйте складний вміст за допомогою обробників подій Mail Merge (наразі не підтримується у версії Python)
- Заповнювати документи даними з будь-якого типу джерела даних (наразі не підтримується у версії Python, підтримується лише джерело даних arrays)

```

Модуль [aspose.words.mailmerging](https://reference.aspose.com/words/python-net/aspose.words.mailmerging/) використовується для роботи з об'єднанням Пошти.

```

## Механізм та основні компоненти операції Mail Merge {#mechanism-and-main-components-of-a-mail-merge-operation}

Aspose.Words надає можливість завантажувати документи в різних [supported formats](https://reference.aspose.com/words/python-net/aspose.words/loadformat/) форматах, а потім дозволяє користувачам виконувати Mail Merge операції.

Зазвичай завантажений документ дозволяє зберігати поля злиття, наприклад, документ у форматі DOCX. Але є формати, які не зберігають такі поля, наприклад, TXT. Якщо Aspose.Words підтримує завантаження таких форматів файлів, ви можете додати поля злиття безпосередньо до моделі документа, зберегти документ у зручному [supported format](https://reference.aspose.com/words/python-net/aspose.words/saveformat/) вигляді та виконати операцію Mail Merge.

Операція Mail Merge об'єднає ваші *mail merge template* та ваші *data source*, щоб створити окремий *merged documents*.

## Що таке шаблон Mail Merge {#what-is-a-mail-merge-template}

Мета застосування операції mail merge з використанням шаблону злиття полягає в тому, щоб спростити процес створення документа.

Існує кілька способів створення і оформлення шаблону злиття. Ви можете використовувати Microsoft Word, і шаблон злиття не повинен бути шаблоном Microsoft Word, тобто документом у форматі DOT або DOTX, це може бути звичайний документ у форматі DOC або DOCX. Вам потрібно вставити в цей шаблон кілька спеціальних полів, які називаються полями злиття, у місцях, куди ви хочете пізніше вставити дані з джерела даних. Або ви можете програмно створити шаблон злиття за допомогою класу [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/).

Шаблон об'єднання містить основний текст, який повинен бути однаковим у всіх вихідних документах після виконання операції Mail Merge. Ви можете використовувати будь-який формат для свого шаблону, якщо є можливість додати до нього поля для об'єднання. Усі поля для об'єднання у вашому шаблоні будуть заповнені з вашого джерела даних під час операції Mail Merge.

## Типи джерел даних для операції Mail Merge {#data-source-types-for-a-mail-merge-operation}

В даний час Aspose.Words для Python via .NET Mail Merge приймає лише масив значень як джерело даних. Інші типи будуть додані в майбутніх версіях.

Наступний приклад коду показує, як створити простий шаблон і заповнити його даними за допомогою функціональності Mail Merge:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Mail Merge and Reporting-base_operations-SimpleMailMerge.py" >}}

## Об'єднані документи операції Mail Merge {#merged-documents-of-a-mail-merge-operation}

Об'єднаний документ є результатом операції Mail Merge, що виконується при об'єднанні шаблону з джерелом даних. Усі поля для об'єднання в об'єднаному документі замінюються фактичними даними з вашого джерела даних.

На наступному малюнку показаний приклад шаблону об'єднання з об'єднаними полями перед виконанням операції Mail Merge.

![mail-merge-and-reporting-fields-aspose-words-net](mail-merge-and-reporting-1.jpg)

На наступному малюнку показаний приклад вихідного об'єднаного документа, отриманого в результаті виконання операції Mail Merge.

![mail-merge-and-reporting-result-aspose-words-net](mail-merge-and-reporting-2.jpg)

## Дивіться також

- [Робота з шаблонами Mail Merge в Word](https://docs.microsoft.com/en-us/power-platform/admin/work-mail-merge-templates)