Ansicht
Dokumentation
ISM_BAPI_MATERIAL_RT_PREPARE - Anlegen und Ändern von Materialstammdaten (Retail)
General Data in Customer Master rdisp/max_wprun_time - Maximum work process run timeDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Mit dieser Methode können neue Materialstammdaten angelegt oder bestehende Materialstammdaten geändert werden.
Zusätzlich zum Anlegen und Ändern von Materialstammdaten können auch die Daten der folgenden Strukturen gelöscht werden:
- MATERIALDESCRIPTION
- UNITSOFMEASURE
- INTERNATIONALARTNOS
- VENDOREAN
- UNITOFMEASURETEXTS
- LAYOUTMODULEASSGMT
- MATERIALLONGTEXT
Damit erkennbar ist, dass ein Datensatz gelöscht werden soll, muss in der entsprechenden Struktur das Feld FUNCTION mit dem Wert 003 belegt werden. Bei der Neuanlage oder beim Ändern von Daten ist dieses Feld nicht relevant.
Wenn es sich bei dem in der Struktur HEADDATA angegebenen Material um ein Sammelmaterial handelt, können in den betreffenden Strukturen (CLIENTDATA, ...) Daten sowohl zum Sammelmaterial als auch zu den Varianten angegeben werden. Dies ist in der Regel nur dann sinnvoll, wenn spezielle Daten für die Variante abweichend zu den Daten des Sammelmaterials gepflegt werden sollen. Sind keine expliziten Daten für die Varianten vorhanden, werden diese auf Basis der Daten des Sammelmaterials automatisch angelegt.
Wird eine Variante neu angelegt, muss für diese Variante ein Eintrag in der Struktur VARIANTSKEYS hinterlegt werden. Damit ist es möglich auch zu einem bereits existierenden Sammelmaterial neue Varianten anzulegen.
Enthält eine Struktur Felder für Maßeinheiten (z. B. Struktur CLIENTDATA: Feld BASE_UOM), Sprachkennzeichen (z. B. Struktur MATERIALDESCRIPTION: Feld LANGU) oder Länderkennzeichen (z. B. Struktur TAXCLASSIFICATIONS: Feld DEPCOUNTRY), dann gibt es immer auch ein gleichnamiges Feld mit der Endung _ISO. Damit hat man die Möglichkeit, für die Maßeinheiten, Sprachkennzeichen oder Länderkennzeichen entweder den intern verwendeten SAP-Code oder einen normierten ISO-Code zu übergeben. ISO-Codes werden intern für die weitere Verarbeitung in einen SAP-Code umgewandelt. Der ISO-Code kommt nur zur Anwendung, wenn der SAP-Code nicht übergeben wird. Im Customizing der Maßeinheiten, Sprachkennzeichen und Länderkennzeichen muss eine eindeutige Abbildung der ISO-Codes auf die SAP-Codes gewährleistet sein, wenn mit ISO-Codes gearbeitet wird.
Die Verbuchung der übergebenen Daten erfolgt synchron, d. h. nicht über einen Verbuchungstask. Dies ist notwendig, weil diese Methode auch bei der ALE-Verteilung zum Einsatz kommt und die ALE-Eingangsverarbeitung keine asynchrone Verbuchung unterstützen kann, weil ansonsten der Verarbeitungsstatus des zugeordneten IDocs nicht verlässlich gesetzt werden kann.
Tritt beim synchronen Verbuchen der Anwendungsdaten ein schwerwiegender Datenbankfehler auf, so wird in der Methode ein Rollback für alle bisher durchgeführten Datenbankänderungen ausgelöst. Wird die Methode zusammen mit anderen Methoden in einer Commit-Einheit aufgerufen, werden damit auch die Datenbankänderungen der vorher durchgeführten Methodenaufrufe zurückgerollt, falls diese noch nicht committed wurden. Der Rollback ist notwendig, damit nach einem Datenbankfehler kein inkonsistenter Zustand auf der Datenbank entsteht, weil ein Teil der Anwendungsdaten korrekt verbucht werden konnte und der Rest nicht.
Falls bei der Verarbeitung der Daten Hinweis- oder Fehler-Meldungen auftreten, werden diese im Anwendungs-Log hinterlegt. Falls man sich die protokollierten Meldungen anschauen möchte, ist es notwendig, ein Commit nach dem Aufruf dieser Methode durchzuführen, damit die Daten im Anwendungs-Log auf die Datenbank geschrieben werden. Selbst wenn die Struktur RETURN im Feld TYPE eine Meldung vom Typ E (Error) zurückliefert, muss ein Commit durchgeführt werden, damit der Anwendungslog weggeschrieben wird. Für das korrekte Zurücksetzen der Daten im Fehlerfall sorgt die Methode selbst. Das Commit ist auch dazu notwendig, um z. B. das Verbuchen der Klassifizierungsdaten anzustoßen, denn der Verbuchungsbaustein für die Klassifizierungsdaten wird mittels PERFORM ON COMMIT registriert und erst durch ein COMMIT WORK zur Ausführung gebracht.
Beispiel
Hinweise
Damit die Daten angelegt oder geändert werden können, benötigen Sie die notwendigen Berechtigungen zum Bearbeiten der entsprechenden Materialstammdaten.
Weiterführende Informationen
Ab Release 4.5A ist auch die korrekte Verteilung von Löschvormerkungen über diese Methode möglich. Löschvormerkungen werden im Retailfall nur für die mandantenspezifischen (Parameter CLIENTDATA) und die werksspezifischen Materialdaten (Parameter PLANTDATA) gesetzt. Werden Löschvormerkungen (Feld DEL_FLAG) für einen der beiden Parameter übergeben, wird beim Verbuchen ein entsprechender Workflow erzeugt, der abhängig vom Wert des Löschkennzeichens entweder das mandantenweite oder werksspezifische Auslisten für dieses Material oder die Rücknahme einer bestehende Löschvormerkung anstößt.
Weitere Informationen zu diesem Thema findet man in der ERP-Bibliothek unter LO SAP Retail -> Artikel: Artikelauslistung.
Parameter
ADDNLCLIENTDATAADDNLCLIENTDATAX
CHARACTERISTICVALUE
CHARACTERISTICVALUEX
CLIENTDATA
CLIENTDATAX
CLIENTEXT
CLIENTEXTX
DISTRCHAINKEYS
FORECASTPARAMETERS
FORECASTPARAMETERSX
FORECASTVALUES
HEADDATA
INTERNATIONALARTNOS
IN_JPTMARA
IN_MARA
IN_MARC_TAB
IN_MARD_TAB
IN_MBEW_TAB
IN_MLGN_TAB
IN_MLGT_TAB
IN_MVKE_TAB
IN_NEW_VBER_TAB
IN_NEW_VKORG
IN_NEW_VTWEG
IN_NEW_WERKS
IN_NEW_WERK_TAB
LAYOUTMODULEASSGMT
LAYOUTMODULEASSGMTX
MAKT_STRU
MATERIALDESCRIPTION
MATERIALLONGTEXT
NEW_SINGLE_MATERIAL
NEW_VARIANTS_TAB
PATTERN_ARTICLE
PATTERN_VKORG
PATTERN_VTWEG
PATTERN_WERKS
PLANNINGDATA
PLANNINGDATAX
PLANTDATA
PLANTDATAX
PLANTEXT
PLANTEXTX
PLANTKEYS
POSDATA
POSDATAX
POSEXT
POSEXTX
SALESDATA
SALESDATAX
SALESEXT
SALESEXTX
STORAGELOCATIONDATA
STORAGELOCATIONDATAX
STORAGELOCATIONEXT
STORAGELOCATIONEXTX
STORAGELOCATIONKEYS
STORAGETYPEDATA
STORAGETYPEDATAX
STORAGETYPEEXT
STORAGETYPEEXTX
STORAGETYPEKEYS
TAXCLASSIFICATIONS
TOTALCONSUMPTION
UNITOFMEASURETEXTS
UNITSOFMEASURE
UNITSOFMEASUREX
UNPLNDCONSUMPTION
VALUATIONDATA
VALUATIONDATAX
VALUATIONEXT
VALUATIONEXTX
VALUATIONTYPEKEYS
VARIANTSKEYS
VENDOREAN
WAREHOUSENOKEYS
WAREHOUSENUMBERDATA
WAREHOUSENUMBERDATAX
WAREHOUSENUMBEREXT
WAREHOUSENUMBEREXTX
XADD_SEGMENTS
XCOPY_SEGMENTS
Ausnahmen
Funktionsgruppe
JPMM11PERFORM Short Reference TXBHW - Original Tax Base Amount in Local Currency
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 13426 Date: 20240523 Time: 144658 sap01-206 ( 177 ms )
