CTI 桌面管理器（托管控件）

 

发布日期： 2016年11月

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

使用“CTI 桌面管理器”托管控件类型将“计算机电话集成”(CTI) 适配器插入到 Unified Service Desk 以处理屏幕弹出消息、呼叫路由、电话软件控件和其他 CTI 功能。

本主题内容

创建一个 CTI 桌面管理器托管控件

预定义的 UII 操作

预定义事件

创建一个 CTI 桌面管理器托管控件

有关创建 CTI 桌面管理器及配置相应托管控件的信息，请参阅 创建 CTI 桌面管理器。

预定义的 UII 操作

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

关闭

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

CloseAndPrompt

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

DisableToolbarButton

此操作在代理应用程序中禁用工具栏上的指定工具栏按钮。

参数	说明
	要禁用的工具栏按钮名称。

EnableToolbarButton

此操作启用代理应用程序中工具栏上的指定工具栏按钮。

参数	说明
	要启用的工具栏按钮名称。

查找

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

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

FireEvent

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

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

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

GoBack

此操作与单击浏览器实例上的后退按钮等效。

GoForward

此操作与单击浏览器实例上的前进按钮等效。

GoHome

此操作转到为该浏览器实例指定的初始化 URL。

LoadArea

此操作从 Dynamics 365 加载特定区域。 这与在导航窗格（如销售、服务和市场营销）中选择区域等效。 唯一的参数是要单击的区域名称。 例如：“areaService”。

参数	说明
框架	影响的框架名称。 如果未指定名称，其将自动设置页面上找到的第一个框架为目标。

MoveToPanel

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

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

导航

此操作用于导航到一个 Dynamics 365 url。

参数	说明
URL	要导航到的 URL。 该参数为必需参数。
Noscan	如果提供了此参数，且为“True”，则不会从页面中捕获此数据参数。
HideCommandBar	如果提供了此参数，且为 True，则将显示内部框架，而不加载 Dynamics 365 命令栏。
HideNavigationBar	如果提供了此参数，且为 True，则将显示窗体，而不是加载 Dynamics 365 导航栏。
框架	当页面上存在框架时，该参数将指定要导航的框架名称，而不是导航主窗口。
发布数据	作为 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	用于创建新实例的实体的逻辑名称。

备注

其余的参数由 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。

ReRoute

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

RunScript

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

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

RunXrmCommand

此操作用于将 Dynamics 365 SDK JavaScript 注入 Dynamics 365 窗体。

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

保存

此操作保存当前 Dynamics 365 页。

SaveAll

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

SaveAndClose

此操作会把错误数据保存在 Dynamics 365 窗体上，并关闭此托管控件。

SetSize

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

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

ToggleNavigation

此操作折叠或展开 Dynamics 365 窗口左侧面板上的导航窗格。 此操作要正常工作，则导航必须包含一个导航面板。

ToggleRibbon

此操作折叠或展开功能区。 如果您将功能区隐藏在“导航”操作中，则不会显示该功能区，并且此操作不起作用。 只有在初始加载功能区时，此操作才会正常工作。

WaitForComplete

此操作可用于阻止处理直到 URL 完成加载。

备注

某些 Web 页面，特别是 Dynamics 365 页具有多个框架。 此操作只等待主框架完成。

参数	说明
毫秒	指示用毫米表示的等待超时的时间的可选参数。

预定义事件

这些是这托管控件类型的预定义事件。

BrowserDocumentComplete

页面完成加载时发生。

参数	说明
url	完成页面 URL 的加载。

PageLoadComplete

在框架完成加载时均发生。 在页面上使用 iFrame 或框架时，此事件在每次页面加载时多次发生。 此事件对应于代码中单独的 BrowserDocumentComplete 事件。

参数	说明
框架	完成加载的框架的名称。
url	完成加载的框架的 URL。

PopupRouted

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

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

另请参阅

使用 CTI 适配器与 CTI 系统集成

Unified Service Desk 2.0

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