!--a11y-->
プログラム属性に論理データベース名を入力することにより実行可能プログラムを論理データベースにリンクすると、論理データベースプログラムのサブルーチンと実行可能プログラムのイベントブロックによって、データの読込と処理を行うモジュールプログラムが形成されます。個々の処理ブロックは、実行時環境によって事前定義された順序で呼び出されます。実行時の動作は、論理データベースの構造、選択および PUT 命令、ならびに実行可能プログラムの GET 命令により制御されます。

実行時環境の呼出は、論理データベースの構造と実行可能プログラムの定義の両方に依存します。論理データベースの構造によって、論理データベースの処理ブロックが呼び出される順序が決定されます。これにより、実行可能プログラム内で GET イベントブロックが呼び出されます。この GET イベントブロックによって、論理データベースの読込の深さが決定されます。実行可能プログラムの宣言部にある TABLES または NODES の命令により、論理データベースに定義された入力項目の中から選択画面に組み込まれる項目が決まります。論理データベースと実行可能プログラムの間のデータの受け渡しに使用するインタフェース作業領域も定義されます。
データベースへの実際のアクセスには、PUT_TABLE サブルーチンの中のOpen SQL 命令を使用します。読み込まれたデータは、インタフェース作業領域 (TABLES 命令を使用して定義されます) を使用して、実行可能プログラムに渡されます。論理データベースプログラム内にデータが読み込まれると、GET イベントブロック内のデータを実行可能プログラムが処理できるようになります。このテクニックによって、データの読込と処理が分割されます。
実行可能プログラムの属性に論理データベースを指定すると、これがプログラムの標準選択画面に反映されます。論理データベースの選択項目とプログラム自身の選択項目の両方が含まれています。関連ノードのインタフェース作業領域を宣言することにより、どの論理データベース選択がプログラムに関連しており、画面に表示する必要があるかを指定することができます。
次の一覧には、(前述の) ABAP 実行時環境が論理データベースのサブルーチンを呼び出す順序と、実行可能プログラムのイベントブロックを示します。実行時環境は、実行時環境で一連のプロセッサ (選択画面プロセッサ、レポートプロセッサ) を実行します。次に一覧表示した ABAP コードでは、個々のステップに属する処理ブロックを示します。
...
1. 選択画面が処理される前の初期化。
サブルーチン:
FORM init
このサブルーチンは、選択画面が最初に表示される前に 1 回だけ呼び出されます。
イベントブロック:
INITIALIZATION.
このイベントは、選択画面が最初に表示される前に 1 回だけ発生します。
2. 選択画面が表示される各セッションの前の選択画面初期化のPBO (たとえば、キー項目のデフォルト値の設定)。
サブルーチン:
FORM pbo.
このサブルーチンは、選択画面が送信されるたびに呼び出されます (表示される前)。
イベントブロック:
AT SELECTION-SCREEN OUTPUT.
このイベントは、選択画面が送信されるたびに呼び出されます (表示される前)。
3. 選択画面がプレゼンテーションサーバで表示され、ユーザは入力項目にデータを入力できるようになります。
4. 入力ヘルプ(F4) または項目ヘルプ(F1) に対して可能な要求。
サブルーチン:
FORM par_VAL.
FORM selop_VAL.
FORM selop-LOW_VAL.
FORM selop-HIGH_VAL.
ユーザがデータベース固有のパラメータ par または選択基準 selop の入力可能値の一覧を要求すると、これらのサブルーチンが必要に応じて呼び出されます。
ユーザがこれらのパラメータの項目ヘルプを要求すると、末尾が _VAL ではなく_HLP のサブルーチンが呼び出されます。
イベントブロック:
AT
SELECTION-SCREEN
ONVALUE-REQUEST FOR par.
AT SELECTION-SCREEN
ONVALUE-REQUEST FOR selop-LOW.
AT SELECTION-SCREEN
ONVALUE-REQUEST FOR selop-HIGH.
ユーザがデータベース固有のパラメータ par または選択基準 selop の入力可能値の一覧を要求すると、これらのイベントが必要に応じて開始されます。
ユーザがこれらのパラメータの項目ヘルプを要求すると、オプション ON VALUE-REQUEST ではなく ON HELP-REQUEST が指定されたイベントが発生します。
5. 選択画面のPAI。ユーザが正しく、完全で妥当性のあるデータを入力したかをチェックします。また権限チェックも含まれています。エラーが発生すると、ユーザダイアログをプログラムして、関連項目を再び入力可能にすることができます。
サブルーチン:
FORM pai USING fname mark.
インタフェースパラメータ FNAME と MARK は、実行時環境により渡されます。
FNAME には、選択画面の選択基準またはパラメータの名称が含まれています。
MARK = space の場合、ユーザは単一値か範囲選択のどちらかを入力しています。
MARK = '*' の場合、ユーザは複数選択画面でも選択を入力しています。
FNAME = '*' と MARK = 'ANY' を組合せて使用すると、ユーザが機能を選択した際に、一度に全エントリをチェックすることができます。
イベントブロック:
AT SELECTION-SCREEN ON fname.
特定の入力項目を処理するイベント。
AT SELECTION-SCREEN ON END OF fname.
複数選択を処理するイベント。
AT SELECTION-SCREEN.
全ユーザ入力を処理するイベント。
6. データを読み込む前の処理。
サブルーチン:
BEFORE EVENT 'START-OF-SELECTION'.
論理データベースは、たとえば内部テーブルの初期化などデータを読み込む前の必要なアクションのため、このサブルーチンを使用することができます。
イベントブロック:
START-OF-SELECTION.
選択画面が処理された後の、実行可能プログラムの最初のイベント。このイベントブロックを使用してデータ処理のプログラムを準備することができます。
7. 論理データベースでのデータ読込と実行可能プログラムでの処理。
サブルーチン:
FORM PUT_node.
論理データベースによって、ノード node の選択されたデータが読み込まれます。
イベントブロック:
GET table [LATE].
このイベントは、前のサブルーチンの PUT 命令によってトリガされます。このイベントブロックでは、対応するインタフェース作業領域での node のデータ読込の処理が可能になります。
8. データ読込後の処理。
サブルーチン:
AFTER EVENT 'END-OF-SELECTION'.
論理データベースでは、たとえばメモリ領域の解放などデータ読込後の必要なアクションのために、このサブルーチンを使用することができます。
イベントブロック:
END-OF-SELECTION.
最後のレポートイベント。このイベントブロックを使用して、ソートなど、作成した一時データセットを処理することができます。
9. 前のステップの間に一覧が生成された場合、実行時環境の一覧プロセッサはプログラムを制御して一覧を表示します。

