面板布局（托管控件）
发布日期： 2016年11月
适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2013,Dynamics CRM 2015,Dynamics CRM 2016
使用“面板布局”托管控件定义 Unified Service Desk 中面板的排列方式。 面板存放着各个托管控件，而面板布局定义 Unified Service Desk 客户端应用程序的主屏幕上各个托管控件的排列方式。Unified Service Desk 附带一些预定义的面板类型，用于支持各种布局选项，如选项卡布局、层面布局和堆叠布局。 有关详细信息，请参阅Unified Service Desk 中的面板、面板类型和面板布局。
如果托管控件的“面板布局”类型没有定义在应用程序中，就会自动创建默认的面板布局 - 标准主面板。 如果创建托管控件的“面板布局”类型，您必须为标准主面板配置一个可替换的对象。 任何面板布局可能应用在此处；然而，定义标准主面板是非常普遍的。
本节内容
创建面板布局托管控件
预定义的 UII 操作
预定义事件
创建面板布局托管控件
在创建新的承载控件时，“新的承载控件”屏幕中的字段基于要创建的承载控件的类型而变化。 本节提供有关特定于“面板布局”托管控件类型的特定字段的信息。 有关创建承载控件的详细信息，请参阅 创建或编辑承载的控件。
.jpeg "“面板布局”托管控件")
在“新的承载控件”屏幕：
从“USD 组件类型”下拉列表中选择“面板布局”。
从“PanelType”下拉列表中，选择要创建的面板布局类型。 您可以从以下各项中选择一个：“标准主面板”、“功能区主面板”、“垂直拆分”、“水平拆分”、“XAML”和“用户定义”。 XAML 和用户定义的布局面板是您定义的自定义面板。 有关各面板布局的详细信息，请参阅Unified Service Desk 中的面板、面板类型和面板布局。 此页面中的字段会根据所选的面板类型而改变。
从“动态应用程序”列表中选择“是”或“否”确定该托管控件是否为动态。 动态托管控件可为全局的或非全局的。 全局动态托管控件加载于第一请求并在其后隐藏，且可在任何时间请求他们，如在全局会话、正常会话或工作流期间。 仅可在已启动会话后加载非全局动态托管控件，且个会话使用应用程序的不同实例。 如果动态托管控件是工作流的一部分，且在工作流启动时尚未启动，则工作流将启动托管控件，且在工作流完成后，关闭它。
如果在“动态应用程序”列表中选择了“是”，“用户可关闭”复选框才可用。 选中该复选框，指定此托管控件可被用户关闭。
如果在“PanelType”列表中选择了“垂直拆分”、“水平拆分”、“XAML”或“用户定义”，“全局应用程序”复选框才可用。 选中该复选框，将此托管控件设置为全局。 全局承载的控件可在客户会话之外显示。 控件比如代理的仪表板、留言板或搜索都是全局托管的控件的常见用法。 全局承载的控件不具有会话特定状态，所以在更改会话时，保留这些全局承载控件。 如果未选中复选框，则承载的控件就会变成基于会话。 基于会话的控件存在于客户会话的上下文中。 如果用户更改为另一个会话，上次会话的所有会话页都会被隐藏。
如果在“PanelType”列表中选择了“垂直拆分”、“水平拆分”、“XAML”或“用户定义”，“显示组”字段才可用。 指定将显示此托管控件的面板。 有关各类在 Unified Service Desk 中可用的面板的信息，请参阅 Unified Service Desk 中的面板、面板类型和面板布局。
如果在“PanelType”列表中选择了“XAML”，在您为面板类型指定了 XAML 定义的地方“XAML”字段才可用。
如果在“PanelType”列表中选择了“用户定义”，“程序集 URI”和“程序集类型”字段才可用。 在“程序集 URI”字段中，键入您的程序集名称。 在“程序集类型”字段中，指定以下值：<AssemblyName>.<ClassName>。 有关如何创建用户定义的面板布局的详细信息，请参阅创建自定义面板布局。
预定义的 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
此操作显式设置托管控件的宽度和高度。 在画板布局中使用“自动”时，这尤其有用。
参数 |
说明 |
|---|---|
宽度 |
托管控件的宽度。 |
高度 |
托管控件的高度。 |
SetVisualProperty
设置托管控件的视觉 (UIElement) 属性，如高度、宽度和可见性。 此操作调用对于 UI 自动化尤其有用，例如自动显示或隐藏面板。 高效使用此操作，需熟悉 XAML 和 Unified Service Desk 布局。
参数 |
说明 |
|---|---|
elementname |
要设置其属性（如 Expander、StackPanel 和 Grid）的 UI 元素名称。 例如: elementname=Expander |
propertyname |
要设置的指定元素的属性名称，例如 Height、Width、Visibility 和 Color。 例如: propertyname=Visibility |
value |
为指定的属性指定适当的值。 此参数支持的值的类型为 string、enumeration、integer 或 bool。 例如：value=Visible |
此消息的使用示例，请参阅 演练 8：在您的代理应用程序中使用 Parature 知识库 中的 步骤 3：配置操作调用以自动显示和隐藏知识库搜索面板。
备注
默认情况下，此操作仅对托管控件的“面板布局”类型显示。 若要结合使用 SetVisualProperty 操作与派生自 DynamicsBaseHostedControl 类的所有其他预定义 Unified Service Desk 托管控件类型，您必须显式添加一个 SetVisualProperty 调用的 UII 操作调用到相应托管控件。详细信息： 添加一个 UII 操作至托管控件
预定义事件
没有此托管控件类型可用的预定义事件。
另请参阅
Unified Service Desk 中的面板、面板类型和面板布局
UII 操作
事件
统一服务台配置演练
托管控件类型和操作/事件引用
TechNet：适用于 Microsoft Dynamics CRM 的 Unified Service Desk 管理指南
Unified Service Desk 2.0
© 2017 Microsoft。 保留所有权利。 版权