Runapp

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

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

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

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

支持的脚本类型


通用	Email	聊天	电话	工作项目	短信

类似操作比较

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

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

输入属性

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

属性	说明
说明文字	输入在脚本中唯一标识此操作的短语。标题显示在脚本画布上的操作图标下方。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 向导

您还可以直接在操作的属性中配置该操作。

双击 Runapp 操作以打开 RunApp Property Editor 向导。
查看图像
输入接收 Runapp 操作的坐席相应的 ID。对于呼出脚本，使用 {__agentID} 作为变量名，对于所有其他脚本使用 {AGENTID}。

选择操作类型。

字段	说明
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	在 Action Command 字段中输入 HTML 代码以生成表单。您无需包含开始和结束的<表单>标记。单击 Preview 以查看该表单。

单击 OK。