Besteht ein Business-Objekt aus Teilobjekten, können Sie für das Hinzufügen bzw. Entfernen von Teilobjekten folgende standardisierten BAPIs implementieren:

• Add<Name des Teilobjekts>()

• Remove<Name des Teilobjekts>()

Die BAPIs Add<Name des Teilobjekts>() und Remove<Name des Teilobjekts>() sind Instanzmethoden.

Bei der Festlegung der Import-Parameter sind folgende Aspekte zu beachten:

• Beide BAPIs müssen als Import-Parameter im Funktionsbaustein die Schlüsselfelder des zugehörigen Business-Objekttyps beinhalten. Dabei müssen die Namen der Parameter mit den Namen der Objektschlüssel im BOR übereinstimmen und die gleichen Datenelemente besitzen.

• Zusätzlich werden Parameter für diejenigen Daten benötigt, die das betreffende Teilobjekt eindeutig identifizieren.

• Das BAPI muß zusätzlich einen TestRun-Parameter besitzen, der es ermöglicht, Testläufe durchzuführen. Ist dieser Parameter mit dem Wert "X" gefüllt, wird das BAPI zwar normal abgearbeitet, die Ergebnisse werden aber nicht vom BAPI in den Verbucher geschrieben. Somit können nach Ausführen des BAPIs BapiService.TransactionCommit sämtliche Ergebnisse, wie beispielsweise der Application Log, ausgewertet werden, die Datenbank bleibt aber vom BAPI unberührt.

Bei der Festlegung der Export-Parameter eines Remove<Name des Teilobjekts>()-BAPIs sind folgende Aspekte zu beachten:

• Sie sollten als Export-Parameter nur den Parameter Return anlegen, um Meldungen aus dem Methodenaufruf an das aufrufende Programm zurückzugeben. Um ein umfangreiches Monitoring der Ergebnisse des Remove<Name des Teilobjekts>()-BAPIs sowohl bei einem synchronen als auch bei einem asynchronen Aufruf zu gewährleisten, müssen beim Füllen des Return-Parameters die folgenden Konventionen eingehalten werden:

• Wird das BAPI erfolgreich abgearbeitet, also das gewünschte Teilobjekt gelöscht, muß im Return-Parameter folgende standardisierte T100-Nachricht übergeben werden:

• Das Feld MESSAGE_V1 enthält den externen Namen des Business-Objektes, wie z.B. SalesOrder, dessen Teilobjekt gelöscht wurde.

• In MESSAGE_V2 wird derjenige Schlüssel zurückgegeben, unter dem auf das Objekt zugegriffen wurde, dessen Teilobjekt gelöscht worden ist. Dies kann entweder bei externer Nummervergabe der externe Schlüssel oder bei interner Nummernvergabe der interne Schlüssel sein. Besitzt das Objekt mehrere Schlüsselfelder, dann müssen die Werte dieser Schlüsselfelder in MESSAGE_V2 konkateniert werden. Bei der Konkatenation ist die diejenige Reihenfolge einzuhalten, in der die Schlüsselfelder im BOR definiert sind. Außerdem muß für jedes Schlüsselfeld die maximale Länge verwendet werden, so daß gegebenenfalls ein Auffüllen notwendig ist.

• Tritt bei der Abarbeitung des Remove<Name des Teilobjekts>()-BAPIs ein Fehler auf, ist neben den anwendungsspezifischen Fehlermeldungen folgende standardisierte Nachricht im Return-Parameter zu übergeben:

• Neben der standardisierten Meldung können weitere Meldungen in den Return-Parameter geschrieben werden. Insbesondere im Fehlerfall müssen Meldungen zurückgegeben werden, die den Fehler konkret beschreiben. Deshalb sollte der volle Funktionsumfang des Typs BAPIRET2 Verwendung finden. Insbesondere sollten die Felder Parameter, Row und Field gefüllt werden.

Bei der Festlegung der Export-Parameter eines Add<Name des Teilobjekts>()-BAPIs sind diese Aspekte zu beachten:

• Wird das BAPI erfolgreich abgearbeitet, also das gewünschte Teilobjekt angelegt, muß im Return-Parameter folgende standardisierte Nachricht übergeben werden:

• Tritt bei der Abarbeitung des Add<Name des Teilobjekts>()-BAPIs ein Fehler auf, ist neben den anwendungsspezifischen Fehlermeldungen folgende standardisierte Nachricht im Return-Parameter zu übergeben:

• Neben der standardisierten Meldung können weitere Meldungen in den Return-Parameter geschrieben werden. Insbesondere im Fehlerfall müssen Meldungen zurückgegeben werden, die den Fehler konkret beschreiben. Deshalb sollte der volle Funktionsumfang des Typs BAPIRET2 Verwendung finden. Insbesondere sollten die Felder Parameter, Row und Field gefüllt werden.