8. /IQX/HANDLE_FORM_ACTION

Attributes:

Function Group - /IQX/FAB_API

Description - Process an Action from the Form

Remote Enabled Function Module

Import Parameters

Parameter
Type
Default
Optional
Pass by Value
Short Text
IV_ACTIONSTRING

Yes
IV_INSTANCE/IQX/INSTANCE
YesYesUI5 Forms Data Instance GUID 
IV_FORM_NAME/IQX/FORM_NAME

   Yes

        YesForm Name (eForms)
IT_CHANGED_DATA/IQX/FORMS_CHANGED_DATA_TT
YesYes/IQX/FORMS_CHANGED_DATA Table Type
IV_UNAMESY-UNAME
YesYesABAP System Field: Name of Current User
IT_CHANGED_RELATED_DATA/IQX/FORMS_REL_I_TT
YesYes/IQX/FORMS_REL_I Table Type

Export Parameters

Parameter
Type
Pass by Value
Short Text
ES_MESSAGESBAPIRET2_T        YesReturn parameter table

Changing Parameters

None

Tables

None

Exceptions

ACTION_NOT_ALLOWED

ERROR_OCCURED

Documentation

  • This FM is used to set a new status to the form  based on the action allowed, form name and the instance number. 
  • The FM  '/IQX/GET_FORM_DATA' is used to fetch the form related data based on the instance number from the table ' /iqx/formhd_inst'.
  • Check made to see if the action is allowed for the user. Raise an exception 'action_not_allowed' if not allowed.
  • If the form name has been specified, get the header details from '/IQX/FORMHD'.
  • If the ultra mode is set, read the form data from the class /iqx/cl_forms_assist-> /iqx/cl_forms_assist. Get the component 'Currentlevelofaction'.
  • Assign the changed action and call the FM '/IQX/FAB_CREATE_FORMDATA2' to update the entity.
  • Else if ultra mode is not set read the table '/IQX/FORMS_DATA' for the latest iteration and store the data in a table.
  • Get the 'CurrentLevelAction' and move the changed action to it and call the FM  '/IQX/FAB_POST_FORM_DATA' to update the data.