SAP ABAP Data Element ROFNAME_S (Function Module for Application Data Collection)
Hierarchy
PI_BASIS (Software Component) Basis Plug-In
   BC-BW (Application Component) BW Service API
     RSUM (Package) BW Service API: Metadata
Basic Data
Data Element ROFNAME_S
Short Description Function Module for Application Data Collection  
Data Type
Category of Dictionary Type D   Domain
Type of Object Referenced     No Information
Domain / Name of Reference Type FUNCNAME    
Data Type CHAR   Character String 
Length 30    
Decimal Places 0    
Output Length 30    
Value Table TFDIR    
Further Characteristics
Search Help: Name    
Search Help: Parameters    
Parameter ID   
Default Component name    
Change document    
No Input History    
Basic direction is set to LTR    
No BIDI Filtering    
Field Label
  Length  Field Label  
Short 10 Funct.Mod. 
Medium 17 Function Module 
Long 38 Function Module for Data Collection 
Heading 38 Function Module for Data Collection 
Documentation

Definition

This function module is used to get data for a DataSource that was created using generic data extraction (transaction RSO2). During an extraction process, this function module is called up several times in succession:

  1. Initialization call up:

Only the request parameters are transferred to the module here (see below). The module cannot transfer any data as yet.

  1. First read call up:

The request parameters are not transferred again. The extractor returns data typified by the extract stucture in an interface table. The request parameter (I_MAXSIZE) specifies the number of expected rows.

  1. Second read call up:

The extractor returns data connected to the first data package, again in a package with I_MAXSIZE rows.

  1. The function module is called up again and again until it calls up the exception 'NO_MORE_DATA'. No more data is allowed to be transferred in the call up in which this exception arose.

The function module must have the following interfaces:

Importing parameters:

I_DSOURCE type SRSC_S_IF_SIMPLE-DSOURCE DataSource

I_INITFLAG type SRSC_S_IF_SIMPLE-INITFLAG Initialization call up

I_MAXSIZE type SRSC_S_IF_SIMPLE-MAXSIZE Package size

I_REQUNR type SRSC_S_IF_SIMPLE-REQUNR Request number

Tables:

I_T_SELECT type SRSC_S_IF_SIMPLE-T_SELECT

I_T_FIELDS type SRSC_S_IF_SIMPLE-T_SELECT

E_T_DATA

Exceptions:

NO_MORE_DATA

ERROR_PASSED_TO_MESS_HANDLER

Notes to the individual parameters:

I_INITFLAG
When the function module is called up for the first time, this parameter is set to 'X', afterwards it is set to ' '.

I_MAXSIZE
This parameter contains the number of rows expected for a read call up.

Example

An example of a function module that meets these requirements is RSAX_BIW_GET_DATA_SIMPLE. A simple method of creating a syntactically correct module is to copy it into its own function group and to copy the top-include rows of RSAX (LRSAXTOP) function group into the top- include for this function group. Afterwards, you need to adjust the copied function module to meet your own requirements.

History
Last changed by/on SAP  20080415 
SAP Release Created in