Ansicht
Dokumentation

/IXOS/DC_H_HELP_VALUES_GET - Copy from HELP_VALUES_GET_EXTEND and modified

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
This documentation is copyright by SAP AG.
Preliminary comment

This function module has been released.

The documentation is being revised so that it conforms to the requirements for released function modules.

Function module: HELP_VALUES_GET_EXTEND

Purpose: Possible values display with selection considering the
screen restrictions

Function group: SHL3 - Help functions for external use

Responsible: KRAFTT

Release: -

Documentation

Functionality

This function module displays the possible values for a field. The full functionality of the standard F4 Help is available in the display. The function module also takes the screen selection into account, i.e. the values in the screen fields before F4 Help is requested will selectively be considered in the display by user request.

Example:

data: table like help_info-tabname,

field like help_info-fieldname.

program_name(10) type c.

dynpro_name(4) type n.

data: returncode like sy_subrc,

selection(1) type c,

select_value like help_info_fldvalue,

select_index like sy_tabix.

data: getfields like dynpfield occurs 0 with header line.

data: updfields like dynpfld occurs 0 with header line.

table = 'OBJSUB'.

field = 'OBJECTNAME'.

program_name = 'TESTPROG'.

dynpro_name = '0100'.

refresh dynpfields.

move 'OBJSUB-OBJECTTYPE' to dynpfields-fieldname

append dynpfields.

move 'OBJSUB-DDTEXT' to dynpfields-fieldname.

append dynpfields.

refresh: getfields, updfields.

move 'OBJSUB' to updfields-tabname.

move 'OBJECTNAME' to updfields_fieldname.

append updfields.

loop at dynpfields.

split dynpfields_fieldname at '-'

into getfields-tabname getfields_fieldname.

split dynpfields-fieldname at '-'

append getfields.

append updfields.

endloop.

call function 'HELP_VALUES_GET_EXTEND'

exporting

display = ' '

dyname = program_name

dynumb = sy-dynnr

fieldname = field

input_value = ' '

tabname = tabelle

shrink = 'X'

exporting

returncode = returncode

selection = selection

select_value = selval

select_index = selind

tables

getfields = getfields

updfields = updfields.

Notes

Use this function module in your Help programming if several screen fields are to be used for selecting the displayed values, and the displayed values are also to be returned to the screen fields. The table must be defined and active in the ABAP/4 Dictionary.
For restricting values, see also the documentation of function module HELP_VALUES_SHRINK.

Parameter description

Parameter Reference field/structure Default value

Import parameters:

DISPLAY SPACE
DYNAME DD02S-PROG
DYNUMB DD02S-DNUM
FIELDNAME HELP_INFO-FIELDNAME
INPUT_VALUE HELP_INFO-FLDVALUE SPACE
TABNAME HELP_INFO-TABNAME

Export parameters:
RETURNCODE SY_SUBRC
SELECTION
SELECT_VALUE HELP_INFO-FLDVALUE
SELECT_INDEX SY-TABIX

Table parameters:
GETFIELDS DYNPFLD
UPDFIELDS DYNPFLD

• Import parameters

• DISPLAY: Display indicator
  Meaning: If you set the display indicator ('X'), the
  values will only be output for display. No
  choosing of values will be possible.
  Value set: SPACE, 'X'.
  Initial value: SPACE

• DYNAME: Name of program (of calling screen)
  Meaning: Name of the program from which this function
  module was called. Do not use sy-repid here,
  use sy-cprog instead. (The value in
  sy-repid is the main program of the function
  group of the Help processor.
  Value set: None
  Initial value: None

• DYNUMB: Number of calling screen
  Meaning: Number of screen from which the function module
  is called. You can set SY-DYNNR here.
  Value set: None
  Initial value: None

• FIELDNAME: Name of a table field
  Meaning: Name of the table field for which Help is
  requested. The field must belong to an active
  Dictionary table.
  Value set: None
  Initial value: None

• INPUT_VALUE: Obsolete, exists for upward compatibility only.

• TABNAME: Name of a table
  Meaning: Name of the table containing field FIELDNAME.
  The table must be active in the Dictionary.
  Value set: None
  Initial value: None

• SHRINK: Flag for restricting
  Meaning: If this flag is set ('X'), the field contents
  of table GETFIELDS are used for restricting
  the values. Otherwise, no restriction
  applies.
  

• Export parameters:

• RETURNCODE: Return value, 0: successful, 4: nothing found

• SELECTION: Selection flag
  Meaning: SELECTION = 'X', if the user selected a value.
  Needed to qualify the action "Cancel".

• SELECT_VALUE: Selected value
  Meaning: Field contents selected by the user. If
  SPACE, the default value is selected, if
  SELECTION is set, otherwise cancel.

• SELECT_INDEX: Table record of the selected value
  Meaning: Table record of the value from the display, it
  may not be the same as the database table
  record.

• Table parameters:

• GETFIELDS: Fields for restricting the data display
  Meaning: GETFIELDS contains the restriction conditions
  for the data display. Only values meeting these
  conditions will be displayed. If GETFIELDS is
  empty, no restriction is made and flag
  SHRINK is overridden.
  The specified fields should belong to a
  Dictionary table. If GETFIELDS is filled,
  table UPDFIELDS can remain empty and the
  field transport back to the screen is done
  for the screen fields specified in GETFIELDS.
  Value set: None

• UPDFIELDS: Fields for returning values to the screen
  Meaning: If GETFIELDS is empty, but you want to
  return values for multiple screen fields,
  these fields must be specified in UPDFIELDS.
  Additionally, you must return the values
  yourself with help of the function module
  DYNP_VALUES_UPDATE.
  Value set: None

Parameters

DISPLAY
DYNAME
DYNUMB
FIELDNAME
GETFIELDS
INPUT_VALUE
RETURNCODE
SELECTION
SELECT_INDEX
SELECT_VALUE
SHRINK
TABNAME
TECHALIAS
UPDFIELDS

Exceptions

Function Group

S/SAPLDC_H

ABAP Short Reference   CPI1466 during Backup  
This documentation is copyright by SAP AG.

Length: 10682 Date: 20240426 Time: 192706     sap01-206 ( 74 ms )