Runapp

从脚本启动自定义功能，特别是启动表单、网页或应用程序。任何指向联系人面板的 URL 都必须配置为允许在 ifram 中显示。坐席必须在 MAX 中Panels 设置设为On。Salesforce Agent 和 Salesforce Agent Lightning 支持这个操作。

此操作通过 Ondata 分支提交信息。

Runapp 的一个常见用法是为带有 ONANSWER 事件（通过 Onanswer 操作管理）的坐席弹出一个标准表单或自定义 URL。

您可以使用 PAGE action来向坐席弹出简单的 HTML 页面。Page对于创建遵循独立分支的项序列非常有用，但是只要您通过 Runapp 提交信息，该信息都要经过 Ondata 分支。

Supported Script Types

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 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.

通用

 电子邮件 聊天 电话 工作项目 短信

Comparison of Similar Actions

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

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

Input Properties

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

属性

说明

说明文字

输入在脚本中唯一标识此操作的短语。标题显示在脚本画布上的操作图标下方。The default is the action name.

AgentID

坐席 ID。您可以为该字段使用一个变量，例如 {agentId}。

呼出技能已分配一个自定义脚本，因此当 Runapp 在呼出自定义脚本中触发时，会使用 Begin 操作，因为它已经“知道”坐席是谁（进行呼出呼叫的坐席）。因此，仅当将 {__agentID} 用作变量名称时，弹出屏幕才会起作用。对于呼入脚本，该脚本在 Onanswer 触发之前并不“知道”坐席是谁，因此会将坐席 ID 变量设置为 AGENTID。

您可以通过双击该操作来使用 RunApp 属性编辑器配置此属性。

ActionType

  • RunExe：CXone回放不支持附件。这需要驻留在 Windows 路径中或具有 ActionValue 字段中所输入完整路径的本地可执行文件。文件路径必须包含双反斜杠 (\\)。例如，C:\\Program Files\\CXone\\studio.exe。大多数现代浏览器不支持运行可执行程序。如果您希望使用此类型可执行文件，请确保坐席使用兼容的浏览器。
  • OpenURL：打开 ActionValue 字段中指定的 URL 的默认 Web 浏览器。
  • ShowCustomForm：启动在 Studio 中创建的自定义 HTML 表单。从自定义表单中捕获的数据将触发脚本中的 ONDATA 事件。

您可以通过双击该操作来使用 RunApp Property 属性编辑器配置此属性。

ActionValue

该值为指定的 ActionType 所需要。在此属性中，通过将变量封装在 {braces} 中，可以支持变量。

  • RunExe：Windows 可执行文件的名称或路径。文件路径必须包含双反斜杠 (\\)。例如，C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}。
  • OpenURL：必须是全限定域名和 URL。支持查询字符串参数。例如，http://www.example.com/file.asp?ANI={ANI}。您还可以通过将 icAgentPanelTitle= 参数附加到 URL 来自定义 MAX 界面所弹出选项卡的标题。
  • ShowCustomForm：此字段提供了构建自定义 HTML 表单的功能。可以使用任何标准表单输入字段，包括“输入”、“文本区域”、“密码”、“复选框”、“单选”、“选择”、“按钮”和“提交”。请勿包含 <form> 标签。

    每个输入字段必须包含一个名称。将忽略没有名称的字段。例如，<input type="text" name="phone">。

    该脚本必须包含以下内容之一，您的自定义表单才能正常工作：

    • Ondata 操作：名称和值将作为变量通过此操作返回给脚本。
    • WaitForSubmit 属性：当包含该项并设置为 True 时，字段名将成为脚本中的变量。字段值成为变量的内容。

    支持多个值的表单字段（例如“复选框”和“选择”）将包含一个逗号分隔的数组。

    多个提交按钮可以使用相同或不同的名称，但任何提交按钮都会提交数据并关闭窗口。如果想要一个不提交的按钮，则使用一个按钮而不是提交。

    链接样式表不受支持，但您可以使用内联样式。例如，<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)">

您可以通过双击该操作来使用 RunApp Property Editor 属性编辑器配置此属性。

WaitForSubmit

True或False。True 表示系统将等待坐席的提交操作。此外，字段名称成为脚本中的变量，字段值作为变量内容。WaitForSubmit 只适用于 Action Type 为 ShowCustomForm 的情况。它与 WaitTimeout 一起运作。当 WaitForSubmit 设置为 False 时，您必须在脚本中包含 Ondata 操作，它将字段名称和值作为变量返回给脚本。

确定系统是否等待坐席执行的提交操作。启用后，系统会等待坐席执行的提交操作。字段名称成为脚本中的变量，字段值作为变量的值。当被禁用时，您必须在脚本中包含 Ondata 操作，它将字段名称和值作为变量返回给脚本。设置为 True 可启用，或者设置为 False 可禁用。

仅当 Action Type 为 ShowCustomForm 时，此选项才适用。它与 WaitTimeout 一起运作。

WaitTimeout

如果 Action Type 为 ShowCustomForm，则秒数会触发 OnTimeout 分支。

结果分支条件

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

条件

说明

Default

除了脚本满足条件要求其接受其他分支的情况之外，所要采用的路径。如果未定义操作的其他分支，也会执行此操作。
Submit 当 WaitForSubmit 设置为“真”时所采用的路径。
Timeout 在指定的秒数内没有响应时所采用的路径。

OnError

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

Runapp Wizard

You can also configure the action directly in the action's properties.

  1. 双击 Runapp 操作以打开 RunApp Property Editor 向导。
  2. 输入接收 Runapp 操作的坐席相应的 ID。对于呼出脚本，使用 {__agentID} 作为变量名，对于所有其他脚本使用 {AGENTID}。
  3. 选择操作类型。
    字段说明
    Run an executable program

    运行本地可执行文件。此选项使用仅适用于 Internet Explorer 的 Java 插件，CXone 不支持 Internet Explorer。这需要驻留在 Windows 路径中或具有 ActionValue 字段中所输入完整路径的本地可执行文件。文件路径必须包含双反斜杠 (\\)。例如，C:\\Program Files\\CXone\\studio.exe。大多数现代浏览器不支持运行可执行程序。如果您希望使用此类型可执行文件，请确保坐席使用兼容的浏览器。

    Pop open a web page

    在Action Command字段中输入网页的完整 URL。该页面将使用坐席本地计算机上的默认浏览器打开。

    Prompt the user with a web page like form
    1. 在 Action Command 字段中输入 HTML 代码以生成表单。您无需包含开始和结束的<表单>标记。
    2. 单击 Preview 以查看该表单。
  4. 单击 OK。