Indicate

This help page is for Desktop Studio.This information is also available for CXone Studio.

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

双击该操作可打开配置向导。

依赖关系

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

  • 因为您的 MAX 会根据 ActionType 为所有指标使用一组预定义的图像。使用 MAX 属性指定图像ImageFile不会改变坐席看到的图像。

支持的脚本类型

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.

通用

 Email 聊天 电话 语音信箱 工作项目 短信 数字

类似操作比较

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

  • 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 下拉列表。通常，您需要两个具有相同名称的操作。一个用于启用该按钮，一个用于禁用该按钮。
ActionType
  • RunExe：运行本地可执行文件。该选项使用仅适用于 Internet Explorer 的 Java 插件，而 CXone 不支持该插件。这要求本地可执行文件位于 Windows 路径下或在 ActionValue 字段中输入完整路径。文件路径必须包含双反斜杠 (\\)。例如，C:\\Program Files\\CXone\\studio.exe。大多数现代浏览器不支持运行可执行程序。如果您希望使用此类型可执行文件，请确保坐席使用兼容的浏览器。
  • OpenURL：打开 ActionValue 字段中指定的 URL 的默认 Web 浏览器。
  • SpawnScript：生成 ActionValue 字段中指定的脚本并传递参数。
  • SignalScript：标示 ActionValue 字段中指定的脚本并传递参数。
  • ShowCustomForm：启动在 Studio 中创建的自定义 HTML 表单。从自定义表单中捕获的数据将触发脚本中的 ONDATA 事件。
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 表单。可以使用任何标准表单输入字段，包括“输入”、“文本区域”、“密码”、“复选框”、“单选”、“选择”、“按钮”和“提交”。不应包含<form> 标签。
    • 每个输入字段必须包含一个名称。将忽略没有名称的字段。例如，<input type="text" name="phone">。名称和值将作为变量通过 Ondata 操作返回给脚本。如果脚本中缺失 Ondata 操作，表单将毫无用处。支持多个值的表单字段（例如“复选框”和“选择”）将包含一个逗号分隔的数组。
    • 多个提交按钮可以使用相同或不同的名称，但任何提交按钮都会提交数据并关闭窗口。如果想要一个不提交的按钮，则使用一个按钮而不是提交。
    • 不支持链接样式表，但支持内联样式。例如，<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)">

结果分支条件

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

条件

说明

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 文件中包含生成脚本的示例。

下载此脚本。