使用ScriptForge库通过Python宏编辑LibreOffice Writer字段

核心问题分析 #

你通过ui.CreateDocument得到的SF_Writer是简化的脚本框架对象，并非直接的LibreOffice UNO文档实例，所以那些针对UNO文档的方法（比如getByName、TextFieldMasters）无法直接调用。要操作文档字段，必须先获取底层的UNO文档对象。

获取UNO文档实例并操作Input Fields #

步骤1：获取真实的UNO文档对象 #

可以直接通过UNO API创建文档，或者从已有的SF_Writer对象中提取：

# 方式1：直接通过UNO API创建文档（更稳定）
import uno
ctx = uno.getComponentContext()
smgr = ctx.getServiceManager()
desktop = smgr.createInstanceWithContext("com.sun.star.frame.Desktop", ctx)
doc = desktop.loadComponentFromURL(
    "file:///MY_TEMPLATE.ott",
    "_blank",
    0,
    ()
)

# 方式2：从已创建的SF_Writer对象中提取UNO文档
# doc = doc.getDocument()

步骤2：遍历并填充Input Fields #

Input Fields在UNO中属于com.sun.star.text.TextField.InputText类型，需要遍历文档所有文本字段匹配名称后修改内容：

def fill_input_field(doc, field_name, new_value):
    text_fields = doc.getTextFields()
    enum = text_fields.createEnumeration()
    while enum.hasMoreElements():
        field = enum.nextElement()
        if field.supportsService("com.sun.star.text.TextField.InputText"):
            if field.Name == field_name:
                field.Content = new_value
                field.update()  # 更新字段显示
                return True
    return False

# 调用示例
fill_input_field(doc, "FIELD_NAME", "需要填充的内容")

更适合自动化的模板设置建议 #

• 使用书签（Bookmarks）替代Input Fields：书签定位更直接，无需遍历所有字段，适合批量填充：

  def fill_bookmark(doc, bookmark_name, new_value):
      if bookmark_name in doc.Bookmarks:
          bookmark = doc.Bookmarks.getByName(bookmark_name)
          cursor = bookmark.getAnchor().createTextCursor()
          cursor.setString(new_value)
  

• 使用邮件合并功能：如果后续要从电子表格取数，LibreOffice自带的邮件合并可直接对接Calc表格，无需编写复杂宏，适合大规模批量生成信函。
• 使用自定义属性（Custom Properties）：在模板中插入DocProperty字段并关联文档自定义属性，通过修改属性批量更新字段：

  # 设置自定义属性
  doc_properties = doc.getDocumentProperties()
  custom_props = doc_properties.getUserDefinedProperties()
  if not custom_props.hasByName("FIELD_NAME"):
      custom_props.addProperty("FIELD_NAME", 0, "")
  custom_props.setPropertyValue("FIELD_NAME", "新内容")
  # 刷新所有DocProperty字段
  doc.getTextFields().refresh()
  

常见排查要点 #

• 确保模板中的Input Fields已在「变量」选项卡中正确设置名称。
• 运行宏前需调整LibreOffice宏安全设置（工具→选项→安全性→宏安全→设置为低/中）。
• 若使用SF_Writer对象，需确认其getDocument()方法在当前版本中可用（部分脚本框架版本存在差异）。

内容的提问来源于stack exchange，提问作者Jayden67