Kontakt

Ansicht
Dokumentation

C1F2_SUBSTANCES_READ - EHS: Lesen von Spezifikationsdaten (ohne Berücks. der Referenzierung)

C1F2_SUBSTANCES_READ - EHS: Lesen von Spezifikationsdaten (ohne Berücks. der Referenzierung)

Fill RESBD Structure from EBP Component Structure   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Dieser Funktionsbaustein ist Teil des Application Programming Interface (API) im EH&S für Spezifikationen. Er dient dem Lesen von Spezifikationsdaten.

Welche Spezifikationen werden gelesen?

Um die Spezifikationen zu bestimmen, zu denen das SAP-System Daten liest, muß die Tabelle X_API_HEADER_TAB Sätze enthalten, bei denen eines der folgenden Felder belegt ist:

  • Satznummer (RECN)
  • Spez.schlüssel (SUBID)

Wenn ein Eintrag in der Tabelle X_API_HEADER_TAB beide Werte enthält, wird die Satznummer zur Selektion benutzt. Wenn die Tabelle X_API_HEADER_TAB keinen Eintrag enthält, wird die Ausnahme NO_OBJECT_SPECIFIED ausgelöst.

Welche Daten werden von den Spezifikationen gelesen?

Welche Spezifikationsdaten gelesen werden, wird durch die einzelnen Kennzeichen I_FLG_xxx festgelegt, wobei ein Kennzeichen mit einer oder mehreren Ausgabetabellen wie folgt korrespondiert:

I_FLG_HEADER X_API_HEADER_TAB
I_FLG_REFSUBS E_API_REFSUBS_TAB
I_FLG_IDENT X_API_IDENT_TAB
E_API_IDENT_SUBLIST_TAB
I_FLG_IDENT_LONGTEXT E_API_IDENT_LONGTEXT_TAB
I_FLG_MATJOIN E_API_MATJOIN_TAB
I_FLG_PROPERTIES X_API_PROP_HEADER_TAB
X_API_PROP_TAB
I_FLG_PROP_DATA E_API_PROP_DATA_TAB
E_API_PROP_COMPONENT_TAB
E_API_PROP_TAB0F_TAB
I_FLG_PROP_DETAILS X_API_PROP_USAGE_TAB
E_API_PROP_RELIABILITY_TAB
E_API_PROP_SOURCE_TAB
X_API_PROP_FTEXT_TAB
E_API_PROP_TAB07_TAB
E_API_PROP_TAB0B_TAB
E_API_PROP_TAB0D_TAB
I_FLG_PROP_FTEXT_LONGTEXT X_API_PROP_FTEXT_TAB
E_API_PROP_FTEXT_LONGTEXT_TAB

Wenn ein Kennzeichen auf TRUE gesetzt ist, werden die entsprechenden Daten in die zugehörige Ausgabetabelle oder in die zugehörigen Ausgabetabellen gestellt. Wenn ein Kennzeichen auf TRUE gesetzt, aber keine zugehörige Ausgabetabelle angegeben ist, wird die Ausnahme PARAMETER_ERROR ausgelöst.

Außerdem kann die Datenselektion wie folgt eingeschränkt werden:

  • nur Identifikator-Langtexte zu bestimmten Identifikatoren (Vorgabe in X_API_IDENT_TAB)
  • nur Bewertungen zu bestimmten Bewertungsarten (Vorgabe in X_API_PROP_HEADER_TAB)
  • nur Bewertungen mit bestimmter Verwendung (Vorgabe in X_API_PROP_USAGE_TAB)
  • nur Bewertungen, die eine Verwendung haben, für die der Benutzer berechtigt ist (I_FLG_PROP_CHECK_AUTH_BY_USAGE = TRUE)
  • nur Bewertungs-Detaildaten zu bestimmten Bewertungen (Vorgabe in X_API_PROP_TAB; die zugehörigen Bewertungsartkopfdaten X_API_PROP_HEADER_TAB sollten ebenfalls gefüllt sein)
  • nur Bewertungs-Langtexte zu bestimmten Freitexten (Vorgabe in X_API_PROP_FTEXT_TAB)

Die jeweilige Vorgabe wird überschrieben, wenn die entsprechenden Daten ebenfalls angefordert werden (also das entsprechende Kennzeichen und Szenario gesetzt ist).

Wie und wofür werden die Daten gelesen?

Das sog. Szenario I_SCENARIO bestimmt, wie die Spezifikationsdaten gelesen werden, also "zum Anzeigen" (unsicher oder sicher, d.h. mit oder ohne shared Sperre) oder "zum Ändern". Innerhalb eines Szenarios gibt es maximal vier Ebenen, für die einzeln die Leseart festgelegt werden kann. Jede Ausgabetabelle ist dabei einer Ebene wie folgt zugeordnet:

