About Form Processing

You can define values for these URL properties and the associated JPOs or URLs to implement pre-, post-, or cancel processing.

There are 3 types of processing:


  • Pre-processing executes before loading the editable form page.
  • Post processing executes after completion of the edit process. The edit process, post process JSP, and post process JPO are done in a single transaction. If an exception occurs during the edit or post process, the system rolls back the entire transaction.
  • Cancel processing executes whenever a user clicks a Cancel button or closes the editable form component.

To specify a pre/post/cancel processing JSP or JPO, pass the parameters listed in the table below to the appropriate JSP files:


  • emxForm.jsp
  • emxFormEdit.jsp (for direct edit modes)

The following parameters are applicable only for edit mode.

URL Parameter Possible/Default Values Description

preProcessJPO

<JPOName>:<MethodName>

The JPO to use when a user clicks Edit on a form component.

preProcessURL

${SUITE_DIR}/emxCustomPreProcess.jsp

or

../<ApplicationDirectory>/emxCustomPreProcess.jsp

Example:../engineeringcentral/emxCustomPrePreocess.jsp

The JSP called before displaying an editable page. Specify the JSP name using the macro for the page location, or use the relative path as listed in the examples.

postProcessJPO

<JPOName>:<MethodName>

The JPO to use when a user clicks the Done button on a Form.

postProcessURL

${SUITE_DIR}/emxCustomPostProcess.jsp

or

../<ApplicationDirectory>/emxCustomPostProcess.jsp

Example: ../engineeringcentral/emxCustomPostProcess.jsp

The JSP called when a user clicks the Done button on a Form. The system calls the configured JSP after the edit processing and database update. Specify the JSP name using the macro for the page location, or use the relative path as listed in the examples.

cancelProcessJPO

<JPOName>:<MethodName>

The JPO to execute when a user clicks the Cancel or close window button on a Form.

cancelProcessURL

${SUITE_DIR}/emxCustomCancelProcess.jsp

or

..<ApplicationDirectory>/emxCustomCancelProcess.jsp

Example: ../engineeringcentral/emxCustomCancelProcess.jsp

The JSP to call when a user clicks the Cancel button or closes the component window. Specify the JSP name using the macro for the page location, or use the relative path as listed in the examples.