Dokumentation zur VorgehensweiseHierarchien zwischen BAPI-Parametern definieren Dieses Dokument in der Navigationsstruktur finden

 

Wenn Sie eigene ALE-Geschäftsprozesse entwickeln, kann es erforderlich sein, dass Sie für die Parameterfilterung hierarchische Abhängigkeiten zwischen BAPI-Tabellenparametern definieren müssen.

Solche Abhängigkeiten werden über Feldreferenzen zwischen den Parametern der Tabellen eines BAPIs definiert.

Die Parameterfilterung für die Bestimmung der Datenmenge und damit auch die Definition von Abhängigkeiten ist nur für die Verteilung von Stammdaten über asynchronaufgerufene BAPIs relevant und zulässig.

Beispiel Beispiel

Ein BAPI für Material-Stammdaten enthält u.a. die Tabellen für Werksdaten und zugehörige Lagerdaten. Die Tabelle für Werksdaten referenziert auf die Tabelle für Lagerdaten über das Schlüsselfeld WERKS. Es existiert eine hierarchische Abhängigkeit zwischen den Werks- und Lagerdaten, d.h. wenn das Werk 001 zu einem Material aufgrund der Parameterfilterung nicht repliziert werden soll, dann werden auch die Lagerdaten zu dem Werk 001 nicht repliziert.

Ende des Beispiels.

Voraussetzungen

Sie nutzen die BAPI-Parameterfilterung zur Steuerung des Umfangs der Datenmenge in der Schnittstelle eines BAPIs.

Vorgehensweise

Solche hierarchischen Abhängigkeiten können Sie in der ALE-Entwicklung über   BAPI   Datenfilterung   Hierarchie der Tabellenparameter pflegen (BDBP)   definieren.

Geben Sie den Objekttyp und die Methode des BAPIs ein. Über die Eingabehilfe können Sie sich die vorhandenen BOR-Objekttypen und die zugehörigen Methoden anzeigen und eine Auswahl vornehmen.

Im Menü Hierarchie gibt es folgende Bearbeitungsaktivitäten für die Hierarchieerstellung:

  • Anlegen

  • Ändern

  • Anzeigen

  • Löschen

Hierarchie anlegen

Es wird geprüft, ob eine Hierarchie für das BAPI bereits existiert. Anschließend wird geprüft, ob bereits eine ALE-IDOC Schnittstelle generiert wurde und ob das zugehörige IDOC bereits freigegeben wurde.

Wenn das IDOC bereits freigegeben wurde, muss davon ausgegangen werden, dass die generierte Schnittstelle bereits zum Kunden ausgeliefert wurde und somit aus Kompatibilitätsgründen zu einem bestehenden BAPI keine Hierarchie angelegt bzw. geändert werden kann. In diesem Fall müssen Sie ein neues BAPI anlegen. Eine entsprechende Fehlermeldung wird angezeigt. Existiert die ALE-Schnittstelle bereits, aber das IDOC ist noch nicht freigegeben, so werden Sie darauf hingewiesen, dass eine Nachgenerierung notwendig ist.

Im Folgebild wird ein grafischer Hierarchiebaum angezeigt. Einzelheiten dazu finden Sie unter Grafische Hierarchieanzeige bearbeiten weiter unten.

Hierarchie ändern

Es erfolgen die gleichen Prüfungen wie beim Anlegen. Im Folgebild gibt es die gleichen Bearbeitungsaktivitäten wie beim Anlegen

Hierarchie anzeigen

Es erfolgen die gleichen Prüfungen wie beim Anlegen. Im Folgebild können keine Änderungen an der Hierarchie vorgenommen werden.

Um die Feldreferenzen zwischen den Tabellen anzusehen, führen Sie einen Doppelklick auf der Elterntabelle aus. Die Elterntabelle wird automatisch in das folgende Einblendfenster übernommen. Über die Eingabehilfe können Sie eine der möglichen Kindtabellen auswählen.

Über die Drucktaste Feldreferenzen können Sie sich die Feldreferenzen anzeigen.

