In BAPIs, die Änderungen auf der Datenbank hervorrufen, z.B. Change()- und Create()-BAPIs, muß man zwischen den Parameterfeldern unterscheiden können, die geändert werden sollen (den "änderungsrelevanten Feldern"), und denen, die unverändert bleiben sollen.

Zu diesem Zweck genügt die Verwendung eines Initialwerts nicht, da es sich bei dem Initialwert auch um einen gültigen, neuen Wert handeln kann. Ebensowenig kann in der ABAP-Programmiersprache und auch auf anderen Entwicklungsplattformen einem Datentyp der Wert "NULL" zugewiesen werden um ein Feld als nicht belegt zu markieren.

Um in einem Change()- oder Create()-BAPI die Felder mit änderungsrelevanten Informationen zu identifizieren, werden deshalb standardisierte Änderungsparameter eingesetzt. Sie können hierbei zwei unterschiedliche Strategien verwenden:

• Identifizieren der änderungsrelevanten Felder durch Markierung
• Identifizieren der änderungsrelevanten Felder durch Vergleich

In diesem Ansatz werden änderungsrelevante Felder in einem Parameter durch eine entsprechende Markierung in einem zusätzlichen Änderungs-Parameter identifiziert:

• Für jeden Parameter des BAPIs, der änderungsrelevante Felder beinhaltet, muß ein zusätzlicher Änderungs-Parameter mit der gleichen Anzahl Felder und den gleichen Feldnamen angelegt werden.
• Beim Aufruf des BAPIs müssen in dem zusätzlichen Änderungs-Parameter genau die Felder mit einem Update-Kennzeichen (Flag) markiert werden, die im korrespondierenden Parameter änderungsrelevante Daten beinhalten.

Auf diese Weise kann das BAPI genau identifizieren, welche Felder des Parameters modifizierte Daten enthalten, und in welchen Feldern keine Änderungen vorgenommen wurden.

Beachten Sie folgende Konventionen, wenn Sie Änderungs-Parameter anlegen:

• Der Name des zusätzlichen Änderungs-Parameters setzt sich aus dem Namen des Parameters und dem Suffix "X" zusammen. Heißt der Parameter beispielsweise EquiSales, ist der Name des zusätzlichen Änderungs-Parameters EquiSalesX.
• Der zusätzliche Änderungs-Parameter muß genau die gleiche Anzahl Felder sowie die gleichen Feldnamen wie der Parameter haben. Als Datenelement für die änderungsrelevanten Felder müssen Sie das Datenelement BAPIUPDATE (CHAR 1) verwenden. Dieses kann folgende Werte annehmen:

• 'X'

• ' ' (kein Wert)

• Handelt es sich bei dem Parameter um eine Tabelle, muß der zusätzliche Änderungs-Parameter auch eine Tabelle sein.

In diesem Ansatz werden änderungsrelevante Felder durch den Vergleich zweier Parameter identifiziert, von denen der eine die aktuell gültigen Daten und der andere die neuen, geänderten Daten enthält.

Beim Aufruf des Change()-BAPIs müssen die aktuellen Daten aus der Datenbank sowie die neuen, geänderten Daten in die entsprechenden Parameter eingetragen werden. Der aktuelle Datenbestand kann dabei beispielsweise aus dem vorausgegangenen Aufruf eines GetDetail()-BAPIs übernommen werden.

Folgende Vergleiche sind nun möglich:

• Die aktuellen Daten können zunächst gegen den tatsächlichen Datenbankbestand geprüft werden, um festzustellen, ob sich dieser in der Zwischenzeit verändert hat. So können Datenbankänderungen erkannt werden, die zwischen dem Lesevorgang mit dem GetDetail()-BAPI und dem Datenbank-Update stattgefunden haben.
• Die Daten beider Parameter können Feld für Feld verglichen werden. Werden in einem Feld unterschiedliche Daten festgestellt, müssen die entsprechenden Werte aus dem Parameter mit den neuen Daten übernommen werden.

Beachten Sie folgendes, wenn Sie änderungsrelevante Felder durch Vergleich identifizieren:

• Ein aufrufendes Programm muß in der Lage sein, alle Parameterfelder des Change()-BAPIs zu versorgen. Aus diesem Grund müssen Sie die Parameterfelder des Change()-BAPIs genau mit den Feldern eines entsprechenden GetDetail()-BAPIs am gleichen Business-Objekttyp abstimmen.
• Die Namen der zu vergleichenden Parameter müssen gleich sein, wobei der Parameter mit den geänderten Daten zusätzlich das Suffix 'New' erhält.

• Beide Parameter müssen genau die gleichen Felder und die gleiche Struktur besitzen.

1. Füllen des Parameters EquiSales mit den Daten aus dem Aufruf des entsprechenden GetDetail()-BAPIs.
2. Initialisieren des Parameters EquiSalesNew mit den Werten aus dem Parameter EquiSales.
3. Ändern der gewünschten Parameterwerte im Parameter EquiSalesNew, z.B. EquiSalesNew-Distr_Chan='EN'.

Folgende Tabelle vergleicht die oben beschriebenen Möglichkeiten, änderungsrelevante Felder in BAPIs zu identifizieren und soll als Entscheidungshilfe dienen.