Putvalue

このヘルプページはStudio向けです。 この情報は、Desktop Studio用にも提供されています。

他のスクリプトや連絡先からアクセスできるようにするために、CXone Mpowerデータベーステーブルにデータを格納および取得します。 このデータはGETvalueアクションで取得できます。

他のスクリプトやコンタクトがいくつかの変数にアクセスする必要がある場合、通常はデータベースが最良のソリューションとなります。

依存関係

  • Putvalueは一意のデータ型を使用し、これにアクセスするには次の適切なStudioアクションを使用する必要があります：Getvalue、Remvalue、Getlist、およびClearlist。
  • PersistentプロパティがFalseに設定されている場合、特定のコンタクトによって追加されたすべての公開値は、コンタクトがリリースされると自動的に削除されます。 この機能は通常、親スクリプトが生成された子スクリプトを追跡する必要がある場合に使用されます。 各子スクリプトは、「{MasterID}リスト」などのNameプロパティと{ContactID}の値でPutvalueを実行します。 「{MasterID}リスト」は公開されているため、親スクリプトは定期的にGetlistを実行して、現在実行されている子スクリプトの数を検出できます。 Persistent=falseプロパティのおかげで、子スクリプトの公開値は、リリースされると自動的に削除されます。 子スクリプトの正確な数を維持するために追加の作業は必要ありません。
  • 非永続的なパブリック変数は、それらの変数を設定するスクリプトの存続期間を通じて、他のスクリプト/連絡先と共有できます。 変数は、解放されると自動的にクリーンアップされます。
  • Persistent変数は、Getvalue（削除プロパティはtrueに設定）、Remvalue、またはClearlistを実行して手動で削除する必要があります。 大量のデータや長期間必要なデータにPutvalueを使用することはお勧めしません。 データを保存する必要がある場合、DB Connectorを使用して、お使いのデータベースに接続することをお勧めします。

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

その四角から分岐した線が、他の3つにつながっている四角。

一般

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

関連するアクション

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

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

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

メモ：

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

入力プロパティ

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

プロパティ

説明

Add Caption

スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。 アクションアイコンにカーソルを合わせるとキャプションが表示されます。

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が切れてから最大で1時間ほどです。 これは、TTLをチェックするプロセスが、1時間に1回、1時間の開始時に実行されるためです。 たとえば、TTLの有効期限が10:03の場合、TTLの有効期限をチェックするプロセスは11:00まで実行されません。つまり、データは11:00まで存在し続けることになります。

このプロパティの最小値は1時間で、最大値は168時間（7日間）です。 デフォルトは24時間です。 許容限度を超えた値を設定すると、アクションは最も近い許容値を使用します。

結果分岐条件

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

条件

説明

Default

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