如何使用Python的win32com从DXL文件创建Lotus Notes文档

Lotus Script对应的功能本质是调用Lotus Notes提供的COM接口，Python的win32com可以直接调用同一套接口，仅语法格式有差异，无需额外适配。

前置条件 #

• 本地已正确安装Lotus Notes客户端并完成COM组件注册
• 导入使用的目标ID拥有目标Notes数据库的至少作者权限
• 已关闭正在运行的Lotus Notes客户端，避免COM调用冲突

核心实现步骤 #

1. 初始化Notes COM会话，切换到指定的导入用ID
2. 打开目标导入的Notes数据库
3. 实例化NotesDXLImporter对象，配置DXL文件路径与导入规则
4. 执行导入，验证导入结果

完整代码示例 #

import win32com.client

def import_dxl_to_notes(id_path, id_password, target_server, target_db_path, dxl_file_path):
    # 初始化Notes会话
    notes_session = win32com.client.Dispatch("Lotus.NotesSession")
    # 切换到指定ID，不需要切换可注释该段，直接调用Initialize传入当前ID密码
    notes_session.SwitchToID(id_path, id_password)
    # 初始化会话，密码留空会弹出Notes原生密码输入框
    notes_session.Initialize(id_password)
    
    # 打开目标数据库
    target_db = notes_session.GetDatabase(target_server, target_db_path)
    if not target_db.IsOpen:
        target_db.Open()
        if not target_db.IsOpen:
            raise Exception("无法打开目标数据库，请检查权限与路径配置")
    
    # 初始化DXL导入器
    dxl_importer = notes_session.CreateDXLImporter()
    # 配置导入参数
    dxl_importer.InputFilePath = dxl_file_path
    dxl_importer.OutputDatabase = target_db
    # 关闭签名校验，避免跨ID导入的签名错误
    dxl_importer.ValidateSignature = False
    # 配置导入冲突规则：需替换现有设计、覆盖相同UNID的文档可设置为True
    dxl_importer.ReplaceDBProperties = False
    dxl_importer.ReplaceDesign = False
    dxl_importer.CreateFTIndex = False
    
    # 执行导入
    dxl_importer.Import()
    
    # 返回导入结果
    return f"导入完成，共导入{dxl_importer.ImportedNoteCount}个文档"

# 调用示例
if __name__ == "__main__":
    try:
        res = import_dxl_to_notes(
            id_path = r"C:\Notes\Data\another.id",
            id_password = "your_id_password",
            target_server = "Server01/YourOrg", # 本地库填空字符串即可
            target_db_path = r"your\target_db.nsf",
            dxl_file_path = r"C:\export\test.dxl"
        )
        print(res)
    except Exception as e:
        print(f"导入失败：{str(e)}")

常见问题处理 #

• 加密字段导入失败：导出DXL时需使用原ID取消文档加密属性后重新导出，否则新ID没有解密密钥无法读取内容
• 表单匹配错误：DXL中记录的表单名称必须在目标数据库中存在，否则文档会默认使用数据库默认表单，字段可能丢失
• 权限报错：确认目标ID在目标数据库的ACL列表中，且拥有创建文档的权限，如需导入带读者域的文档需要更高权限
• COM调用报错：重启脚本前需关闭Notes客户端进程，避免多进程占用COM接口导致调用失败

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