如何将当前正在处理的商机传递到Canvas App的Gallery控件中

1. 配置应用入站参数 #

打开Canvas App编辑器，进入设置页的「参数」板块，新增自定义参数：

• 参数名：CurrentOpportunityID（建议使用英文，避免编码兼容问题）
• 数据类型：文本
• 无需勾选「必需」，防止应用脱离表单上下文运行时报错

2. 修改Gallery默认选中规则 #

找到展示「我的商机」的Gallery控件，将其Default属性修改为如下公式：

LookUp(
    你的商机数据源名称,
    商机唯一标识列的逻辑名 = Param("CurrentOpportunityID")
)

说明：如果Param("CurrentOpportunityID")为空（比如应用单独打开而非从商机表单唤起），公式会返回空值，Gallery仍然默认选中第一条记录，完全兼容原有使用逻辑。

3. 表单嵌入控件配置传参 #

回到商机主表单编辑器，找到你嵌入的Canvas App控件，打开控件的高级属性面板，找到Parameters配置项，添加如下键值对：

• 键：CurrentOpportunityID（必须和第一步定义的参数名完全一致，大小写敏感）
• 值：选择表单上下文中商机表的唯一标识列，通常是Opportunity表的Opportunity ID（逻辑名opportunityid，为GUID格式）

4. 发布验证 #

• 先保存并发布Canvas App的所有修改，再发布商机表单的配置更改
• 打开任意已存在的商机记录，确认Canvas App的Gallery自动选中对应商机
• 手动点击Gallery内其他商机，验证切换功能正常可用

额外提示：如果你的商机数据源为Dataverse，匹配时请使用列的逻辑名而非显示名，避免多语言环境下匹配失败。

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