SAP Function POPUP_GET_VALUES_USER_CHECKED - Dialog box for requesting values, check by user exit

Parameter Reference Type Length Default Optional Text
FORMNAME 0 Name of external subroutine
NO_CHECK_FOR_FIXED_VALUES 0 SPACE X Flag: Deactivate check on fixed values (X)
POPUP_TITLE 0 Text of title line
PROGRAMNAME TRDIR-NAME C 40 Name of module pool of external subroutine
START_COLUMN 0 '5' X Start column of the dialog box
START_ROW 0 '5' X Start line of the dialog box

Parameter Reference Type Length Text
RETURNCODE 0 User response

Parameter Reference Length Optional Text
FIELDS SVAL 278 Table fields, values and attributes

Exception Text
ERROR_IN_FIELDS FIELDS were transferred incorrectly


INCLUDE 'DOCU_HAS_TO_BE_ELABORATED' OBJECT DOKU ID TX
Function
INCLUDE 'POPUP_GET_VALUES_BASE' OBJECT DOKU ID TX
The user input is copied and can be sent to an external subroutine (userexit), which can be specified in the interface of this function module.If you do not specify an external subroutine, the data is returnedwithout being checked.
If you specify an external subroutine, then its interface must consistof the table FIELDS and an error structure. The external subroutineanalyzes the data, processes it as required, and, if an error occurs,fills the error structure accordingly. The function module analyzes theerror structure and either stops the processing or sends an errormessage and lets the user enter new data.
You can use this function module to do the following:
  • Query values for which a check against the database is not enough.

  • Query values to copy objects.

  • Support prototyping.

    • Examples
    For examples, see the program RSSPO430.
    Notes
    • You can define processing of your choice in the user exits. For example,
      • you can display the dialog box for this function group again.
      INCLUDE 'POPUP_GET_VALUES_NOTES_02' OBJECT DOKU ID TX
      The user action is returned in the parameter. Itcan take the following values:
      • " " (Space)

        • The user wants to perform the action, the user exit did notreturn errors, FIELDS contains the input values
        • "A"

          • The user cancelled the action, FIELDS contains theoriginal values
          Names of external subroutines (user exit) which are called at eventPAI, after value entry. Define the form routine as follows:
          FORM TABLES FIELDS STRUCTURE SVAL
          CHANGING ERROR STRUCTURE SVALE.
          * copy the values from FIELDS into internal structures
          * process internal structure and possibly call other dialog boxes
          IF error.
          ERROR handling
          ENDIF:
          ENDFORM.
          INCLUDE 'SPO_PAR_NO_CHECK_FOR_FIXED_V' OBJECT DOKU ID TX
          Dialog box title line text. It must be translatable (e.g. use numberedtexts).
          Name of the program or module pool in which the form routine FORMNAMEis defined.
          Column in which the dialog box starts. Default value 5.
          Row in which the dialog box starts. Default value 5.
          The table contains the fields, values and attributes for the layout ofthe dialog box. The fields appear in the sequence that they have inthe FIELDS table. For each field that is to appear in the dialog boxone line must be filled:
          • TABNAME (table name)

            • The table must be active in the Data Dictionary.
            • FIELDNAME (name of the field to be displayed)

              • The field must belong to Table TABNAME.
              • VALUE (field value)

                • VALUE can be assigned a value when the function module is called up.This value is displayed. If the user does not cancel the action, VALUEcontains the value entered by the user.
                INCLUDE 'FU_POPUP_GET_VALUES_1' OBJECT DOKU ID TX
                • FIELD_ATTR (field attribute)

                  • The field attribute determines the layout attribute of the field andmust have one of the following values:
                  " " (Space) normal display, ready for input
                  "01" highlighted, ready for input
                  "02" normal display, not ready for input
                  "03" highlighted, not ready for input
                  "04" field is not displayed
                  • FIELD_OBL

                    • obligatory. The indicator determines whether or not the field isobligatory and must have one of the following values:
                    " " (Space) field is optional
                    "X" field is obligatory
                    • FIELDTEXT (keyword)

                      • In FIELDTEXT the keyword for the field can be specified unless thedictionary keyword is to be used.
                      • COMP_CODE

                        • Field not required for this function module
                        • COMP_TAB

                          • Field not required for this function module
                          • COMP_FIELD

                            • Field not required for this function module
                            • NOVALUEHLP

                              • This indicator specifies whether the value help button should bedisplayed, and must have one of the following values.
                              " " = The value help button is permanently displayed
                              "X" = The value help button is not displayed