Ansicht
Dokumentation

WDRDA_READ_WDRD_SINGLE - NOTRANSL: Lesen Belieferungsbeziehung für Lieferwerk/Warengruppe/Material

General Material Data   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
This documentation is copyright by SAP AG.

Functionality

Der Baustein liefert für ein Lieferwerk (I_RESWK), eine Warengruppe (I_MATKL) und ein Material (I_MATNR) eine zuvor ermittelte Belieferungsbeziehung (Menge belieferter Werke oder Kunden) zurück.

Ob das System zu einer Schlüsselkombination Werke (Rückgabe in E_T_WERKS) oder Kunden (Rückgabe in E_T_KUNNR) als Abnehmer lesen soll, können Sie über den Parameter I_RTYPE einstellen.

Die Ebene (Werk, Werk und Warengruppe, Werk und Material/Warengruppe), auf der der Baustein eine Belieferungsbeziehung von der Datenbank liest, wird dem Baustein über den Parameter I_LEVEL mitgegeben. Es müssen nur die für das Lesen von dieser Ebene notwendigen Schlüsselfelder (Werk, Warengruppe, Material) an den Baustein übergeben werden.

Wenn Sie den Parameter I_RFCHK setzen, führt das System die Findung einer Referenz für die Belieferungsbeziehung über die BAdI-Methode EX_BADI_WDRD_005 durch. Dies darf nur geschehen, falls im Profil zur Ermittlung der Belieferungsbeziehung für die entsprechende Art der Abnehmer die Methode 'Referenz' eingestellt ist! Wenn eine Referenz ermittelt wurde, wird diese in der Struktur E_S_REF_KEY zurückgegeben. Tritt ein Fehler bei der Ermittlung der Referenz auf, unterbricht der Baustein seine Arbeit mit einer Ausnahme- und Fehlermeldung.

Setzen Sie den Parameter I_ENQUE, setzt das System auf den zu lesenden Satz (ggf. auf den Satz zur Referenz) eine SAP-Sperre. Ist der Satz bereits gesperrt, bricht der Baustein seine Arbeit mit einer Ausnahme- und Fehlermeldung ab.

Die Menge der Abnehmer pro Schlüsselkombination ist auf der Datenbank in Form einer Zeichenkette variabler Länge abgelegt und wird vom Baustein für die Rückgabe in eine interne Tabelle konvertiert (ein Satz pro Abnehmer). Eine unkonvertierte Rückgabe im Format der Datenbanktabelle (Rückgabe in E_T_WDRD) können Sie über den Parameter I_DBRES einstellen.

Der Baustein liefert die auf die Datenbank fortgeschriebenen Steuerungsparameter für die Ermittlung der Belieferungsbeziehung zurück (E_S_CTRL), sofern keine unkonvertierte Rückgabe eingestellt ist. Das Gleiche gilt für das Erstellungs- und das Ermittlungsdatum (E_CDATE bzw. E_DDATE).

Eine Abnehmerfindung kann auch eine leere Menge von Abnehmern ermitteln und auf die Datenbank fortschreiben. Falls die Ausgabetabelle der Abnehmer für eine angeforderte Schlüsselkombination leer ist, kann anhand der Steuerungsparameter (vorhanden oder nicht vorhanden, insbesondere ob die Methode für die Ermittlung der jweiligen Art von Abnehmern initial ist oder nicht) festgestellt werden, ob noch keine Ermittlung der Belieferungsbeziehung durchgeführt wurde oder ob sie mit dem Ergebnis 'keine Abnehmer vorhanden' durchgeführt wurde.

Der Baustein verfügt über eine Pufferungs-Logik für einmal gelesene Sätze. Über einen Parameter (I_BPBUF) können Sie steuern, daß der Puffer beim Lesen umgangen und direkt von der Datenbank gelesen wird (bypass buffer). Über einen weiteren Parameter (I_RFBUF) können Sie steuern, ob das Ergebnis des aktuellen Zugriffs in den Puffer geschrieben wird und ein eventuell vorhandener Pufferinhalt für die Kombination Werk, Warengruppe, Material und Art der Abnehmer durch den aktuellen Zugriff ersetzt wird (refresh buffer). Der Buffer Refresh ist nur möglich, wenn mit Bypassing Buffer gelesen wird.

Example

Notes

Der Baustein prüft die die Eingabeparameter Werk, Warengruppe und Material nicht auf ihre Existenz. Der Baustein prüft lediglich, ob die Schlüsselfelder, die zum Lesen auf der angeforderten Ebene notwendig sind, mitgegeben wurden.

Falls innerhalb eines Prozesses für eine Vielzahl von Kombinationen (Werk, Warengruppe, Material) Daten gelesen werden, sollten die Daten zunächst über den Baustein WDRDA_SELECT_WDRD_INTO_BUFFER in den Puffer geladen werden (Prefetch). Anschließend können die Daten mit dem Baustein WDRDA_READ_WDRD_SINGLE aus dem Puffer ausgelesen werden. Über einen Parameter (I_RFBUF) können Sie steuern, ob der bisherige Pufferinhalt durch diesen neuen Zugriff ersetzt werden soll.

Further information

DE-EN-LANG-SWITCH-NO-TRANSLATION

Parameters

CH_T_KUNNR
CH_T_WDRD
CH_T_WDRD_EXTWG
CH_T_WERKS
E_CDATE
E_DDATE
E_S_CTRL
E_S_REF_KEY
I_BPBUF
I_DBRES
I_ENQUE
I_EXTWG
I_LEVEL
I_MATKL
I_MATNR
I_RESWK
I_RFBUF
I_RFCHK
I_RTYPE

Exceptions

DRD_NOT_EXISTING
DRD_NOT_UNIQUE
ERROR_IN_REFERENCE
ERROR_WHEN_LOCKING
FOREIGN_USER_LOCK
WRONG_OR_MISSING_INPUT

Function Group

WDRDA

Addresses (Business Address Services)   Fill RESBD Structure from EBP Component Structure  
This documentation is copyright by SAP AG.

Length: 5938 Date: 20240523 Time: 151625     sap01-206 ( 130 ms )