首页 on Yven

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 替换为目标环境的值。

PCF Multiselect Records 控件配置笔记

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

背景

在 Model-driven App 中，原生的 Lookup 字段只支持单选。当需要实现多选记录关联时，可以借助社区优秀的 PCF 控件来扩展。本文记录使用 Víctor Sánchez 开发的 Multiselect Records PCF 控件时，字段配置过程中遇到的关键问题。

配置要点

1. 绑定字段类型选择

不要直接绑定 Lookup 字段。 需要新建一个 Multiple Lines of Text（多行文本）类型字段来承载 PCF 控件的数据。

字段类型：Multiple Lines of Text → Text Area
绑定方式：将该字段拖入表单 → 配置为 PCF 控件

这样 PCF 控件会将选中的记录 ID 序列化存储在该文本字段中。

2. Field Filter Values 写法

如果 Filter 条件绑定的是表单上的自定义 Lookup 字段，参数写法需要在字段名后加 _value 后缀：

// 自定义 Lookup 字段「新客户」的 filter 参数
_new_accountid_value

// 而非
_new_accountid

这是因为 Lookup 字段在 DOM 中的实际值存储在 _value 属性中。

3. Columns 参数格式

配置 Columns（显示列）时，Display Name 和 fieldName 缺一不可，且格式必须严格：

[
 {
 "Display Name": "客户名称",
 "fieldName": "name"
 },
 {
 "Display Name": "客户编号",
 "fieldName": "accountnumber"
 },
 {
 "Display Name": "城市",
 "fieldName": "address1_city"
 }
]

⚠️ 注意是 Display Name 和 fieldName，不能写成 displayName 或 display_name。

参考资源

Multiselect Records PCF - GitHub
Víctor Sánchez 的原始实现

总结

三个关键点：

🍌 你好，小黄人博客！

Wed, 01 Jan 2025 00:00:00 +0000

欢迎来到我的技术博客

经过一番折腾，这个基于 Hugo + 小黄人主题 的个人技术博客终于上线了 🎉

作为一个长期在微软技术生态中摸爬滚打的软件工程师，我一直想有一个地方来沉淀和分享自己的技术积累。这个博客就是这样一个空间。

我会写些什么

这里的内容将主要围绕以下几个方向：

Power Platform

Power Apps：Canvas App 和 Model-driven App 的实战技巧
Power Automate：Cloud Flow 和 Desktop Flow 的自动化场景
Power BI：数据可视化与嵌入式分析
Dataverse：数据建模、安全模型、API 集成

Dynamics 365

Customer Engagement：Sales、Customer Service、Field Service 模块的定制开发
C# Plugin & Custom Workflow：服务端扩展开发最佳实践
JavaScript Form Script：前端表单脚本与 Ribbon 定制
System Integration：D365 与 ERP、第三方系统的集成方案

.NET & Azure

ASP.NET Core：Web API 开发
Azure Functions：Serverless 集成场景
DevOps：CI/CD、ALM、Solution 管理

关于这个博客的技术栈

这个博客本身也是一个有趣的小项目：

技术	说明
Hugo	Go 语言编写的静态站点生成器，构建速度极快
自定义主题	从零手写的小黄人主题，SCSS + Vanilla JS
GitHub Pages	免费托管，自动部署
Giscus	基于 GitHub Discussions 的评论系统

// 作为一个 .NET 开发者，第一篇博文当然要有代码块 😎
public class MinionBlog
{
 public string Author => "Yven Yuan";
 public string Theme => "Banana! 🍌";
 public List<string> Topics => new() { "Power Platform", "Dynamics 365", ".NET" };

 public void StartBlogging()
 {
 Console.WriteLine("Hello, Minions! 👁️");
 }
}

写在最后

“君子务本，本立而道生。” —— 技术这条路，扎实走好每一步。

感谢你的到访，欢迎通过 GitHub 或邮件与我交流。一起成长 🚀

关于我

Mon, 01 Jan 0001 00:00:00 +0000

Yven Yuan

专注微软技术生态的软件工程师 · Power Platform / Dynamics 365 / .NET

🍌 🍌 🍌

👋 关于我

你好！我是 Yven Yuan，一名专注于微软技术生态的软件工程师和技术博主。

我热衷于 Power Platform（Power Apps、Power Automate、Power BI）、Dynamics 365（Customer Engagement、Finance & Operations）以及 .NET 技术栈。我相信低代码与专业代码的结合能够为企业带来高效的数字化转型解决方案。

📝 博客内容

Power Platform 实战 Dynamics 365 开发 .NET / C# 心得 Azure 云架构 Dataverse 深探 Power Fx DevOps 实践低代码最佳实践

🛠️ 技术栈

Microsoft Power Platform

Power Apps (Canvas) Power Apps (Model-driven) Power Automate (Cloud) Power Automate (Desktop) Power BI Power Pages Power Fx Connectors & Custom APIs

Dynamics 365

