SNIPPET

允許您在您的指令碼中新增自訂代碼。

Dependencies

此動作中的代碼必須用 Snippet 編寫，該語言是由 NICE CXone 開發的內部指令碼設計語言。Studio 技術參考指南提供了有關 snippet 指令碼的詳細資訊。
動態資料物件的屬性不能被命名為__type （包含兩個底線字元）。該詞保留以用於解析來自動態物件的 JSON。
您可以使用 Snippet 動作進行 API 調用。最大回應大小為 32KB。這與 REST API 動作中的回應大小限制一致。嚴格執行該限制，以防止叢集不穩定和服務中斷。如果可以，請使用REST APIaction代替。此動作具有相同的限制，但可以處理更大的負載。如果必須使用 SNIPPET動作，請按照以下提示減少傳回資料的大小：
- 篩選 API 回應中的資料。例如，如果您使用NICE報告 API 獲取聯絡人，您可以根據聯絡人的 startDate 和 endDate 篩選結果。此 API 調用還允許您返回和限制項目的最高計數。請參閱指令碼整合附帶的 API 文件，以確定可以使用哪些篩選功能。
- 更新 API 請求，只返回您需要的資料。例如，如果您使用 NICE報告 API 獲取聯絡人資訊，您可以使用 contactId或 agentId 欄位只返回相關資料。請參閱指令碼整合附帶的 API 文件，以確定可以使用哪些資料限制。
- 如果無法執行前述任一選項，請構建中介軟體。


一般	電郵	聊天	電話	語音郵件	工作項目	SMS	數位

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

屬性	描述
Caption	輸入在指令碼中唯一標識此操作的短語。標題出現在指令碼畫布上的動作圖示下。The default is the action name.
Data	包含在 Snippet Editor 中新增的自訂代碼。這可能包括多個 ASSIGN和 DYNAMIC 命令、各種流程控制語句以及內置和使用者定義的函數。
MaxStringSize	設定 Data 屬性中所有命令的最大字串大小。選項包括：Limit2K、Limit4K、Limit8K、Limit16K、Limit32K。此限制適用於與 Rest API 和 SOAP 的整合回應。

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

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

在 Snippet動作中使用 asjson() 函數，並將產生的 JSON 儲存在字串變數中。當您需要傳遞 JSON 資料時，在其他Studio動作的屬性中使用該字串變數。這種方法避免了在儲存指令碼時出現驗證錯誤的可能性。
如果您正在調整支援 ASR 允許聯絡人透過說話、點擊手機按鍵或兩者組合的方式來回應錄音的語音提示。的 IVR 自動電話選單，允許呼叫者透過語音命令或按鍵輸入或二者進行互動，以獲取資訊、路由至呼入語音通話或二者兼有。系統，有一組參數可以在 snippets 中使用。
Snippet 語言提供了關鍵字命令，允許您聲明變數和物件，建立迴圈和反覆運算語句，等等。
Studio 包含您可以在指令碼中使用的內建函數。
您可以建立自己的自訂函數，在 snippet 中使用。
您可以在 Snippet Editor 視窗中測試和除錯 snippet 代碼。

The Snippet Editor window opens when you double-click on a Snippet action.

Snippet動作中的Snippet Editor視窗有兩個標籤。這兩個標籤都允許您建立相同類型的代碼。您可以在兩個標籤之間來回切換，並在任一位置編輯代碼。這些標籤是：

此範例不是一個完整的指令碼。使用此動作時需要額外的指令碼編寫工作。

In this simple example, the code in the Snippet is used to test whether a prospect can be created using information from a third-party system.

A script with two SNIPPET actions.