Putvalue

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

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

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

相依性

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

支援的指令碼類型

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

通用

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

相關動作

此動作是可以在資料庫表格中儲存和擷取資料（以便其他指令碼可以存取這些資料）的多種動作之一；它的行為類似於欄位或值的清單。使用它們來儲存多個值，或在其他指令碼中進一步需要的值。包括此動作在內的完整動作清單如下：Putvalue、Getvalue、Remvalue、Getlist和Clearlist。

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

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

注釋：

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

輸入屬性

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

屬性

描述

新增 標題

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

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

選擇的Scope必須與指令碼中包含的所有其他清單動作中設定的Scope相符。清單動作是 Putvalue、Getvalue、Remvalue、Getlist和Clearlist。即使清單的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

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