CRM 对话（托管控件）
发布日期： 2016年11月
适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2013,Dynamics CRM 2015,Dynamics CRM 2016
使用“Dynamics 365 对话”托管控件类型与 Dynamics 365 对话进行操作。 您可以调用 Dynamics 365 对话托管控件上的“StartDialog”操作来开始在 Unified Service Desk中的 Dynamics 365 对话。
本主题内容
创建 Dynamics 365 对话托管控件
预定义的 UII 操作
预定义事件
创建 Dynamics 365 对话托管控件
在创建新的承载控件时，“新的承载控件”屏幕中的字段基于要创建的承载控件的类型而变化。 本节提供有关特定于“Dynamics 365 对话”托管控件类型的特定字段的信息。 有关创建承载控件的详细信息，请参阅 创建或编辑承载的控件。
.jpeg "Dynamics 365 对话托管控件")
在“新的承载控件”屏幕：
在“Unified Service Desk”区域下，从“USD 组件类型”下拉列表中选择“Dynamics 365 对话”。
“托管类型”下拉列表指定您希望如何托管此控件。 您可以选择“内部 WPF”（默认）或“IE 流程”。 有关详细信息，请参阅为您的控件选择一个托管方法。
在“常见属性”区域下，选择“应用程序为全局”复选框将承载的控件设置为全局。 全局承载的控件可在客户会话之外显示。 控件比如代理的仪表板、留言板或搜索都是全局托管的控件的常见用法。 全局托管控件不具有会话特定状态，所以在更改会话时，保留这些相同的全局托管控件。 如果未选中复选框，则承载的控件就会变成基于会话。 基于会话的控件存在于客户会话的上下文中。 如果用户更改为另一个会话，上次会话的所有会话页都会被隐藏。
在“显示组”字段中显示此承载的控件显示的面板。 “MainPanel” 是最常见的此托管控制类型。 有关各类在 Unified Service Desk 中可用的面板的信息，请参阅 Unified Service Desk 的面板。 有关其他 通用 字段的详细信息，请参阅 创建或编辑承载的控件。
预定义的 UII 操作
这些是这种类型的承载控件的预定义操作。
关闭
此操作用于关闭托管控件。
FireEvent
触发托管控件的用户自定义事件。
参数 |
说明 |
|---|---|
名称 |
用户自定义事件的名称。 |
所有后续名称=值成为事件的参数。 有关创建用户自定义事件的详细信息，请参阅 创建用户自定义事件。
MoveToPanel
此操作用于在运行时移动面板件的承载控件。
参数 |
说明 |
|---|---|
应用程序 |
要移动的承载控件的名称。 |
面板 |
承载的控件的目标面板。 |
New_CRM_Page
为正在创建的指定实体的新 Dynamics 365 记录创建新页面，并将该页面视为指定托管控件的弹出窗口。 对窗口导航规则进行评估以确定创建实体记录页面显示的位置。
参数 |
说明 |
|---|---|
LogicalName |
用于创建新实例的实体的逻辑名称。 |
备注
其余的参数由 name=value 对组成。 在为指定实体创建新记录的表单中，这些为额外的预填充值。 有关使用此操作的详细信息，请参阅 演练 7：在代理应用程序中配置代理脚本 中的步骤 4。
Open_CRM_Page
打开指定实体的现存实例，由 ID 指定，并将页面视为指定托管控件的弹出窗口。 对窗口导航规则进行评估以确定弹出窗口显示的位置。
参数 |
说明 |
|---|---|
LogicalName |
打开实体的逻辑名称 |
id |
要打开实体记录的 ID。 |
弹出窗口
从托管控件弹出 URL 并对其运行窗口导航规则以发送该弹出到适当的位置。
参数 |
说明 |
|---|---|
url |
使用此作为从显示控件请求弹出的 URL 以从该托管控件发送一个弹出。 |
框架 |
该弹出源自的框架。 |
RealignWindow
在监视器上的指定位置显示托管控件。 您最多可在两台监视器上显示托管控件。 此操作适用于配置为置于 USDFloatingPanel 或 USDFloatingToolPanel 面板类型上的托管控件实例。
参数 |
说明 |
|---|---|
screen |
指定要显示托管控件的屏幕。 有效值为 1 或 2。 如果不指定此参数，则默认情况下将传递 1。 |
left |
指定目标监视器屏幕左侧应显示托管控件的位置（以百分比为单位）。 有效值为 0 到 100。 如果不指定此参数，则默认情况下将传递 0。 |
top |
指定目标监视器屏幕上方应显示托管控件的位置（以百分比为单位）。 有效值为 0 到 100。 如果不指定此参数，则默认情况下将传递 0。 |
width |
指定目标监视器上的托管控件窗口的宽度（以百分比为单位）。 有效值为 1 到 100。 如果不指定此参数，则默认情况下将传递 100。 |
height |
指定目标监视器上的托管控件窗口的高度（以百分比为单位）。 有效值为 1 到 100。 如果不指定此参数，则默认情况下将传递 100。 |
SetSize
此操作显式设置托管控件的宽度和高度。 在画板布局中使用“自动”时，这尤其有用。
参数 |
说明 |
|---|---|
宽度 |
托管控件的宽度。 |
高度 |
托管控件的高度。 |
StartDialog
此操作采取多个参数，但对于不涉及特定记录的对话，您只可以指定“名称”参数。
参数 |
说明 |
|---|---|
客户 |
在 Dynamics 365 的“设置”>“流程”部分可以看到对话的名称。 |
DialogId |
您也可以通过其 ID 指定对话。 如果指定“DialogId”参数，它将由操作而不是“名称”参数使用。 |
实体 |
这是对话运行时针对的实体类型。 如果使用“DialogId”参数，则需执行此步骤。 如果“名称”参数已被使用，则无需执行此步骤。 |
ID |
这是对话会话适用的实体 ID。 如果未指定此参数，对话针对系统中适当类型的首次输入进行运行。 |
在完成对话后，它将会提示用户关闭该窗口。 如果用户确定，也将关闭 Unified Service Desk 中设计的选项卡。
预定义事件
以下预定义的事件与该托管控件的类型有关联。
BrowserDocumentComplete
页面完成加载时发生。 在托管控件的“Dynamics 365 页面”类型上，在数据保存到替换参数列表后发生此事件。 虽然多个框架将单独触发它们的“BrowserDocumentComplete” 事件，但此事件只发生一次。
参数 |
说明 |
|---|---|
url |
完成页面 URL 的加载。 |
PopupRouted
在系统路由了弹出窗口之后发生。
参数 |
说明 |
|---|---|
url |
路由了弹出窗口的 URL。 |
另请参阅
CRM 页（托管控件）
UII 操作
事件
统一服务台配置演练
托管控件类型和操作/事件引用
Microsoft Dynamics CRM 统一服务台管理指南
Unified Service Desk 2.0
© 2017 Microsoft。 保留所有权利。 版权