使用する
シナリオとシナリオで使用されるビジネスオブジェクトタイプがシナリオの分析で識別された後、BAPIシグニチャは設計フェーズ内で概念的に定義されます。内容を記述し、パラメータ名とパラメータ構造を定義する必要があります。
BAPIは技術的なインターフェースではなくビジネスインターフェースを表すため、BAPIを開発するための次の中心的な要件が発生します。外部アプリケーションでは、ユーザーはアプリケーションとBAPIドキュメントの知識だけを使用してBAPI呼び出しを正しく実装できる必要があります。ユーザーはSAPの知識を持っている必要がないため、SAPシステムを「ブラックボックス」と見なすことができます。
このフェーズでは、BAPIの関数から、BAPIがインスタンスメソッドであるかクラスメソッドであるか、および標準化されたBAPIとして実装できるかどうかも決定する必要があります。インスタンスメソッドは、ビジネスオブジェクトタイプの特定のインスタンスを参照します。たとえば、BAPI Flight.GetDetailは、正確に1つのフライトの詳細を取得します。これらのメソッドは、BORでインスタンス依存として定義されています。クラスメソッドは、ビジネスオブジェクトタイプの特定のインスタンスを参照しません。たとえば、 Flight.GetListは、特定の基準に一致するすべての既存のフライトのリストを提供します。標準化された作成メソッドもクラスメソッドに属します。createメソッドは、新しいインスタンスを作成します。BAPIたとえば、 FlightBooking.CreateFromData（）は、SAPシステムに新しい航空券の予約を作成します。これらのメソッドは、BORでインスタンスに依存しないものとして定義されています。
ビジネスオブジェクトタイプの特定のインスタンスは、キーフィールドによって識別されます。そのため、このコンテキストで特別な役割を果たします。設計段階では、インスタンスに依存するBAPIのキーを特別なパラメーターとして識別する必要があります。詳細については、インターフェイスの定義を参照してください。
BAPI署名を設計するときは、次の点に注意する必要があります。
-
メソッドの設計（BAPI）とパラメーターは、特定の規則に準拠している必要があります。規則も参照してください。
-
基本的な機能を提供するさまざまな標準的なメソッドとパラメーターがあります。BAPIとそのパラメーターがこのカテゴリーに該当する場合は、指定されたルールに従って構造化する必要があります。概要については、標準化されたBAPIと標準化されたパラメータを参照してください。
-
署名が明確に構造化されて使いやすいように、設計の推奨事項に従う必要があります。
