使用 代理脚本 类型的托管控件定义呼叫脚本，该脚本向呼叫中心代理提供说明，以便在给定会话的客户交互期间指导他们。 有关更多信息，请参阅 使用代理脚本指导客户交互。
创建 Agent Scripting 托管控件
在创建新的托管控件时， New Hosted Control （新建托管控件 ） 屏幕中的字段会根据您要创建的托管控件的类型而有所不同。 本节提供有关代理 脚本 托管控件类型唯一的特定字段的信息。 有关创建托管控件的详细信息，请参阅 创建或编辑托管控件。
在“新建托管控件”屏幕中，在 Unified Service Desk 区域下，从“Unified Service Desk 组件类型”下拉列表中选择“代理脚本”。 WorkflowPanel 是此托管控件类型最常用的面板，它显示在 Display Group 字段中。 有关 Unified Service Desk 中可用的各种面板的信息，请参阅 Unified Service Desk 中的面板、面板类型和面板布局。 有关其他 General 字段的信息，请参阅 创建或编辑托管控件。
预定义的 UII作
这种类型的托管控件支持以下作。
返回
返回到历史记录中的上一步。
关闭
此作用于关闭托管控件。
FireEvent 事件
从此托管控件触发用户定义的事件。
| 参数 | DESCRIPTION |
|---|---|
| 姓名 | 用户定义的事件的名称。 |
所有后续的 name=value 对都将成为事件的参数。 有关创建用户定义的事件的更多信息，请参阅 创建用户定义的事件。
转到任务
此作显示指定的代理任务。 可用的代理任务名称可以在 Microsoft Dataverse 的 代理脚本 部分（设置>代理脚本）中看到。
| 参数 | DESCRIPTION |
|---|---|
| 指定要在 Data 字段中显示的代理任务的名称。 |
GoToTaskByContext
此作已弃用。 使用 GoToTask 作。
GotoTaskByDnis
此作已弃用。 使用 GoToTask 作。
移动到面板
此作用于在运行时在面板之间移动托管控件。
| 参数 | DESCRIPTION |
|---|---|
| 应用程序 | 要移动的托管控件的名称。 |
| 面板 | 托管控件的目标面板。 |
New_CRM_Page
创建一个页面，用于创建指定实体的 Dataverse 记录，并将该页面视为指定托管控件中的弹出窗口。 评估窗口导航规则以确定用于创建实体记录的页面的显示位置。
| 参数 | DESCRIPTION |
|---|---|
| 逻辑名称 | 用于创建新实例的实体的逻辑名称。 |
注释
其余参数应由 name=value 对组成。 这些是表单中用于为指定实体创建新记录的其他预填充值。 有关使用此作的更多信息，请参阅 演练 7：在代理应用程序中配置代理脚本中的步骤 4。
Open_CRM_Page
打开由 ID 指定和标识的实体的现有实例，并将该页面视为来自指定托管控件的弹出窗口。 评估窗口导航规则以确定弹出窗口的显示位置。
| 参数 | DESCRIPTION |
|---|---|
| 逻辑名称 | 要打开的实体的逻辑名称。 |
| id | 要打开的实体记录的 ID。 |
弹窗
从托管控件弹出一个 URL，并针对它运行窗口导航规则，以将弹出窗口路由到适当的位置。
| 参数 | DESCRIPTION |
|---|---|
| 网址 | 使用此 URL 路由来自此托管控件的弹出窗口，就像它是从显示的控件请求的弹出窗口一样。 |
| 框架 | 此弹出窗口的来源帧。 |
重新对齐窗口
在监视器上的指定位置显示托管控件。 您最多可以在两个监视器上显示 Hosted Control。 此作适用于配置为放置在 USDFloatingPanel 或 USDFloatingToolPanel 面板类型上的托管控件实例。
| 参数 | DESCRIPTION |
|---|---|
| 屏幕 | 指定要在其上显示托管控件的屏幕。 有效值为 1 或 2。 如果不指定此参数，则默认传递 1。 |
| 左 | 指定目标监视器上应显示托管控件的位置（以百分比表示）。 有效值为 0 到 100。 如果不指定此参数，则默认传入 0。 |
| 顶部 | 指定目标监视器上应显示托管控件的屏幕顶部的位置（以百分比表示）。 有效值为 0 到 100。 如果不指定此参数，则默认传入 0。 |
| 宽度 | 指定目标监视器上托管控件窗口的宽度（以百分比表示）。 有效值为 1 到 100。 如果不指定此参数，则默认传递 100。 |
| 身高 | 指定目标监视器上托管控件窗口的高度（以百分比表示）。 有效值为 1 到 100。 如果不指定此参数，则默认传递 100。 |
SetSize
此作显式设置托管控件的宽度和高度。 当您在面板布局中使用 “auto” 时，这特别有用。
| 参数 | DESCRIPTION |
|---|---|
| 宽度 | 托管控件的宽度。 |
| 身高 | 托管控件的高度。 |
ShowSendButton 显示
此作在客户端应用程序中的代理脚本上显示 Send （发送 ） 按钮。 此按钮通常用于聊天会话，当用户单击该按钮时，将触发 SendClicked 事件，该事件用于将脚本文本写入聊天窗口。
预定义事件
以下预定义事件与此托管控件类型相关联。
所有答案已访问
当单击当前任务的所有答案时出现。 这对于清单很有用。 基本上每个答案都指向相同的任务。 因此，当您单击按钮时，它们将在它们旁边显示复选框。 选中所有事件后，将触发此事件。
| 参数 | DESCRIPTION |
|---|---|
| 任务 | 已单击其所有答案的任务的名称。 |
| id | 已单击所有答案的任务的 ID。 |
SendClicked
单击客户端应用程序中代理脚本上的 Send 按钮时出现。 若要显示 Send Button，应调用 ShowSendButton 作。
任务已更新
每次到达代理脚本时发生，无论是通过用户单击答案，还是通过某个组件调用对此托管控件上的作之一。
| 参数 | DESCRIPTION |
|---|---|
| 任务 | 到达的代理脚本任务的名称。 对于主菜单（不是代理脚本配置中列出的任务），将触发一个事件，并将此参数设置为 “[Main Menu]”。 |
另请参阅
使用代理脚本指导客户交互配置和管理代理脚本UII作事件查看托管控件的预定义作和事件查看作和事件的嵌入式帮助演练 7：在代理应用程序中配置代理脚本托管控件类型和作/事件参考Unified Service Desk for Microsoft Dynamics CRM 管理指南