Customer Engagement Sales Customer Service Field Service Finance & Operations Dataverse C# Plugin JavaScript (Form Script) Custom Workflow SSRS / FetchXML

开发 & DevOps

C# / .NET ASP.NET Core JavaScript / TypeScript Azure Functions Azure Service Bus Git GitHub Actions Azure DevOps CI/CD

🍌 🍌 🍌

📬 联系我

GitHub: Yven-Yuan
Email: Yven.Yuan@outlook.com

欢迎交流技术话题，一起成长 🚀

简历

Mon, 01 Jan 0001 00:00:00 +0000

个人概况

多年 Dynamics 365 / Power Platform 解决方案顾问，专注于基于 Dynamics 365 Customer Engagement 的企业级 CRM 系统架构设计、定制化开发与系统集成。精通 D365 CE 扩展开发（C# Plugin、Custom Workflow Activity、JavaScript Client-side Scripting）、Dataverse 数据建模、Power Automate 流程自动化及多系统集成。

🎓 教育背景

南京航空航天大学 · 计算机科学与技术 · 本科

核心能力

🛠️ D365 & Power Platform 技术栈

Dynamics 365 CE Dataverse Power Apps Power Automate C# Plugin Custom Workflow JavaScript (Form Script) Web API / OData Organization Service FetchXML SSRS / Power BI SSIS / KingswaySoft Azure Functions DevOps / ALM

📋 业务领域

Sales Customer Service Field Service Marketing 物业管理教育培训金融服务汽车零售电子制造国际贸易招聘平台

项目经验

💼 服务客户与项目

长城汽车 — 汽车制造与经销商管理

主导 D365 CE 经销商管理系统（DMS）建设，覆盖整车销售、售后维修、配件管理、客户回访全链路。基于 Power Apps Model-driven App 为经销商门店定制业务表单与仪表板视图；开发 C# Plugin 实现车辆 VIN 码自动解码、保修期自动计算、配件库存智能补货预警；通过 Power Automate 打通 D365 与车企 ERP、MES 系统，实现订单-生产-交付全流程数据贯通；设计 多层级安全角色（主机厂/大区/经销商/门店），实现数据权限精细化管控。

GM 通用汽车 — 汽车制造与全球供应链

参与 D365 CE 全球售后服务平台建设，支持亚太区多国经销商网络。负责 Custom Workflow Activity 开发实现索赔工单自动审核、RMA 退货流程自动化；开发 C# Plugin 对接全球零部件主数据系统（PMD）实现配件信息实时同步与 ETA 估算；通过 Azure Functions + Service Bus 集成 SAP ERP 系统，实现索赔金额自动计算与财务回写；编写 JavaScript 复杂表单逻辑（多语言界面切换、VIN 校验、维修工时自动计算），支持中/英/日多语言环境。

Philips 飞利浦 — 医疗健康与家电行业

负责 D365 CE Field Service 模块定制开发，支撑医疗设备及家电产品的售后服务体系。配置 Field Service 资源调度（工单自动派发、技术员排程优化、服务区域管理）；开发 C# Plugin 实现设备序列号自动关联维保合同、SLA 级别自动匹配、配件消耗自动扣减库存；基于 Power BI Embedded 开发售后服务可视化看板（工单完成率、客户满意度、配件周转分析）；通过 OData Web API 对接 IoT 平台实现设备故障远程诊断与主动派单。

索尼中国 / 索尼新加坡 — 电子制造行业

负责 D365 Customer Engagement 环境搭建与部署，完成 Dataverse 数据模型设计（实体、字段、关系、表单定义）。基于 C# Plugin 实现售后工单自动派发、SLA 超时预警等核心业务逻辑；通过 JavaScript Form Script 优化用户体验（动态表单联动、业务规则校验、Ribbon 按钮定制）；集成后台 ERP 系统实现订单-库存数据实时同步。

高力国际集团 — 全球物业咨询与资产管理

作为核心开发参与 D365 CE 物业租赁管理系统建设。主导 Custom Workflow Activity 开发实现合同到期自动提醒与续租流程触发；设计并开发 SSRS 报表（租赁看板、应收分析、客户价值评估）；负责历史数据迁移（SSIS + KingswaySoft 工具链，从遗留系统迁移 50 万+ 客户及合同记录），制定数据清洗策略与增量同步方案，保障上线数据完整性。

绿城集团 — 房地产行业

参与 D365 CE 售楼 CRM 系统开发，负责客户跟进管理、楼盘认购、签约流程的定制化开发。开发 C# Plugin 实现客户重复分配检测、销售漏斗阶段自动推进逻辑；通过 OData Web API 对接明源 ERP 系统实现房源信息双向同步；封装通用 RESTful API 供前端 Portal 调用，实现在线预约看房与客户自助查询功能。

上海永达汽车集团 — 汽车销售与售后服务

