Lowest level entry (SAP Library - BC Extended Applications Function Library)

Lowest level entry

For this entry level, the function modules generated for data processing are available.

Call the function module VIEW_MAINTENANCE_LOW_LEVEL. Knowledge of the view or table-specific function module name for the data processing is not necessary, as it is put together by the system and then called.

Pass the name of the table or view and the desired function when calling. You must evaluate the returned user commands.

You must also perform all the activities which the maintenance dialog otherwise performs:

Authorization check
Lock
Fetch and format the required information from the Dictionary
Select, edit and save the data
Restrict the data selection in dialog for subset fields
Dynamic interface modification (menus and functions)

Interface description

Import parameters

FCODE
desired function.

'READ' Read the data from the DB

'EDIT' process data
'RDED' Read and edit
'SAVE' Write the data to the DB
'ORGL' Re-set all marked entries
'ORGD' Re-set one entry

VIEW_ACTION
Action (Display, maintain or transport).
see function module VIEW_MAINTENANCE_CALL documentation

VIEW_NAME
Name of the table or view.

CORR_NUMBER
Change request number for the changes made.
see function module VIEW_MAINTENANCE_CALL documentation

Export parameters

LAST_ACT_ENTRY
Index of the record in table EXTRACT on which the cursor was positioned.

UCOMM
Last maintenance dialog user command.

You must process the following commands yourself on this entry level:

'SAVE' Save the data in the DB
'ORGL' Re-set all marked entries in the display table (EXTRACT)

If this command is returned, you must call the lowest entry level function module again with this command and then with the previous command. You do not have to write your own re-set program.

Example

The lowest entry level was called with the module VIEW_MAINTENANCE_LOW_LEVEL and the function 'EDIT'. The user has called the function 'ORGL'. The module VIEW_MAINTENANCE_LOW_LEVEL has now to be called first with the function 'ORGL'. The module runs in the background. Then the module VIEW_MAINTENANCE_LOW_LEVEL has to be called again with the function 'EDIT'.

‘ORGD' Re-set the entry in the display table (EXTRACT) header.

see command 'ORGL' for command processing.

'ANZG' Change action: Change -> Display
'AEND' Change action: Display -> Change
‘ENDE' End processing
‘BACK' Return to calling position
'ATAB' Fetch another table or view
This field also contains the commands which were realized in user modules in the maintenance screens.

UPDATE_REQUIRED
Flag: Entries changed, Save required.

The user has made changes which make it necessary to save the data before leaving the maintenance dialog.

Tables

CORR_KEYTAB
Table with the keys of the entries to be transported. The table is only used in transport mode.

Structure: INCLUDE STRUCTURE E071K

DBA_SELLIST
Selection conditions for the database access.

Structure: INCLUDE STRUCTURE VIMSELLIST see function module VIEW_MAINTENANCE _CALL documentation.

All data which are read in for the table processing or are created during maintenance, are stored in the internal table TOTAL at run time.

The table TOTAL has the structure:

INCLUDE STRUCTURE <view name> or <table name>
INCLUDE STRUCTURE VIMFLAGTAB

See also the function module VIEW_MAINTENANCE_CALL documentation.

DPL_SELLIST
Selection conditions for the display of part of a work area on the maintenance screens.

Structure and documentation as DBA_SELLIST

The data are stored at run time in the internal table EXTRACT. The table EXTRACT always only contains the table records which have been filtered out of the table TOTAL as a result of a user action.

The table EXTRACT has the same structure as the table TOTAL

See also the documentation of the function module VIEW_MAINTENANCE_CALL

EXCL_CUA_FUNCT
dynamically activated interface functions.

Structure: INCLUDE STRUCTURE VIMEXCLFUN, see function module VIEW_MAINTENANCE_CALL documentation.

TOTAL
Data table, contains all data which have been read in and changed, deleted or added during the processing.

Structure:

INCLUDE STRUCTURE <view name> or <table name>
INCLUDE STRUCTURE VIMFLAGTAB

All data which are read in for the table processing or are created during maintenance are stored at run time in the internal table TOTAL. After the function has been carried out, the table gets a processing flag for each record processed.

EXTRACT
Data display work table.

Structure as table TOTAL

The data are stored at run time in the internal table EXTRACT. The table EXTRACT always only contains the table records which have been filtered out of the table TOTAL as the result of a user action. After the function has been performed, the table contains all the data found by the last selection for display.

X_HEADER
Control block table for the table or view.

Structure: INCLUDE STRUCTURE VIMDESC

The table contains the Dictionary header information about the table or view, such as sub-set, selection conditions, maintenance status, delivery class. The table also contains the generation information and event time information for the table or view. You can fill this table with the function module VIEW_GET_DDIC_INFO.

X_NAMTAB
Control block table for the fields of the table or view.

Structure: INCLUDE STRUCTURE VIMDESC.

The table contains the field information about the table or view, from the dictionary such as the position of the field in the structure, key information and the maintenance characteristics of the field. You can fill this table with the function module VIEW_GET_DDIC_INFO.

Exceptions

MISSING_CORR_NUMBER
Correction number missing

SAVING_CORRECTION_FAILED
Error while saving the entries in a change request.