Indicate

此説明頁面適用於 CXone Studio。此資訊也可用於 Desktop Studio。

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

相依性

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

支援的指令碼類型


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

類似動作比較

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

Runapp：從指令碼啟動自訂功能，特別是啟動表單、網頁或應用程式。
PopURL：打開網頁 URL，並為網頁彈出的面板提供位置和樣式選項。
Indicate：使用自訂功能擴展客服專員介面，尤其是客服專員點擊以啟動自訂功能的圖示。這類似於 Runapp，不同之處在於使用 Indicate 時，ActionType 由指令碼而不是客服專員啟動。

輸入屬性

這些屬性定義了動作執行時使用的資料。

此動作的屬性會隨著您的配置動態改變。例如，如果您選擇 Agent 作為 Target，則下一個欄位會從 Contact ID 變為 Agent ID。

屬性	描述
Add Caption	輸入在指令碼中唯一標識此操作的短語。標題出現在指令碼畫布上的動作圖示下。
Target	從下拉式清單中選擇接收者類型：Agents、Team、Skill、Everyone 或 Contact。 Everyone 選項已被棄用。請勿選擇。
Target Id 聯絡人 ID、客服專員 ID、團隊。	目標的 ID，如客服專員 ID 。此屬性的名稱依您選擇的 Target 而有所不同。變數替換通常用於該屬性。
Name	此屬性是用於標識值的名稱或金鑰。這可以是任何名稱或數字。名稱不區分大小寫。若您在使用多個 Indicate 動作，此名稱用來追蹤哪個 Indicate 動作被開啟或關閉。
Image File	在CXone檔案伺服器上，在租戶用於管理 CXone 環境的技術支援、計費和全域設定的高級組織分組目錄下圖像檔案的 URL 這是客服專員將點擊的圖像。檔案必須是 GIF、JPG 或 PNG 格式，大小為 16x16 像素。在 Salesforce Agent 或 Salesforce Agent Lightning 中使用 Indicate 動作時需要此屬性。警告 ImageFile 的中斷連結可能導致相關租戶出現嚴重的性能問題。在使用自訂圖示時，請務必驗證連結是否準確。
Tooltip	當滑鼠游標暫留在指示器圖示或文字上時出現的文字。
State	用於確定是否顯示指示器的On或Off下拉式清單。通常，您需要兩個同名的indicate 動作：一個啟用按鈕，另一個停用按鈕。
Action Type	Run Exe：執行本機可執行檔。此選項使用了僅適用於 Internet Explorer 的 Java 外掛程式，而 CXone 不支援該瀏覽器：不要選擇此選項。 Open URL：開啟一個預設網頁瀏覽器並轉至 URL 欄位中指定的 URL。 Spawn script：建置一個Script Name欄位中指定的指令碼並傳遞參數。 Signal script：傳輸一個 ActionValue 欄位中指定的指令碼訊號並傳遞參數。 Show Custom Form：啟動自訂 HTML 表單。將用於表單的 HTML 代碼貼上到Html屬性中。從自訂表單中擷取的資料觸發指令碼中 ONDATA 事件動作。
URL	指定要開啟的 URL。只有當您選擇 Open URL 或 Run Exe 作為 Action Type 時，此屬性才會出現。對於打開 URL，您必須使用完全合格的網域名稱和 URL。支援查詢字串參數。例如 http://www.example.com/file.asp?ANI={ANI}。您還可以自訂 MAX 介面中彈出顯示的標籤標題，只需將 icAgentPanelTitle= 參數附加至 URL 即可。對於 Run Exe，您必須使用位於 Windows 路徑中或在 URL 欄位中輸入完整路徑的本機可執行檔。檔案路徑中必須包含雙反斜線 (\\)。例如 C:\\Program Files\\CXone\\studio.exe。如今大部分瀏覽器都支援執行可執行程式。如果您要使用此類型，請確保客服專員使用相容的瀏覽器。
Script Name	輸入要產生的指令碼的完整路徑和名稱。路徑必須是從目前指令碼所在的資料夾開始的相對路徑。您必須同時指定 Skill#。這將會傳送到產生的指令碼中。您可以指定要傳入指令碼的任何其他 Parameters。只有當您選擇 Spawn script 作為 Action Type 時，此屬性才會出現。
Skill#	輸入 ACD 技能的編號，以傳入所產生的指令碼。您還必須指定要產生的 Script Name。您可以指定要傳入指令碼的任何其他 Parameters。只有當您選擇 Spawn script 作為 Action Type 時，此屬性才會出現。
Contact ID	輸入要傳送訊號的指令碼 ID。通常來說，這是聯絡人 ID。預設情況下，此屬性將使用 {contactId} 變數。您可以使用 {masterID} 傳輸上層指令碼，或使用類似於 {spawnID} 的參數來傳輸子指令碼。只有當您選擇 Signal script 作為 Action Type 時，此屬性才會出現。
Parameters	指定任何其他參數，以傳送至產生的指令碼或已訊號化的指令碼。新增參數是可選的。只有當您選擇 Spawn script 或 Signal script 作為 Action Type 時，此屬性才會出現。
Html	輸入要啟動的自訂表單的 HTML。您可以使用任何標準的表單輸入欄位，包括Input、Textarea、Password、Checkbox、Radio、Select、Button 和 Submit。但是，請勿包含 <form> 標記。新增欄位時：每個輸入欄位必須包含名稱。沒有名稱的欄位將被忽略。例如，<input type="text" name="phone">。可使用 Ondata 動作將名稱和值作為變數傳回指令碼。如果指令碼缺少 Ondata 動作，則該表單將無用。支援多個值的表單欄位（如 Checkbox 和 Select）將含有一個以逗號分隔的陣列。可使用多個同名或不同名的「提交」按鈕，任何「提交」按鈕都可提交資料並關閉視窗。如果您需要某個按鈕不進行提交，則使用「按鈕」而不要使用「提交」。不支援連結的樣式表，但支援內嵌樣式。例如，<div style="position: absolute; left: 10px; top: 100px;">。當連結至某個外部指令碼時，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)">` 只有當您選擇 Signal script 作為 Action Type 時，此屬性才會出現。

結果分支條件

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

條件	描述
Default	指令碼未能滿足需要它採用其中一個分支的條件時採用的路徑。如果沒有定義動作的其他分支，也會採用該路徑。
錯誤	動作未能正確執行時採用的路徑。例如，當出現連接不良、語法錯誤等意外問題時。 _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 檔案中包含一個產生的指令碼的例子。下面是一個範例，說明如何在指令碼中使用此動作。這不是一個完整的指令碼。可能需要額外的指令碼。

下載此指令碼。