Putvalue

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

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

Dependencies

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

Supported Script Types

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

一般

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

Related Actions

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

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

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

注釋：

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

Input Properties

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

屬性

描述

標題

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

Scope

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

選擇的Scope必須與指令碼中包含的所有其他清單動作中設定的Scope相符。清單動作是 Putvalue, Getvalue, Remvalue, Getlist, and 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 小時。設定允許限值之外的值將導致動作使用最接近的允許值。

Result Branch Conditions

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

條件

描述

Default

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