Dynamics 365 Word Templates 跨环境同步指南

Sun, 22 Jun 2025 00:00:00 +0000

问题背景

在 Dynamics 365 Customer Engagement 项目中，经常需要在开发、测试、生产等不同环境之间同步 Word Templates（文档模板）。

一个常见的问题是：同一实体在不同环境中的 ObjectTypeCode 可能不同。Word Template 内部通过 ObjectTypeCode 来关联实体，如果直接导出导入，模板会因找不到对应的实体而失效。

解决流程

步骤一：查询实体的 ObjectTypeCode

首先确认当前环境中目标实体的 ObjectTypeCode：

SELECT [ObjectTypeCode]
FROM Entity WITH(NOLOCK)
WHERE name = 'EntityName'

将 EntityName 替换为实际实体名称，如 account、contact、new_customentity 等。

分别在不同环境中执行此查询，记录各自的 ObjectTypeCode 值。

步骤二：导出 Word 模板

在源环境中，通过 设置 → 模板 → 文档模板 下载需要迁移的 Word Template（.docx 文件）。

步骤三：修改 .docx 文件

.docx 文件本质上是一个 ZIP 压缩包，内部包含多个 XML 文件。我们需要解压并修改其中的 ObjectTypeCode 引用。

# 解压 docx 文件
unzip template.docx -d template_extracted/

# 在 XML 文件中查找并替换 ObjectTypeCode
# 将源环境的 ObjectTypeCode 替换为目标环境的值
grep -r "ObjectTypeCode" template_extracted/

关键文件通常包括：

word/document.xml — 主文档内容
word/settings.xml — 文档设置

使用文本编辑器打开这些 XML 文件，找到所有引用了源环境 ObjectTypeCode 的地方，替换为目标环境的值。

<!-- 示例：将 10285 替换为目标环境的 ObjectTypeCode -->
<ObjectTypeCode>10285</ObjectTypeCode>

步骤四：处理 customXml 引用

如果 Word Template 引用了 XML 数据源，还需要修改 customXml 文件夹中的两个文件：

customXml/item1.xml — 自定义 XML 数据
customXml/itemProps1.xml — XML 属性定义

# 查找 customXml 中的 ObjectTypeCode 引用
grep -r "ObjectTypeCode" template_extracted/customXml/

同样将 ObjectTypeCode 替换为目标环境的值。