エラーメッセージ 

定義

エラーメッセージはアプリケーション固有のエラー状況を説明するメッセージです。

用途

プロキシ生成機能はエラーメッセージの例外クラスを生成します。アプリケーションがこのような例外クラスを使用して例外をトリガすると、ABAP プロキシランタイムはこれを自動的にエラーメッセージに変換します。アプリケーションはエラーメッセージを使用してアプリケーションエラーを記録します (たとえば、要求されたカスタマプロファイルが不明です、など)。

構造

●      エラーメッセージの構造は WSDL 文書で記述され、制限はありません。

●      XI のエラーメッセージは統合リポジトリの標準化されたエラーメッセージタイプによって記述され、WSDL 文書の対応する構造に変換されます (下記参照)。

XI のエラーメッセージの標準化された構造

XI では、エラーの原因に関するエラーメッセージ情報から生成された例外クラスを以下の構造を使用して指定することができます。

定義済の構造 STANDARD にはエラーの転送に不可欠な情報が含まれます。構造 ADDITION はアプリケーションで自由に使用できます。

XI 標準構造の例

エラーメッセージを送信するには、エラーメッセージ用に生成された構造に必要な情報をすべて設定し、対応する例外クラスで例外をトリガします。

  data: l_standard_data     type  <標準エラーデータタイプ>,
      l_detail_data       type  <標準エラーデータタイプ用の詳細構造>,
      l_additional_data   type  <アプリケーションエラーデータタイプ>.

l_standard_data-fault_text   = <エラーテキスト>.
l_standard_data-fault_url   = <エラー URL>.
l_detail_data-severity       = <システムエラーカテゴリ>.
l_detail_data-text           = <システムエラーテキスト>.
l_detail_data-id             = <システムエラー ID>.
l_detail_data-url            = <システムエラー URL>.

append l_detail_data to l_standard_data-fault_detail.

l_additional_data  = <アプリケーションエラー情報>

RAISE EXCEPTION TYPE <例外クラス名>
   EXPORTING
      standard = l_standard_data
      addition = l_additional_data.

アプリケーションログを使用する場合、または BAPI リターンテーブルからエラー情報にアクセスする場合は、これらを直接使用してエラーメッセージに必要なすべての情報を設定することもできます。この場合は、プロキシランタイムのメソッド CL_PROXY_FAULT=>RAISE を呼び出すだけでエラーをトリガすることができます。

CALL METHOD cl_proxy_fault=>raise
  EXPORTING
   exception_class_name   = <例外クラスの名称>
   application_log_handle = < アプリケーションログ: プロトコルのハンドル>
   bapireturn_tab         = < BAPI リターン情報を含むテーブル>.

アプリケーションログのハンドルまたは BAPI リターン情報を持つテーブルのどちらも転送しない場合は、メソッドはエラーメッセージの標準データを以下の方法で完全に設定します。

faultText	インテグレーションリポジトリのエラーメッセージテキスト (60 文字に短縮)
faultUrl	インテグレーションリポジトリのこのメッセージのテキスト (長) の URL

以下の追加項目はアプリケーションログまたは BAPI リターンテーブルからのデータに対して設定されます。

faultDetail-severity	この項目には BAP メッセージタイプが以下のようにマッピングされます。
	ABAP 項目 MSGTY	エラーメッセージ項目 faultDetail-severity
	A (= アベンド)	error
	E (= エラー)	error
	W (= 警告)	warning
	S (= 正常終了)	情報提供
	I (= 情報)	情報提供
faultDetail-text	書式設定された T100 メッセージテキスト (サービスが実行された言語で設定)。
faultDetail-url	T100 テキスト (長) への URL (利用可能な場合)。
faultDetail-id	作業領域とメッセージ番号を連結したもの (例: “XY(007)”)。

Exchange Infrastructure のデータ表現

非同期通信の場合は、Exchange Infrastructure のモニタリング機能を使用してエラーメッセージを確認することができます。たとえば、技術的モニタリングでは、エラーに関する追加情報を選択することにより、より読みやすい形でエラーメッセージを表示することができます。同期通信の場合は、メソッド CL_PROXY_FAULT=>SHOW を使用してこのタイプの書式を呼出側のアプリケーションに統合することができます。