利用python在Word文檔中創(chuàng)建和執(zhí)行條件郵件合并

更新時間：2024年08月09日 11:10:22 作者：Eiceblue

郵件合并域和IF域是Word文檔中兩種非常實用的域,前者可以用來進行郵件合并,根據數據批量創(chuàng)建定制的Word文檔,本文講介紹如何使用Python在Word文檔中創(chuàng)建條件郵件合并域以及執(zhí)行條件郵件合并,需要的朋友可以參考下

引言

郵件合并域和IF域是Word文檔中兩種非常實用的域。前者可以用來進行郵件合并，根據數據批量創(chuàng)建定制的Word文檔。后者則可以用來根據不同的條件顯示不用的內容。我們可以把IF域和郵件合并域結合起來，實現帶條件的郵件合并，從而擴展郵件合并的應用范圍。Python可以幫助我們自動化這一過程，實現更便捷的批量操作。
本文講介紹如何使用Python在Word文檔中創(chuàng)建條件郵件合并域以及執(zhí)行條件郵件合并。

本文所使用的方法需要用到Spire.Doc for Python，PyPI：pip install Spire.Doc。

用Python在Word文檔中創(chuàng)建條件郵件合并域

我們可以將郵件合并域插入到IF域中來實現創(chuàng)建條件郵件合并域。在創(chuàng)建時，我們需要先在段落中插入一個IF域以及起始代碼，然后插入一個郵件合并域，最后插入剩余代碼以及域結束標記。
以下是創(chuàng)建條件郵件合并域的操作步驟示例：

導入所需模塊。
創(chuàng)建Document對象從而創(chuàng)建一個Word文檔。
在文檔中添加一個節(jié)并設置好頁面。
創(chuàng)建段落樣式，在節(jié)中添加段落和文本，并設置段落樣式。
在創(chuàng)建IfField對象，通過IfField.Code屬性設置其起始代碼（IF ），然后使用Paragraph.Items.Add()方法將其添加到段落中。
使用Paragraph.AppendField()在后面添加一個郵件合并域。
使用Paragraph.AppendText()在郵件合并域后面添加剩余代碼。
使用Paragraph.AppendFieldMark()方法在最后添加一個域結束標記，并通過IfField.End屬性將其設置為IF域的結束位置。
使用Document.SaveToFile()方法保存文檔。
釋放資源。

代碼示例

from spire.doc import *

# 創(chuàng)建 Document 實例
doc = Document()

# 向文檔添加一個節(jié)
section = doc.AddSection()

# 設置頁面大小和邊距
section.PageSetup.PageSize = PageSize.A4()
section.PageSetup.Margins.All = 50

# 創(chuàng)建段落樣式
style = ParagraphStyle(doc)
style.Name = "Style1"
style.CharacterFormat.FontName = "HarmonyOS Sans SC"
style.CharacterFormat.FontSize = 16
doc.Styles.Add(style)

# 添加段落并設置樣式
paragraph = section.AddParagraph()
paragraph.AppendText("尊敬的")
paragraph.AppendField("Name", FieldType.FieldMergeField)
paragraph.AppendText("：")
paragraph.ApplyStyle(style.Name)
paragraph = section.AddParagraph()

# 在段落中添加 IF 域
paragraph = section.AddParagraph()
ifField = IfField(doc)
ifField.Type = FieldType.FieldIf
ifField.Code = "IF "
paragraph.Items.Add(ifField)
# 在 If 域的代碼中添加郵件合并域
paragraph.AppendField("CustomerType", FieldType.FieldMergeField)
paragraph.AppendText(" = ")
paragraph.AppendText("\"VIP\"")
paragraph.AppendText(" \"親愛的VIP客戶，感謝您的一貫支持！我們特別為您提供的免費送貨上門服務。\"")
paragraph.AppendText("\"我們將不定期提供額外的優(yōu)惠，請關注我們的公告或郵件。\"")
# 在末尾添加域結束標記以結束 IF 域
endIf = paragraph.AppendFieldMark(FieldMarkType.FieldEnd)
ifField.End = endIf
paragraph.ApplyStyle(style.Name)

# 添加段落并設置樣式
paragraph = section.AddParagraph()
paragraph.AppendText("您的總消費金額（￥）：")
paragraph.AppendField("TotalSpent", FieldType.FieldMergeField)
paragraph.ApplyStyle(style.Name)
paragraph = section.AddParagraph()
paragraph.AppendText("\r\n此致，\r\n有限公司")
paragraph.ApplyStyle(style.Name)

# 保存文檔
doc.SaveToFile("output/條件郵件合并.docx", FileFormat.Docx)
doc.Close()

結果文件

用Python執(zhí)行Word文檔條件郵件合并

我們可以使用Document.MailMerge.Execute()方法執(zhí)行郵件合并，然后將Document.IsUpdateFields更新域以顯示最后的條件郵件合并結果。
以下是操作步驟：

導入所需模塊。
讀取用于合并的表中的數據為列表。
遍歷數據行，跳過標題：
創(chuàng)建Document對象并加載要合并的Word文檔。
- 使用Document.MailMerge.GetMergeFieldNames()方法獲取文檔中的郵件合并域的名稱為列表。
- 使用Document.MailMerge.Execute()方法使用數據執(zhí)行郵件合并。
- 將Document.IsUpdateFields屬性設置為True，更新IF域。
- 使用Document.SaveToFile()方法保存文檔。
釋放資源。

代碼示例

from spire.doc import *
import csv

# 從 CSV 文件中讀取數據
data = []
with open("示例.csv", "r", encoding="utf-8") as csvfile:
    read = csv.reader(csvfile)
    for row in read:
        data.append(row)

# 遍歷數據行，跳過標題行
for i in range(1, len(data)):
    # 創(chuàng)建 Document 實例并加載 Word 文檔
    doc = Document("output/條件郵件合并.docx")
    # 從文檔中獲取域名
    fieldNames = doc.MailMerge.GetMergeFieldNames()
    # 執(zhí)行郵件合并
    doc.MailMerge.Execute(fieldNames, data[i])
    # 更新 If 域
    doc.IsUpdateFields = True
    # 保存文檔
    doc.SaveToFile(f"output/顧客/{data[i][0]}.docx", FileFormat.Docx2019)
    doc.Close()

csvfile.close()

結果文件