Bestimmen der Entwicklungsobjekte im Dictionary (SAP-Bibliothek)

Bestimmen der Entwicklungsobjekte im Dictionary

Einsatzmöglichkeiten

Nachdem Sie die Inhalte, Namen und Datenformate der erforderlichen Schnittstellen-Parameter festgelegt haben, können Sie die benötigten Datenobjekte im ABAP Dictionary bestimmen.

Ablauf

Beachten Sie dabei folgende Richtlinien:

Als Parameter können Sie einzelne Felder, Feldleisten und Tabellen verwenden. Jeder Parameter muß auf ein Dictionary-Objekt verweisen.

Beachten Sie, daß alle Parameter als Struktur definiert sein müssen. Besteht ein Parameter nur aus einem Feld, muß dieser auf ein Feld in einer BAPI-Struktur verweisen.

Komplexe Datentypen, z.B. Tabellen als Felder in Strukturen, sind nicht erlaubt.

Für die BAPI-Schnittstelle müssen Sie eigene Datenstrukturen anlegen, die unabhängig von den Datenstrukturen sind, die allgemein in der R/3-Anwendung verwendet werden. Nur so ist es möglich, Änderungen in den R/3-Anwendungen durchzuführen, ohne die BAPIs zu beeinflussen.

Die Namen der anzulegenden Datenstrukturen müssen mit BAPI beginnen und aussagekräftig sein.

In einer BAPI-Struktur dürfen keine INCLUDE-Strukturen verwendet werden, da Erweiterungen einer INCLUDE-Struktur im allgemeinen zu einer inkompatiblen Änderung der BAPI-Struktur führen. (Weitere Informationen hierzu finden Sie unter Inkompatible Weiterentwicklungen.) BAPI-Strukturen selbst sollten auch nicht in anderen Strukturen verwendet werden.

Struktur S1 besteht aus den Feldern F1 und F2. Struktur S2 inkludiert Struktur S1 und hat selbst ein Feld F3. Wird nun zu Struktur S1 ein Feld F3 hinzugefügt, hat dies in eine inkompatible Änderung an Struktur S2 zur Folge und führt darüber hinaus zu einer Namenskollision der Felder F3.

Folgende Grafik illustriert diese Problematik.

Für Felder in BAPI-Strukturen können Sie bestehende Datenelemente und Domänen einsetzen. Verwenden Sie nach Möglichkeit nur zentrale Datenelemente und Domänen, die in der Basisentwicklung bzw. der Anwendungsbasis enthalten sind. Die zugehörigen Entwicklungsklassen beginnen mit B bzw. S.

Bevor Sie ein bestehendes Datenelement oder eine bestehende Domäne verwenden, sollten Sie Rücksprache mit dem jeweiligen Objektverantwortlichen halten.

Wählen Sie für die Felder in den Strukturen leicht verständliche, englische Namen. Für BAPIs vor Release 4.0 stehen maximal 10 Zeichen zur Verfügung, ab Release 4.0 können die Namen der Strukturen bis zu 30 Zeichen lang sein. Sie können für die Namen alphanumerische Zeichen sowie Unterstriche verwenden.

Seit Release 4.0 werden für Datenelemente im ABAP Dictionary sprechende, englische Defaultfeldnamen gepflegt. Diese sollten Sie, wenn immer möglich, als die Namen der Felder und Parameter verwenden.

Sie können sich darüber hinaus mit Hilfe des Reports BBAPIFLD englische Vorschlagswerte für die Namen von Feldern oder Parametern generieren lassen. Wie Sie diesen Report verwenden, ist in der Report-Dokumentation beschrieben.

Wenn in den internen Arbeitsstrukturen eines BAPIs deutsche Feldnamen verwendet werden, können Sie die in Abschnitt Mapping zwischen internen/externen Datenformaten beschriebene Transaktion verwenden, um zwischen den deutschen und englischen Feldnamen zu konvertieren.

Für das Beispiel aus den vorangegangenen Schritten könnten nachstehend beschriebene Parameter und Bezugsfelder bzw. Bezugstabellen identifiziert werden.

Das erste Beispiel hierzu verwendet u.a. Strukturen, die zu Release 3.1 angelegt wurden. In diesem Release waren die Namen von Strukturen maximal 10 Zeichen lang.

Das zweite Beispiel zeigt, wie man die Namensgebung der verwendeten Strukturen zu Release 4.0 verbessern könnte.

Parameter und ihre Bezugsfelder in Release 3.1

Parameter im Funktionsbaustein	Bezugsfeld/Bezugstabelle
COMPANYCODEID	BAPI0002_2-COMP_CODE
COMPANYCODEDETAIL	BAPI0002_2
COMPANYCODEADDRESS	BAPI0002_3
RETURN	BAPIRETURN

Parameter und ihre Bezugsfelder in Release 4.0

Parameter im Funktionsbaustein	Bezugsfeld/Bezugstabelle
COMPANYCODE	BAPI0002_2-COMP_CODE
COMPANYCODEDETAIL	BAPI0002_COMPANYCODEDETAIL
COMPANYCODEADDRESS	BAPI0002_COMPANYCODEADDRESS
RETURN	BAPIRETURN