【近日追加予定】タプル

タプルは異なる種類の複数の値をまとめて送信する場合に設定するパラメーターの種類です。

タプルのパラメーターには以下の項目を設定できます。

• フォーマット形式
• タプルの要素
• 初期値

タプルの要素

タプルの要素には以下の項目を設定できます。

• ラベル
• 要素の種類

ラベル

アクションの実行フォームに表示されるラベルを設定できます。

要素の種類

要素の種類は以下から選択できます。

• 文字列
• 数値
• 日付
• 真偽値

さらに要素の種類ごとに入力必須かどうかや正規表現による入力値チェックなどを設定できます。

要素の種類ごとに設定できる項目は、各種パラメーターのドキュメントをご参照ください。

フォーマット形式

タプルを送信する際のフォーマット形式を以下から選択できます。

• フォーマットなし
• JSON
• 区切り文字

フォーマットなし

タプルの形式のまま送信されます。

フォーマットなし は以下のデータソースでのみ利用できます。

• MySQL
• PostgreSQL
• JavaScript

例）MySQL の WHERE 句で利用する場合

1. アクションの追加画面または編集画面から処理の設定画面に移動します。
2. データソースの選択からMySQLのデータソースを選択します。
3. パラメーターを追加し入力値の種類をタプル、フォーマット形式をフォーマットなしに設定し、任意の要素の種類を設定します。
4. SQL文を入力しWHERE句で{{ パラメーター名 }}の形式でタプルのパラメーターを利用します。

5. アクションを保存します。
6. アクションの実行画面でタプルのパラメーターに値を入力して実行すると、入力した値がWHERE句に展開されてSQLが実行されます。

JSON

配列をJSON形式に変換した文字列が送信されます。

（例）要素の種類が文字列、数値、日付（unixtimeとして利用する）、日付（unixtimeとして利用しない）、真偽値（有効は設定した真の値）の場合に送信される文字列の場合。

["a",1,"1672498800","2023-01-01","有効"]

区切り文字

• 区切り文字
• 引用符

を設定でき、設定内容に基づいてタプルを変換した文字列が送信されます。

（例）要素の種類が文字列、数値、日付（unixtimeとして利用する）、日付（unixtimeとして利用しない）、真偽値（有効は設定した真の値）で、引用符に "、区切り文字に , を設定した場合にの場合に送信される文字列の場合。

"a","1","1672498800","2023-01-01","有効"