ACEPSDB_DOCITEM_READ_SINGLE SAP Function module

ACEPSDB_DOCITEM_READ_SINGLE 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 ACEPSDB_DOCITEM_READ_SINGLE into the relevant SAP transaction such as SE37 or SE80.

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

Pattern for FM ACEPSDB_DOCITEM_READ_SINGLE - ACEPSDB DOCITEM READ SINGLE

CALL FUNCTION 'ACEPSDB_DOCITEM_READ_SINGLE' "
  EXPORTING
    id_ace_comp =               " tacecomp-comp
    id_bukrs =                  " ace_bukrs     Company Code
    id_objid =                  " ace_guid      Accrual Object Number
    id_gjahr =                  " gjahr         Fiscal Year
    id_subid =                  " ace_subid     Accrual Item
    id_acrtype =                " ace_acrtype   Accrual Type
    id_accrule =                " accounting_principle  Accounting Principle (AP)
    id_docnr =                  " aceps_docnr   Document Number of an Accrual Engine Document
*   ib_only_db = SPACE          " flag          General Indicator
  IMPORTING
    es_acepsoit_node =          " acepsoit_ldb  Transfer Table in Logical Database Structure ACEPSOIT_LDB
  EXCEPTIONS
    NOT_FOUND = 1               "
    ERROR_OCCURRED = 2          "               An error has occurred
    .  "  ACEPSDB_DOCITEM_READ_SINGLE

ABAP code example for Function Module ACEPSDB_DOCITEM_READ_SINGLE

The ABAP code below is a full code listing to execute function module ACEPSDB_DOCITEM_READ_SINGLE 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_es_acepsoit_node  
 
 TYPE ACEPSOIT_LDB
.

 

SELECT single COMP 
  FROM TACECOMP 
  INTO @DATA(ld_id_ace_comp).


DATA(ld_id_bukrs) = 'Check type of data required'.

DATA(ld_id_objid) = 'Check type of data required'.

DATA(ld_id_gjahr) = 'Check type of data required'.

DATA(ld_id_subid) = 'Check type of data required'.

DATA(ld_id_acrtype) = 'Check type of data required'.

DATA(ld_id_accrule) = 'Check type of data required'.

DATA(ld_id_docnr) = 'Check type of data required'.

DATA(ld_ib_only_db) = 'Check type of data required'.
.

CALL FUNCTION 'ACEPSDB_DOCITEM_READ_SINGLE'
  EXPORTING
    id_ace_comp =                ld_id_ace_comp
    id_bukrs =                   ld_id_bukrs
    id_objid =                   ld_id_objid
    id_gjahr =                   ld_id_gjahr
    id_subid =                   ld_id_subid
    id_acrtype =                 ld_id_acrtype
    id_accrule =                 ld_id_accrule
    id_docnr =                   ld_id_docnr
*   ib_only_db =                 ld_ib_only_db
  IMPORTING
    es_acepsoit_node =           ld_es_acepsoit_node
  EXCEPTIONS
    NOT_FOUND =                  1
    ERROR_OCCURRED =             2
    .  "  ACEPSDB_DOCITEM_READ_SINGLE

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
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_es_acepsoit_node
 
 TYPE ACEPSOIT_LDB ,
ld_id_ace_comp
 
 TYPE TACECOMP-COMP ,
ld_id_bukrs
 
 TYPE ACE_BUKRS ,
ld_id_objid
 
 TYPE ACE_GUID ,
ld_id_gjahr
 
 TYPE GJAHR ,
ld_id_subid
 
 TYPE ACE_SUBID ,
ld_id_acrtype
 
 TYPE ACE_ACRTYPE ,
ld_id_accrule
 
 TYPE ACCOUNTING_PRINCIPLE ,
ld_id_docnr
 
 TYPE ACEPS_DOCNR ,
ld_ib_only_db
 
 TYPE FLAG .



SELECT single COMP 
  FROM TACECOMP 
  INTO ld_id_ace_comp.

ld_id_bukrs = 'Check type of data required'.
ld_id_objid = 'Check type of data required'.
ld_id_gjahr = 'Check type of data required'.
ld_id_subid = 'Check type of data required'.
ld_id_acrtype = 'Check type of data required'.
ld_id_accrule = 'Check type of data required'.
ld_id_docnr = 'Check type of data required'.
ld_ib_only_db = 'Check type of data required'.