Hierarchie löschen

Es erfolgen die gleichen Prüfungen wie beim Anlegen. Nach einer Sicherheitsabfrage wird die Hierarchie zu dem BAPI gelöscht.

Grafische Hierarchieanzeige bearbeiten

In der grafischen Hierarchieanzeige entspricht der Wurzelknoten dem Funktionsbaustein zu dem BAPI. Der Wurzelknoten dient nur zur Anzeige und wird nicht gesichert. Er kann auch nicht geändert werden.

Die grafische Anzeige können Sie wie folgt bearbeiten:

  • Tabellenparameter hinzufügen

  • Tabellenparameter löschen

  • Feldreferenzen zwischen Eltern- und Kindtabelle pflegen

  • Hierarchie sichern

Eltern-Tabellen, die direkt unter dem Wurzelknoten eingefügt werden und keine Kindtabellen besitzen, werden nicht gesichert. Falls nur derartige Elterntabellen angelegt werden, so existiert keine Hierarchie und folglich wird auch keine Hierarchie gesichert.

Tabellenparameter hinzufügen

Positionieren Sie den Cursor auf einen Knoten der Hierarchiedarstellung und wählen Sie   Bearbeiten   Tabellenparameter hinzufügen  .

Wenn Sie den Cursor auf den Wurzelknoten positionieren, können Sie über die Eingabehilfe eine Eltern-Tabelle der obersten Ebene auswählen.

Wenn eine Tabelle über dem markierten Knoten existiert, wird diese in das folgende Einblendfenser automatisch übernommen, und Sie können zu dieser Tabelle eine Kind-Tabelle hinzufügen.

Grundsätzlich kann eine Tabelle nur einmal in der Hierarchie existieren. über die Eingabehilfe können Sie sich die verfügbaren Tabellen anzeigen.

Im Einblendfenster können Sie sich über die Drucktaste Feldreferenzen die gemeinsamen Felder der Eltern- und Kindtabelle anzeigen, über die Feldreferenzen definiert werden können. Durch Markieren können Sie die Felder auswählen, für die eine Feldreferenz definiert werden soll. Falls keine Feldreferenzen zwischen den beiden Tabellen existieren, so wird ein Fehlermeldung ausgegeben.

Tabellenparameter löschen

Um eine Tabelle zu löschen, positioniert Sie den Cursor auf den entsprechenden Knoten der Hierarchiedarstellung mit dem Tabellennamen der Kind-Tabelle. Bestätigen Sie die Sicherheitsabfrage. Grundsätzlich werden alle weiteren Kind-Tabellen der zu löschenden Tabelle ebenfalls gelöscht.

Feldreferenzen zwischen Eltern- und Kindtabellen pflegen

Positionieren Sie den Cursor auf den Knoten einer Kind-Tabelle und wählen Sie   Bearbeiten   Tabellenparameter   Feldreferenzen ändern   oder die Drucktaste Feldreferenz mit der Änderungsikone.

Das folgende Einblendfenster enthält den Elternparameter und, sofern eine Referenz bereits existiert, auch den Kindparameter.

Beim Anlegen können Sie über die Eingabehilfe die zugehörige Kindtabelle auswählen.

Über die Drucktaste Feldreferenzen können Sie sich die gemeinsamen Felder anzeigen. Es werden nur Feldreferenzen auf Felder angezeigt, die namensgleich in Eltern- und Kind-Tabellen vorkommen.

Durch Markieren können Sie Referenzen zwischen Feldern definieren. Bereits definierte Feldreferenzen sind bereits markiert.

Hierarchie sichern

Um eine Hierarchie zu sichern, wählen Sie   Hierarchie   Sichern  .

Beim Sichern wird ein Transportauftrag abgefragt, da die zugehörige Customizing-Tabelle an das Korrektur- und Transportsystem angeschlossen ist.

Die Hierarchie wird nicht gesichert, wenn ein Fehler beim Datenbankzugriff auftritt. Eine entsprechende Fehlermeldungen wird ausgegeben.