使用する
このセクションでは、BAPI呼び出しをアプリケーションプログラムに統合する前に、BAPIについて知っておくべきことを説明します。
命名規則
BAPIは、ビジネスオブジェクトタイプの名前の後にBAPIの名前が続くことで識別されます。(BAPI名は英語であり、BAPIがビジネスオブジェクトに対して行うことを説明します)。ピリオドは、名前の2つの部分を区切ります。
標準化されたBAPIとパラメーター
ほとんどのビジネスオブジェクトタイプに実装できる標準化されたBAPIがいくつかあります。これらのBAPIには特定の機能があります。たとえば、BAPI GetList()は、ビジネスオブジェクトタイプのインスタンスのリストを取得します。
これらのBAPIは、指定されたルールに従って実装され、すべてのビジネスオブジェクトに同じ名前が付けられています。BAPIGetList()たとえば、多くのビジネスオブジェクトに使用できます。CompanyCode.GetList()とMaterial.GetList()。これらのBAPIの詳細については、標準化されたBAPIを参照してください。
可能な限り、BAPIのパラメータも標準化されています。BAPI用に実装および定義できる標準化されたパラメーターは、BAPIインターフェースで使用されます。
データベースの一貫性
オブジェクトのインスタンスを作成したり、オブジェクトのデータを更新したりする各BAPIは、データベースの整合性に責任があります。すべてのデータベース変更は完全に実行されるか、まったく実行されません。
しかし仕事をコミットするコマンドはBAPI自体によって実行されてはなりません。呼び出し側プログラムによって実行される必要があります。詳細については、 BAPIを開発するためのトランザクションモデルを参照してください。
ダイアログオリエンテーションなし
BAPIは、SAPサーバーシステムから呼び出し元アプリケーションに画面ダイアログを返しません。
承認
SAPシステムと対話するには、ユーザーは特定の権限セットを持っている必要があります。アプリケーションプログラムの一部としてBAPIを実行するには、アプリケーションのユーザは、SAPマスタレコードに適切な権限を設定しておく必要があります。BAPIで提供されるドキュメントには、必要な権限に関する情報が含まれています。
不十分な許可の結果として失敗したBAPIを実行しようとすると、呼び出し元のアプリケーションに報告されます。
データ型とデータ表示
BAPIは、ビジネスアプリケーション用のプログラミングインターフェイスです。したがって、ニュートラル(内部)データ型とデータ形式は、BAPIインターフェイスでほぼ排他的に使用されます。たとえば、いくつかの例外があります。
-
通貨コード
-
内部キー
-
量
-
アドレス構造の特定のフィールド
変換BAPIは、内部形式と外部形式の間の適切な変換のために提供されています。詳細については、ヘルプ機能のサービスBAPIを参照してください。
BAPIパラメータは、SAPがサポートするほとんどのデータ型を使用できます。データ型は、ABAPディクショナリの各パラメータの構造エントリに文書化されています。
処理モード
BAPIが直接呼び出される場合(たとえば、BAPI ActiveXコントロール、SAP DCOMコンポーネントコネクタを使用する場合、または基になる汎用モジュールを直接呼び出す場合)、同期モードで処理されます。
分散環境(ALE)でのBAPIの呼び出しの詳細については、分散アプリケーションのプログラミングを参照してください。
ビジネスオブジェクト属性
ビジネスオブジェクトの属性には、BAPIインターフェイス自体を介してアクセスします。このような属性を取得するBAPIの例は次のとおりです。GetDetail()ビジネスオブジェクトCompanyCodeの。