Customizing Built-In Profound.js Screens

Owned by Emily Seage
Oct 30, 2023
1 min read

Overview

Profound.js includes several built-in screens which can be customized. These screens are included in a JSON file which can be modified using the Visual Designer.

The JSON file that includes these screens are located in the Profound.js installation folder under the /modules directory. For example: /profoundjs/modules/puiscreens.json.

Customizing

The puiscreens.json file includes the following record formats:

  • SIGNONSCRN is the sign on panel.

  • ERRSCRN is the panel which is displayed when an unmonitored exception occurs in the application job.

  • EOJSCRN is the panel which is displayed when the application job ends.

  • TIMEOUTSCRN is the panel which is displayed when the session has timed out.

Any customizations can be made to these record formats, so long as field binding is not modified. This means that there can be no addition, removal, or changing of bound fields. However, widgets can be hidden, new widgets can be added, styles can be changed, etc.

Before making any changes to this file, we recommend saving an original copy outside of the Profound.js installation folder. We also recommend keeping a copy of your puiscreens.json file outside of the installation folder as well, in case any changes are made to this file during a product update.

Error Recovery

If field binding is changed in a customized version of puiscreens.json, critical failure will occur when Profound.js attempts to process the screens. To recover from this situation, simply replace the customized file with a copy of the original JSON file.

Â