5.4.3.5. DELETEを用いたユーザ定義（SQL）の作成¶
この章では、DELETE文を利用したユーザ定義の作成方法とその詳細について説明します。
5.4.3.5.1. 本チュートリアルで作成するユーザ定義の概要¶
本チュートリアルでは、
「IM-共通マスタ上のユーザのうち、タスクの入力値として指定されたユーザコードを持つユーザを削除する」
というタスクの処理の実装を通して、DELETE文を用いたユーザ定義の作成方法とその詳細を説明します。
作成するユーザ定義の処理イメージは以下の通りです。
図：処理イメージ
なお本チュートリアルでは、処理内容の簡略化のため期間情報や多言語情報を加味しません。
5.4.3.5.2. データベース種別とクエリ種別¶
はじめに、今回作成するユーザ定義（SQL）が対象とするデータベース種別、および、クエリ種別を設定します。
本チュートリアルでは以下の値を設定します。
- データ種別 - 「TENANT」
- クエリ種別 - 「DELETE」
5.4.3.5.3. 入力値/出力値¶
次に、作成するユーザ定義を呼び出す際の入力値と、呼び出しが完了した際に返却する出力値を定義します。
ユーザ定義（SQL）の作成において入力値/出力値は、クエリ種別を選択したタイミングで自動的に初期値が設定されます。
クエリ種別「DELETE」設定時の入力値/出力値の初期値は以下の通りです。
図：クエリ種別「DELETE」選択時の入力値/出力値の初期値
ここで留意すべき点は、出力値がシステムによって固定であることです。
IM-LogicDesignerではクエリ種別を元に出力値を自動で決定します。
クエリ種別「DELETE」選択時に設定される出力値の詳細は以下の通りです。
出力値 説明 count<integer> 処理総数が格納されます。 query<string> 実行されたクエリが格納されます。
なお出力値とは違い、入力値は開発者が決定する必要があります。
本チュートリアルでは、入力値として「削除対象ユーザのユーザコード」を以下のように定義します。
入力値 説明 delete_user_cd<string> 削除対象ユーザのユーザコードを格納します。
5.4.3.5.4. クエリ設定¶
次に、実際に削除処理を行うクエリ（DELETE文）の設定を行います。
5.4.3.5.4.1. 想定するDELETE文¶
本チュートリアルで想定する処理は、以下のSQLによって表現されます。
DELETE FROM imm_user
WHERE
user_cd = /*delete_user_cd*/'tutorial'
5.4.3.5.5. ユーザ定義（SQL）を作成する。¶
最後に、これまでの内容を踏まえてユーザ定義（SQL）を作成します。
「SQL定義編集」画面を表示します。
ユーザ定義の基本情報となる各項目に以下の値を入力します。
ユーザ定義ID「tutorial_ud_sql_delete」
バージョン「1」（固定）
- ユーザ定義名
- 標準 - 「ユーザ定義[SQL-DELETE]」
- 日本語、英語、中国語（中華人民共和国） - 入力なし
- カテゴリ
- カテゴリID - 「tutorial_user_category」
ソート番号「1004」
図：基礎情報の定義
データベース種別とクエリ種別を「データベース種別とクエリ種別」をもとに設定します。
図：データベース種別、および、クエリ種別の定義
入力値を「入力値/出力値」をもとに値を設定します。
図：入力値の定義
クエリに「想定するDELETE文」で提示したSQLを設定します。
図：クエリの定義
「登録」をクリックします。
図：登録
以上で、DELETEを用いたユーザ定義（SQL）の作成が完了しました。