SAP クエリには、複数のオプションがあります。それによって、クエリで生成されたデータを他のソフトウェア製品への追加処理に渡すことができます。オプションの内容は次のとおりです。

• XXL インタフェースによる表計算プログラム (EXCEL など )

• SAP ビジネスグラフィック

• 経営情報システム (EIS)

• ファイルへのダウンロード

いずれの場合も、手順は同じです。生成されたデータは内部テーブル ( データテーブル ) に配置され、そこでの項目の順序およびタイプはクエリ一覧における順序とタイプに対応しています。もう 1 つの内部テーブル ( 内容説明テーブル ) には、データテーブルの個別項目に関する内容説明が含まれます。テーブルには、一覧のタイプおよび位置だけでなく、項目名に関する情報も含まれます。これらのテーブルはともに、上記のソフトウェアへの追加処理に渡されます。

拡張 SQUE0001 を介した SAP クエリにより、同じインタフェースを使用して他のソフトウェア製品にアクセスすることもできます。 SQUE0001 は、次のコンポーネントで構成されています。

SQUE0001 は、次の 2 つのコンポーネントで構成されます。

• 汎用モジュール EXIT_RSAQEXCE_001

• メニュー拡張 RSAQEXCE+DAT

プロジェクトで拡張を ( トランザクション CMOD を使用して ) 有効化すると、 SAP クエリにより生成された各レポートは、 プライベートファイル ( 機能コード : +DAT) と呼ばれる追加対話機能にリンクされます。この プライベートファイルにより、汎用モジュールが呼び出され、上記のテーブル ( データテーブルと内容説明テーブル ) が渡されます。その後、上記のテーブル ( データテーブルと内容説明テーブル ) は汎用モジュールに渡されます。したがって、選択画面には、他の対話式機能 ( EXCEL 、グラフィック、 EIS 、ファイルへのダウンロード、および保存 ) などの追加パラメータが含まれており、ユーザはあらかじめ一覧を照会しなくてもクエリを実行することができます。選択画面では、このパラメータの名称は プライベートファイルになっているため、メニュー拡張にも同じ名称を付けることをお奨めします。これは SAP 標準に対応しています。

このセクションでは、汎用モジュール EXIT_RSAQEXCE_001 に渡すパラメータと、パラメータの値の解釈方法または処理方法について説明します。次の例は、この処理を示しています。

クライアント 03 では、ユーザグループ RX のユーザにより、一行基本一覧、統計、およびランク一覧で構成されるクエリ X1 が登録されています。基本一覧では、次の項目が順番に出力されます。

項目 KNCI-UM01U については、読込レコード数、パーセント値、および平均値の詳細も必要です。ランク一覧では、次の項目が順番に出力されます。

汎用モジュール EXIT_RSAQEXCE_001 には、次のパラメータがあります。

PROGRAM パラメータには、汎用モジュールを呼び出したクエリレポートの名称が含まれます。この名称により、処理されたクエリを判断することができます。これは名称が必ず次のように構成されているためです。

この例の場合、レポートの名称は AQRX==========X1============ となります。

LIST_ID パラメータには、渡されるデータテーブルを指定する 3 文字の ID が含まれます。クエリによって生成された各一覧は、複数のサブ一覧 ( 基本一覧、複数の統計、および複数のランク一覧 ) で構成されます。汎用モジュールに渡されるデータテーブル ( DATATAB) には、 1 つのサブ一覧のデータのみが含まれるのに対し、内容説明テーブル ( LISTDESC) には、すべてのサブ一覧の項目の内容説明が常に含まれます。

可能なパラメータ値は次のとおりです。

したがって、 LIST_ID パラメータには、 2 つの機能があります。まず、該当するサブ一覧タイプを判断することができます。次に、内容説明テーブルに該当するエントリを定義することができます。

この例では、基本一覧のデータが処理される場合には値 G00 、統計のデータが処理される場合には値 T01 、ランク一覧のデータが処理される場合には値 R01 が LIST_ID パラメータに含まれます。

LISTTEXT パラメータには、クエリの定義時に関連する一覧に割り当てられるテキストが含まれます。

DATATAB テーブルには渡されるサブ一覧のデータが含まれます。この項目の順序およびタイプは、サブ一覧に出力された項目の順序と対応しています。また、テーブルの各行は一覧の行と対応し、基本一覧に存在するすべての改行が無視されます ( つまり、必ず 1 テーブル行となります ) 。

データテーブルの構造は、渡されるサブ一覧の定義方法によって異なるため、その構造をあらかじめ汎用モジュールで定義しておく必要があります。そのために、内容説明テーブル LISTDESC を使用することができます。データテーブルの個別項目にアクセスするには、フィールドシンボルと ASSIGN COMPONENT 命令を使用します。

以下の例の基本一覧を渡す場合、データテーブルの 1 行は 5 つの項目で構成され、各項目のデータ型、長さ、および小数点以下桁数は次のようになります。

統計を渡す場合は、データテーブルの 1 行は 5 つの項目で構成され、各項目のタイプ、長さ、および小数点以下桁数は次のようになります。

ランク一覧を渡す場合は、データテーブルの 1 行は 4 つの項目で構成され、各項目のタイプ、長さ、および小数点以下桁数は次のようになります。

項目のデータ型、長さ、および小数点以下桁数を定義するには、 ABAP の命令 DESCRIBE FIELD または内容説明テーブル LISTDESC ( 下記参照 ) のいずれかを使用します。

LISTDESC 内容説明テーブルには、データテーブル DATATAB の項目の内容説明が含まれます。これには、項目のタイプ、長さ、少数点以下桁数だけでなく、 DESCRIBE FIELD 命令で定義することができない情報も含まれています。この例のような複数のサブ一覧がクエリにある場合は、内容説明テーブルには、このクエリによって渡すことができるすべてのデータテーブル ( つまり、サブ一覧すべて ) の項目の内容説明が常に含まれます。 LIST_ID パラメータを使用して、内容説明テーブルから該当するエントリを検索することができます。

したがって、この例では、基本一覧、統計、およびランク一覧のデータテーブルの項目の内容説明が常に内容説明テーブルに含まれます。

内容説明テーブルは RSAQLDESC 構造を持っており、次の項目が含まれています ( 内容説明テーブル : RSAQLDESC) 。