Ansicht
Dokumentation

C1F5_SPECIFICATIONS_READ - EHS: Read Specification Data - New

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 R3up  
This documentation is copyright by SAP AG.
SAP E-Book

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__LOG_KEY_TAB. The caller can fill the logical key attributes of the object classes with values here. Then only the objects that belong to this logical key are output by the API function module.

    Parameters

    • 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_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

    Exceptions

    Function Group

    C1F5

    PERFORM Short Reference   PERFORM Short Reference  
    This documentation is copyright by SAP AG.

    Length: 10232 Date: 20240523 Time: 075550     sap01-206 ( 118 ms )