External Form

Introduction 

External Forms in Joget allow you to map a process activity to a form hosted outside of the Joget platform. This feature is useful when you need to integrate external systems, providing flexibility to handle forms independently while still participating in Joget’s workflow process.

With External Forms, when a user accesses an assignment, they view an embedded external form in an iFrame instead of a typical Joget form. Relevant information about the assignment is passed to the external form as request parameters, enabling seamless integration.

How does it work?

To map an activity to an External Form, follow these steps:

1. Activity Mapping
   Use the Map Activities to Forms feature and select the option to map the activity to an External Form.

2. Assignment Handling
   When the assignee opens the task in their Inbox, they will see an iFrame pointing to the specified external URL.
   

3. Parameters Passed to the External Form
   Joget passes the following parameters to the external form via request:

   • appId
   • appVersion
   • processId
   • processVersion
   • activityId
   • processRequesterId
   • username

   These parameters enable the external page to interact with Joget’s workflow context.

4. Form Management
   The external page handles form retrieval, validation, and saving. Joget relinquishes control over these operations once the external form is loaded.

5. Completing the Assignment
   To proceed with the workflow, you must invoke Joget’s JSON API to complete the assignment in order to move on to the next node in the workflow process. See JSON API Integration | Complete the Assignment with Variables for detailed steps.