Putvalue

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

將資料儲存在 NICE CXone 資料庫表格中,以便其他指令碼和聯絡人可以存取它。這些資料可透過 GETvalue 動作檢索。

如果有幾個變數需要由其他指令碼或聯絡人存取,則資料庫通常是最好的解決方案。

相依性

  • Putvalue使用獨特的資料類型,這些資料類型必須使用以下適當的 Studio 動作存取:GetvalueRemvalueGetlistClearlist
  • Persistent 屬性設定為 False 時,一旦聯絡人被釋放,由給定聯絡人新增的所有公用值都會被自動移除。此功能通常用於上層指令碼需要追蹤建置的子指令碼時。每個子指令碼都將使用Name屬性(比如「{MasterID}List」和 {ContactID} 值)執行 Putvalue 動作。由於「{MasterID}List」是公用的,上層指令碼可定期執行 Getlist 來發現目前有多少子指令碼正在運行。憑藉 Persistent=false 屬性,子指令碼的公用值將在釋放時自動移除。無需額外的工作來維持字指令碼的準確數量。
  • 在設定這些變數的指令碼的生命週期中,其他指令碼/聯絡人可以分享非持續性公用變數。這些變數釋放後會自動清除。
  • 必須透過執行 GetvalueRemove 屬性設定為 true)、RemvalueClearlist 來手動刪除 Persistent 變數。不建議對大量資料或您長時間需要的資料使用 Putvalue。如果您需要儲存資料,建議您使用 DB 連接器 並連接到您控制的資料庫。

支援的指令碼類型

一個正方形,其上有一條通往其他三個正方形的分支線。

通用

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

相關動作

此動作是可以在資料庫表格中儲存和擷取資料(以便其他指令碼可以存取這些資料)的多種動作之一;它的行為類似於欄位或值的清單。使用它們來儲存多個值,或在其他指令碼中進一步需要的值。包括此動作在內的完整動作清單如下:PutvalueGetvalueRemvalueGetlistClearlist

這些動作使用一種僅可用這一組 Studio 動作存取的獨特資料類型。這些資料無法藉由任何其他方式存取。無論使用者的權限如何,使用者都無法存取並使用本資料庫。

值將在資料庫表格中列出限定的時間,具體在 Putvalue 動作的 TTL hrs 屬性中配置。預設時間為 24 小時,但可設定範圍為 1 小時到 168 小時(7 天)。在達到 TTL 之前,您可使用 Remvalue 動作刪除資料。這可讓您透過指令碼完全掌控資料。

注釋:

  • 如果有幾個變數需要由其他指令碼或聯絡人存取,則資料庫通常是最好的解決方案。
  • 在設定這些變數的指令碼的生命週期中,其他指令碼或聯絡人可以分享非持續性公用變數。這些變數釋放後會自動清除。

輸入屬性

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

屬性

描述

新增 標題

輸入在指令碼中唯一標識此操作的短語。標題出現在指令碼畫布上的動作圖示下。

Scope

選擇此動作處理的值對其他聯絡人的可見程度。只有共用相同範圍的聯絡人才能存取相同的資料。選項包括:

選擇的Scope必須與指令碼中包含的所有其他清單動作中設定的Scope相符。清單動作是 PutvalueGetvalueRemvalueGetlistClearlist即使清單的Name相同,如果Scope設定不相符,也無法識別。

Name

用於識別值。這可以是任何名稱或數字。名稱不區分大小寫。使用 Getvalue 擷取值時,Name 必須相同。若 Name 屬性不相符,則其將無法相互識別,即使 Scope 設定相同。

Value

將被儲存的值或資料。

Method

當儲存多個具有相同名稱的值時,它們會被放入一個清單。選擇以下其中一種方法:

  • ReplaceAll:此為預設值,將被自動選中。
  • Append:將新值放在清單的末尾。在附加值時,若在 24 小時內附加超過 1000 個值,則將不再附加,直至部分附加值被清除(24 小時後)。
  • Insert:將值放在清單的開頭。對 Getvalue 的後續調用將從清單的開頭檢索資料。
Persistent

如果您希望特定聯絡人儲存的資料在聯絡人被釋放後仍保留,請選擇 True。依預設,當聯絡人被釋放後,資料將被移除 (False)。

TTL (hrs)

將此屬性設定為您希望資料可用的時間(以小時為單位)。當達到 TTL(存留時間)時,將清除資料。清除資料的實際時間可能在 TTL 過期後的一小時內。這是因為檢查 TTL 的進程每小時執行一次,並且在整點開始。例如,如果 TTL 在 10:03 過期,則檢查 TTL 過期的進程直到 11:00 才會執行,這意味著資料將繼續存在到 11:00。

此屬性的最小值為一小時,最大值為 168 小時(7 天)。預設值為 24 小時。設定允許限值之外的值將導致動作使用最接近的允許值。

結果分支條件

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

條件

描述

Default

指令碼未能滿足需要它採用其中一個分支的條件時採用的路徑。如果沒有定義動作的其他分支,也會採用該路徑。