Indicate

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

Double-click the action to open a configuration wizard.

依赖关系

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

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

支持的脚本类型

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

通用

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

类似操作比较

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

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

输入属性

这些属性定义操作在执行时使用的数据。

属性

说明
Target

从下拉列表中选择接收者类型： Agents、Team、Skill、Everyone、Contact。 Everyone 选项已弃用。
TargetIDs

目标的 ID，如坐席 ID 或技能 ID。
Name

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

CXone 文件服务器上的业务单位关闭 用于管理 CXone环境的技术支持、计费和全局设置的高级组织分组目录中图像文件的 URL。 这是坐席将单击的图像。 文件必须为 GIF、JPG 或 PNG 格式，且大小为 16x16 像素。

在 Salesforce Agent 或 Salesforce Agent Lightning 中使用 Indicate 操作时，需要此属性。

警告如果 ImageFile的链接断开，会给相关业务单位带来严重的性能问题。 使用自定义图标时，验证此链接的准确性非常重要。
Tooltip

当鼠标光标悬停在指示器图标或文本上时显示的文本。
State

用于确定是否将显示指示器的 On 或 Off 下拉列表。 一般，您需要两个同名的 indicate 操作：一个用于启用按钮，一个用于禁用按钮。
ActionType
  • RunExe: Runs a local executable. This option uses a Java plugin that only works with Internet Explorer, which CXone does not support: do not select this option. This requires a local executable that resides in the Windows path or with the full path entered in the ActionValue field. The file path must include double back slashes (\\) in the path. For example, C:\\Program Files\\CXone\\studio.exe. Most modern browsers do not support running executable programs. If you want to use this type, ensure that your agents use a compatible browser.
  • OpenURL: Opens a default web browser to the URL specified in the ActionValue field.
  • SpawnScript: Spawns a script specified in the ActionValue field and passes parameters.
  • SignalScript: Signals a script specified in the ActionValue field and passes parameters.
  • ShowCustomForm: Launches a custom HTML form created in Studio. The captured data from the custom form will trigger the ONDATA event in the script.
ActionValue

该值为指定的 ActionType 所需要。 此属性中支持变量，方法是用大括号 ( { } ) 将其括起来。

  • RunExe：Windows 可执行文件的名称或路径。 文件路径必须包含双反斜杠 (\\)。 例如，C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}。
  • OpenURL ：必须是全限定域名和 URL。 支持查询字符串参数。 例如，http://www.example.com/file.asp?ANI={ANI}。 您还可以通过将 icAgentPanelTitle= 参数附加到 URL 来自定义 MAX 界面所弹出选项卡的标题。
  • SpawnScript ：要生成的脚本的名称。 该名称必须是脚本的完整路径（在运行脚本的当前目录中）。 脚本生成参数 SkillID 是必需的。 如果没有 ACD 技能 ID，脚本将无法生成。
  • SignalScript ：要标示的运行脚本的 ID。 通常情况下，您正在生成一个相关的脚本，可以使用 {ContactID} 来标示当前脚本。 使用 {MasterID} 来标示父脚本，或者使用 {SpawnID} 之类来标示子脚本。
  • ShowCustomForm ：此字段允许您创建自定义 HTML 表单。 您可以使用新式浏览器能够支持的 HTML 和 CSS。 可使用任何标准表单输入字段，包括“输入”、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 时，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)">

    • Some characters used in HTML and CSS are interpreted as code, such as double quotes. To get around this, use the .char() function to add the character where it belongs. For example:

      //The double quotes in the HREF tag cause a problem:
      ASSIGN html = "ASSIGN html = "<a href="https://www.w3schools.com">Visit W3Schools</a>""
      //To get around that, replace those double quotes with the char equivalent:
      ASSIGN html = "ASSIGN html = "<a href={char(34)}https://www.w3schools.com{char(34)}>Visit W3Schools</a>"

结果分支条件

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

条件

说明

Default

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

OnError

操作无法正确执行时所采用的路径。 例如，出现连接不良、语法错误等意外问题时。 _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 文件中包含生成脚本的示例。

下载此脚本。