Ansicht
Dokumentation
C1F5_SPECIFICATIONS_READ - EHS: Read Specification Data - New
BAL_S_LOG - Application Log: Log header data SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3upThis documentation is copyright by SAP AG.
Functionality
Interface
Object Class Dependency
The interface for the Application Programming Interface (API) function module to read specification data has a flat branched table for each object class, see Object Class Dependency.
Scenario Parameters
Using the scenario parameter I_SCENARIO, the caller specifies:
- Which object class is to be read
- For which type of editing (display with/without read lock, create, change) the data is to be read
The scenario parameter has a component of ABAP type C of length 1 for each object class, to which one of the following values can be passed respectively (there are constants to do this in the Include file CBUI08):
- ' ': Do not read
- 'N': Read for information system (do not set lock)
- 'S': Read for display (protect data with read locks)
- 'X': Read for change (protect data with write locks)
Call of Subobjects
As standard, the caller uses the API function module to read all direct and indirect subobjects for a specific set of transferred objects.
Example:
- If the caller wants to read the regulatory lists, the usages, and the long texts for a specific set of identifiers, it must specify the following:
- In the table X_IDENTIFIER_TAB the objects (that is, the identifiers)
- All direct and indirect higher-level parent objects of the objects, in this case the specification headers of the identifiers in the table X_SPEC_HEAD_TAB
- The subobjects of the identifiers are then placed in the following tables according to the scenario components:
- X_REGULATORY_LIST_TAB
- X_IDENTIFIER_USAGE_TAB
- X_IDENT_LONGTEXT_TAB
Filter Methods
As standard there are the following filter methods with which the caller can restrict the set of subobjects to be read:
- The caller can fill the RECN field for the subobject tables with values. Then only those subobjects are output that match these RECN values.
- If the caller reads a whole time interval, all corresponding change states for these RECN values are output.
- For each object class there is another optional table with the name I_
Parameters
- Parameters for specifying the time period for which the data is to be read (see also Interval-Based Read and Write of Data Records):
- I_ADDINF
- I_VALFR
- I_VALTO
- I_FLG_KEY_DATE_SWITCH_ONLY
- I_FLG_RETURN_WHOLE_INTERVAL
- Parameters for language handling:
- I_LSADM
- Other parameters:
- I_FLG_WITH_REF_DATA (Read with referenced value assignment headers)
- I_FLG_WITH_INH_DATA (Read with inherited identifiers and value assignment instances)
- I_FLG_WITH_INH_REC_PNTRS (if I_FLG_WITH_INH_DATA = ' ' (indicator not set), read with inherited value assignment instance pointers)
- I_FLG_DANG_GOOD_DATA (Read with dangerous goods data. All identifiers and value assignment data are determined for the specified UN-listed substances and the total result added.)
- I_USAGECHECK (Comparison mode for usages (see data element ESEUSGCCK))
- I_USAGE_TAB (Usages to filter out identifiers and value assignment instances)
- I_FLG_SORT_PROP_DATA (Read value assignment data sorted)
- I_FLG_READ_ALL_CHARACT (Read characteristics without value)
- I_FLG_GET_NUM_VALS_FOR_LANGUS (Fill X_CHARACT_DATA_LANGU_TAB)
- X_CHARACT_DATA_LANGU_TAB (Numeric value assignments with units for the languages in the table I_LANGU_TAB)
- I_LANGU_TAB (Languages for filling X_CHARACT_DATA_LANGU_TAB)
- I_FLG_STATUS_CHECK (Check: status allows edit of identifier or value assignment instance)
- I_FLG_NO_AUTH_CHECK (No authorization checks)
- This indicator makes it possible to deactivate the authorization checks
- when reading, as is necessary, for example, in the where-used list when deleting. Note, however, that when the indicator is set, persons processing data can display data for which they are not authorized.
- Parameters for notifying errors and warnings:
- E_FLG_INTERNAL_ERROR
- E_FLG_ERROR
- E_FLG_WARNING
- E_ERROR_TAB (of type ESPAP_EXTERROR_TAB_TYPE in type group ESPAP)
Logic
The API function module for reading specification data includes the following functions:
- Call of read routine for root node specification header
- Prior check that transferred internal tables are sorted correctly
- Check and correction of passed scenario parameters for the individual object classes so that the higher-level parent objects are always read for requested subobjects.
- Guarantee that the table for specification headers is filled by placing the RECNROOT values of the remaining transferred data records in the table if necessary
- Guarantee that all checks are made. It is not possible to deactivate all checks.
- Read all transferred data records and lock if necessary.
Example
Notes
Further information
Parameters
E_ERROR_TABE_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
Exceptions
Function Group
C1F5PERFORM Short Reference PERFORM Short Reference
This documentation is copyright by SAP AG.
Length: 10232 Date: 20240523 Time: 075550 sap01-206 ( 118 ms )