TB_REF_OBJECTS_ADD SAP Function module - Add More Objects to an Existing Reference

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

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

Pattern for FM TB_REF_OBJECTS_ADD - TB REF OBJECTS ADD

CALL FUNCTION 'TB_REF_OBJECTS_ADD' "Add More Objects to an Existing Reference
  EXPORTING
    imp_reftyp =                " refon-reftyp  Type of Referencing
    imp_refnr =                 " refon-refnr   Nr  der Referenzierung
  TABLES
    t_refon =                   " refon         Tabelle mit Objektnummern (mind. 1!)
  EXCEPTIONS
    REFTYP_UNKNOWN = 1          "               Typ ist unbekannt (ATR1 beachten!)
    REFERENCE_NOT_FOUND = 2     "               Referenzierung nicht vorhanden
    REFERENCE_NOT_ACTIVE = 3    "               Referenzierung nicht erweiterbar, da nicht aktiv
    INTERNAL_ERROR = 4          "               Internal Error
    .  "  TB_REF_OBJECTS_ADD

ABAP code example for Function Module TB_REF_OBJECTS_ADD

The ABAP code below is a full code listing to execute function module TB_REF_OBJECTS_ADD 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:
it_t_refon  
 
 TYPE STANDARD TABLE OF REFON,"TABLES PARAM
wa_t_refon
 
 LIKE LINE OF it_t_refon
.

 

SELECT single REFTYP 
  FROM REFON 
  INTO @DATA(ld_imp_reftyp).

 

SELECT single REFNR 
  FROM REFON 
  INTO @DATA(ld_imp_refnr).

 

"populate fields of struture and append to itab
append wa_t_refon to it_t_refon.
.

CALL FUNCTION 'TB_REF_OBJECTS_ADD'
  EXPORTING
    imp_reftyp =                 ld_imp_reftyp
    imp_refnr =                  ld_imp_refnr
  TABLES
    t_refon =                    it_t_refon
  EXCEPTIONS
    REFTYP_UNKNOWN =             1
    REFERENCE_NOT_FOUND =        2
    REFERENCE_NOT_ACTIVE =       3
    INTERNAL_ERROR =             4
    .  "  TB_REF_OBJECTS_ADD

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
ELSEIF SY-SUBRC EQ 4. "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_imp_reftyp
 
 TYPE REFON-REFTYP ,
it_t_refon
 
 TYPE STANDARD TABLE OF REFON ,
wa_t_refon
 
 LIKE LINE OF it_t_refon,
ld_imp_refnr
 
 TYPE REFON-REFNR .



SELECT single REFTYP 
  FROM REFON 
  INTO ld_imp_reftyp.
 

"populate fields of struture and append to itab
append wa_t_refon to it_t_refon.

SELECT single REFNR 
  FROM REFON 
  INTO ld_imp_refnr.