Fonction SAP CBIH_MP30_MP_READ - EHS: Read Measurement Project Data

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
I_ADDINF RCGADDINF u 27 Additional Information on Object
I_FLG_FILL_EXTERROR ESP1_BOOLEAN 0 ESP1_FALSE X Indicator: Fill extended error information table
I_FLG_KEY_DATE_SWITCH_ONLY ESP1_BOOLEAN 0 ESP1_FALSE X Indicator: Change key date and change number only
I_FLG_MJ_HEADER ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MJ_HEADER_LTXT1 ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MJ_HEADER_LTXT2 ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MJ_HEADER_VAL ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MJ_JOIN_WA ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MJ_REFERENCE ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MJ_VALUES ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MP_EQUIPMENT ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MP_HEADER ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MP_HEADER_LTXT1 ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MP_HEADER_LTXT2 ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MP_HEADER_VAL ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MP_PLAN ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MP_PLAN_LTXT ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MP_PLMET ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MP_WA ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_MP_WA_LTXT ESP1_BOOLEAN 0 ESP1_FALSE X
I_FLG_NO_AUTH_CHECK ESP1_BOOLEAN 0 ESP1_FALSE X Indicator: Switch off authorization checks
I_FLG_READ_ALL_CHARACT ESP1_BOOLEAN 0 ESP1_FALSE X Indicator: Read all value assignments
I_FLG_RETURN_WHOLE_INTERVAL ESP1_BOOLEAN 0 ESP1_FALSE X Indicator: Read the entire time interval
I_FLG_SORT_PROP_DATA ESP1_BOOLEAN 0 ESP1_FALSE X Indicator: Return value assignments sorted
I_LANGU LANGU C 1 SY-LANGU X
I_SCENARIO ESPAP_SCENARIO_TYPE 0 Lock Scenario
I_VALFR RCGADDINF-VALDAT D 8 X Upper Time Interval Limit
I_VALTO RCGADDINF-VALDAT D 8 X Lower Time Interval Limit

Paramètre Reférence Type Long. Description
E_FLG_ERROR ESP1_BOOLEAN 0 Error reading a record indicator
E_FLG_LOCKFAIL ESP1_BOOLEAN 0
E_FLG_WARNING ESP1_BOOLEAN 0 Warning reading a record indicator

Paramètre Reférence Long. Facultatif Description
E_API_MJ_HEADER_LTXT1_TAB CIHMJ_MJLTAPI_TAB_TYPE 0 X
E_API_MJ_HEADER_LTXT2_TAB CIHMJ_MJLTAPI_TAB_TYPE 0 X
E_API_MJ_HEADER_PROP_TAB CIH01_IHPRAPI_TAB_TYPE 0 X
E_API_MJ_HEADER_TAB CIHMJ_MJAPI_TAB_TYPE 0 X
E_API_MJ_HEADER_VAL_TAB CIH01_IHVALAPI_TAB_TYPE 0 X
E_API_MJ_JOIN_WA_TAB CIHMW_MJWAAPI_TAB_TYPE 0 X
E_API_MJ_REFERENCE_TAB CIHMR_RFMJAPI_TAB_TYPE 0 X
E_API_MJ_VALUES_TAB CIHMV_MJVAAPI_TAB_TYPE 0 X
E_API_MP_EQUIPMENT_TAB CIHPD_MPDVAPI_TAB_TYPE 0 X
E_API_MP_HEADER_LTXT1_TAB CIHMP_MPLTAPI_TAB_TYPE 0 X
E_API_MP_HEADER_LTXT2_TAB CIHMP_MPLTAPI_TAB_TYPE 0 X
E_API_MP_HEADER_PROP_TAB CIH01_IHPRAPI_TAB_TYPE 0 X
E_API_MP_HEADER_VAL_TAB CIH01_IHVALAPI_TAB_TYPE 0 X
E_API_MP_PLAN_LTXT_TAB CIHPL_MPPLTAPI_TAB_TYPE 0 X
E_API_MP_PLAN_TAB CIHPL_MPPLAPI_TAB_TYPE 0 X
E_API_MP_PLMET_TAB CIHMT_MPMTAPI_TAB_TYPE 0 X
E_API_MP_WA_LTXT_TAB CIHPW_MPWLTAPI_TAB_TYPE 0 X Long Text Work Area
E_API_MP_WA_TAB CIHPW_MPWAAPI_TAB_TYPE 0 X
X_API_MP_HEADER_TAB CIHMP_MPHAPI_TAB_TYPE 0

