交互式服务中心页面（托管控件）

 

发布日期： 2016年11月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2013,Dynamics CRM 2015,Dynamics CRM 2016

使用交互式服务中心页面托管控件类型来托管 Unified Service Desk 中的交互式服务中心窗体，以集成两个应用程序的功能。 交互式服务中心提供一个直观的界面，并将与客户相关的所有重要信息显示在一个地方，让客户支持代理专注于需要注意的事情。

备注

此功能在 Unified Service Desk 2.1 中进行了介绍。

当交互式服务中心窗体在交互式服务中心页面托管控件中加载，它将自动扫描页面的数据，并自动填充 Unified Service Desk 中的替换参数。交互式服务中心页面托管控件类型可呈现许多特定于处理交互式服务中心页面的预定义的 UII 操作和事件，包括列表处理操作、显示快速搜索或高级搜索页面的查找操作。

Unified Service Desk 为您提供一个示例包交互式服务中心，该示例包演示了您如何轻松地将交互式服务中心页面集成到 Unified Service Desk 中。 更多信息：TechNet：Unified Service Desk 2.1 示例应用程序

备注

您可以将您托管的控件的现有 Dynamics 365 页面 类型更改为 交互式服务中心页面类型，以显示交互式服务中心应用程序使用的交互式体验窗体代替Dynamics 365窗体。 但是，这样做存在着一些注意事项。 有关详细信息，请参阅 博客：支持 Unified Service Desk 中的以交互为中心的窗体

本主题内容

创建交互式服务中心页面托管控件

预定义的 UII 操作

预定义事件

创建交互式服务中心页面托管控件

在创建新的承载控件时，“新的承载控件”屏幕中的字段基于要创建的承载控件的类型而变化。 本节提供有关特定于交互式服务中心页面托管控件类型的特定字段的信息。 有关创建承载控件的详细信息，请参阅 创建或编辑承载的控件。

在“新的承载控件”屏幕：

• 在 Unified Service Desk 区域下，从 USD 组件类型下拉列表中选择交互式服务中心页面。

• 从允许多个页面下拉列表中，选择否（默认值），当 Unified Service Desk 接到导航操作调用或页面被路由到选项卡时，将替换当前显示的交互式服务中心页面并更新浏览器历史记录。 在调用第二个 URL 或窗口导航规则将一个页面指向选项卡时，选择是将自动创建下拉列表。 这将允许用户在附加到此控件的交互式服务中心页面之间快速搜索。 此外，如果选择是，附加字段，最大浏览器数将可用，您可以在其中指定在下拉列表中显示的页面的最大数目。

• IE 流程是此托管控件类型的默认托管类型，您无法选择任何其他托管类型。 有关 Unified Service Desk 中所支持托管方法的信息，请参阅 为您的控件选择一个托管方法。

• 选择应用程序为全局复选框将托管控件设置为全局。 全局承载的控件可在客户会话之外显示。 控件比如代理的仪表板、留言板或搜索都是全局托管的控件的常见用法。 全局承载的控件不具有会话特定状态，所以在更改会话时，保留这些全局承载控件。 如果未选中复选框，则承载的控件就会变成基于会话。 基于会话的控件存在于客户会话的上下文中。 如果用户更改为另一个会话，上次会话的所有会话页都会被隐藏。

• 在“显示组”字段中显示此承载的控件显示的面板。 “MainPanel” 是最常见的此托管控制类型。 有关各类在 Unified Service Desk 中可用的面板的信息，请参阅 Unified Service Desk 中的面板、面板类型和面板布局。

• 从应用程序为动态列表中选择是或否确定它是否为动态托管控件。 动态托管控件允许代理通过使用 UI 或编程代码按需启动或关闭托管控件。 更多信息：动态统一服务台托管控件

  如果您选择是，用户可关闭复选框才可用。 选中此复选框，让用户关闭此托管控件。

有关其他 通用 字段的详细信息，请参阅 创建或编辑承载的控件。

预定义的 UII 操作

这些是这种类型的承载控件的预定义操作。

备注

交互式服务中心页面类型的托管控件支持 Dynamics 365 页面类型的托管控件所支持的所有 UI 操作。 但是，当您首次创建并保存交互式服务中心页面类型的托管控件的实例时，某些 UII 操作不可用。 对托管控件实例的任何后续更新将添加缺少的 UII 操作。

AssociatedView

此操作加载交互式服务中心的特定关联视图。 通常通过单击导航栏中实体记录名称旁边的向下箭头并选择相关实体来访问这些视图。

参数	说明
navItemName	要显示的相关实体。 示例: Cases
Id	要为其显示关联实体记录的主要实体记录 ID。
tabset	在 Dynamics 365 中的区域。 示例：areaSales 或 areaService。

结束

此操作用于关闭托管控件。 不同于“CloseActive”操作，如果此选项卡（托管控件）正在显示多个页面，它将在您的代理应用程序中关闭所有在此选项卡显示的页面。

CloseActive

此操作用于关闭此托管控件中的活动窗口。 如果活动窗口唯一在托管控件中显示的窗口，则该托管控件将关闭。 如果您已为您的托管控件选择不允许多个页面（允许多个页面 = 否），此操作与关闭操作等效。

CloseAndPrompt

此操作提示用户在关闭托管控件之前保存或放弃更改。

