使用する
多くのサービスBAPIは、基本的なヘルプ機能を提供します。サービスBAPIは、個々のアプリケーションコンポーネントからのBAPIに情報またはサービスを提供します。
の下のBORコンポーネント階層にあります。
個々のサービスBAPIの詳細については、BORのBAPIドキュメントを参照してください。
特徴
インターフェイスドキュメントにアクセスするためのBAPI
以下のBAPIを使用して、BAPIインターフェイスのドキュメントと説明を表示できます。
-
HelpValues.GetList()
このメソッドは、BAPIパラメータ項目の入力値(F4ヘルプ)を決定します。このメソッドは、特定のBAPIパラメーターフィールドの有効な入力値を表示し、エンドユーザーが入力フィールドに正しい値を入力できるようにします。
-
BapiService.FieldHelpGetDocu()
このメソッドは、BAPIパラメータ項目の文書(F1ヘルプ)を読み取ります。これにより、エンドユーザーにBAPIパラメータフィールドの説明を提供できます。
-
BapiService.InterfaceGetDocu()
このメソッドは、BAPIのインターフェイスドキュメント全体を読み取ります。ビジネスオブジェクトタイプ、メソッド、パラメータ、およびパラメータフィールドに関するドキュメントにアクセスできます。
-
BapiService.HyperLinkGetText()
このメソッドは、ドキュメントへのハイパーリンクを持つSAPオブジェクトドキュメントを読み取ります。このドキュメント自体は、BapiService.InterfaceGetDocu()またはBapiService.HyperLinkGetText()方法。
エラーメッセージを解釈するためのBAPI
以下のBAPIは、BAPIエラーメッセージの解釈に役立ちます。
-
BapiService.MessageGetDetail()
このメソッドは、BAPIエラーメッセージの短いテキストと長いテキストを表示します。
-
BapiService.ApplicationLogGetDetail()
このメソッドは、アプリケーションログのエントリを読み取ります。
COMMITとROLLBACKを制御するためのBAPI
トランザクションモデル( BAPIを開発するためのトランザクションモデルを参照)は、オブジェクトインスタンスを作成したりオブジェクトデータを変更したりするすべてのBAPIがデータベースの整合性に責任があることを規定しています。
データベースへの変更の書き込みまたは変更のリセット(COMMITおよびROLLBACK)に使用されるコマンドは、BAPI自体によって実行されてはならず、外部アプリケーションプログラムから直接呼び出される必要があります。
外部プログラムは、これらの呼び出しに次のサービスBAPIを使用できます。
-
BapiService.TransactionCommit()
このメソッドは、仕事をコミットする指図。SAPシステムのデータを変更するプログラムでBAPIを呼び出す場合は、このメソッドを呼び出して変更をデータベースに渡す必要があります。
-
BapiService.TransactionRollback()
このメソッドは、ロールバック作業指図。SAPシステムのデータを変更するプログラムでBAPIを呼び出す場合、このメソッドを使用して、変更がデータベースに書き込まれないようにすることができます。これは、BAPIがBapiService.TransactionCommit()変更はまだデータベースに転送されていません。
内部データ形式と外部データ形式の間で変換するためのBAPI(ドメイン変換)
BAPIはプログラミングインターフェイスであり、エンドユーザーインターフェイスではありません。このため、BAPIではニュートラルデータ形式(一部の例外を除く)を使用する必要があります。BAPIパラメータの項目は、フォーマットされた形式ではなく、データベースで使用される内部形式でBAPIインタフェースに表示されます。
プログラムでBAPIを呼び出す場合、たとえば画面にデータを表示するには、外部データ形式を使用する必要があります。以下の変換BAPIを使用して、必要な形式でデータを表示することができます。
-
BapiService.DataConversionInt2Ext1()
このBAPIは、データを内部形式から必要な外部形式に変換します。
-
BapiService.DataConversionExt2Int1()
このBAPIは、データを外部形式から必要な内部形式に変換します。
データを変換できるのは、変換対象のデータの基礎となるドメインの変換ルーチンがABAPディクショナリに保持されている場合のみです。それ以外の場合、データは変換されずに返されます。
次の図は、変換BAPIが使用される場所を示しています。
変換BAPI