8. /IQX/HANDLE_FORM_ACTION

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

Parameter

Type

Default

Optional

Pass by Value

Short Text

IV_ACTION

STRING

 

 

Yes

 

IV_INSTANCE

/IQX/INSTANCE

 

Yes

Yes

UI5 Forms Data Instance GUID 

IV_FORM_NAME

/IQX/FORM_NAME

 

   Yes

        Yes

Form Name (eForms)

IT_CHANGED_DATA

/IQX/FORMS_CHANGED_DATA_TT

 

Yes

Yes

/IQX/FORMS_CHANGED_DATA Table Type

IV_UNAME

SY-UNAME

 

Yes

Yes

ABAP System Field: Name of Current User

IT_CHANGED_RELATED_DATA

/IQX/FORMS_REL_I_TT

 

Yes

Yes

/IQX/FORMS_REL_I Table Type

Export Parameters

Parameter

Type

Pass by Value

Short Text

Parameter

Type

Pass by Value

Short Text

ES_MESSAGES

BAPIRET2_T

        Yes

Return 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.