Adding a popup form

A popup (modal) form appears as shown in the screenshot below and is the result of clicking on a row (record) in a grid:

These types of forms can be used to show additional details on a record (view only form) or allow the user to amend the selected record in the grid. The example above is a view only form that shows additional details on an employment history record.

Using the example above, the JSON for this popup form appears as follows:

{ 
   "title":"Contracts",
   "action":"query",
   "queryreference":"SS - Contracts",
   "role":"SS",
   "message_no_data_content":"There are currently no contracts to show.",
   "message_no_data_title":"Contracts",
   "options":"Select",
   "field_caption_width":"30",
   "select_mode":"Single",
   "next_action_title":"Contract Information",
   "next_action":"form",
   "next_reference":"SSVCONT",
   "FieldsToExtract":[ 
      { 
         "app_role":"SS"
      }
   ]
}

The entries required for the popup form itself (not the grid), as highlighted above. The purpose of each of these JSON entries is outlined in the table below:

Name Description
options This is mandatory.
select_mode If the value is set to “Single” as the example shows, clicking on a row will trigger the “next_action” which is to display a “form”.
next_action_title This is non-mandatory. The title of the form will default to “More Info” if this is not included.
next_action This is set to form in the above example as a form is to be displayed when the user clicks on a row in the grid.
next_reference This is the unique reference of the form (form reference) located in the Form Builder in the windows application (System Setup > HR Portal > Form Builder).