KM 控件（托管控件）

 

发布日期： 2016年11月

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

使用托管控件的新“KM 控件”类型，可显示代理应用程序中的 Microsoft Dynamics 365 或 Parature 内的知识库文章。 使用新的托管控件，您的服务代理可以搜索文章、通过案例关联文章或解除与文章的关联、复制链接到文章，以及通过电子邮件或聊天发送文章，而无需切换应用程序。详细信息：使用 Dynamics 365 或 Parature 知识进行有效的客户接洽 和 配置 Unified Service Desk 以使用 Dynamics 365 或 Parature 知识

本主题内容

创建 KM 控件（托管控件）

预定义的 UII 操作

预定义事件

创建 KM 控件（托管控件）

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

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

• 在“Unified Service Desk”区域下，从“USD 组件类型”下拉列表中选择“KM 控件”。

• “许多个页面”下拉列表不支持此控制托管类型。

• “托管类型”下拉列表指定您希望如何托管此控件。 您可以选择“IE 流程”（默认）或“内部 WPF”。 有关详细信息，请参阅为您的控件选择一个托管方法。

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

• 在“显示组”字段中显示此承载的控件显示的面板。 在知识管理包中，KM 控件显示在“RighPanel”中；但是，您可以根据需要选择将其显示在“LeftPanel”或“MainPanel”。 有关各类在 Unified Service Desk 中可用的面板的信息，请参阅 Unified Service Desk 中的面板、面板类型和面板布局。

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

预定义的 UII 操作

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

关联

将 Dynamics 365 或 Parature 中的知识库记录与“KM 控件”中的父实体记录相关联。

参数	说明
entitytypename	关联知识库记录的父实体的逻辑名称。 例如：entitytypename=incident
recordid	关联知识库记录的父实体记录的 ID。
articleuniqueid	要关联的文章的唯一 ID。 例如：articleuniqueid=7924/8112/Article/41
articletitle	表示要关联的文章标题的字符串值。 例如：articletitle=Diffused Sunlight and Weather Conditions
articleprivateurl	要关联的 Parature 中文章的专用 URL。 例如：articleprivateurl=https://demo.parature.com/ics/km/kmRefEdit.asp?questionID=41 > [!NOTE] > 如果您使用本机 Dynamics 365 知识库，此参数将不适用；它仅适用于 Parature 知识库。
articlepublicurl	要关联的文章的公共 URL。 如果您使用本机 Dynamics 365 知识库，则文章应已发布到外部门户（在 Dynamics 365 中的“知识库管理设置”对话框上选择“使用外部门户”），以便您可以在此参数中使用文章 URL。 例如: articlepublicurl=https://support.microsoft.com/kb/{kbnum}

关闭

关闭“KM 控件”托管控件。

解除关联

解除知识库记录关联，其中该知识库记录已与“KM 控件”中的父实体记录关联。

参数	说明
articleuniqueid	要取消关联的文章的唯一 ID。 例如：articleuniqueid=7924/8112/Article/41
relatedentityrecordid	与知识库记录关联的父实体记录 ID。
entityname	与知识库记录关联的父实体的逻辑名称。 例如: entitytypename=incident

FireEvent

通过“KM 控件”托管控件触发用户定义的事件。

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

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

MoveToPanel

在运行时，将托管控件移动至 Unified Service Desk 的指定面板。

参数	说明
app	要移动的承载控件的名称。
panel	托管控件所移动至的目标面板的名称。

弹出窗口

从托管控件弹出 URL，并对其运行窗口导航规则，以发送该弹出到适当的位置。

参数	说明
url	使用此 URL 作为显示控件请求的弹出，以从该托管控件发送一个弹出。
frame	该弹出所源自的框架。

RealignWindow

在监视器上的指定位置显示托管控件。 您最多可在两台监视器上显示托管控件。 此操作适用于配置为置于 USDFloatingPanel 或 USDFloatingToolPanel 面板类型上的托管控件实例。

