Ansicht
Dokumentation
RPY_DATA_MODEL_MULTI_READ - Datenmodelle lesen + weitere Informationen
TXBHW - Original Tax Base Amount in Local Currency CPI1466 during BackupDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Der Funktionsbaustein RPY_DATA_MODEL_MULTI_READ liest Informationen zu EINER oder MEHREREN Datenmodell-Hierarchien des Data Modeler und übergibt sie in Form Tabellen.
Wichtig ist, zu unterscheiden zwischen dem TRANSPORTOBJEKT Datenmodell und dem Datenmodell im UMGANGSSPRACHLICHEN Sinne.
- Das Transportobjekt Datenmodell kennzeichnet GENAU EIN Objekt, nämlich die Wurzel einer Datenmodell-Hierarchie.
- Der umgangssprachliche Begriff kennzeichnet in der Regel den ganzen BAUM, d.h., die Wurzel, alle Nachfolger (Entitätstypen und Datenmodelle), deren Nachfolger und so weiter.
Was gelesen wird, können Sie über Parameter weitgehend selbst bestimmen. Sie können
- nur genau das Transportobjekt (Datenmodell) lesen, das der Wurzel der Datenmodell-Hierarchie entspricht
- alle Transportobjekte (Datenmodelle UND Entitätstypen) lesen, die in der Datenmodell-Hierarchie vorkommen
- die Tiefe des Baumes bestimmen; wählen Sie als Tiefe 1, wird nur die Wurzel gelesen; wählen Sie die Tiefe 2, werden die Wurzel und die unmittelbar darunter liegenden Objekte gelesen (soweit angefordert)
- auch mehr oder weniger Informationen lesen, als durch die Transportobjekte bestimmt sind; z.B. können Sie nur die Stückliste des kompletten Baumes auslesen, oder Sie fordern nur die ein- und ausgehenden Beziehungen zwischen Entitätstypen im Baum an, oder sie lesen nur die Dokumentationen zu den Datenmodellen oder Entitätstypen oder ...
Wenn Sie genau das Transport-Objekt (Datenmodell) auslesen möchten, so belassen Sie alle Vorschlagswerte bei den Eingangs-Parametern. Wenn Sie mehr oder weniger Informationen benötigen, so ändern Sie die Eingangs-Parameter nach Bedarf ab.
Zum Transportobjekt Datenmodell gehören:
- Grundinformationen zum Datenmodell
- Stückliste (Verweise auf Nachfolger und Positionen)
- SAPScript-Dokumentation
Nicht zum Transportobjekt gehören:
- Formatierte Dokumentation
- Nachfolgende Entitätstypen und Datenmodelle
- Beziehungen zwischen Entitätstypen, Attribute, ...
- Verwendungsnachweis
Über die Parameter WITH_* (z.B. WITH INGOING_RELATIONSHIPS) wird festgelegt, ob bestimmte Teilinformationen gewünscht sind. Diese werden dann in den gleichnamigen Strukturen und Tabellen (z.B. Tabelle INGOING_RELATIONSHIPS) zurückgegeben.
Haben Sie einen WITH-Parameter (z.B. WITH INGOING_RELATIONSHIPS) und WITH_FORMATTED_DOCUMENTATION bzw. WITH_SAPSCRIPT_DOCUMENTATION angekreuzt ('X'), so wird die Dokumentation (z.B. zu den eingehenden Beziehungen) in den entsprechenden Tabellen FORMATTED_DOCUMENTATION bzw. SAPSCRIPT_DOCUMENTATION übergeben.
Der Funktionsbaustein löst keine Exception aus. Treten während der Abarbeitung Problemsituationen oder Fehler auf, so werden diese über die Tabelle ERRORS an den Aufrufer zurückgegeben.
Ist diese Tabelle leer, so trat kein Fehler auf. Ansonsten entspricht jede Zeile der Tabelle einem Fehler. Im Feld ERRORCLASS findet sich die Art des Fehlers (Objekt nicht gefunden, Berechtigungsfehler, Sperrfehler, ...). In den Feldern MSGID/MSGTYPE/MSGNUMBER/MSGVAR1/.../MSGVAR4 finden sich die Informationen, die einem MESSAGE-Befehl in ABAP entsprechen. Trat weder ein interner noch ein Parameter-Fehler auf, so läßt sich mit Hilfe der Felder OBJECTID/OBJECTTYPE das Objekt bestimmen, bei dem der Fehler auftrat.
Beispiel
Mit dem folgenden Aufruf des Funktionsbaustein lesen Sie genau die zwei Datenmodelle 'Einkaufsgruppe' und 'Beschaffungsinformation', also nur genau zwei Transportobjekte.
* Declaration of variables
data: t_errors like rpygser occurs 10 with header line,
t_data_model_ids like rpydmmi occurs 2 with header line,
t_model_infos like rpydmdm occurs 2,
t_parts_list like rpydmhi occurs 50,
t_sapscript_documentation like rpydmsd occurs 1000.
* Determine data model to be read
t_data_model_ids = 'SAP_40129'. " Buyer group
append t_data_model_ids.
t_data_model_ids = 'SAP_40201'. " Procurement information
append t_data_model_ids.
* Call: read 2 transport objects data models (1 level)
call function 'RPY_DATA_MODEL_MULTI_READ'
exporting
cico_mode
= 'R'
cico_request_no = ' '
language
= sy-langu
levels = 1
with_sapscript_documentation = 'X'
with_parts_lists = 'X'
tables
errors
= t_errors
data_model_ids = t_data_model_ids
model_infos = t_model_infos
sapscript_documentation = t_sapscript_documentation
parts_lists = t_parts_list.
* Error handling
loop at t_errors.
if ...
...
endif.
endloop.
Weiterführende Informationen
Weitergehende Informationen zu den Strukturen und Tabellen, die im Aufruf von RPY_DATA_MODEL_MULTI_READ vorkommen, finden Sie unter:
Folgende Funktionsbausteine gehören ebenfalls zur Repository-API des Data Modeler und können für Sie von Interesse sein:
Allgemeinere Informationen zum Data Modeler und zur Datenmodellierung finden sie
- in der Online-Dokumentation zum Data Modeler
- im Buch 'Data Modeler' aus der Buchreihe über die Abap/4 Development Workbench
- im Methoden-Handbuch 'SAP-Informationsmodell' (Produktnummer 50007795).
Parameter
ALIASESASSIGNED_TABLES_OR_VIEWS
ATTRIBUTES
CICO_MODE
CICO_REQUEST_NO
DATA_MODEL_IDS
ERRORS
FORMATTED_DOCUMENTATION
INGOING_RELATIONSHIPS
INGOING_SPECIALIZATIONS
LANGUAGE
LEVELS
MODEL_INFOS
OUTGOING_RELATIONSHIPS
OUTGOING_SPECIALIZATIONS
OUTGOING_SPEC_CATEGORIES
PARTS_LISTS
SAPSCRIPT_DOCUMENTATION
SUCCESSOR_ENTITY_INFOS
SUCCESSOR_MODEL_INFOS
WHERE_USED_LISTS
WITH_ALIASES
WITH_ASSIGNED_TABLES_OR_VIEWS
WITH_ATTRIBUTES
WITH_FORMATTED_DOCUMENTATION
WITH_INGOING_RELATIONSHIPS
WITH_INGOING_SPECIALIZATIONS
WITH_OUTGOING_RELATIONSHIPS
WITH_OUTGOING_SPECIALIZATIONS
WITH_OUTGOING_SPEC_CATEGORIES
WITH_PARTS_LISTS
WITH_SAPSCRIPT_DOCUMENTATION
WITH_SUCCESSOR_ENTITY_INFOS
WITH_SUCCESSOR_MODEL_INFOS
WITH_WHERE_USED_LISTS
Ausnahmen
Funktionsgruppe
SIDMGeneral Material Data Vendor Master (General Section)
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 13436 Date: 20240523 Time: 110115 sap01-206 ( 129 ms )
