Overloading policies
Revision as of 19:49, 3 September 2013 by old>Admin (→Adding an overloaded policy)
Overloading policies
The server policies can be hardcoded into the deployment file for various reasons
- Ensure system values are not subject to change in the designer
- Ease environment replication: Just copy the whole database, and define environmental differences in a file.
Adding an overloaded policy
Policy overloads are placed inside the Context element in the deployment file, where the connection strings are placed too.
- Tomcat: <tomcat root>/conf/Catalina/localhost/<application>.xml
- JBoss:
The policy in question should use the following syntax:
<Parameter name="Policy.XXXXX" value="YYYYY"/>
X = Name of the policy Y = Value of the policy
Important notes
- Please ensure the datatype fits Policy type, or the overloaded value will default to the installation value.
- For boolean values use "true" or "false"
- Policy overloads are loaded ONCE when the application is loaded by the servlet container.
- If you change the values, you will need to restart the application or the container.
- The Context parameters can optionally be set inside the servlet container manager
Example configuration
<?xml version="1.0" encoding="UTF-8"?> <Context path="/TempusServa" swallowOutput="true"> <Parameter name="Policy.applicationDisplayName" value="CustomerPortal"/> <Parameter name="Policy.doMainMenuAccordion" value="false"/> <Resource name="jdbc/TempusServaLive" auth="Container" type="javax.sql.DataSource"
...
</Context>
Protecting the variables
By setting the special policy policyHideValues, overloaded are no longer visible from backend system.
<Parameter name="Policy.policyHideValues" value="true"/>