Indicate

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

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

Dependencies

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

Supported Script Types


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

Comparison of Similar Actions

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

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

Input Properties

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

属性	说明
Target	从下拉列表中选择接收者类型：Agents, Team, Skill, Everyone, Contact. The Everyone option has been deprecated.
TargetIDs	目标的 ID，如坐席 ID 或技能 ID。
Name	此属性是用于标识值的名称或键。可以是任何名称或数字。名称不区分大小写。 If you have multiple Indicate actions in use, this name is used to track which Indicate action is turned on or off.
ImageFile	CXone 文件服务器上的业务单位用于管理 CXone环境的技术支持、计费和全局设置的高级组织分组目录中图像文件的 URL。这是坐席将单击的图像。文件必须为 GIF、JPG 或 PNG 格式，且大小为 16x16 像素。 This property is required when using the Indicate action in Agent for Salesforce or Agent for Salesforce Lightning. Warning A broken link for ImageFile can cause severe performance issues for the associated business unit. When using custom icons, it is important to verify that the link is accurate.
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)">`

Result Branch Conditions

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

条件	说明
Default	除了脚本满足条件要求其接受其他分支的情况之外，所要采用的路径。如果未定义操作的其他分支，也会执行此操作。
OnError	操作无法正确执行时所采用的路径。例如，出现连接不良、语法错误等意外问题时。_ERR 变量以单个下划线字符填充，应包含对问题的简要解释。

Tips and Tricks

支持 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>

Script Example

此示例并非完整的脚本。要使用此操作，需要额外的脚本编写工作。

This example demonstrates how to incorporate the Indicate action into a script. It includes examples of how to pass different types of data to the spawned script. An example of a spawned script is included in the downloadable ZIP file.

Download this script.