标准的 Web 应用程序（承载的控件）

 

发布日期： 2016年11月

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

“标准 Web 应用程序”托管控制类型类似“CRM 页面”类型，除了前者本应用于托管非 Dynamics 365 页面（如外部网页），并且提供外部网页相关功能的脚本注入。 与“CRM 页面”托管控件类似，这些页面可以被自动化。 自动化的最佳方法是通过 JavaScript 注入（包含调用已在页面中定义或操控 DOM 的 JavaScript 功能）。RunScript 操作还可用于从页面获取值。

备注

该托管控件类型不支持 托管应用程序工具包 (HAT)，可促进自动化托管应用程序的 UI 的任务。 HAT 包括用来自动化应用程序的数据驱动适配器 (DDA)、描述性绑定和自动化（Windows 工作流）。详细信息：使用 UII 自动化适配器与外部和 Web 应用程序互动

本主题内容

创建承载标准的 Web 应用程序的控件

预定义的 UII 操作

预定义事件

创建承载标准的 Web 应用程序的控件

在创建新的承载控件时，“新的承载控件”屏幕中的字段基于要创建的承载控件的类型而变化。 本节提供有关对承载“标准 Web 应用程序”的控件唯一的特定字段的信息。 有关创建承载控件的详细信息，请参阅 创建或编辑承载的控件。

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

• 在“Unified Service Desk”区域下，从“SD 组件类型”下拉列表中选择“标准 Web 应用程序”。

• 在调用第二个 URL 或 window 导航规则将一个页面指向选项卡时，从“允许多个页面”下拉列表中选择“是”以自动创建下拉列表。 这将允许用户在附加到此控件的页面之间快速搜索。 如果选择“否”，当 Unified Service Desk 接到导航操作调用或页面被路由到选项卡时，将替换当前显示的页面并更新浏览器历史记录。

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

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

• 在“显示组”字段中指定此承载的控件显示的面板。 有关各类在 Unified Service Desk 中可用的面板的信息，请参阅 Unified Service Desk 的面板。

预定义的 UII 操作

这些是该承载的控件类型可用的预定义 UII 操作。

关闭

此操作用于关闭托管控件。

FireEvent

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

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

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

GoBack

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

GoForward

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

GoHome

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

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	用于创建新实例的实体的逻辑名称。

备注

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

RunScript

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

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

SetSize

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

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

WaitForComplete

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

备注

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

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

预定义事件

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

BrowserDocumentComplete

页面完成加载时发生。 在托管控件的“CRM 页面”类型上，在数据保存到替换参数列表后发生此事件。 虽然多个框架将单独触发它们的“BrowserDocumentComplete” 事件，但此事件只发生一次。

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

PopupRouted

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

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

另请参阅

UII 操作
事件
查看为托管控件预定义的操作和事件
创建或编辑承载的控件
演练 2：在代理应用程序中显示外部网页
托管控件类型和操作/事件引用

Unified Service Desk 2.0

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