PSD1160 – Prevent to change form if data has been changed

Summary

This PhenixID Solution Document (PSD) is written for PhenixID Identity Manager (IM) 5.5.0 or later.

If a user have changed a value on one form/tab and do not saved that change before moving to another form, this filter will interrupt and a popup will be presented. This can be useful if you have restriction filter on a form that should not be visible/available if a specific value is set on an object.
Popup text is customisable.

Configuration

You add the filter as a tab restriction filter and a hidden control is added with the text for the popup. The filter is used per form/tab so you can add it to several tabs if you like.

Add filter

1. Open the form/tab where you like the popup to be present
2. Click Tools – Tab Properties
3. Click browse button to the right of Restriction Filter
4. Click Add and Java Class Filter
5. Type filter.SingleCompulsoryFilter and click OK
   When OK is clicked, IM will add [JAVA] in front of the filter.
   Result will be [JAVA]filter.SingleCompulsoryFilter
6. Click OK and Apply to leave Tab Properties

Add Popup text

1. Open the form/tab where you like the popup to be presented (it probably already open if you continue from previous section)
2. Add Text Field control to you workspace
3. In Attribute Name replace the text StringAttribute with COMPULSORY_WARNING_TEXT
4. In Title add the popup text you like to be presented. For example:
   INFORMATION < BR > You have unsaved data! < BR > Click CLOSE to save the unsaved data. < BR > Click CANCEL to restore the original data.
5. Uncheck the Editable checkbox and check the Hidden checkbox in Parameters section.
6. Click Apply and Save your form
7. Login to IM WEB and test your configuration

Add custom button text

This feature was added to IM 5.5.1
By default the two buttons in the dialog box have the text CANCEL and CLOSE. If you like to change that to something else you can do this by adding to labels to the lang-file.

1. Open en.lang.
   drive:\..\PhenixID\IM\customer\lang
2. Add:
   8C-E4-66-B2=Cancel
   8C-E4-66-A8=Close
3. Change Cancel and Close respectively to what you like to call the buttons.
4. Save and close the file
5. Update other lang-files if you use them.
6. Restart PIM and verify.
   NOTE: If you do not add anything in the lang-file, the buttons will default to CLOSE and CANCEL.