本文介绍如何在 dynamics 365 模型驱动应用中，通过自定义 html/javascript 弹窗（web resource）收集用户输入，并将选项集（option set）等字段值回传至主表单，替代简单提示框，提升数据录入效率与用户体验。
本文介绍如何在 dynamics 365 模型驱动应用中，通过自定义 html/javascript 弹窗（web resource）收集用户输入，并将选项集（option set）等字段值回传至主表单，替代简单提示框，提升数据录入效率与用户体验。
在 Dynamics 365 中，当业务流程要求用户在提交前必须填写某关键字段（如“赢取原因”“解决状态”等选项集字段）时，仅用 alert() 或 Xrm.Navigation.openAlertDialog() 提示用户“请填写字段”往往体验较差——它无法直接编辑，也无法自动同步值。更规范、可扩展的方案是：使用自定义 Web Resource 构建轻量级弹窗表单，支持字段编辑与双向数据回传。
✅ 推荐实现路径：Open Web Resource + 父子窗通信
Dynamics 365 官方推荐且唯一支持模态交互的客户端 API 是 Xrm.Navigation.openWebResource。它可在当前页面上下文中打开一个 HTML 页面（即 Web Resource），并支持通过 window.parent 或 Xrm.Utility.getGlobalContext() 进行安全通信。
? 步骤概览：
- 创建 Web Resource（HTML + JS）：包含目标字段的下拉选择器（如
- 在主表单中触发弹窗：调用 openWebResource 并传递必要参数（如字段逻辑名、当前记录 ID）；
- 在弹窗中加载并提交数据：用户选择后，通过 window.parent.Xrm.Page.getAttribute(...).setValue(...) 回写值；
- 刷新或保存主表单（可选）：调用 Xrm.Page.data.refresh() 或 save() 触发后续逻辑。
? 示例代码（Web Resource HTML）
<!-- Web Resource 名称: new_/popup_fill_reason.html -->
<!DOCTYPE html>
<html>
<head>
<title>请选择赢取原因</title>
<style>
body { font-family: 'Segoe UI', sans-serif; padding: 20px; }
select, button { padding: 8px; margin: 5px; }
</style>
</head>
<body>
<label for="reasonSelect">赢取原因：</label>
<select id="reasonSelect">
<option value="">-- 请选择 --</option>
<option value="1">战略契合</option>
<option value="2">价格优势</option>
<option value="3">服务响应快</option>
</select>
<br>
<button onclick="submitAndClose()">确定</button>
<button onclick="window.close()">取消</button>
<script>
function submitAndClose() {
const selectedValue = document.getElementById('reasonSelect').value;
if (!selectedValue) return;
// ✅ 安全回写至主表单字段（假设字段逻辑名为 'new_wonreason'）
try {
// 获取父页面 Xrm 对象（需确保跨域同源，且 Web Resource 已发布）
const parentXrm = window.parent.Xrm;
if (parentXrm && parentXrm.Page) {
parentXrm.Page.getAttribute('new_wonreason')?.setValue(parseInt(selectedValue));
// 可选：触发字段变更事件或自动保存
parentXrm.Page.data.refresh(false);
}
} catch (e) {
console.error("回写字段失败：", e);
}
window.close();
}
</script>
</body>
</html>⚠️ 关键注意事项：
- Web Resource 必须发布：上传后需在解决方案中“发布定制项”，否则 openWebResource 无法加载；
- 同源策略限制：Web Resource 必须托管在当前环境（如 https://contoso.crm.dynamics.com/），不可引用外部 URL；
- 权限与上下文：window.parent.Xrm 在弹窗中可用，但需确保主表单已完全加载；建议在 onSave 或按钮点击事件中调用，避免竞态；
- 选项集值映射：真实场景中应通过 Xrm.WebApi 查询 EntityMetadata 或预置 JSON 映射，而非硬编码
- 移动端兼容性：openWebResource 在模型驱动 App 移动端不支持模态弹窗，此时应改用 Xrm.Navigation.openForm() 打开新实体表单（如 Opportunity Close），或使用 Power Apps 组件替代。
✅ 替代建议（更符合平台最佳实践）
若该弹窗本质是业务流程必填环节（如“标记为赢取”），强烈建议采用原生平台机制：
- 将字段设为业务规则强制必填（Business Rule → “字段必须有值”）；
- 或使用 Power Automate 流程校验 + 自定义消息；
- 或重用标准系统表单（如 OpportunityClose 实体），通过 Xrm.Navigation.openForm() 调用，天然支持数据绑定与保存逻辑。
综上，openWebResource 是实现自定义弹窗编辑的可行技术路径，但务必结合业务语义权衡——优先使用平台原生能力，再以 Web Resource 做精细化补充。
