Sqltable

SQL（Structured Query Language）ステートメントをデータベースサーバーに送信し、複数行の結果を返します。 このアクションは、（UTCタイムゾーンではなく）アカウントに関連付けられたバックエンドサーバーの場所に基づいて日時を返します。 この日時を別のタイムゾーンに変換するには、Snippetactionを使用できます。

依存関係

• SETDB actionを使用して、クエリーを実行するDB Connectorグループを選択します。Setdbがないと、デフォルトのCXoneデータベースが使用されます。 このデータベースは、すべての顧客に提供される表の汎用辞書です。

• このアクションは、すべての行を配列として返します。
• 複数の行が予想される場合は、actionと同じ目的でSqltableを使用します。 Sqlselectアクションと同様に、列の値は列名と同じ名前の変数に格納されます。 ただし、このアクションでは、各列変数に複数のレコードが格納される場合があります。 各記録は、RowSeparatorプロパティで定義された文字で区切られます。 デフォルトのパイプ記号（|）を使用すると、各列を配列として参照できます。
• SQLデータベースは、データを明示的にソートしない場合、いかなる種類の順序も保証しません。
• 大量のデータを選択しないように注意してください。 これにより、最終的にスクリプトが失敗します。 大きなテーブルへの順次アクセスが必要な場合は、Sqlcursoractionを参照してください。

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

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

プロパティ

プロパティ	説明
Caption	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。 アクションアイコンにカーソルを合わせるとキャプションが表示されます。 The default is the action name.
SQLQuery	データベースサーバーに送信されるSQLステートメント。 このステートメントは記録を返す必要があります。
RowSeparator	個々の記録を区切るために使用される区切り文字。
FieldCountVar	SQLクエリーによって返されるフィールドの数を返す変数の名前。
RowCountVar	SQLクエリーによって返された行数を返す変数の名前。 作成された行数変数は、シーケンスを繰り返す回数を決定するLoopactionで非常に役立ちます。
GlobalVariables	使用されていません。
Publish	変数と値を公開し、データベース内のすべてを連絡先に関連付けます。 特定のデータを公開する場合は、Assignactionを使用します。
MaxRows	取得する行の最大数。 デフォルトは100です。
TimeoutSec	クエリがタイムアウトするまでの秒数。 デフォルトは10です。 サポートされる最大秒数は30です（実際には、より大きな数値をフィールドに入力できます）。

分岐

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