呼び出されたプログラムの選択画面入力 

実行可能プログラムを開始すると、通常、プログラムに接続された論理データベースおよびプログラム自身の選択基準とパラメータが含まれている標準選択画面が表示されます ( 直接実行 - レポートを参照してください) 。SUBMIT を使用して実行可能プログラムを開始した場合は、選択画面の入力項目に入力するためのさまざまなオプションを使用することができます。

SUBMIT...[VIA SELECTION-SCREEN]
      [USING SELECTION-SET <var>]
      [WITH <sel> <criterion>]
      [WITH FREE SELECTIONS <freesel>]
      [WITH SELECTION-TABLE <rspar>].

これらのオプションには、以下の効果があります

ｷ        VIA SELECTION-SCREEN

呼び出される実行可能プログラム ( レポート) の選択画面が表示されます。他の 1 つ以上のオプションを使用して値をプログラムに転送すると、選択画面の対応する入力項目が埋められます。ユーザはこの値を変更できます。デフォルトでは、SUBMIT の後、選択画面は表示されません。

ｷ        USING SELECTION-SET <var>

このオプションでは、バリアント <var> で呼び出したプログラムを開始するようシステムに通知します。

ｷ        WITH <sel> <criterion>

このオプションを使用して、選択画面の個別エレメント <sel> ( 選択テーブルおよびパラメータ) に入力します。エレメント<criterion> の1 つを使用してください。

–         <op> <f> [SIGN <s>] 、指定値のみを選択する

<sel> が選択基準の場合は、呼び出されたプログラムの 選択テーブル <sel> の OPTION 項目の入力に <op> を、LOW 項目の入力に <f> を、SIGN 項目の入力に <s> を使用します。

<sel> がパラメータの場合は、<op> にはどの演算子も使用できます。パラメータ<sel> には必ず <f> を入力します。

–         [NOT] BETWEEN <f₁> AND <f₂> [SIGN <s> ] 、範囲を選択する

呼び出されたプログラム の選択テーブル <sel> の LOW 項目に <f₁> を 、HIGH 項目に <f₂> を、SIGN 項目に <s> を転送します。NOT オプションを省略すると、値 B Ｔ が OPTION 項目に書き込まれます。NOT オプションを使用すると、NB が OPTION 項目に書き込まれます。

–         IN <seltab> 、選択テーブルを転送する

呼び出された実行可能プログラムの選択テーブル <sel> に呼出元プログラムのテーブル <seltab> の値を入力します。テーブル<seltab> は、選択テーブルの構造を持つ必要があります。RANGES 命令を使用して、テーブルを登録してください。

ｷ        WITH FREE SELECTION <freesel> 、動的選択のユーザダイアログ

このオプションを使用するには、呼び出されたプログラムが動的選択をサポートしている論理データベースに接続されていなければなりません。呼出元プログラムでは、汎用モジュールFREE_SELECTIONS_INIT と FREE_SELECTIONS_DIALOG を使用します。これらの汎用モジュールを使用すると、選択画面上で動的選択を入力することができます。これらの汎用モジュールの 1 つのエクスポートパラメータは、RSDS データ型グループの構造RSDS_TEXPR を持っています。このエクスポートパラメータの値を同一構造の内部テーブル<freesel> を使用して、呼び出されたレポートに転送します。

ｷ        WITH SELECTION-TABLE <rspar> 、値の動的転送

ディクショナリ構造 RSPARAMS を持つ内部テーブル <rspar> が必要です。このテーブルは次の 6 項目で構成されます。

–         SELNAME ( 型 C 、項目長 8) 、選択基準またはパラメータの名称

–         KIND ( 型 C 、項目長 1) 、選択タイプ (S は選択基準、P はパラメータ)

–         SIGN 、OPTION 、LOW 、HIGH 、通常の選択テーブルと同様 (LOW および HIGH が型 C 、項目長 45 の場合を除く)

