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

 

Der Funktionsbaustein ALE_ASYNC_BAPI_GET_RECEIVER wird von dem Anwendungsprogramm zur Ermittlung der Empfänger eines asynchronen BAPIs aufgerufen.

Dabei werden die folgenden Mechanismen wirksam:

  • 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 das Anwendungsprogramm der Empfängerermittlung die Objekt-ID (z.B. 01815) als Filterobjekt-Wert übergeben.

    Der Funktionsbaustein ALE_ASYNC_BAPI_GET_RECEIVER ermittelt über die Objekt-ID die aktuellen Filterobjekt-Werte des Objektes, über das das abhängige BAPI auf ein anderes BAPI bzw. anderen Nachrichtentyps referenziert. Dazu muss die Anwendung einen Funktionsbaustein zur Verfügung stellen, der das Lesen der Objekt-Daten ermöglicht. Der Name des Funktionsbausteins muss in einer ALE-Customizing Tabelle hinterlegt werden, auf die die Empfängerermittlung zur Laufzeit zugreift (Tabelle TBD18).

  • Werden keine Empfänger ermittelt oder wird das BAPI nicht im ALE-Verteilungsmodell gefunden, so wird eine leere Tabelle für die Empfänger 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).

  • 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, optional

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

Exceptions

Parameter

Beschreibung

ERROR_IN_FILTEROBJECTS

Filterobjekte sind fehlerhaft oder unvollständig

ERROR_IN_ALE_CUSTOMIZING

Fehler im ALE-Customizing