Indicate

本帮助页面适用于 Studio。 此信息也可用于Desktop Studio。

使用自定义功能扩展代理界面，特别是代理单击以启动自定义功能的图标。 坐席界面中的这些图标可用于运行或发送脚本、打开 URL 或构建基于 Web 的基本表单并处理其数据。

依赖关系

  • 脚本中的指示器也必须关闭，否则在联系结束后，指示器将继续出现在坐席界面中。 通常使用两个 Indicate 操作，一个用于打开按钮，另一个用于关闭按钮。
  • 由于 Indicate 操作非常灵活，因此在编程时要非常小心，并对脚本进行全面测试。
  • 确保与 Image File 属性一起使用的链接有效。 断开的链接会给 CXone Mpower 服务器带来严重的性能问题。

  • MAX 基于 Action Type，对所有指示器使用一组预定义的图像。 将 Image File 属性与 MAX 指定图像不会更改坐席看到的图像。

支持的脚本类型

其中一条分支线通向其他三个正方形的正方形。

通用

 电子邮件 聊天 电话 语音信箱 工作项目 短信 数字

类似操作比较

以下操作具有类似功能，但存在一些关键区别：

  • Runapp：从脚本启动自定义功能，尤其是启动表单、网页或应用程序。
  • PopURL：打开网页 URL，并为从网页上弹出的面板提供位置和样式选项。
  • Indicate：使用自定义功能扩展坐席界面，特别是坐席单击以启动自定义功能的图标。 这与 Runapp 类似，但对于 Indicate，Action Type 由脚本而不是坐席发起。

输入属性

这些属性定义操作在执行时使用的数据。 此操作的所有属性都接受变量替换。 为此，请在属性字段中输入变量。 将变量括在大括号 ( { } ) 中。

此操作的某些属性名称会在您配置时动态更改。 例如，如果您选择坐席作为目标，则下一个字段将从联系人 ID 更改为坐席 ID。

属性

说明

Add Caption

输入在脚本中唯一标识此操作的短语。 标题显示在脚本画布上的操作图标下方。

Target

从下拉列表中选择接收者类型：Agents、Team、Skill、Everyone 或 Contact。 默认为 Contact。 Everyone 选项已弃用。 不要选择它。

Contact ID、Agent ID、Team、Skill、Name

目标的 ID，如坐席 ID。此属性的名称因您选择的 Target 而异。
Name

此属性是用于标识值的名称或键。 可以是任何名称或数字。 名称不区分大小写。如果您使用多个 Indicate 操作，则此名称用于跟踪已开启或关闭的 Indicate 操作。
State

用于确定是否将显示指示器的 On 或 Off 下拉列表。 一般，您需要两个同名的 indicate 操作：一个用于启用按钮，一个用于禁用按钮。
Image File

CXone Mpower 文件服务器上的租户关闭 用于管理 CXone Mpower环境的技术支持、计费和全局设置的高级组织分组目录中图像文件的 URL。 这是坐席将单击的图像。 文件必须为 GIF、JPG 或 PNG 格式，且大小为 16x16 像素。在 Salesforce Agent 或 Salesforce Agent Lightning 中使用 Indicate 操作时，需要此属性。

警告如果 Image File的链接断开，会给相关租户带来严重的性能问题。 使用自定义图标时，验证此链接的准确性非常重要。
Tool Tip

当鼠标光标悬停在指示器图标或文本上时显示的文本。
Action Type
  • Run Exe：运行本地可执行文件。 此选项使用仅适用于 Internet Explorer 的 Java 插件，CXone Mpower 不支持：请勿选择此选项。 在 URL 字段中输入可执行文件的路径。
  • Open URL：打开 URL 字段中指定的 URL 的默认 Web 浏览器。
  • Spawn Script：生成在 Script Name 字段中指定的脚本并传递指定的 Skill # 和 Parameters。
  • Signal Script：向由 Contact ID 字段中的 ID 指定的脚本发出信号，并传递 Parameters。
  • Show Custom Form：启动自定义 HTML 表单。 将表单的 HTML 代码粘贴到 HTML 属性中。 从自定义表单中捕获的数据会触发脚本中的 ONDATA 事件操作。
URL

指定要打开的 URL。 仅当您选择 Open URL 或 Run Exe 作为 Action Type 时，才会显示此属性。

