FunktionsdokumentationEmpfänger für synchrone BAPIs ermitteln Dieses Dokument in der Navigationsstruktur finden

 

Der Funktionsbaustein ALE_SYNC_BAPI_GET_RECEIVER wird vom Anwendungsprogramm zur Ermittlung der Empfänger eines synchronen BAPIs aufgerufen.

Dabei werden die folgenden Mechanismen wirksam:

  • Falls keine Empfänger ermittelt werden oder das BAPI nicht im Verteilungsmodell gefunden wird, so wird eine leere Tabelle für die Empfänger zurückgegeben.

  • Falls eine Abhängigkeit für ein BAPI im ALE-Verteilungsmodell als eine Bedingung definiert ist, so wird der Empfänger des referenzierten BAPIs bzw. Nachrichtentyps bestimmt. Dazu muss die Anwendung der Empfängerermittlung die Objekt-ID (z.B. 01815) als Filterobjekt-Wert übergeben.

    Die Empfängerermittlung liest nun selbst über die Objekt-ID die aktuellen Filterobjekt-Werte des Objektes nach, über das das abhängige BAPI auf ein anderes BAPI bzw. anderen Nachrichtentyps referenziert. Dazu stellt die Anwendung einen Funktionsbaustein zur Verfügung, der das Lesen der Objekt-Daten ermöglicht. Der Name des Funktionsbausteins wird in einer ALE-Customizing Tabelle hinterlegt, auf die die Empfängerermittlung zur Laufzeit zugreift (Tabelle TBD18). Neben dem logischen System wird auch die RFC-Destination zurückgegeben.

  • Falls die übergebenen Filterobjekttypen und -werte nicht zu einer vollständigen und fehlerfreien Empfängerermittlung ausreichen, werden Fehlernachricht und Ausnahme zurückgegeben (ERROR_IN_FILTEROBJECTS).

  • Falls die RFC-Destination zu einem logischen Empfängersystem nicht gepflegt ist, werden Fehlernachricht und eine Ausnahme zurückgegeben (NO_RFC_DESTINATION_MAINTAINED).

  • Treten Inkonsistenzen im Verteilungsmodell aufgrund fehlendem bzw. fehlerhaftem Customizing auf, werden Fehlernachricht und Ausnahme zurückgegeben (ERROR_IN_ALE_CUSTOMIZING).

Input Parameter

Parameter

Bezugsfeld/Bezugsstruktur

Beschreibung

OBJECT

BDI_BAPI-OBJECT

BOR-Objekt des BAPIs

METHOD

BDI_BAPI-METHOD

BOR-Methode des BAPIs

RECEIVER_INPUT

BDI_LOGSYS

Logische Empfängersysteme als Vorgabewert

FILTEROBJECT_VALUES

BDI_FOBJ

Filterobjekte und -werte

Output Parameter

Parameter

Bezugsfeld/Bezugsstruktur

Beschreibung

RECEIVERS

BDI_LOGSYS

Empfängersysteme des BAPIs und RFC-Destination

Exceptions

Parameter

Beschreibung

ERROR_IN_FILTEROBJECTS

Filterobjekte sind fehlerhaft oder unvollständig

ERROR_IN_ALE_CUSTOMIZING

Fehler im ALE-Customizing

NO_RFC_DESTINATION_MAINTAINED

RFC Destination zum logischen System fehlt