# F4IF_INT_TABLE_VALUE_REQUEST — F4 Help from Internal Table

> Shows a standard value help popup built from the contents of an internal table and returns the selected value. Developers use it in AT SELECTION-SCREEN ON VALUE-REQUEST or PROCESS ON VALUE-REQUEST when no suitable search help exists. Set RETFIELD to the field to return and VALUE_ORG = 'S' for a structured table; with DYNPPROG, DYNPNR and DYNPROFIELD the value is written back to the screen field, otherwise read it from RETURN_TAB.

- Modules: CA
- Type: Function module
- Function group: SDHI
- Remote-enabled (RFC): No
- S/4HANA status: Used the same way in S/4HANA
- URL: https://nekuhub.com/en/functions/f4if-int-table-value-request/

## Importing parameters

| Parameter | Type | Description | Required |
|---|---|---|---|
| RETFIELD | DFIES-FIELDNAME | Name of the field to return | Yes |
| DDIC_STRUCTURE | TABNAME | Dictionary structure of VALUE_TAB | - |
| PVALKEY | DDSHPVKEY | Key for personal value list | - |
| DYNPPROG | SY-REPID | Current program | - |
| DYNPNR | SY-DYNNR | Screen number | - |
| DYNPROFIELD | HELP_INFO-DYNPROFLD | Screen field for the returned value | - |
| STEPL | SY-STEPL | Step loop line of the screen field | - |
| WINDOW_TITLE | C | Title of the hit list | - |
| VALUE | HELP_INFO-FLDVALUE | Current field value | - |
| VALUE_ORG | DDBOOL_D | Value organization: C (cell by cell) or S (structured) | - |
| MULTIPLE_CHOICE | DDBOOL_D | Allow multiple selection | - |
| DISPLAY | DDBOOL_D | Display only | - |
| CALLBACK_PROGRAM | SY-REPID | Callback program | - |
| CALLBACK_FORM | SY-XFORM | Callback form routine | - |
| CALLBACK_METHOD | IF_F4CALLBACK_VALUE_REQUEST | Callback object | - |
| MARK_TAB | DDSHMARKS | Preselected lines for multiple selection | - |

## Exporting parameters

| Parameter | Type | Description |
|---|---|---|
| USER_RESET | C | User cancelled the dialog |

## Tables parameters

| Parameter | Type | Description | Required |
|---|---|---|---|
| VALUE_TAB | - | Table of values | Yes |
| FIELD_TAB | DFIES | Field descriptions of the hit list | - |
| RETURN_TAB | DDSHRETVAL | Selected values | - |
| DYNPFLD_MAPPING | DSELC | Mapping of screen fields to table fields | - |

## Exceptions

- PARAMETER_ERROR: Incorrect parameters
- NO_VALUES_FOUND: No values found

## Call template (ABAP)

```abap
CALL FUNCTION 'F4IF_INT_TABLE_VALUE_REQUEST'
  EXPORTING
    retfield = lv_retfield
  IMPORTING
    user_reset = lv_user_reset
  TABLES
    value_tab = lt_value_tab
    field_tab = lt_field_tab
    return_tab = lt_return_tab
    dynpfld_mapping = lt_dynpfld_mapping
  EXCEPTIONS
    parameter_error = 1
    no_values_found = 2
    OTHERS = 3.
```