Ebene 1, Kopfebene (Header): X_API_HEADER_TAB
Ebene 2 (Level 2): E_API_REFSUBS_TAB
X_API_IDENT_TAB
E_API_IDENT_LONGTEXT_TAB
E_API_IDENT_SUBLIST_TAB
E_API_MATJOIN_TAB
X_API_PROP_HEADER_TAB
X_API_PROP_TAB
E_API_PROP_DATA_TAB
E_API_PROP_COMPONENT_TAB
E_API_PROP_TAB0F_TAB
Ebene 3 (Level 3): X_API_PROP_USAGE_TAB
E_API_PROP_RELIABILITY_TAB
E_API_PROP_SOURCE_TAB
X_API_PROP_FTEXT_TAB
E_API_PROP_FTEXT_LONGTEXT_TAB
E_API_PROP_TAB07_TAB
E_API_PROP_TAB0B_TAB
E_API_PROP_TAB0D_TAB

Hinweise

  • Damit das SAP-System Identifikator-Langtexte liest (I_FLG_IDENT_LONGTEXT = TRUE), muß eine der folgenden Bedingungen erfüllt sein, sonst bricht die Funktion mit der Ausnahme PARAMETER_ERROR ab:
  • Der Aufrufer muß die zugehörigen Identifikatoren ebenfalls anfordern

(I_FLG_IDENT = TRUE und Ausgabetabelle X_API_IDENT_TAB im Aufruf angegeben).
  • Der Aufrufer muß die zugehörigen Identifikatoren in der Tabelle X_API_IDENT_TAB an die Funktion übergeben.

  • Um die Bewertungsarten zu bestimmen, muß die Tabelle X_API_PROP_HEADER_TAB Sätze enthalten, bei denen eines der folgenden Felder belegt ist:
  • Satznummer (RECN)

  • Bewertungsartschlüssel (ESTCAT)

  • Damit die Merkmalsbewertungen (I_FLG_PROP_DATA = TRUE) in der Reihenfolge in die Tabelle E_API_PROP_DATA_TAB gestellt werden, wie sie auch im Dialog erscheinen, muß das Kennzeichen I_FLG_SORT_PROP_DATA = TRUE gesetzt werden. Beachten Sie dabei, daß die Sortierung zusätzlich Zeit und damit Performance kostet.

  • Damit in der Tabelle X_API_PROP_DATA_TAB auch unbewertete Merkmale zurückliefert werden, muß das Kennzeichen I_FLG_READ_ALL_CHARACT = TRUE gesetzt werden.

  • Damit das System nur die Bewertungen liest (I_FLG_PROPERTIES = TRUE), für deren Verwendung der Benutzer eine Berechtigung besitzt, muß das Kennzeichen I_FLG_PROP_CHECK_AUTH_BY_USAGE = TRUE gesetzt werden. Ist das Kennzeichen gleich FALSE, werden alle Bewertungsinstanzen zurückgeliefert, auch die, für die der Benutzer evtl. keine Berechtigung gemäß Verwendung besitzt. Diese sind jedoch mit einer Warnung markiert (X_API_PROP_TAB-ERRORMODE = ESPAP_ERRORMODE-WARNING). Auf welche Aktivität (Anzeigen oder Ändern) die Berechtigung geprüft wird, hängt vom gewählten Szenario ab.

  • Damit das System nur die Bewertungen liest, die eine bestimmte Verwendung haben (I_FLG_PROPERTIES = TRUE, Ausgabetabelle X_API_PROP_TAB angegeben) kann eine Verwendung in der Tabelle X_API_PROP_USAGE_TAB angegeben werden. Pro Eintrag müssen folgende Felder definiert werden:
  • Einstufung (VACLID)

  • Gültigkeitsraum (RVLID)

  • Aktivkennzeichen (ACTVFLG = 'X')

Ist das Kennzeichen I_FLG_PROP_CHECK_AUTH_BY_USAGE = TRUE gesetzt, wird die vorgegebene Verwendung zuerst einer Berechtigungsprüfung unterzogen, d.h. enthält die vorgegebene Verwendung Einträge, für die der Benutzer keine Berechtigung besitzt, werden diese Einträge entfernt. Somit werden nur Bewertungen gelesen, die die vorgegebene Verwendung besitzen und für die der Benutzer berechtigt ist.

  • Damit Bewertungs-Langtexte gelesen werden (I_FLG_PROP_FTEXT_LONGTEXT = TRUE), muß eine der folgenden Bedingungen erfüllt sein, sonst bricht die Funktion mit der Ausnahme PARAMETER_ERROR ab.
  • Der Aufrufer muß die zugehörigen Freitexte ebenfalls anfordern (I_FLG_PROP_DETAILS = TRUE und Ausgabetabelle X_API_PROP_FTEXT_TAB im Aufruf angegeben).

  • Der Aufrufer muß die zugehörigen Freitexte in der Tabelle X_API_PROP_FTEXT_TAB an die Funktion übergeben

  • Eine intern evtl. ausgeschaltete Berechtigungsprüfung (LG_FLG_NO_AUTH_CHECK = TRUE) wird am Ende dieser Funktion bedingungslos wieder eingeschaltet.

Weiterführende Informationen

  • Typgruppe ESPAP
  • Typgruppe ESPRH




Parameter

E_API_APPLSCP_TAB
E_API_IDENT_LONGTEXT_TAB
E_API_IDENT_SUBLIST_TAB
E_API_MATJOIN_TAB
E_API_PROP_CARR_TAB
E_API_PROP_COMPONENT_TAB
E_API_PROP_DATA_LANGU_TAB
E_API_PROP_DATA_TAB
E_API_PROP_FTEXT_LONGTEXT_TAB
E_API_PROP_PACK_TAB
E_API_PROP_RELIABILITY_TAB
E_API_PROP_SOURCE_TAB
E_API_PROP_SPROV_TAB
E_API_PROP_TAB07_TAB
E_API_PROP_TAB0B_TAB
E_API_PROP_TAB0D_TAB
E_API_PROP_TAB0F_TAB
E_API_REFSUBS_TAB
E_API_STATUS_TAB
E_API_TPLREL_TAB
E_FLG_ERROR
E_FLG_LOCKFAIL
E_FLG_WARNING
I_ADDINF
I_FLG_APPLSCP
I_FLG_DANG_GOOD_DATA
I_FLG_GET_NUM_VALS_FOR_LANGUS
I_FLG_HEADER
I_FLG_HEADER_USAGE
I_FLG_IDENT
I_FLG_IDENT_LONGTEXT
I_FLG_IDENT_SUBLIST
I_FLG_IDENT_USAGE
I_FLG_KEY_DATE_SWITCH_ONLY
I_FLG_MATJOIN
I_FLG_NO_AUTH_CHECK
I_FLG_PROPERTIES
I_FLG_PROP_CARR
I_FLG_PROP_CHAR_DATA
I_FLG_PROP_CHECK_AUTH_BY_USAGE
I_FLG_PROP_COMP
I_FLG_PROP_DATA
I_FLG_PROP_DETAILS
I_FLG_PROP_FTEXT
I_FLG_PROP_FTEXT_LONGTEXT
I_FLG_PROP_PACK
I_FLG_PROP_REL
I_FLG_PROP_SOURCE
I_FLG_PROP_SPROV
I_FLG_PROP_TAB07
I_FLG_PROP_TAB0B
I_FLG_PROP_TAB0D
I_FLG_PROP_TAB0F
I_FLG_PROP_USAGE
I_FLG_READ_ALL_CHARACT
I_FLG_REFSUBS
I_FLG_RETURN_WHOLE_INTERVAL
I_FLG_SHOW_LOCAL_INH_REC
I_FLG_SKIP_AUTH_ERRORS
I_FLG_SKIP_AUTH_MESSAGES
I_FLG_SKIP_RECNTPH
I_FLG_SORT_PROP_DATA
I_FLG_STATUS_ALLOCS
I_FLG_TPLREL
I_FLG_USG_AND
I_FLG_VAL_CHECK_BY_STATUS
I_FLG_WITH_INH_DATA
I_LANGU_TAB
I_LSADM
I_SCENARIO
I_SCENARIO_CALLBACK_FUNC
I_USAGECHECK
I_VALFR
I_VALTO
X_API_HEADER_TAB
X_API_IDENT_TAB
X_API_PROP_FTEXT_TAB
X_API_PROP_HEADER_TAB
X_API_PROP_TAB
X_API_PROP_USAGE_TAB
X_FURTHER_PARAMS

Ausnahmen

CONVMODE_SET_FAILED
INTERNAL_ERROR
INTERVAL_ACCESS_ERROR
KEYDATE_OR_CHANGENUMBER_ERROR
NO_OBJECT_SPECIFIED
PARAMETER_ERROR

Funktionsgruppe

C1F2

PERFORM Short Reference   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 13476 Date: 20240523 Time: 094256     sap01-206 ( 180 ms )