SAP C1F2_SUBSTANCES_READ_WITH_REF Function Module for NOTRANSL: EHS: Lesen von Spez.daten (mit Berücksichtigung der Referenzieru

Search SAP Function Modules

C1F2_SUBSTANCES_READ_WITH_REF is a standard c1f2 substances read with ref SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for NOTRANSL: EHS: Lesen von Spez.daten (mit Berücksichtigung der Referenzieru processing and below is the pattern details for this FM, showing its interface including any import and export parameters, exceptions etc. there is also a full "cut and paste" ABAP pattern code example, along with implementation ABAP coding, documentation and contribution comments specific to this or related objects.

See here to view full function module documentation and code listing for c1f2 substances read with ref FM, simply by entering the name C1F2_SUBSTANCES_READ_WITH_REF into the relevant SAP transaction such as SE37 or SE38.

Function Group: C1F2
Program Name: SAPLC1F2
Main Program: SAPLC1F2
Appliation area: M
Release date: N/A
Mode(Normal, Remote etc): Normal Function Module
Update:

Function C1F2_SUBSTANCES_READ_WITH_REF pattern details

In-order to call this FM within your sap programs, simply using the below ABAP pattern details to trigger the function call...or see the full ABAP code listing at the end of this article. You can simply cut and paste this code into your ABAP progrom as it is, including variable declarations.

CALL FUNCTION 'C1F2_SUBSTANCES_READ_WITH_REF'"NOTRANSL: EHS: Lesen von Spez.daten (mit Berücksichtigung der Referenzieru
  EXPORTING
   I_SCENARIO =  "
*  I_FLG_REFSUBS = ESP1_FALSE "
*  I_FLG_IDENT = ESP1_FALSE "
*  I_FLG_IDENT_SUBLIST = ESP1_TRUE "
*  I_FLG_IDENT_LONGTEXT = ESP1_FALSE "
*  I_FLG_IDENT_USAGE = ESP1_FALSE "
*  I_FLG_MATJOIN = ESP1_FALSE "
*  I_FLG_TPLREL = ESP1_FALSE "
*  I_FLG_APPLSCP = ESP1_FALSE "
*  I_FLG_PROPERTIES = ESP1_FALSE "
*  I_FLG_PROP_DATA = ESP1_FALSE "
   I_ADDINF =  "Additional Information on Object
*  I_FLG_PROP_CHAR_DATA = ESP1_FALSE "
*  I_FLG_CHAR_VAL_DESCR = ESP1_TRUE "
*  I_FLG_PROP_DETAILS = ESP1_FALSE "
*  I_FLG_PROP_COMP = ESP1_FALSE "
*  I_FLG_PROP_USAGE = ESP1_FALSE "
*  I_FLG_PROP_REL = ESP1_FALSE "
*  I_FLG_PROP_SOURCE = ESP1_FALSE "
*  I_FLG_PROP_FTEXT = ESP1_FALSE "
*  I_FLG_PROP_FTEXT_LONGTEXT = ESP1_FALSE "
*  I_FLG_PROP_TAB07 = ESP1_FALSE "
*  I_VALFR =  "Lower Time Interval Limit
*  I_FLG_PROP_TAB0B = ESP1_FALSE "
*  I_FLG_PROP_TAB0D = ESP1_FALSE "
*  I_FLG_PROP_TAB0F = ESP1_FALSE "
*  I_FLG_PROP_PACK = ESP1_FALSE "
*  I_FLG_PROP_SPROV = ESP1_FALSE "
*  I_FLG_PROP_CARR = ESP1_FALSE "
*  I_FLG_SORT_PROP_DATA = ESP1_FALSE "
*  I_FLG_READ_ALL_CHARACT = ESP1_FALSE "
*  I_FLG_PROP_CHECK_AUTH_BY_USAGE = ESP1_FALSE "
*  I_FLG_ONLY_PRIVATE_PROP = ESP1_FALSE "
*  I_VALTO =  "Upper Time Interval Limit
*  I_FLG_USG_AND = ESP1_TRUE "
*  I_FLG_NO_AUTH_CHECK = ESP1_FALSE "Indicator: Switch off authorization checks
*  I_FLG_VAL_CHECK_BY_STATUS = ESP1_FALSE "
*  I_FLG_DANG_GOOD_DATA = ESP1_FALSE "
*  I_FLG_SHOW_LOCAL_INH_REC = ESP1_FALSE "
*  I_FLG_GET_NUM_VALS_FOR_LANGUS = ESP1_FALSE "
*  I_USAGECHECK = ' ' "
*  I_FLG_REPORT_NO_AUTH_CHECK =  "
*  I_FLG_SKIP_AUTH_ERRORS = ESP1_FALSE "
*  I_FLG_WITH_INH_DATA = ESP1_TRUE "
*  I_FLG_KEY_DATE_SWITCH_ONLY = ESP1_FALSE "Indicator: Change key date and change number only
*  I_SCENARIO_CALLBACK_FUNC =  "
*  I_FLG_RETURN_WHOLE_INTERVAL = ESP1_FALSE "Indicator: Read the entire time interval
*  I_LSADM =  "Language support parameters
*  I_FLG_HEADER = ESP1_FALSE "
*  I_FLG_HEADER_USAGE = ESP1_FALSE "

 IMPORTING
   E_FLG_LOCKFAIL =  "Indicator: Lock on at least one record failed
   E_FLG_ERROR =  "Error reading a record indicator
   E_FLG_WARNING =  "Warning reading a record indicator

CHANGING
*  X_FURTHER_PARAMS =  "

TABLES
   X_API_HEADER_TAB =  "Specification Header Data
*  X_API_PROP_TAB =  "
*  E_API_PROP_DATA_TAB =  "
*  E_API_PROP_DATA_LANGU_TAB =  "
*  E_API_PROP_COMPONENT_TAB =  "
*  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_REFSUBS_TAB =  "Data of Requested Reference Specifications
*  E_API_PROP_TAB0B_TAB =  "
*  E_API_PROP_TAB0D_TAB =  "
*  E_API_PROP_TAB0F_TAB =  "
*  E_API_PROP_PACK_TAB =  "
*  E_API_PROP_SPROV_TAB =  "
*  E_API_PROP_CARR_TAB =  "
*  I_LANGU_TAB =  "Language table
*  X_API_IDENT_TAB =  "Data of Requested Identifiers
*  E_API_IDENT_LONGTEXT_TAB =  "Data of Requested Identifier Long Texts
*  E_API_IDENT_SUBLIST_TAB =  "Data of Required Ident. Specification List Assignment
*  E_API_MATJOIN_TAB =  "Data of Requested Material Assignments
*  E_API_TPLREL_TAB =  "Data of Requested Inheritance Relationships
*  E_API_APPLSCP_TAB =  "Data of Requested Scopes of Application
*  X_API_PROP_HEADER_TAB =  "

EXCEPTIONS
   NO_OBJECT_SPECIFIED = 1    PARAMETER_ERROR = 2    INTERNAL_ERROR = 3    CONVMODE_SET_FAILED = 4    INTERVAL_ACCESS_ERROR = 5 

.

Customer Function user exits

Below is a list of CUSTOMER FUNCTION exit user exits that are available within this program and maybe relevant for this FM.
EXIT_SAPLC1F2_001 EHS: Saving Additional Data in the Database

IMPORTING Parameters details for C1F2_SUBSTANCES_READ_WITH_REF

I_SCENARIO -

Data type: ESPAP_SCENARIO_TYPE
Optional: No
Call by Reference: No ( called with pass by value option)

I_FLG_REFSUBS -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_IDENT -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_IDENT_SUBLIST -

Data type: ESP1_BOOLEAN
Default: ESP1_TRUE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_IDENT_LONGTEXT -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_IDENT_USAGE -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_MATJOIN -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_TPLREL -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_APPLSCP -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROPERTIES -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_DATA -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_ADDINF - Additional Information on Object

Data type: RCGADDINF
Optional: No
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_CHAR_DATA -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_CHAR_VAL_DESCR -

Data type: ESP1_BOOLEAN
Default: ESP1_TRUE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_DETAILS -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_COMP -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_USAGE -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_REL -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_SOURCE -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_FTEXT -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_FTEXT_LONGTEXT -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_TAB07 -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_VALFR - Lower Time Interval Limit

Data type: RCGADDINF-VALDAT
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_TAB0B -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_TAB0D -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_TAB0F -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_PACK -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_SPROV -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_CARR -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_SORT_PROP_DATA -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_READ_ALL_CHARACT -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_PROP_CHECK_AUTH_BY_USAGE -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_ONLY_PRIVATE_PROP -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_VALTO - Upper Time Interval Limit

Data type: RCGADDINF-VALDAT
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_USG_AND -

Data type: ESP1_BOOLEAN
Default: ESP1_TRUE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_NO_AUTH_CHECK - Indicator: Switch off authorization checks

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_VAL_CHECK_BY_STATUS -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_DANG_GOOD_DATA -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_SHOW_LOCAL_INH_REC -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_GET_NUM_VALS_FOR_LANGUS -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_USAGECHECK -

Data type: ESTLP-USAGECHECK
Default: ' '
Optional: No
Call by Reference: No ( called with pass by value option)

I_FLG_REPORT_NO_AUTH_CHECK -

Data type: ESP1_BOOLEAN
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_SKIP_AUTH_ERRORS -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: No
Call by Reference: No ( called with pass by value option)

I_FLG_WITH_INH_DATA -

Data type: ESP1_BOOLEAN
Default: ESP1_TRUE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_KEY_DATE_SWITCH_ONLY - Indicator: Change key date and change number only

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_SCENARIO_CALLBACK_FUNC -

Data type: RS38L-NAME
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_RETURN_WHOLE_INTERVAL - Indicator: Read the entire time interval

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_LSADM - Language support parameters

Data type: EHSBS_LSADM
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_HEADER -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_FLG_HEADER_USAGE -

Data type: ESP1_BOOLEAN
Default: ESP1_FALSE
Optional: Yes
Call by Reference: No ( called with pass by value option)

EXPORTING Parameters details for C1F2_SUBSTANCES_READ_WITH_REF

E_FLG_LOCKFAIL - Indicator: Lock on at least one record failed

Data type: ESP1_BOOLEAN
Optional: No
Call by Reference: No ( called with pass by value option)

E_FLG_ERROR - Error reading a record indicator

Data type: ESP1_BOOLEAN
Optional: No
Call by Reference: No ( called with pass by value option)

E_FLG_WARNING - Warning reading a record indicator

Data type: ESP1_BOOLEAN
Optional: No
Call by Reference: No ( called with pass by value option)

CHANGING Parameters details for C1F2_SUBSTANCES_READ_WITH_REF

X_FURTHER_PARAMS -

Data type: ESPRH_FURTHER_PARAMS_TYPE
Optional: Yes
Call by Reference: Yes

TABLES Parameters details for C1F2_SUBSTANCES_READ_WITH_REF

X_API_HEADER_TAB - Specification Header Data

Data type: ESPRH_APIRH_TAB_TYPE
Optional: No
Call by Reference: No ( called with pass by value option)

X_API_PROP_TAB -

Data type: ESPRH_APIVA_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_DATA_TAB -

Data type: ESPRH_APIPR_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_DATA_LANGU_TAB -

Data type: ESPRH_APIPR_LANGU_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_COMPONENT_TAB -

Data type: ESPRH_APIVP_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

X_API_PROP_USAGE_TAB -

Data type: ESPRH_APIDU_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_RELIABILITY_TAB -

Data type: ESPRH_APIDR_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_SOURCE_TAB -

Data type: ESPRH_APIDS_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

X_API_PROP_FTEXT_TAB -

Data type: ESPRH_APIDF_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_FTEXT_LONGTEXT_TAB -

Data type: ESPRH_APIFL_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_TAB07_TAB -

Data type: ESPRH_API07_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_REFSUBS_TAB - Data of Requested Reference Specifications

Data type: ESPRH_APIRR_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_TAB0B_TAB -

Data type: ESPRH_API0B_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_TAB0D_TAB -

Data type: ESPRH_API0D_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_TAB0F_TAB -

Data type: ESPRH_API0F_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_PACK_TAB -

Data type: ESPRH_APIPACK_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_SPROV_TAB -

Data type: ESPRH_APISP_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_PROP_CARR_TAB -

Data type: ESPRH_APICARR_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

I_LANGU_TAB - Language table

Data type: ESP5_LANGUTAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

X_API_IDENT_TAB - Data of Requested Identifiers

Data type: ESPRH_APIRI_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_IDENT_LONGTEXT_TAB - Data of Requested Identifier Long Texts

Data type: ESPRH_APIIL_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_IDENT_SUBLIST_TAB - Data of Required Ident. Specification List Assignment

Data type: ESPRH_APIRL_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_MATJOIN_TAB - Data of Requested Material Assignments

Data type: ESPRH_APIMJ_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_TPLREL_TAB - Data of Requested Inheritance Relationships

Data type: ESPRH_APITPLREL_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

E_API_APPLSCP_TAB - Data of Requested Scopes of Application

Data type: EHSAS_APIAS_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

X_API_PROP_HEADER_TAB -

Data type: ESPRH_APIVH_TAB_TYPE
Optional: Yes
Call by Reference: No ( called with pass by value option)

EXCEPTIONS details

NO_OBJECT_SPECIFIED -

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

PARAMETER_ERROR - Indicator set but relevant table missing

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

INTERNAL_ERROR -

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

CONVMODE_SET_FAILED -

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

INTERVAL_ACCESS_ERROR - Access to time intervals failed

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

Copy and paste ABAP code example for C1F2_SUBSTANCES_READ_WITH_REF Function Module

The ABAP code below is a full code listing to execute function module POPUP_TO_CONFIRM including all data declarations. The code uses the original data declarations rather than the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the newer method of declaring data variables on the fly. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8), which i why i have stuck to the origianl for this example.

ABAP code using 7.40 inline data declarations to call FM C1F2_SUBSTANCES_READ_WITH_REF

The below ABAP code uses the newer in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. Please note some of the newer syntax below, such as the @DATA is not available until 4.70 EHP 8.

Search for further information about these or an SAP related objects