Слияние документов Word

Слияние почтовых сообщений в текстовом документе онлайн

Слияние писем — это самый простой способ создать набор документов, которые идентичны, за исключением определенной информации, например имени и адреса получателя. Многие организации общаются со своими клиентами/членами с помощью писем, информационных бюллетеней и рекламных материалов, используя слияние писем, поэтому в этой статье мы рассмотрим детали того, как слить письма в Word с помощью C# REST API.

API слияния почты

Aspose.Words Cloud предлагает возможности создания нового документа Word, открытия существующего документа или конвертации его в PDF, XPS, SVG, EPUB и различные другие форматы. Поскольку наш API разработан в соответствии с архитектурой REST, вам не нужно беспокоиться об ограничениях языка или платформы. Теперь, чтобы использовать API в приложении C# .NET, установите Aspose.Words Cloud SDK для .NET с помощью следующей команды:

 Install-Package Aspose.Words-Cloud

После установки нам необходимо зарегистрировать бесплатную учетную запись на панели управления Aspose.Cloud с помощью учетной записи GitHub или Google или просто зарегистрироваться и получить учетные данные клиента.

Заполнить шаблон Mail Merge на C#

Чтобы заполнить шаблон почтового слияния с помощью файла данных, выполните указанные ниже действия.

String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get MyClientID from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get MyClientSecret from https://dashboard.aspose.cloud/

// создайте экземпляр класса конфигурации и укажите персонализированные данные Client ID и Client Secret
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// инициализируйте объект WordsAPI с помощью экземпляра конфигурации
var wordsApi = new WordsApi(config);
// первый входной документ
string inputDocument = "SampleMailMergeTemplate.docx";
string inputDataFile = "SampleMailMergeTemplateData.txt";
// имя результирующего файла
string resultantFile = "TestPostDocumentExecuteMailMerge.docx";
// прочитать содержимое файла данных
string data = File.ReadAllText("/Downloads/" + inputDataFile, System.Text.Encoding.UTF8);
// Создайте объект ExecuteMailMergeRequest, указав входной файл, файл данных и детали полученного вывода.
Requests.ExecuteMailMergeRequest request = new Requests.ExecuteMailMergeRequest(inputDocument, data, null, null, null, null, null, null, null, null, resultantFile);
// выполнить операцию слияния почты
DocumentResponse result = wordsApi.ExecuteMailMerge(request);

Слияние писем Word с помощью команды cURL

Команды cURL также являются удобным способом доступа к REST API. Поскольку Aspose.Words Cloud разработан на основе архитектуры REST API, мы можем легко получить доступ к API через команды cURL. Теперь, в качестве предварительного условия, нам нужно сгенерировать токен доступа JWT на основе Client ID и Client Secret.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Для получения более подробной информации посетите страницу Как получить токен JWT с помощью идентификатора клиента и секретного ключа клиента.

Получив токен доступа JWT, мы можем использовать следующую команду cURL для заполнения шаблона Mail Merge. Мы загружаем данные из текстового файла.

  • API ExecuteMailMerge выполняет основную операцию.
  • SampleMailMergeTemplate.docx — это шаблон входного письма, доступный в облачном хранилище.
  • Мы используем параметр -F для загрузки входных данных из файла SampleMailMergeTemplateData.txt.
  • Результирующий файл, указанный в параметре destFileName, будет сохранен в облачном хранилище.
curl -v "https://api.aspose.cloud/v4.0/words/SampleMailMergeTemplate.docx/MailMerge?withRegions=false&destFileName=TestPostDocumentExecuteMailMerge.docx" \
-X PUT  \
-F data=@/Downloads/SampleMailMergeTemplateData.txt \
-H "Content-Type: multipart/form-data" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"
Предварительный просмотр слияния почты

Изображение 1: Предварительный просмотр документа после операции слияния.

Образцы файлов из приведенного выше примера доступны по следующим ссылкам.

Заключение

В этой статье мы обсудили детали того, как выполнить слияние писем в документах Word с помощью фрагмента кода C#. В то же время мы также изучили шаги слияния писем с использованием команд cURL. Обратите внимание, что наш SDK создан в соответствии с лицензией MIT, поэтому его полный исходный код доступен для загрузки через репозиторий GitHub. Мы предлагаем вам изучить документацию по продукту и узнать о других интересных функциях, поддерживаемых API.

Похожие статьи

Мы также рекомендуем посетить следующие ссылки, чтобы узнать больше о: