Kontakt

Ansicht
Dokumentation

C1F5_SPECIFICATIONS_READ - EHS: Lesen von Spezifikationsdaten - neu

C1F5_SPECIFICATIONS_READ - EHS: Lesen von Spezifikationsdaten - neu

Addresses (Business Address Services)   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Schnittstelle

Abhängigkeit der Objektklassen

Die Schnittstelle des Application-Programming-Interface (API)- Funktionsbausteins zum Lesen von Spezifikationsdaten besitzt für jede Objektklasse eine flach verzweigte Tabelle, siehe Abhängigkeit der Objektklassen.

Szenarioparameter

Mit Hilfe des Szenarioparameters I_SCENARIO gibt der Aufrufer an,

  • welche Objektklasse gelesen werden soll
  • für welche Bearbeitungsart (Anzeigen ohne/mit Lesesperre, Anlegen, Ändern) die Daten gelesen werden sollen

Der Szenarioparameter besitzt für jede Objektklasse eine Komponente vom ABAP-Typ C der Länge 1, der jeweils einer der folgenden Werte übergeben werden kann (hierzu gibt es Konstanten in der Include-Datei CBUI08):

  • ' ': nicht lesen
  • 'N': lesen für das Informationssystem (keine Sperren absetzen)
  • 'S': lesen zum Anzeigen (Daten mit Lesesperren schützen)
  • 'X': lesen zum Ändern (Daten mit Schreibsperren schützen)

Aufruf der Unterobjekte

Standardmäßig liest der Aufrufer mit dem API-Funktionsbaustein alle direkten und indirekten Unterobjekte zu einer bestimmten Menge von übergebenen Objekten.

Beispiel:

Wenn der Aufrufer die gesetzlichen Listen, die Verwendungen und die Langtexte zu einer bestimmten Menge von Identifikatoren lesen möchte, muss er Folgendes angeben:
  • In der Tabelle X_IDENTIFIER_TAB die Objekte (d.h. die Identifikatoren).

  • Alle direkten und indirekten übergeordneten Vaterobjekte der Objekte, in diesem Fall die Spezifikationsköpfe der Identifikatoren in der Tabelle X_SPEC_HEAD_TAB.

Gemäß der Szenariokomponenten werden dann die Unterobjekte der Identifikatoren in folgende Tabellen gestellt:
  • X_REGULATORY_LIST_TAB

  • X_IDENTIFIER_USAGE_TAB

  • X_IDENT_LONGTEXT_TAB

Filtertechniken

Standardmäßig gibt es folgende Filtertechniken, mit denen der Aufrufer die zu lesende Menge der Unterobjekte einschränken kann:

  • Der Aufrufer kann das Feld RECN der Unterobjekttabellen mit Werten vorbelegen. Dann werden nur die Unterobjekte herausgegeben, die zu diesen RECN-Werten passen.
Wenn der Aufrufer ein ganzes Zeitintervall liest, werden alle zugehörigen Änderungsstände zu diesen RECN-Werten herausgegeben.
  • Zu jeder Objektklasse gibt es eine weitere optionale Tabelle mit der Namensgebung I__LOG_KEY_STAB. Der Aufrufer kann hier die logischen Schlüsselattribute der Objektklassen mit Werten vorbelegen. Es werden dann nur die Objekte vom API-Funktionsbaustein herausgegeben, die zu diesen logischen Schlüsseln gehören.

Parameter

  • I_ADDINF

  • I_VALFR

  • I_VALTO

  • I_FLG_KEY_DATE_SWITCH_ONLY

  • I_FLG_RETURN_WHOLE_INTERVAL

  • Parameter zur Sprachenbehandlung:
I_LSADM
  • Weitere Parameter:
  • I_FLG_WITH_REF_DATA (mit referenzierten Bewertungsköpfen lesen)

  • I_FLG_WITH_INH_DATA (mit vererbten Identifikatoren und Bewertungsinstanzen lesen)

  • I_FLG_WITH_INH_REC_PNTRS (falls I_FLG_WITH_INH_DATA= ' ' (Kennzeichen nicht gesetzt), mit vererbten Bewertungsinstanz-Zeigern lesen)

  • I_FLG_DANG_GOOD_DATA (mit Gefahrgutdaten lesen. Zu den angegebenen UN-Listenstoffen werden alle Identifikatoren und Bewertungsdaten ermittelt und dem Gesamtergebnis hinzugefügt.)

  • I_USAGECHECK (Vergleichsmodus für Verwendungen (siehe Datenelement ESEUSGCCK))

  • I_USAGE_TAB (Verwendungen zum Herausfiltern von Identifikatoren und Bewertungsinstanzen)

  • I_FLG_SORT_PROP_DATA (Bewertungsdaten sortiert lesen)

  • I_FLG_READ_ALL_CHARACT (auch Merkmale ohne Wert lesen)

  • I_FLG_GET_NUM_VALS_FOR_LANGUS (X_CHARACT_DATA_LANGU_TAB befüllen)

  • X_CHARACT_DATA_LANGU_TAB (nummerische Bewertungen mit Einheiten zu den Sprachen in der Tabelle I_LANGU_TAB)

  • I_LANGU_TAB ( Sprachen für die Befüllung von X_CHARACT_DATA_LANGU_TAB)

  • I_FLG_STATUS_CHECK (Prüfung: Status erlaubt Bearbeitung des Identifikators oder der Bewertungsinstanz)

  • I_FLG_NO_AUTH_CHECK (keine Berechtigungsprüfungen)

Das Kennzeichen ermöglicht, beim Lesen die Berechtigungsprüfungen abzuschalten, wie es z.B. innerhalb des Verwendungsnachweises beim Löschen notwendig ist. Beachten Sie jedoch, dass bei gesetztem Kennzeichen der Sachbearbeiter Daten zur Anzeige bringen, zu denen er nicht berechtigt ist.
  • Parameter zur Mitteilung von Fehlern und Warnungen:
  • E_FLG_INTERNAL_ERROR

  • E_FLG_ERROR

  • E_FLG_WARNING

  • E_ERROR_TAB (vom Typ ESPAP_EXTERROR_TAB_TYPE in der Typgruppe ESPAP)

Logik

Der API-Funktionsbaustein zum Lesen von Spezifikationsdaten umfasst folgende Funktionen:

  • Aufruf der Leseroutine für den Wurzelknoten Spezifikationskopf.
  • Zuvorige Sicherstellung, dass die übergebenen internen Tabellen korrekt sortiert sind.
  • Prüfung und Korrekur der übergebenen Szenarioparameter für die einzelnen Objektklassen, damit zu angeforderten Unterobjekten stets auch die übergeordneten Vaterobjekte gelesen werden.
  • Sicherstellung, dass die Tabelle der Spezifikationsköpfe gefüllt ist, indem gegebenenfalls die RECNROOT-Werte der übrigen übergebenen Datensätze in die Tabelle gestellt werden.
  • Sicherstellung, dass alle Prüfungen grundsätzlich stattfinden. Es ist nicht möglich, alle Prüfungen generell abzuschalten.
  • Nachlesen aller übergebenen Datensätze und Sperrung, falls nötig.

Beispiel

Hinweise

Weiterführende Informationen





Parameter

E_ERROR_TAB
E_FLG_ERROR
E_FLG_INTERNAL_ERROR
E_FLG_WARNING
E_SCENARIO
I_ADDINF
I_ASSESSMENT_LGK_STAB
I_CARRIAGE_LGK_STAB
I_CHARACT_DATA_LGK_STAB
I_COMPOSITION_LGK_STAB
I_FLG_DANG_GOOD_DATA
I_FLG_DB_SEARCH_AT_BIG_BUFFER
I_FLG_FILTER_INACTIVE_USAGE
I_FLG_GET_NUM_VALS_FOR_LANGUS
I_FLG_KEY_DATE_SWITCH_ONLY
I_FLG_NO_AUTH_CHECK
I_FLG_READ_ALL_CHARACT
I_FLG_RETURN_WHOLE_INTERVAL
I_FLG_SKIP_AUTH_MESSAGES
I_FLG_SKIP_RECNTPH
I_FLG_SKIP_RH_CNTNT_CHECK
I_FLG_SORT_PROP_DATA
I_FLG_STATUS_CHECK
I_FLG_WITH_INH_DATA
I_FLG_WITH_INH_REC_PNTRS
I_FLG_WITH_REF_DATA
I_FLG_WITH_REF_DATA_OVRWR
I_IDENTIFIER_LGK_STAB
I_IDENTIFIER_USAGE_LGK_STAB
I_IDENT_LONGTEXT_LGK_STAB
I_LANGU_TAB
I_LSADM
I_MATERIAL_LGK_STAB
I_PACKAGING_LGK_STAB
I_PACK_CODE_APPR_LGK_STAB
I_REFERENCE_LGK_STAB
I_REGULATORY_LIST_LGK_STAB
I_RELATION_LGK_STAB
I_RESTRICTION_LGK_STAB
I_RISK_CLASS_LGK_STAB
I_SCENARIO
I_SCENARIO_CALLBACK_FUNC
I_SOURCE_LGK_STAB
I_SPEC_PROV_PACK_LGK_STAB
I_STATUS_LGK_STAB
I_TRANSPORT_APPR_LGK_STAB
I_TRANSPORT_CLASS_LGK_STAB
I_USAGECHECK
I_USAGE_TAB
I_USER_DEF_TEXT_LGK_STAB
I_USR_DEF_LONGTEXT_LGK_STAB
I_VALFR
I_VALTO
I_VALUATION_HEAD_LGK_STAB
I_VALUATION_INST_LGK_STAB
I_VALUATION_USAGE_LGK_STAB
X_ASSESSMENT_TAB
X_CARRIAGE_TAB
X_CHARACT_DATA_LANGU_TAB
X_CHARACT_DATA_TAB
X_COMPOSITION_TAB
X_FURTHER_PARAMS
X_IDENTIFIER_TAB
X_IDENTIFIER_USAGE_TAB
X_IDENT_LONGTEXT_TAB
X_MATERIAL_TAB
X_PACKAGING_TAB
X_PACK_CODE_APPR_TAB
X_REFERENCE_TAB
X_REGULATORY_LIST_TAB
X_RELATION_TAB
X_RESTRICTION_TAB
X_RISK_CLASS_TAB
X_SOURCE_TAB
X_SPEC_HEAD_TAB
X_SPEC_PROV_PACK_TAB
X_STATUS_TAB
X_TRANSPORT_APPR_TAB
X_TRANSPORT_CLASS_TAB
X_USER_DEF_TEXT_TAB
X_USR_DEF_LONGTEXT_TAB
X_VALUATION_HEAD_TAB
X_VALUATION_INST_TAB
X_VALUATION_USAGE_TAB

Ausnahmen

Funktionsgruppe

C1F5

Addresses (Business Address Services)   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 10966 Date: 20240523 Time: 113253     sap01-206 ( 137 ms )