郵件合併 Word 文件

線上郵件合併 word 文檔

郵件合併是產生一組除某些資訊(即收件人的姓名和地址)外完全相同的文件的最簡單方法。許多組織使用郵件合併透過信件、新聞通訊和促銷件與其客戶/成員進行溝通，因此在本文中，我們將討論如何使用 C# REST API 郵件合併 Word 文件的詳細資訊。

郵件合併 API

Aspose.Words Cloud 提供建立新 Word 文件、開啟現有文件或將其轉換為 PDF、XPS、SVG、EPUB 和其他各種格式的功能。由於我們的 API 是按照 REST 架構開發的，因此您不必擔心語言或平台限制。現在，為了在 C# .NET 應用程式中使用 API，請使用以下命令安裝 Aspose.Words Cloud SDK for .NET：

 Install-Package Aspose.Words-Cloud

安裝完成後，我們需要使用 GitHub 或 Google 帳戶透過 Aspose.Cloud 儀表板 註冊免費帳戶，或直接註冊並取得您的用戶端憑證。

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

// 建立配置類別的實例並提供您的個人化客戶端 ID 和客戶端密鑰詳細信息
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);

使用 cURL 指令進行郵件合併 Word

cURL 指令也是存取 REST API 的便捷方式。由於 Aspose.Words Cloud 是在 REST API 架構之上開發的，因此我們可以透過 cURL 命令輕鬆存取 API。現在，作為先決條件，我們需要根據客戶端 ID 和客戶端金鑰詳細資訊產生 JWT 存取權杖。

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"

更多詳細資訊請造訪如何使用客戶端 ID 和客戶端金鑰取得 JWT 令牌。

一旦我們有了 JWT 存取令牌，我們就可以使用以下 cURL 命令來填入郵件合併範本。我們從文字檔案載入資料。

  • ExecuteMailMerge API 執行主要操作。
  • 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：郵件合併作業後的文件預覽。

上述範例中的範例文件可在以下連結中找到

結論

在本文中，我們討論如何使用 C# 程式碼片段在 Word 文件中執行郵件合併的詳細資訊。同時，我們也學習了使用cURL指令進行郵件合併的步驟。請注意，我們的 SDK 是根據 MIT 許可證構建的，因此其完整的原始程式碼可透過 GitHub 儲存庫下載。我們建議您瀏覽產品文件並了解 API 支援的其他令人興奮的功能。

相關文章

我們還建議您訪問以下連結以了解更多資訊：