Getvalue

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

檢索先前使用 Putvalue 動作儲存的值。

支援的指令碼類型

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

通用

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

相關動作

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

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

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

注釋:

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

輸入屬性

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

屬性

描述

新增 標題

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

Scope

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

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

Name 用於識別值。這可以是任何名稱或數字。名稱不區分大小寫。使用 Getvalue 擷取值時,Name 必須相同。若 Name 屬性不相符,則其將無法相互識別,即使 Scope 設定相同。
Variable 您想保留的變數名稱檢索的數值。
Default Value 您將提供予沒有配對之任何記錄的值。不能超過 200 個字元。
Remove True(預設值)用於在檢索到該值後將其從Scope屬性中移除。False允許重複存取相同的值。

結果分支條件

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

條件

描述

Default

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

NoData

沒有指定屬性的值時採用的路徑。

貼士與技巧

  • 清單根據既定的名稱臨時儲存多個項目。要從清單檢索所有項目,請使用適用於 Getvalue 的重複來電或適用於 Getlist 的單個來電。
  • 使用 Getvalue 檢索多個值時,請將 Remove 屬性設定為 True。一旦已檢索了最後一個值,後續來電將觸發 No Data 分支條件。
  • 使用 GetvaluePutvalue 動作的範例是會議指令碼。要建立此指令碼,多方通話發起方必須使用 Putvalue 儲存其多方通話 ID。隨後的呼叫者可以使用 Getvalue 檢索多方通話 ID 後加入多方通話。