Modifying Messages in Access Governance Suite

  • 7011156
  • 18-Mar-2011
  • 19-Oct-2012

Resolution

Access Governance Suite provides a set of out-of-the-box messages that are configurable within your installation. These messages are stored within the Message catalogue in the iiqMessages.properties file. This file may be localized for your language, but the messages are listed by the locale where they are used within the product and displayed to the end user.

NOTE: Depending on your application server type, the iiqMessages.properties file may reside in the identityiq.jar file and may not be extracted during setup.

By reviewing the sections, you can determine what messages are contained within that section of functionality. Then by reading through the displayed messages, you can see where the message you seek to modify can be modified within the properties. Once you have identitied the specific message that you wish to modify, you should document the proper tag for that message or item that you wish to modify or multiples thereof.

For example, I will provide you a case wherein your auditors feel that in order for the product to qualify to pass their compliance for your audit, the "Signoff" button should state something else instead and make a demand that the button be changed to say "Certify Audit". Further, they would like some different wording in legal as well, since they know that users might not feel compelled to actually review things if the option to click is in place. They feel that the wording is insufficient for a through review. "Click to see the entitlements that grant this role" and "Click to see the entitlements that make up this profile" simply do not comprise a strong enough incentive to enforce the review for them. Instead, they want the messages to say: "Review these entitlements that grant this role" and "Review these entitlements that comprise this profile."

Knowing that these changes need to be made, the first thing that you would want to do, is to determine if they exist within the Access Governance Suite Messages catalogue: iiqMessages.properties.

By searching the file, you can easily locate the words "Sign Off" for the sign off button. You can easily locate this button as the key:

inst_sign_off_button=Sign Off

and because you know that this is a text item in the message catalogue, all you ahve to do is add this to your iiqCustom.properties file, and this will override the iiqMessages.properties file and output the appropriate information. You may have to either reset the configuration cache from the debug pages as a System Administrator or restart your web application server to have this take effect, but it iwll do so once those changes have been made like so:

inst_sign_off_button=Certify Audit

and either the System Configuration cache has been reset or the web application server has been reset.

Moving along, you decide also to satisfy legal's requirements as well. You can do this by searching for the text strings that they were looking to change as well. A search will yiedl the following results:

#workItem pages

click_to_see_entitlements_granting_role=Click to see the entitlements that grant this role
click_to_see_entitlements_granting_profile=Click to see the entitlements that make up this profile

##Cerification identity list certification.xhtml

click_to_see_entitlements_granting_role=Click to see the entitlements that grant this role

# Certification item decision options included on the cert item pg - certificationItemDecision.xhtml

click_to_see_entitlements_granting_role=Click to see the entitlements that grant this role

So, in order to satisy legal's requirements, you would modify those items as follows:

#workItem Pages

click_to_see_entitlements_granting_role=Review these entitlements that grant this role
click_to_see_entitlements_granting_profile=Review these entitlements that comprise this profile.

##Cerification identity list certification.xhtml

click_to_see_entitlements_granting_role=Review these entitlements that grant this role

# Certification item decision options included on the cert item pg - certificationItemDecision.xhtml

click_to_see_entitlements_granting_role=Review these entitlements that grant this role

I encourage you to try these modifications. Given the first modification you performed, can you think of anything else that might be required by the auditors when they see the results? How might you go about finding the change?