Exception Description
CONVMODE_SET_FAILED Language Support Error
INTERNAL_ERROR Internal error or Customizing error
INTERVAL_ACCESS_ERROR Access to time intervals failed
NO_OBJECT_SPECIFIED No objects were specified in the header table
PARAMETER_ERROR Indicator set but relevant table missing

Functionality
This function module is part of theApplication ProgrammingInterface (API) of the Environment, Health and Safety (EH&S)component. It is used to read measurement project data.

Which measurement projects are read?
To determine the measurement projects, the X_API_MP_HEADER_TAB tablemust contain records in which one of the following fields is filled:

  • Record number (RECN)

  • Measurement project (MPID)

    • Which data is read by the measurement projects?
    Which data is read is specified by the different I_FLG_xxx indicators,where an indicator corresponds to one or more output tables as follows:
    I_FLG_MP_HEADER ,,X_API_MP_HEADER_TAB
    I_FLG_MP_HEADER_LTXT1 ,,E_API_MP_HEADER_LTXT1_TAB
    I_FLG_MP_HEADER_LTXT1 ,,E_API_MP_HEADER_LTXT2_TAB
    I_FLG_MP_HEADER_VAL ,,E_API_MP_HEADER_VAL_TAB
    ,,E_API_MP_HEADER_PROP_TAB
    I_FLG_MP_WA ,,E_API_MP_WA_TAB
    I_FLG_MP_WA_LTXT ,,E_API_MP_WA_LTXT_TAB
    I_FLG_MP_PLAN ,,E_API_MP_PLAN_TAB
    I_FLG_MP_PLAN_LTXT ,,E_API_MP_PLAN_LTXT_TAB
    I_FLG_MP_PLMET ,,E_API_MP_PLMET_TAB
    I_FLG_MP_EQUIPMENT ,,E_API_MP_EQUIPMENT_TAB
    I_FLG_MJ_HEADER ,,E_API_MJ_HEADER_TAB
    I_FLG_MJ_HEADER_LTXT1 ,,E_API_MJ_HEADER_LTXT1_TAB
    I_FLG_MJ_HEADER_LTXT2 ,,E_API_MJ_HEADER_LTXT2_TAB
    I_FLG_MJ_REFERENCE ,,E_API_MJ_REFERENCE_TAB
    I_FLG_MJ_VALUES ,,E_API_MJ_VALUES_TAB
    I_FLG_MJ_JOIN_WA ,,E_API_MJ_JOIN_WA_TAB
    If an indicator is set to "TRUE," the respective data is placed in thecorresponding output table(s). If an indicator is set to "TRUE," but nocorresponding output table is specified, the exception PARAMETER_ERRORis raised.

    How and for what purpose is the data read?
    The scenario I_SCENARIO determines how the measurement project data isread: "for display" (secure or nonsecure, meaning with orwithout shared lock) or "for changing."
    Within a scenario there is a maximum of two levels for which the readtype can be specified.Each output table is assigned to a level as follows:
    Level 1 ,,X_API_MP_HEADER_TAB
    ,,E_API_MP_HEADER_LTXT1_TAB
    ,,E_API_MP_HEADER_LTXT2_TAB
    Level 2 ,,E_API_MP_HEADER_VAL_TAB
    ,,E_API_MP_HEADER_PROP_TAB
    ,,E_API_MP_WA_TAB
    ,,E_API_MP_WA_LTXT_TAB
    ,,E_API_MP_PLAN_TAB
    ,,E_API_MP_PLAN_LTXT_TAB
    ,,E_API_MP_PLMET_TAB
    ,,E_API_MP_EQUIPMENT_TAB
    ,,E_API_MJ_HEADER_TAB
    ,,E_API_MJ_HEADER_LTXT1_TAB
    ,,E_API_MJ_HEADER_LTXT2_TAB
    ,,E_API_MJ_REFERENCE_TAB
    ,,E_API_MJ_VALUES_TAB
    ,,E_API_MJ_JOIN_WA_TAB
    INCLUDE EHS_FMODULE_API_INTERVAL_ACC OBJECT DOKU ID TX

936476Language-dependent reading of characteristic values