Ansicht
Dokumentation

MATERIAL_READ - Lesen Materialstamm

General Data in Customer Master   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionsbaustein Material_Lesen.

Aufruf

CALL FUNCTION 'MATERIAL_READ'
EXPORTING SCHLUESSEL = MTCOM
IMPORTING MATDATEN = Viewtabelle
RETURN = MTCOR
TABLES SEQMAT01 = Interne Tabelle
( EXCEPTIONS Material_not_found = 4
Plant_not_found = 8 . )

Exceptions-Anweisung nur für sog. Mußtabellen sinnvoll (s.u.).

Mußtabellen
Wenn eine als Mußtabelle gekennzeichnete Tabelle nicht vorhanden ist, bricht der Funktionsbaustein an dieser Stelle ab und liefert eine Fehlermeldung. Die Fehlermeldung können Sie mit der EXCEPTIONS-Anweisung unterdrücken. In diesem Fall erhalten Sie einen Returncode im SY-SUBRC. In beiden Fällen (d.h. mit oder ohne EXCEPTIONS) liefert der Funktionsbaustein im Fehlerfall keine Daten zurück. Alle Mußtabellen zum View können Sie dynamisch deaktivieren (nicht einzeln, sondern als Gesamtheit). Hierzu setzen Sie das Flag MTCOM-NOMUS.

Returncodes
Wenn der Funktionsbaustein ohne Fehlermeldung durchläuft, kann in der Struktur MTCOR pro Tabelle ein Returncodeflag abgefragt werden; z.B. bedeutet MTCOR-RMARD = 'X', daß der Funktionsbaustein vergeblich versucht hat, die Tabelle MARD zu lesen. Wenn das Flag nicht gesetzt ist, war das Lesen erfolgreich, oder der Funktionsbaustein hat überhaupt nicht versucht, die Tabelle MARD zu lesen (weil die Tabelle nicht im View enthalten ist oder weil kein Lagerort angegeben wurde).

MTCOR-LVORM
Dieses Flag ist gesetzt, wenn das Objekt zum Löschen vorgemerkt ist.

MTCOR-PSTAT/MTCOR-FSTAT
Wenn Sie in der MTCOM einen Pflegestatus angeben (z.B. MTCOM-PSTAT = BDE), prüft das System, ob das Objekt von den Fachbereichen Buchhaltung(B), Disposition(D) und Einkauf(E) gepflegt wurde. Ergebnis:

• Feld MTCOR-PSTAT enthält die Fachbereiche, die das Objekt gepflegt haben; MTCOR-PSTAT = 'B' z.B. heißt, daß das Objekt von der Buchhaltung gepflegt wurde, nicht jedoch von der Disposition und dem Einkauf.

• Feld MTCOR-FSTAT enthält die Fachbereiche, die das Objekt zwar pflegen können, es aber nicht getan haben; d.h. das System prüft, ob die Materialart den Fachbereich zuläßt.

Hinweis

Diese Prüfung ist etwas aufwendig (Performance!). Wenn sie nicht benötigt wird, sollte der Funktionsbaustein daher stets mit MTCOM-PSTAT = Space aufgerufen werden!

MTCOM-NOVOR
Wenn ein Werk, aber keine Bewertungsebene oder Verkaufsorganisation angegeben wurde, übernimmt der Funktionsbaustein für das angegebene Werkdie Werte für die beiden letzten Felder automatisch aus Tabelle T001W. Diese Funktion können Sie deaktivieren, indem Sie das Flag MTCOM-NOVOR setzen.

Sperren von Materialien
Falls mittels des Funktionsbausteins MATERIAL_READ oder MATERIAL_READ_MAKF bzw. anderen Funktionsbausteinen der Funktionsgruppen MATL oder MAKF Materialien gesperrt werden, wird die Information darüber, welche Materialien bereits gesperrt wurden, aus Gründen der Performance gepuffert. Dieser Puffer wird zurückgesetzt bzw. ignoriert, wenn die Kennzeichen (MTCOM-)KZSPR und (MTCOM-)KZRFB gesetzt sind. Sie können auch den Funktionsbaustein MATERIAL_RESET_ENQ_BUFFER bzw. MATERIAL_RESET_ENQ_BUFFER_MAKF verwenden, um diesen Puffer komplett zurückzusetzen. Dies kann z.B. erforderlich sein, wenn der Funktionssbaustein DEQUEUE_ALL ausgeführt wurde.

Parameter

MATDATEN
MATPER
RETURN
SCHLUESSEL
SEQMAT01

Ausnahmen

ACCOUNT_NOT_FOUND
BATCH_NOT_FOUND
FORECAST_NOT_FOUND
INVALID_MCH1_MATNR
INVALID_MTCOM
LOCK_ON_ACCOUNT
LOCK_ON_BATCH
LOCK_ON_MATERIAL
LOCK_ON_PLANT
LOCK_ON_SALES
LOCK_ON_SLOC
LOCK_SYSTEM_ERROR
MATERIAL_NOT_FOUND
PLANT_NOT_FOUND
SALES_NOT_FOUND
SA_MATERIAL
SLOCNUMBER_NOT_FOUND
SLOCTYPE_NOT_FOUND
SLOC_NOT_FOUND
T134M_NOT_FOUND
TEXT_NOT_FOUND
UNIT_NOT_FOUND
WAART_ERROR
WV_MATERIAL

Funktionsgruppe

MATL

BAL_S_LOG - Application Log: Log header data   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4914 Date: 20240605 Time: 231705     sap01-206 ( 101 ms )