Sqlselect

SQL（Structured Query Language）ステートメントをデータベースサーバーに送信し、単一の結果を返します。

依存関係

• 複数行の結果が必要な場合はSqlcursoractionを使用します。
• クエリは通常、1つ以上のデータ列を返します。 CXoneがデータベースサーバーからスクリプトにデータを返すと、個々の列はそれぞれ同じ名前の変数に格納されます。
• DBプロバイダーへの標準接続、暗号化接続、またはVPN接続が必要かどうかを判断する必要があります。
• SETDB actionを使用して、クエリーを実行するDB Connectorグループを選択します。Setdbがないと、デフォルトのCXoneデータベースが使用されます。 このデータベースは、すべての顧客に提供される表の汎用辞書です。

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

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

入力プロパティ

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

プロパティ	説明
Caption	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。 アクションアイコンにカーソルを合わせるとキャプションが表示されます。 The default is the action name.
SQLQuery	データベースサーバーに送信されるSQLステートメント。 このステートメントは記録を返すことが期待されます。
GlobalVariables	使用されていません。
Publish	変数と値を公開します。 このプロパティは、連絡先に関連付けられたデータベース内のすべてを公開します。 特定のデータを公開する場合は、Assignactionを使用します。
TimeoutSec	アクションがタイムアウトする前に実行を待機する秒数。 値は0から60の間でなければなりません。

結果分岐条件

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

条件	説明
Default	スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。 他のブランチが未定義の場合にも使用されます。
NoRecords	指定されたプロパティに値がない場合に取られるパス。これは、データベースからデータが返されない場合に発生します。
OnError	アクションが正しく実行されなかったときにとられるパス。 これは例えば、接続不良、構文エラーなど予期しない問題が発生した場合などです。 _ERR変数に1つのアンダースコア文字がある場合、問題の簡潔な説明を入力する必要があります。
OnTimeout	指定された秒数の間応答がない場合に取られるパス。

スクリプトの例

この例では、スクリプト内のSQLSELECTアクションで使用できるロジックを示します。 SETDBアクションは、クエリーを実行するデータベースを含むDB Connectorグループを定義します。 SQLSELECTはクエリーまたはストアドプロシージャを送信します。 スクリプトに単一のレコードを返します。 SELECTステートメントで識別されたデータは、個別の変数と値としてスクリプトに返されます。

この例のSNIPPETアクションには、各ブランチを適切に処理するためのロジックが含まれます。 クエリーによって結果が返されない場合、NoRecordsブランチが表示されます。

このスクリプトをダウンロードします。