参数	说明
screen	指定要显示托管控件的屏幕。 有效值为 1 或 2。 如果不指定此参数，则默认情况下将传递 1。
left	指定目标监视器屏幕左侧应显示托管控件的位置（以百分比为单位）。 有效值为 0 到 100。 如果不指定此参数，则默认情况下将传递 0。
top	指定目标监视器屏幕上方应显示托管控件的位置（以百分比为单位）。 有效值为 0 到 100。 如果不指定此参数，则默认情况下将传递 0。
width	指定目标监视器上的托管控件窗口的宽度（以百分比为单位）。 有效值为 1 到 100。 如果不指定此参数，则默认情况下将传递 100。
height	指定目标监视器上的托管控件窗口的高度（以百分比为单位）。 有效值为 1 到 100。 如果不指定此参数，则默认情况下将传递 100。

搜索

通过将搜索字符串作为参数进行传递，在“KM 控件”中搜索记录。

参数	说明
查询	将在托管控件中搜索的字符串值。 例如：query=contoso。 这将从名称以“contoso”开头的 Dynamics 365 或 Parature 中提取所有知识文章。
结果	表明搜索结果数的整数值将显示在托管控件中。 例如，在托管控件中，指定 results=5 将显示 5 个搜索结果。 如果没有为此数据参数提供值或提供错误值，则将使用默认值 (10)。 此数据参数允许采用的最大值为 20。
筛选器	表明知识库文章类型的整数值将显示在托管控件中： 1：全部（默认） 2：全部草稿 3：全部已发布 4：已发布 - 专用 5：已发布 - 公共 6：已发布-过期 例如，指定 filter=3 仅显示发布的知识库文章。 如果没有提供值或提供错误值，则将使用默认值 (1)。
blockClick	在托管控件中单击搜索结果时，此整数值指示是否阻止显示内嵌内容。 将其设置为 0 以在单击时打开内嵌内容；将其设置为 1 以阻止打开内嵌内容。 例如：blocked=1 如果没有提供值或提供错误值，则将使用默认值 (0)。 如果您将值设置为 1 以阻止内容，则仍将触发 ResultOpen 事件。
排序	表明在搜索结果中知识库文章排序选项的整数值： 1：相关性（默认） 2：等级 3：视图数量 4：上次修改日期（最早的显示在最前面） 5：上次修改日期（最新的显示在最前面） 例如，指定 sort=2 以根据等级对文章进行排序。 如果没有提供值或提供错误值，则数据参数将使用默认值 (1)。

SetArticleContext

将数据附加到“KM 控件”中的当前知识库文章。

参数	说明
articleapplication	将显示知识库文章的托管控件的名称。
articledata	通过 ResultOpen 事件传递的文章记录对象值。

SetSearchProps

启用不同类型的筛选器，以在“KM 控件”中搜索知识库文章。

参数	说明
showFilter	指示是否启用文章类型筛选器来搜索知识库文章。 将 0 设置为隐藏筛选器，并将 1 设置为显示筛选器。 例如：showFilter=1。 如果没有提供值或提供错误值，则将使用默认值 (0)。
showLang	指示是否启用语言筛选器来搜索知识库文章。 将 0 设置为隐藏筛选器，并将 1 设置为显示筛选器。 例如：showLang=1。 如果没有提供值或提供错误值，则将使用默认值 (0)。
showDept	指示是否启用部门筛选器来搜索知识库文章。 将 0 设置为隐藏筛选器，并将 1 设置为显示筛选器。 例如：showDept=1。 如果没有提供值或提供错误值，则将使用默认值 (0)。

SetSize

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

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

SetUserCanClose

通过单击托管控件选项卡右上角的 X 图标，用户可以关闭托管控件。

参数	说明
UserCanClose	将此设置为 true 以允许用户关闭托管控件。 否则，设置 false。

预定义事件

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

PopupRouted

在系统路由了弹出窗口之后发生。

参数	说明
url	路由了弹出窗口的 URL。

ResultOpen

当打开搜索结果来阅读“KM 控件”中的内容时发生。

参数	说明
postdata	Formdata 对象包含表示窗体字段及其知识文章的值的一组键/值对。

SearchComplete

知识库文章搜索完成后发生，且搜索结果已加载到托管控件中。

SelectionChange

当在“KM 控件”中选择结果时发生。

参数	说明
postdata	Formdata 对象包含表示窗体字段及其知识文章的值的一组键/值对。

另请参阅

使用 Dynamics 365 或 Parature 知识进行有效的客户接洽
配置 Unified Service Desk 以使用 Dynamics 365 或 Parature 知识
演练 8：在您的代理应用程序中使用 Parature 知识库
托管控件类型和操作/事件引用

Unified Service Desk 2.0

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