使用する
ALEインタフェースは、アプリケーション汎用モジュールから生成することができます。
これは、複雑なデータ型のデータを渡すインポートパラメータと、処理結果を返すエクスポートパラメータに特に当てはまります。これらは、インターフェースに含めることができる唯一のパラメーターです。
インポートパラメータは、個々のオブジェクトを処理するための構造タイプを参照したり、オブジェクトの一括処理のためにテーブルタイプを参照したりできます。システムパフォーマンスを向上させるために、一括処理をお勧めします。
パラメータは、深くネストされたコンポーネントや構造のパラメータを含め、十分に詳細に文書化する必要があります。これは、最初のデータ転送にとって特に重要です。
処理結果は、エクスポートパラメータの事前定義された構造で返されます
-
個別処理の場合-タイプBAPIRETSへの参照
タイプBAPIRETSは、以下の項目を持つ構造です。BAPIRETS:
OBJECT_KEYは、処理されたオブジェクトのキーです。OBJECT_MSGはBAPIRETCのテーブルタイプです。BAPIRETCはBAPIRET2と同様の構造を持っていますが、複素数データ型のコンポーネントをアドレス指定するためのタイプCHAR255の新しいフィールドCOMPONENTが含まれています。これにより、アプリケーションは、コンポーネントアドレスを持つ特定のオブジェクトに対して複数のメッセージを返すことができます。
-
一括処理の場合-タイプBAPIRETMへの参照
タイプBAPIRETMは、構造BAPIRETIのテーブルタイプです。バピレティ:
これにより、アプリケーションはOBJECT_IDXによって決定されたオブジェクトに対して複数のメッセージを返すことができます。
-
呼び出し元のメッセージタイプとコミット作業またはロールバック作業手順(たとえば、ALEレイヤー):
通常、オブジェクトはアプリケーション汎用モジュールによって正常に処理されるか、警告とともに処理されます。この場合、タイプS(成功)またはW(警告)のメッセージが返され、呼び出し元はコミット作業を設定します。
エラーが特定された場合など、オブジェクトを処理できない場合もありますが、トランザクションは続行できます。次に、タイプE(エラー)のメッセージが少なくとも1つ返されます。呼び出し元はコミット作業を設定します。
エラーのためにトランザクションをそれ以上処理できない場合、たとえば、転記が部分的に行われた後にエラーが発生し、ロールバック作業が必要になった場合。次に、タイプA(abort)のメッセージが少なくとも1つ返されます。呼び出し元はロールバック作業を設定します。
一括処理では、ロールバック作業がすべてのオブジェクトに適用されます。この場合のALE層の反応については、「 ALEインターフェースの生成:手順」セクションで説明しています。
エクスポートパラメータが入力されていない場合、これは処理が成功したことを意味します。この場合、呼び出し元はコミット作業を設定します。
インターフェイスを配信する前に、リリースする必要があります
これは、互換性のある変更のみが許可されることを意味します(BAPIの動作と同様)。
リリースされたインターフェイスは拡張できますが、制限があります
インターフェイスの所有者(SAPなど)は、次の新しいオブジェクトを挿入できます。次に例を示します。
-
エレメンタリーフィールド
-
構造タイプ
-
テーブルタイプ
-
構造を追加する
既存のオブジェクトの削除や参照の変更などの変更は許可されていません(BAPIの動作と同様)。
パートナーまたは顧客は、追加構造でのみリリースされた後、インターフェースを拡張することができます。現時点では、変更は許可されていません。