对于打开 URL，您必须使用完全限定的域名和 URL。 支持查询字符串参数。 例如，http://www.example.com/file.asp?ANI={ANI}。 您还可以通过将 icAgentPanelTitle= 参数附加到 URL 来自定义 MAX 界面所弹出选项卡的标题。

对于运行 Exe，必须使用驻留在 Windows 路径中或在 URL 字段中输入的完整路径的本地可执行文件。 文件路径必须包含双反斜杠 (\\)。 例如，C:\\Program Files\\CXone Mpower\\studio.exe。 大多数现代浏览器不支持运行可执行程序。 如果您希望使用此类型可执行文件，请确保坐席使用兼容的浏览器。
Script Name

输入要衍生的脚本的完整路径和名称。 仅当您选择 Spawn script 作为 Action Type 时，此属性才会显示。

该路径必须是从当前脚本所在文件夹开始的相对路径。 例如，如果脚本位于同一文件夹中，请输入脚本名称。 如果脚本位于当前脚本位置的子文件夹中，请指定路径和脚本名称。 例如，/Subfolder/ScriptName。

您还必须指定 Skill#。 这将被传递到衍生的脚本中。 您可以指定要传递到衍生脚本中的任何额外的 Parameters。
Skill#

输入要传递到衍生脚本中的 ACD 技能的编号。 仅当您选择 Spawn script 作为 Action Type 时，此属性才会显示。

您还必须指定要衍生的 Script Name。 您可以指定要传递到该脚本中的任何其他 Parameters。
Contact ID

输入您想要发送信号的脚本的 ID。 仅当您选择 Signal script 作为 Action Type 时，此属性才会显示。

默认情况下，此属性使用 {contactId} 变量。 您还可以使用 {masterID} 来标示父脚本，或者使用 {spawnID} 之类来标示子脚本。
Parameters

指定要传递到衍生脚本或正被发出信号的脚本中的任何其他参数。 仅当您选择 Spawn script 或 Signal script 作为操作类型时，此属性才会显示。

添加参数是可选的。
Html

输入您要启动的自定义表单的 HTML。 仅当您选择 Show Custom Form 作为 Action Type 时，此属性才会显示。

您可以使用任何标准表单输入字段，包括 Input、Textarea、Password、Checkbox、Radio、Select、Button 和 Submit。 但是，请勿包含 <form> 标签。 添加字段时：

  • 每个输入字段必须包含一个名称。 将忽略没有名称的字段。 例如，<input type="text" name="phone">。 名称和值作为变量通过 Ondata 操作返回给脚本。 如果脚本中缺失 Ondata 操作，表单将毫无用处。 支持多个值的表单字段（例如 Checkbox 和 Select）将包含一个以逗号分隔的数组。
  • 多个提交按钮可以使用相同或不同的名称，但任何提交按钮都会提交数据并关闭窗口。 如果想要一个不提交的按钮，则使用一个按钮而不是提交。
  • 不支持链接样式表，但支持内联样式。 例如，<div style="position: absolute; left: 10px; top: 100px;">。

  • 当链接到外部脚本时，JavaScript 将正常工作，但内容必须是 HTTPS，以免出错。 例如：

    <script type="text/javascript" src="https://www.example.com/test.js"></script> <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)">

结果分支条件

结果分支条件允许您在脚本中创建分支，以在执行操作时处理不同的结果。

条件

说明

Default

除了脚本满足条件要求其接受其他分支的情况之外，所要采用的路径。 如果未定义操作的其他分支，也会执行此操作。

Error

操作无法正确执行时所采用的路径。 例如，出现连接不良、语法错误等意外问题时。 _ERR 变量以单个下划线字符填充，应包含对问题的简要解释。

提示和技巧

支持 Fieldset 和 Legend 以更可读的方式布置表单。 内联样式可以应用于 HTML 实体。 例如： 

<fieldset>
	<legend>Gender:</legend>
	<input type="radio" name="gender" value="male"/>Male
	<input type="radio" name="gender" value="female"/>Female<br/>
</fieldset>

脚本示例

这是一个示例，说明如何在脚本中使用此操作。 它并不是一个完整的脚本。 可能还需要编写其他脚本。

本示例演示如何将 Indicate 操作合并到脚本中。 其中包括如何将不同类型的数据传递给生成的脚本的示例。 可下载的 ZIP 文件中包含生成脚本的示例。 这是一个示例，说明如何在脚本中使用此操作。 它并不是一个完整的脚本。 可能还需要编写其他脚本。

下载此脚本。