查找

导航到指定实体的快速查找列表视图。

参数	说明
	数据参数值应指定要显示的快速查找列表视图的实体逻辑名称。 有一些专有的案例值： 使用 case 或 incident 来为案例显示快速查找列表视图。 使用 advfind 显示高级查找视图。 使用 activities 或 activity 来为多个活动显示快速查找列表视图。

FireEvent

触发托管控件的用户自定义事件。

参数	说明
name	用户自定义事件的名称。

所有后续名称=值成为事件的参数。 有关创建用户自定义事件的详细信息，请参阅 创建用户自定义事件。

GetSelectedCount

此操作可检索选定的项目数。 使用“GetSelectedIds”操作以获取实体的实际 ID 列表。

参数	说明
	该数据参数应指定列表名称以检索选定的 ID。

返回值包含一个表示选定项数量的数字。

GetSelectedIds

此操作用于从列表中检索选定的 ID。

参数	说明
	该数据参数应指定列表名称以捕获选定的 ID。

返回值包含一个用分号分隔的含有选定项目的 ID 列表。

GoBack

此操作与单击交互式服务中心上的后退按钮等效，可将您带回到交互式服务中心的导航堆栈中。

GoHome

此操作带您到用户在 Dynamics 365 中指定的主页。

MoveToPanel

此操作用于在运行时移动面板件的承载控件。

参数	说明
应用程序	要移动的承载控件的名称。
面板	承载的控件的目标面板。

导航

此操作用于导航到交互式服务中心 URL。

参数	说明
URL	要导航到的 URL。 该参数为必需参数。
Noscan	如果提供了此参数，且为“True”，则不会从页面中捕获此数据参数。
HideCommandBar	如果提供了此参数，且为 True，则将显示内部框架，而不是加载交互式服务中心命令栏。
HideNavigationBar	如果提供了此参数，且为 True，则将显示窗体，而不是加载交互式服务中心导航栏。
发布数据	作为 HTTPPOST 事务的一部分发送到服务器的数据。POST 事务通常用来发送 HTML 页面收集的数据。 在 Unified Service Desk 中，此数据可以通过使用“http://event/”从被触发的事件进行接收。 示例：[[postdata]+] 或者，数据可以预期格式作为编码字符与其标题类型被传递。
标题	包含其他 HTTP 标题并发送至服务器的字符串值。 当 postdata 参数用于 Navigate 时，您也应该为 header 参数指定适当的值。 示例：Content-Type:application/x-www-form-urlencoded 如果 Unified Service DeskPOST 事件触发 Navigate 操作，此参数默认值应为 header=[[header]+]

New_CRM_Page

为正在创建的指定实体的新 Dynamics 365 记录创建新页面，并将该页面视为指定托管控件的弹出窗口。 对窗口导航规则进行评估以确定创建实体记录页面显示的位置。

您可将名称=值对中的属性值传递为此操作的数据参数。 例如：

LogicalName=incident
title=Sample Case

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。

刷新

此操作刷新当前页面。

ReRoute

此操作使用当前显示的 URL，并通过窗口导航规则将其从当前托管控件发送，作为一个弹出窗口。

RunScript

此操作将 JavaScript 注入到应用程序的主框架。 应该避免使用 Dynamics 365 客户端 SDK 调用此操作，改用“RunXrmCommand”操作。

参数	说明
	数据参数是会被注入到窗体的 Javascript。 > [!NOTE] > 替换参数可用于脚本，在执行脚本之前才能替换参数。

RunXrmCommand

此操作用于将 Dynamics 365 SDK JavaScript 注入交互式服务中心窗体。

参数	说明
	数据参数是会被注入到窗体的 Javascript。 > [!NOTE] > 替换参数可用于脚本，在执行脚本之前才能替换参数。

保存

此操作将当前数据数据保存在交互式服务中心窗体上。

SaveAll

此操作保存允许显示多个页面的托管控件的所有窗体（“允许多个页面” = 是）。 如果托管控件仅允许显示单页（“允许多个页面” = 否），这与“保存”操作 等效。

SaveAndClose

此操作将当前数据保存在交互式服务中心窗体上，并关闭托管控件。

SetSize

此操作显式设置托管控件的宽度和高度。 在画板布局中使用“自动”时，这尤其有用。

参数	说明
width	托管控件的宽度。
height	托管控件的高度。

预定义事件

以下预定义的事件与该托管控件的类型有关联。

ActiveClosed

在可用托管控件关闭使用 CloseActive操作时发生。

参数	说明
url	在它关闭时，此 URL 在托管控件中显示。

DataReady

在交互式服务页面中的数据已保存至替换参数列表之后发生。

参数	说明
url	页面的 URL。

NavigationRequested

在交互式服务中心中导航时发生。

参数	说明
url	页面导航至的 URL。

RefreshRequested

在当前页上请求刷新时发生。 可以通过按 F5 键或由应用程序调用刷新操作来请求刷新。

参数	说明
url	在请求刷新时显示此 URL。

已保存

在交互式服务中心页面中的记录被保存之后发生。

参数	说明
newId	ID 分派到新创建的记录。

另请参阅

托管控件类型和操作/事件引用
CRM 页（托管控件）

Unified Service Desk 2.0

© 2017 Microsoft。 保留所有权利。 版权