Ansicht
Dokumentation
DMU_DOC_BOM_READ - Anzeige von Materialstücklisten incl. Dokumenten und DMU-Objekten
SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up TXBHW - Original Tax Base Amount in Local CurrencyDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Mit diesem Funktionsbaustein kann eine Stückliste einstufig nach folgenden Stücklistendaten gelesen werden:
Daten | Bedeutung |
---|---|
MATERIAL | Kopfmaterial |
PLANT | Werk |
BOM_ALTERNATIVE | Stücklistenalternative |
BOM_USAGE | Stücklistenanwendung |
CHANGE_NUMBER | Änderungsnummer |
VALID_FROM | Stichtag |
REVISION_LEVEL | Revisionsstand |
Zusätzlich werden für DMU bzw. für die CAD-Schnittstele Dokumente und DMU-Objekte (Transformationsmatrizen, Positionsobjekte) zurückgeliefert.
Der Zusammenhang zwischen Stücklistenkopf bzw. Stücklistenposition und Dokumenten besteht
durch eine Objektverknüpfung. Da z.B. an eine Position der Stückliste mehrere Dokumente verknüpft sein können, kann die Auswahl über Selektionskriterien erfolgen.
Selektionskriterien
- CAD_FLAG
- Nur Dokumente, deren Verknüpfung zur Stücklistenposition gekennzeichnet ist, werden selektiert.
- Dokumentart-Filter: TYPE_FILTER
- Nur Dokumente des angegebenen Typs werden selektiert.
- Dokumentversions-Filter: VERSION_FILTER
- Nur Dokumente der vorgegebenen Version werden selektiert.
- Dokumentstatus-Filter: STATUS_FILTER
- Nur Dokumente mit dem festgelegten Status werden selektiert.
- Dokument-Anwendungsfilter: SINGLE_APPLICATION_FILTER und MULTIPLE_APPLICATION_FILTER
-
Wurde ein Dokument selektiert, so wird mit diesen Parametern ein bestimmtes Original ausgewählt.
Sie haben die Möglichkeit, eine oder mehrere Applikationen anzugeben (z.B. DOC für Word-Dokumente oder PPT für Power-Point-Dokumente).
Der Algorithmus sucht so lange nach Originalen, bis das Original des ersten spezifizierten Typs gefunden wurde. Diese Originaldatei wird zurückgeliefert.
Flags
Folgende Flags können gesetzt werden:
- GET_MATRICES
- Festlegung, ob Transformationsmatrizen bereitgestellt werden sollen.
- GET_SINGLE_FILE
- Festlegung, ob die Dokumentsuche nach dem ersten Erfolg abgebrochen wird.
Ausgabeparameter:
- FL_WARNING
- Flag zeigt an, ob ein Protokolleintrag während der Stücklistenauflösung geschrieben wurde
- RETURN
- Rückgabestruktur für Prozessmeldungen
- BOM_HEADER
- Tabelle mit Daten zu Stücklistenköpfen
- BOM_ITEM
- Tabelle mit Daten zu Stücklistenpositionen
- DOCUMENTDATA
- Tabelle mit Dokument-File-Daten (Originale)
- DOCUMENTFILES
- Tabelle der Dokumente
- DMUPOSITIONOBJECTS
- Tabelle der Positionsobjekte
- DMUMATRICES
- Tabelle der Transformationsmatrizen
- Zur eindeutigen Zuordnung von Stücklistenpositionen, Dokumenten und DMU-Objekten dient ein eindeutiger Identifikator (GUID, globally unique identifier):
- BOM_ITEM-ITEM_GUID
- DOCUMENTDATA-GUID
- DOCUMENTFILES-GUID
- DMUPOSITIONOBJECTS-GUID
- DMUMATRICES-GUID
Beispiel
REPORT dmu_mat_bom_read MESSAGE-ID 26.
DATA: lt_documentdata TYPE TABLE OF dmu_document,
lt_documentfiles TYPE TABLE OF dmu_file.
DATA: lt_bom_header TYPE TABLE OF stko_api02,
lt_bom_items TYPE TABLE OF stpo_api02.
DATA: lt_dmupositionobjects TYPE TABLE OF dmu_posobj,
lt_dmumatrices TYPE TABLE OF dmu_matrix.
DATA: lt_applications TYPE TABLE OF bapi_doc_applications,
ls_application LIKE bapi_doc_applications.
DATA: return LIKE bapiret2,
fl_warning LIKE capiflag-flwarning.
MOVE 'ASM' TO ls_application-wsapplication.
APPEND ls_application TO lt_applications.
MOVE 'PRT' TO ls_application-wsapplication.
APPEND ls_application TO lt_applications.
CALL FUNCTION 'DMU_MAT_BOM_READ'
EXPORTING
material = 'ZMS-A1'
PLANT = ' '
BOM_ALTERNATIVE = ' '
bom_usage = '2'
CHANGE_NUMBER = ' '
valid_from = '22.03.1998'
REVISION_LEVEL = ' '
CAD_FLAG = ' '
type_filter = '*'
version_filter = '*'
status_filter = '*'
single_application_filter = '*'
get_matrices = 'X'
GET_SINGLE_FILE = 'X'
IMPORTING
fl_warning = fl_warning
return = return
TABLES
bom_header = lt_bom_header
bom_item = lt_bom_items
documentdata = lt_documentdata
documentfiles = lt_documentfiles
dmupositionobjects = lt_dmupositionobjects
dmumatrices = lt_dmumatrices
multiple_application_filter = lt_applications
. IF return-type CA 'EA'.
WRITE: / '**************** FEHLER ******************'.
WRITE:/ return-message.
ELSE.
WRITE: / '**************** ERFOLG ******************'.
ENDIF. .
Weiterführende Informationen
Parameter
APPLICATIONSBOMHEADER
BOMITEMS
CHANGE_NUMBER
DMUMATRICES
DMUPOSITIONOBJECTS
DOCUMENTDATA
DOCUMENTFILES
DOCUMENTNUMBER
DOCUMENTPART
DOCUMENTTYPE
DOCUMENTVERSION
FL_WARNING
GET_MATRICES
RETURN
REVISION_LEVEL
VALID_FROM
Ausnahmen
Funktionsgruppe
CAD_DESKTOPCPI1466 during Backup BAL_S_LOG - Application Log: Log header data
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 8456 Date: 20240605 Time: 111510 sap01-206 ( 78 ms )