Ansicht
Dokumentation

OLR3_RFC_GET_DATA - Datenbeschaffung im R/3 für ein Objekt oder mehrere Objekte

OLR3_RFC_GET_DATA - Datenbeschaffung im R/3 für ein Objekt oder mehrere Objekte

General Data in Customer Master   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

In cProjects existiert zu einer Objektart eine Objektverknüpfung im SAP-System.

Abhängig vom Kontext in cProjects ist die Variable EV_CONTEXT gesetzt:

  1. Wenn Daten zum verknüpften Objekt im Zuge der Auswertung gelesen werden, wird in SAP der vorliegende Funktionsbaustein OLR3_RFC_GET_DATA via RFC mit EV_CONTEXT = 'EVALUATION' gerufen.
    In diesem Fall enthält der Datencontainer ET_DATA_BODY bzw. IT_DATA_BODY alle objektverknüpften Objekte zu einem Projekt in cProjects mit einer Objektart, die in dieses SAP-System zeigen.
  2. Wenn für die Objektart im Customizing der Collaboration Projects unter SAP-Schnittstelle --> Einstellungen zu den verknüpften SAP-Objektenvornehmen --> Objektarten für Objektverknüpfungen das Kennzeichen Daten lesen gesetzt ist und der Anwender in cProjects in der Liste der Objektverknüpfungen auf die Identifikation eines verknüpften Objekts klickt, wird in SAP der vorliegende Funktionsbaustein via RFC mit EV_CONTEXT = ' ' gerufen. In diesem Fall enthält der Datencontainer ET_DATA_BODY bzw. IT_DATA_BODY nur genau dieses verknüpfte Objekt.

Die Tabelle DATA im Datencontainer enthält die Felder, die im Customizing der Collaboration Projects definiert wurden (siehe SAP-Schnittstelle --> Einstellungen zu den verknüpften SAP-Objekten vornehmen --> Felder je Objektart).

Der vorliegende Funktionsbaustein ermittelt die unkonvertierten Feldinhalte und gibt diese Werte nach cProjects zurück. Dort gehen die Feldinhalte in das Auswertungs-XML mit ein.

Die Tabelle DATA im Datencontainer enthält die im Customizing der Collaboration Projects definierten Felder (siehe SAP-Schnittstelle --> Einstellungen zu den verknüpften SAP-Objektenvornehmen --> Felder je Rahmen). Dieser Funktionsbaustein ermittelt jeweils den sprachabhängigen Feldbezeichner (laut Anmeldesprache in cProjects, Variable EV_LANGU) und den Wert des Feldes. Das Ergebnis dieser Datenbeschaffung wird im Detailbild des verknüpften Objekts dargestellt.

Diese Datenbeschaffung in ihrer Gesamtheit erfolgt jedoch nur, wenn der Anwender, der in SAP angemeldet ist, die RFC-Berechtigung für die Funktionsgruppe OLR3_RFC besitzt. Die Prüfung erfolgt mit Hilfe des Funktionsbausteins AUTHORITY_CHECK_RFC.

Die Datenbeschaffung für ein konkretes Objekt im Datencontainer ET_DATA_BODY bzw. IT_DATA_BODY erfolgt nur, wenn der in SAP angemeldete Anwender die Anzeigeberechtigung für dieses konkrete Objekt besitzt. Hierfür wird die Methode CHECK_CONSISTENCY mit der Defaultprüfung AUTH_DISP und der Verprobungstabelle/dem Verprobungsview aus der Variablen TABNAME_AUTH verwendet.

Bei fehlender Anzeigeberechtigung zeigt das System in der Auswertung bzw. im Detailbild keine Daten zu diesem Objekt an.

Wenn die Anzeigeberechtigung für ein Objekt existiert, wird für die aktuelle SAP-Proxy-Klasse EV_PROXY_CLASS die Methode GET_DATA gerufen, die ihrerseits die generische Methode GET_DATA in der Klasse CL_R3_OLR3_METHODS ruft. Dort erfolgt die Datenbeschaffung für die Felder im Datencontainer ET_DATA_BODY bzw. IT_DATA_BODY. Der Datencontainer ist wie folgt aufgebaut:

OBJECT_TYPE Objektart aus cProjects
INT_ID_STRING Interner Schlüssel des verknüpften Objekts als String
PROXY_CLASS Proxy-Klasse der SAP-Objektverknüpfung in SAP
EXT_ID Externe Schlüsselfelder in Tabellenform
INT_ID Interne Schlüsselfelder in Tabellenform
TABNAME Tabellen/Views aus denen generisch gelesen wird
TABNAME_EXT Tabelle/View zur Ermittlung des externen Schlüssels
TABNAME_AUTH Tabelle/View für die Prüfung der Anzeigeberechtigung
DATA Dateninhalt

Für jedes Feld in DATA existiert ein Tabelleneintrag:

OLR3_TAB_KEY Technischer Feldname
OLR3_TAB_KEY_EVA Technischer Feldname für die Auswertung
OLR3_TAB_TABLE Name der Tabelle/des Views aus OLR3_TAB_KEY
OLR3_TAB_FIELD Name des Feldes aus aus OLR3_TAB_KEY
OLR3_TAB_VALUE Feldinhalt
OLR3_TAB_LABEL Sprachabhängige Feldbezeichnung
RETURNCODE Returnparameter

In der generischen Methode GET_DATA erfolgt zunächst ein generischer Select. TABNAME enthält die Tabellen/Views, aus denen generisch gelesen wird (siehe Customizing der Collaboration Projects unter SAP-Schnittstelle --> Einstellungen zu den verknüpften SAP-Objektenvornehmen --> Tabelle/View im SAP-System je Objektart und Methode).

RETURNCODE

Der interne Schlüssel des Objekts ist als String in INT_ID_STRING und als Tabelle in INT_ID redundant vorhanden.

In diesem Funktionsbaustein wird nur INT_ID verwendet. Der String INT_ID_STRING wird nur als Information übergeben. Für die Auswertung (EV_CONTEXT = 'EVALUATION') existiert in cProjects ein Puffer, der den String aus INT_ID_STRING als Key verwendet.

Danach erfolgt über das BAdI OLR3_DATA ein nicht-generischer Select (siehe Dokumentation zu OLR3_DATA und zur Methode AT_GET_DATA). Wenn für den aktuellen SAP-Objekttyp in cProjects ein (interner) Schlüssel und eine (externe) Identifikation definiert ist, wird vor Aufruf des BAdIs mit dem internen Schlüssel INT_ID und der Tabelle/dem View aus der Variablen TABNAME_EXT über die Methode CHECK_EXISTENCE der externe Schlüssel in EXT_ID ermittelt.

Somit werden im Interface der BAdI-Methode AT_GET_DATA folgende Daten übergeben:

  • der Schlüssel
  • die Identifikation (soweit vorhanden)
  • die Objektart
  • der Name der SAP-Proxy-Klasse

Dies ermöglicht eine flexible Ausprogrammierung der BAdI-Methode.

RETURNCODE RETURNCODE
EV_CONTEXT   Kontext, in dem dieser Baustein aufgerufen wird
EV_LANGU   Anmeldesprache in cProjects
ET_DATA_BODY   Datencontainer aus cProjcts

 
IT_DATA_BODY   Datencontainer nach cProjects





Parameter

ET_DATA_BODY
EV_CONTEXT
EV_LANGU
IT_DATA_BODY

Ausnahmen

Funktionsgruppe

OLR3_RFC

TXBHW - Original Tax Base Amount in Local Currency   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 9016 Date: 20240523 Time: 053704     sap01-206 ( 246 ms )