Getvalue

Putvalueアクションを使用して以前に保存された値を取得します。

サポートされているスクリプトタイプ

一般	Eメール	チャット	電話	ボイスメール	ワークアイテム	SMS	デジタル

関連するアクション

このアクションは、他のスクリプトがデータにアクセスできるようにするために、データベーステーブルからのデータを格納および取得します。フィールドまたは値のリストのように動作します。複数の値、または他のスクリプトでさらに必要な値を格納するためにそれらを使用します。このアクションを含むアクションの完全なリストは以下のとおりです。Putvalue、Getvalue、Remvalue、Getlist、およびClearlistです。

これらのアクションは、この一連のStudioアクションを使用してのみアクセスできる、一意のデータタイプを使用します。他の方法でデータにアクセスすることはできません。ユーザーは、アクセス許可に関係なく、このデータベースにアクセスして使用することはできません。

値は、Putvalue アクションのTTL hrsプロパティで構成されたとおりに、制限時間の間、データベーステーブルにリストされます。デフォルトは24時間ですが、1時間から168時間（7日間）までの範囲に変更できます。Remvalueアクションを使用すると、TTL時間の前にデータを削除できます。これにより、スクリプト内のデータを完全に制御できます。

メモ：

• 他のスクリプトやコンタクトがいくつかの変数にアクセスする必要がある場合、通常はデータベースが最良のソリューションとなります。
• 非永続的なパブリック変数は、それらの変数を設定するスクリプトの存続期間を通じて、他のスクリプトやコンタクトによって共有される可能性があります。変数は、解放されると自動的にクリーンアップされます。

入力プロパティ

これらのプロパティは、アクションが実行時に使用するデータを定義します。

プロパティ	説明
キャプション を追加	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。アクションアイコンにカーソルを合わせるとキャプションが表示されます。
Scope	このアクションが処理する値を他の連絡先が閲覧できるレベルを選択します。同じスコープを共有する連絡先のみが同じデータにアクセスできます。オプションは次のとおりです。 事業単位 CXone環境におけるテクニカルサポート、請求、およびグローバル設定を管理するために使用される上位レベルの組織グループ （テナント） キャンペーン レポートを作成するために使用されるスキルのグループ。 スキル エージェントのスキル、能力、知識に基づいてインタラクションの配信を自動化するために使用されます ポイントオブコンタクト(PoC) 電話番号やEメールアドレスなど、インバウンドコンタクトがインタラクションを開始するために使用するエントリーポイント。 選択するScopeは、スクリプトに含める他のすべてのリストアクションに設定されているScopeと一致する必要があります。リストアクションは以下のとおりです。Putvalue、Getvalue、Remvalue、Getlist、およびClearlistです。リストのNameが同じであっても、Scope設定が一致しない場合は認識されません。
Name	値を識別するために使用されます。これは、任意の名前または番号にすることができます。名前は大文字と小文字が区別されません。Getvalueを使って値を取得する場合、Nameは同じでなければなりません。Nameプロパティが一致しない場合、Scopeの設定が同じであっても、お互いを認識することはできません。
Variable	取得された値を保持したい変数の名前。
Default Value	一致するマッピングがない記録に提供する値。200文字を超えることはできません。
Remove	True（デフォルト）の場合、値は取得後にScopeプロパティから削除されます。Falseの場合、同じ値に繰り返しアクセスできます。

結果ブランチ条件

結果の分岐条件を使用すると、アクションが実行されたときにさまざまな結果を処理できるように、スクリプトにブランチを作成できます。

条件	説明
Default	スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。他のブランチが定義されていない場合にも使用されます。
NoData	指定されたプロパティに値がない場合に取られるパス。

ヒントとコツ

• リストには、指定された名前に基づいて複数のアイテムが一時的に格納されます。リストからすべての項目を取得するには、Getvalueを繰り返し呼び出すか、Getlistを1回呼び出します。
• Getvalueを使用して複数の値を取得する場合は、RemoveプロパティをTrueに設定します。最後の値が取得されると、後続の呼び出しでデータなしNo Dataブランチ条件がトリガーされます。
• GetvalueアクションとPutvalueアクションの使用例は、会議スクリプトです。このようなスクリプトを作成するには、開始側の会議参加者はPutvalueを使用して会議IDを保存する必要があります。その後の発信者は、Getvalueを使用して会議IDを取得した後、会議に参加できます。