TABLE1 はルートノードで、TABLE2 は論理データベースの中で唯一の下位ノードとします。この場合、データを読み込んで処理する処理ステップは、次の階層順序になります。
START-OF-SELECTION.
FORM put_table1.
GET table1.
FORM put_table2.
GET table2.
GET table1 LATE.
END-OF-SELECTION.
データベースプログラムまたは実行可能プログラムのイベントブロックの中で、次のサブルーチンで AUTHORITY-CHECK 命令を使用して権限チェックを使用すると有用です。
● データベースプログラムのサブルーチン:
○ PAI
○ AUTHORITY_CHECK_table
● 実行可能プログラムのイベントブロック:
○ AT SELECTION-SCREEN
○ AT SELECTION-SCREEN ON fname
○ AT SELECTION-SCREEN ON END OF fname
○ GET table
データベースプログラムまたは実行可能プログラムのどちらに権限チェックを置くかは、次の条件に依存します。
● 論理データベースの構造
たとえば、実際に実行時に会社コードを含む行を読み込む場合、会社コードの権限チェックだけを行う必要があります。
● パフォーマンス
チェックの繰り返しを回避します (たとえば SELECT ループ内のチェック)。
データベースアクセスとアプリケーションロジックを分離すると、権限チェックのすべてを論理データベースプログラムで一括してプログラムすることができます。この結果、大規模プログラミングシステムの保守が容易になります。