FICTR_READ SAP Function module

FICTR_READ is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name FICTR_READ into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: FM2R
Released Date: Not Released
Processing type: Normal fucntion module

Pattern for FM FICTR_READ - FICTR READ

CALL FUNCTION 'FICTR_READ' "
* EXPORTING
*   ip_ctrhivers = 'SAP'        " fmhictr-ctrhivers
*   ip_ctr_objnr = SPACE        " fmfctr-ctr_objnr
*   ip_fictr = SPACE            " fmfctr-fictr
*   ip_fikrs = SPACE            " fm01-fikrs
*   ip_hivarnt = SPACE          " fmhisv-hivarnt
*   ip_hierarchy = SPACE        "
*   ip_language = SPACE         "
*   ip_text = SPACE             "
*   ip_date = '00000000'        " fmfctr-datbis
*   ip_gjahr = '0000'           " fm01p-gjahr
  IMPORTING
    f_fmfctr =                  " fmfctr
    f_fmfctrt =                 " fmfctrt
    f_fmhictr =                 " fmhictr
    f_fmhisv =                  " fmhisv
  EXCEPTIONS
    HIERARCHY_NOT_FOUND = 1     "
    INPUT_ERROR = 2             "
    MASTER_DATA_NOT_FOUND = 3   "
    .  "  FICTR_READ

ABAP code example for Function Module FICTR_READ

The ABAP code below is a full code listing to execute function module FICTR_READ including all data declarations. The code uses 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 original method of declaring data variables up front. 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).

DATA:
ld_f_fmfctr  
 
 TYPE FMFCTR
,
ld_f_fmfctrt  
 
 TYPE FMFCTRT
,
ld_f_fmhictr  
 
 TYPE FMHICTR
,
ld_f_fmhisv  
 
 TYPE FMHISV
.

 

SELECT single CTRHIVERS 
  FROM FMHICTR 
  INTO @DATA(ld_ip_ctrhivers).

 

SELECT single CTR_OBJNR 
  FROM FMFCTR 
  INTO @DATA(ld_ip_ctr_objnr).

 

SELECT single FICTR 
  FROM FMFCTR 
  INTO @DATA(ld_ip_fictr).

 

SELECT single FIKRS 
  FROM FM01 
  INTO @DATA(ld_ip_fikrs).

 

SELECT single HIVARNT 
  FROM FMHISV 
  INTO @DATA(ld_ip_hivarnt).


DATA(ld_ip_hierarchy) = 'some text here'.

DATA(ld_ip_language) = 'some text here'.

DATA(ld_ip_text) = 'some text here'.
 

SELECT single DATBIS 
  FROM FMFCTR 
  INTO @DATA(ld_ip_date).

 

SELECT single GJAHR 
  FROM FM01P 
  INTO @DATA(ld_ip_gjahr).

.

CALL FUNCTION 'FICTR_READ'
* EXPORTING
*   ip_ctrhivers =               ld_ip_ctrhivers
*   ip_ctr_objnr =               ld_ip_ctr_objnr
*   ip_fictr =                   ld_ip_fictr
*   ip_fikrs =                   ld_ip_fikrs
*   ip_hivarnt =                 ld_ip_hivarnt
*   ip_hierarchy =               ld_ip_hierarchy
*   ip_language =                ld_ip_language
*   ip_text =                    ld_ip_text
*   ip_date =                    ld_ip_date
*   ip_gjahr =                   ld_ip_gjahr
  IMPORTING
    f_fmfctr =                   ld_f_fmfctr
    f_fmfctrt =                  ld_f_fmfctrt
    f_fmhictr =                  ld_f_fmhictr
    f_fmhisv =                   ld_f_fmhisv
  EXCEPTIONS
    HIERARCHY_NOT_FOUND =        1
    INPUT_ERROR =                2
    MASTER_DATA_NOT_FOUND =      3
    .  "  FICTR_READ

IF SY-SUBRC EQ 0.
  "All OK
ELSEIF SY-SUBRC EQ 1. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 2. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 3. "Exception
  "Add code for exception here
ENDIF.

ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:

ld_f_fmfctr
 
 TYPE FMFCTR ,
ld_ip_ctrhivers
 
 TYPE FMHICTR-CTRHIVERS ,
ld_f_fmfctrt
 
 TYPE FMFCTRT ,
ld_ip_ctr_objnr
 
 TYPE FMFCTR-CTR_OBJNR ,
ld_f_fmhictr
 
 TYPE FMHICTR ,
ld_ip_fictr
 
 TYPE FMFCTR-FICTR ,
ld_f_fmhisv
 
 TYPE FMHISV ,
ld_ip_fikrs
 
 TYPE FM01-FIKRS ,
ld_ip_hivarnt
 
 TYPE FMHISV-HIVARNT ,
ld_ip_hierarchy
 
 TYPE STRING ,
ld_ip_language
 
 TYPE STRING ,
ld_ip_text
 
 TYPE STRING ,
ld_ip_date
 
 TYPE FMFCTR-DATBIS ,
ld_ip_gjahr
 
 TYPE FM01P-GJAHR .



SELECT single CTRHIVERS 
  FROM FMHICTR 
  INTO ld_ip_ctrhivers.


SELECT single CTR_OBJNR 
  FROM FMFCTR 
  INTO ld_ip_ctr_objnr.


SELECT single FICTR 
  FROM FMFCTR 
  INTO ld_ip_fictr.


SELECT single FIKRS 
  FROM FM01 
  INTO ld_ip_fikrs.


SELECT single HIVARNT 
  FROM FMHISV 
  INTO ld_ip_hivarnt.

ld_ip_hierarchy = 'some text here'.
ld_ip_language = 'some text here'.
ld_ip_text = 'some text here'.

SELECT single DATBIS 
  FROM FMFCTR 
  INTO ld_ip_date.


SELECT single GJAHR 
  FROM FM01P 
  INTO ld_ip_gjahr.