Indicate

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

使用自訂功能擴展客服專員介面，尤其是客服專員點擊以啟動自訂功能的圖示。客服專員介面上的這些圖示可用於執行指令碼或向指令碼發出訊號、開啟 URL 或構建基於 Web 的基本表單以及處理其資料。

點擊兩下此動作，開啟配置精靈。

相依性

指令碼中的指示器也必須關閉，否則在聯絡結束後它將繼續顯示在客服專員介面。通常使用 2 個 Indicate 動作，其中一個開啟按鈕，另一個關閉按鈕。
由於 Indicate 動作高度靈活，因此務必要非常仔細地編寫指令碼並進行全面測試。
確保與 ImageFile 屬性一起使用的連結是有效的。中斷連結會給您的CXone伺服器帶來嚴重的性能問題。
MAX 基於 ActionType 為所有指標使用一組預先定義的圖像。使用 MAX 指定帶有 ImageFile 屬性的圖像，這不會變更客服專員看到的圖像。

支援的指令碼類型


通用	電郵	聊天	電話	語音郵件	工作項目	SMS	數位

類似動作比較

以下動作有類似的功能，但有一些關鍵區別：

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。 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}。您還可以自訂 MAX 介面中彈出顯示的標籤標題，只需將 icAgentPanelTitle= 參數附加至 URL 即可。 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 檔案中包含一個產生的指令碼的例子。

下載此指令碼。