Ansicht
Dokumentation

RPY_ENTITY_SELECT - Entitätstypen lesen

RPY_ENTITY_SELECT - Entitätstypen lesen

BAL Application Log Documentation   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Der Funktionsbaustein RPY_ENTITY_SELECT liest Grundinformationen zu EINEM oder MEHREREN Entitätstypen oder ALLEN Entitätstypen des Data Modeler und übergibt sie in Form von Tabellen.

Selektiert wird über ein Muster. Sie können sowohl für die Id der Entitätstypen als auch für deren Kurzbeschreibungen Muster eingeben. Muster enthalten normalen Text sowie Sonderzeichen. Dabei steht '_' für irgendein beliebiges Zeichen, '%' steht für eine Folge von keinem, einem oder beliebig vielen Zeichen. Achten Sie dabei bitte auf Groß- und Kleinschreibung.

Beispiel:

  • 'FI%' steht für alle Zeichenketten, die mit 'FI' beginnen

  • '%aterial%' steht für alle Zeichenketten, die die Teil-Zeichenkette 'aterial' enthalten (z.B. 'Material', 'Werksmaterial', ...)

Gelesen werden nur die Grundinformationen zu den Entitätstypen. Wenn Sie weitere Informationen benötigen, so können sie diese mittels RPY_ENTITY_MULTI_READ aufgrund der bekannten Ids der Entitätstypen nachlesen.

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 1. Aufruf können Sie alle Grundinformationen zu den Entitätstypen lesen, deren Kurzbeschreibungen das deutsche Wort 'Werk' enthalten.

Mit dem 2. Aufruf können Sie die Grundinformationen aller vorhandener Entitätstypen einlesen.

* Declaration of variables
data: t_errors       like rpygser occurs 10 with header line,
      t_entity_infos like rpydmen occurs 10.

* 1. call: find entity types which contain the
* german word 'Werk' in their short description
refresh t_errors. refresh t_entity_infos.
call function 'RPY_ENTITY_SELECT'
     exporting
          cico_mode          = 'R'
          cico_request_no    = ' '
          entity_id_pattern  = ' '
          short_text_pattern = '%Werk%'
          language           = 'D'
     tables
          errors             = t_errors
          entity_infos       = t_entity_infos.
* Error handling
loop at t_errors.
  if ...
    ...
  endif.
endloop.

* 2. call: find ALL entity types
refresh t_errors. refresh t_entity_infos.
call function 'RPY_ENTITY_SELECT'
     exporting
          cico_mode          = 'R'
          cico_request_no    = ' '
          entity_id_pattern  = '%'
          short_text_pattern = ' '
          language           = sy-langu
     tables
          errors             = t_errors
          entity_infos       = t_entity_infos.
* Error handling
loop at t_errors.
  if ...
    ...
  endif.
endloop.

Weiterführende Informationen

Weitergehende Informationen zu den Strukturen und Tabellen, die im Aufruf von RPY_ENTITY_SELECT 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

CICO_MODE
CICO_REQUEST_NO
ENTITY_ID_PATTERN
ENTITY_INFOS
ERRORS
LANGUAGE
SHORT_TEXT_PATTERN

Ausnahmen

Funktionsgruppe

SIDM

Addresses (Business Address Services)   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 8377 Date: 20240523 Time: 111316     sap01-206 ( 82 ms )