Runapp

從指令碼啟動自訂功能，特別是啟動表單、網頁或應用程式。任何指向聯絡面板的 URL 均必須配置為允許在 iframe 中顯示。客戶專員必須將 MAX 中的 Panels 設定設為開啟On。Agent for Salesforce 和 Agent for Salesforce Lightning 支援此動作。

此動作透過 Ondata 分支提交資訊。

Runapp 的一個常見用法是，為具有 ONANSWER 事件（透過 Onanswer 動作管理）的客服專員彈出一個標準表單或自訂 URL。

您可以使用 PAGE action向客服專員彈出簡單的 HTML 頁面。Page 可用於建立遵循不同分支的一系列項目，而在任何時候使用 Runapp 提交資訊時，資訊均會經過 Ondata 分支。

Supported Script Types


一般	電郵	聊天	電話	工作項目	SMS

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} 用作變數名稱的情況。對於呼入指令碼，在（將客服專員 ID 變數設定為 AGENTID）Onanswer觸發之前，該指令碼並不「知曉」客服專員是誰。您可使用 RunApp 屬性編輯器透過點擊兩下該動作來配置此屬性。
ActionType	RunExe：CXone 不支援。這需要一個駐留在 Windows 路徑中的本機可執行檔案，或者在 ActionValue 欄位中輸入完整路徑。檔案路徑中必須包含雙反斜線 (\\)。例如 C:\\Program Files\\CXone\\studio.exe。如今大部分瀏覽器都支援執行可執行程式。如果您要使用此類型，請確保客服專員使用相容的瀏覽器。 OpenURL：開啟一個預設網頁瀏覽器並轉至 ActionValue 欄位中指定的 URL。 ShowCustomForm：啟動在 Studio 中建立的自訂 HTML 表單。從自訂表單中擷取的資料將觸發指令碼中的 ONDATA 事件。您可使用 RunApp Property 編輯器透過點擊兩下該動作來配置此屬性。
ActionValue	指定的 ActionType 所需的值。透過將變數封裝在{括號}中，此屬性將支援變數。 RunExe：Windows 可執行檔案的名稱或路徑。檔案路徑中必須包含雙反斜線 (\\)。例如 C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}。 OpenURL：必須是完整網域名稱和 URL。支援查詢字串參數。例如 http://www.example.com/file.asp?ANI={ANI}。您還可以自訂 MAX 介面中彈出顯示的標籤標題，只需將 icAgentPanelTitle= 參數附加至 URL 即可。 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	若 OnTimeout為 Action Type，將觸發 ShowCustomForm 分支的秒數。

結果分支條件

結果分支條件允許您在指令碼中建立分支，以處理執行動作時的不同結果。

條件	描述
Default	指令碼未能滿足需要它採用其中一個分支的條件時採用的路徑。如果沒有定義動作的其他分支，也會採用該路徑。
Submit	WaitForSubmit 設定為 True 時採用的路徑。
Timeout	在指定的秒數內沒有回應時採用的路徑。
OnError	動作未能正確執行時採用的路徑。例如，當出現連接不良、語法錯誤等意外問題時。_ERR變數（帶有一個下畫線字元）應填入針對問題的簡要說明。

Runapp Wizard

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

點擊兩下 Runapp 動作，打開 RunApp Property Editor 精靈。
檢視圖像
輸入客服專員的客服專員 ID 以接收 Runapp 動作。對於呼出指令碼，使用 {__agentID} 作為變數名稱，對於所有其他指令碼，則使用 {AGENTID}。

選擇動作類型。

欄位	描述
Run an executable program	執行本機可執行檔案。此選項使用了僅適用於 Internet Explorer 的 Java 外掛程式，而 CXone 不支援該瀏覽器。這需要一個駐留在 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 程式碼以產生表單。不需要包含開始和結束的 <form> 標記。點擊 Preview 查看表單。

點擊 OK。