このテーブルには、呼び出されたプログラムの選択画面に必要なすべての値を呼出元プログラムで動的に入力することが可能です。選択基準の名称が複数回表示されると、呼び出されたプログラムでその選択基準に対して複数行の選択テーブルが登録されます。パラメータの名称が複数回表示されると、最後の値だけが使用されます。LOW と HIGH のデータ型は C であるため、呼び出されたプログラムの選択基準へのデータ型変換が実行されます。これは、たとえばデータ項目にとって重要です。本稼動でプログラムを使用する前に、VIA SELECTION-SCREEN オプションを使用してプログラムをチェックしてください。

WITH SELECTION-TABLE 以外では、上記オプションは何度でも使用でき、また SUBMIT 命令におけるどのような組合せでも使用できます。特に WITH <sel> オプションは、1 つの基準 <sel> に対して複数回使用することができます。呼び出されたプログラムでは、対応する行が使用される選択テーブルにアペンドされます。パラメータには、指定された最後の値が使用されます。WITH SELECTION-TABLE オプションで使用できる組合せは、USING-SELECTION-SET だけです。

選択画面の入力項目が SPA/GPA パラメータとリンクされている場合、SPA/GPA を使用して選択画面に値を受け渡すこともできます ( プログラム間のデータ受け渡しを参照してください) 。

次の実行可能プログラム ( レポート) では、パラメータ PARAMET と選択基準 SELECTO のある選択画面が登録されます。

REPORT  demo_program_submit_rep1.

DATA number TYPE i.
PARAMETERS      paramet(14) TYPE c.
SELECT-OPTIONS  selecto FOR number.

プログラム DEMO_PROGRAM_SUBMIT_REP1 は次のプログラムから、異なるパラメータを使用して呼び出されます。

REPORT demo_program_submit_sel_screen NO STANDARD PAGE HEADING.

DATA: int TYPE i,
      rspar TYPE TABLE OF rsparams,
      wa_rspar LIKE LINE OF rspar.

RANGES seltab FOR int.

WRITE: 'Select a Selection!',
     / '--------------------'.
SKIP.

FORMAT HOTSPOT COLOR 5 INVERSE ON.
WRITE: 'Selection 1',
     / 'Selection 2'.

AT LINE-SELECTION.
   CASE sy-lilli.
     WHEN 4.
      seltab-sign = 'I'. seltab-option = 'BT'.
       seltab-low  = 1.   seltab-high   = 5.
      APPEND seltab.
       SUBMIT demo_program_submit_rep1 VIA SELECTION-SCREEN
                      WITH paramet eq 'Selection 1'
                      WITH selecto IN seltab
                      WITH selecto ne 3
                      AND RETURN.
     WHEN 5.
      wa_rspar-selname = 'SELECTO'. wa_rspar-kind = 'S'.
       wa_rspar-sign = 'E'. wa_rspar-option = 'BT'.
       wa_rspar-low  = 14.  wa_rspar-high = 17.
      APPEND wa_rspar TO rspar.
       wa_rspar-selname = 'PARAMET'. wa_rspar-kind = 'P'.
       wa_rspar-low  = 'Selection 2'.
       APPEND wa_rspar TO rspar.
       wa_rspar-selname = 'SELECTO'. wa_rspar-kind = 'S'.
       wa_rspar-sign = 'I'. wa_rspar-option = 'GT'.
       wa_rspar-low  = 10.
      APPEND wa_rspar TO rspar.
       SUBMIT demo_program_submit_rep1 VIA SELECTION-SCREEN
                      WITH SELECTION-TABLE rspar
                      AND RETURN.
   ENDCASE.

プログラムを開始すると、次の基本一覧が表示されます。

最初のホットスポットをクリックすると、SAPMZTS1 の選択画面が次のように表示されます。

2 番目のホットスポットを 1 回クリックすると、SAPMZTS1 の選択画面は次のようになります。

DEMO_PROGRAM_SUBMIT_REP1 のいずれの呼出の場合も、2 行の選択テーブル SELECTO となる値が転送されます。2 番目の行は、それぞれのダイアログボックス SELECTO の複数選択 に表示されます。SUBMIT 命令の VIA SELECTION-SCREEN オプションがない場合は、それに応じて PARAMET および SELECTO が DEMO_PROGRAM_SUBMIT_REP1 に書き込まれますが、これらは表示されません。