负责 D365 CE 汽车销售及售后服务体系搭建。设计从潜客→试驾→订车→交车→回访的 端到端销售流程自动化，通过 Power Automate 打通 D365、企业微信与短信平台；开发 JavaScript 动态表单 实现车型-配置联动选择、金融方案实时计算；集成 DMS 系统（经销商管理系统）完成车辆库存、维修工单数据对接。

韦博国际英语 — 教育培训行业

参与 D365 CE 教育培训 CRM 系统建设，覆盖潜在学员管理、课程咨询、报名签约全流程。开发 Custom Workflow Activity 实现学员分班逻辑与课程排期自动编排；通过 Web API 对接在线学习平台与微信小程序，实现学员课时消费记录回传和预约提醒推送；开发多维 FetchXML 报表 支撑校区运营决策。

杭州鑫力合金融服务外包 — 金融行业

负责 D365 CE 金融服务 CRM 系统定制开发，覆盖客户信息管理、贷款产品匹配、风控审批流程。开发 C# Plugin 对接第三方征信接口实现客户信用评分自动查询与风险评级；通过 Power Automate 实现贷款审批多级流转、超时自动催办；优化现有系统性能，解决大量并发数据下的 Plugin 超时问题。

圈儿里人 — 混合招聘平台

负责基于 D365 CE 的招聘平台 CRM 系统全流程开发，涵盖企业客户管理、求职者信息库、职位匹配引擎。通过 C# Plugin + Azure Functions 实现求职者技能标签与职位要求的智能匹配算法；开发 Web API 接口 供前端招聘网站调用，实现职位发布、简历投递、面试邀约等功能前后端分离架构；使用 JavaScript 定制 Candidate 实体表单，优化 HR 筛选体验。

徐工北美公司 — 工程机械进出口贸易

参与海外 CRM 项目从零到一的建设，负责前期需求调研与技术方案设计。搭建 D365 CE On-premises 环境（北美机房部署），完成 Dataverse 数据模型设计（客户、经销商、设备、服务工单等核心实体）；开发 多语言/多币种 支持方案（英文/中文界面、美元/人民币结算）；设计设备配件库存管理与维修保养计划模块，通过 C# Plugin 实现配件库存预警与服务到期自动提醒。

UD TRUCK（沃尔沃集团）— 商用车销售与售后服务

参与 D365 CE 商用车销售与服务管理体系建设，覆盖经销商订单、车辆交付、售后维修保养全链路。开发 C# Plugin 实现车辆底盘号/VIN 自动校验、保修期计算与保养计划自动生成；通过 Power Automate 打通 D365 与经销商 DMS、配件供应系统，实现订单-交付-售后数据贯通；基于 JavaScript Form Script 优化销售与服务表单的动态联动与校验逻辑。

JJMC 强生医疗（Johnson & Johnson Medical）— 医疗器械

参与 D365 CE 医疗器械销售与售后服务体系建设，覆盖产品销售、设备装机、维保合同与售后服务全链路。开发 C# Plugin 实现设备序列号自动关联维保合同、SLA 级别匹配与保修期自动计算；基于 Field Service 配置资源调度与工单自动派发，支撑医院装机与维护排程；通过 Web API / OData 对接 ERP 与供应链系统，实现订单-库存-发货数据实时同步；基于 JavaScript Form Script 优化销售与服务表单的动态联动与校验逻辑。

AIA 友邦保险 — 保险与金融服务

参与 D365 CE 保险业务 CRM 系统建设，覆盖代理人/客户管理、保单关联、理赔与客户服务全流程。开发 C# Plugin 对接核保/理赔接口实现客户资质与保单状态自动校验；通过 Power Automate 实现保单续期提醒、理赔多级审批流转与超时催办；基于 FetchXML 报表 支撑代理人业绩与客户价值分析。

Mega 项目 — 台湾地区企业级 D365 平台建设

参与台湾地区企业级 D365 CE / Power Platform 平台化建设项目，承担核心业务模块开发与跨系统集成。负责 Dataverse 复杂数据模型设计与性能优化；开发 C# Plugin / Custom Workflow Activity 支撑高并发场景下的业务逻辑；通过 Azure Functions + Service Bus 实现与 SAP/ERP 等外部系统的松耦合集成；适配 繁体中文 / 英文 多语言环境；推动 Solution ALM 与 CI/CD 实践，保障多环境（开发/测试/生产）稳定交付。

美敦力 Medtronic — 医疗器械与医疗健康

参与 D365 CE 医疗器械销售与售后服务体系建设，支撑设备销售、安装部署、维保合同与售后服务全链路。开发 C# Plugin 实现设备序列号自动关联维保合同、SLA 级别匹配与配件消耗自动扣减；基于 Field Service 配置资源调度与工单自动派发；通过 Power BI Embedded 开发售后服务可视化看板（设备运行、服务完成率、客户满意度）；集成外部系统实现设备故障远程诊断与主动派单。

联系方式

Email: Yven.Yuan@outlook.com
GitHub: Yven-Yuan