You can configure name-value pairs of data, where the name is a property key and the value is a string value that you can use to set internal system configuration properties. Defining a new property enables you to configure a setting beyond what is available in the administrative console.
The com.ibm.ws.jsf.associateLabelWithId custom property changes the rendering behavior for both the <h:selectOneRadio> and <h:selectManyCheckbox> components. The label no longer wraps the input element. Instead, each input element has a unique ID and the label is associated with that ID used for that attribute. Define and set the com.ibm.ws.jsf.associateLabelWithId context parameter to true in the web.xml file. Use the following code as an example.
<context-param> <description> Set to true to explicitly associate labels with their input elements for select one radio buttons and select many check box lists. </description> <param-name>com.ibm.ws.jsf.associateLabelWithId</param-name> <param-value>true</param-value> </context-param>
The com.ibm.ws.jsf.disableEnqueuedMessagesWarning custom property disables the FacesMessage(s) have been enqueued, but may not have been displayed warning message. When this property is set to true in the web.xml file, this warning message is not included in the SystemOut.log.
Use the following code as an example of how to define and set the com.ibm.ws.jsf.disableEnqueuedMessagesWarning context parameter to true in the web.xml file.
<context-param> <description> Set to true to disable the following warning message: FacesMessage(s) have been enqueued, but may not have been displayed </description> <param-name>com.ibm.ws.jsf.disableEnqueuedMessagesWarning</param-name> <param-value>true</param-value> </context-param>
This custom property prevents passing the style information into the items in the check box list. This property defaults to false to maintain the current behavior. Define and set the com.ibm.ws.jsf.disableStylePassthroughForCheckboxList context parameter to true in the web.xml file prevent passing style information into items in the check box list. Use the following code as an example.
<context-param> <description> Set to true if style information should not be passed into items of check box list </description> <param-name>com.ibm.ws.jsf.disableStylePassthroughForCheckboxList</param-name> <param-value>true</param-value> </context-param>
The com.ibm.ws.jsf.DISABLE_UIDATA_NESTED_CHECK custom property determines whether unique IDs are generated for UIData components that are nested inside iterator components that are not UIData components. When this property is set to true in the web.xml file, unique IDs are generated for UIData components even if they are nested inside iterator components that are not UIData components.
When this property is set to false, if a JSF dataTable component is nested within a component that does not extend UIData, such as the Java Widget Library (JWL) dataIterator component, the IDs that are generated for the rows do not increment properly. This situation can result in duplicate IDs being assigned to multiple JSF components.
Use the following code as an example of how to define and set the com.ibm.ws.jsf.DISABLE_UIDATA_NESTED_CHECK context parameter to true in the web.xml file.
<context-param> <description> Set to true to enable unique IDs to be generated for UIData components even if they are nested inside iterator components that are not UIData components. </description> <param-name>com.ibm.ws.jsf.DISABLE_UIDATA_NESTED_CHECK</param-name> <param-value>true</param-value> </context-param>
When parsing the faces-config.xml file from included libraries, the Faces configuration parser attempts to load the DTD even when validation is disabled. The Faces configuration parser uses a SAXParser to read the faces-config.xml. The default behavior of the SAXParser parser is to always load the DTD even if validation is disabled. This behavior can lead to errors initializing the Faces Servlet on systems isolated from the internet.
In your web.xml file, set the com.ibm.ws.jsf.loadExternalDtd context paramater to false to have the Faces configuration parser set the "http://apache.org/xml/features/nonvalidating/load-external-dtd" feature to false.
<context-param> <description> When set to false, this property sets a feature on the SAX parser to prevent loading the external DTD. </description> <param-name>com.ibm.ws.jsf.loadExternalDtd</param-name> <param-value>false</param-value> </context-param>
Because JSF 1.2 is supported, a JSF 1.2 application, might create the ViewExpiredException exception under load. If your view is not found in session, you can use a compatibility mode in JSF to create a new view. This can have adverse behaviors because it is a new view, and items that are usually in the view, such as state, are no longer be there. Use the following code as an example to set the com.sun.faces.enableRestoreView11Compatibility context parameter to true in the web.xml file.
<context-param> <param-name>com.sun.faces.enableRestoreView11Compatibility</param-name> <param-value>true</param-value> </context-param>
The com.sun.faces.enableViewStateIdRendering custom property controls the rendering of the id attribute of the javax.faces.ViewState hidden field. Use the following code as an example to set the com.sun.faces.enableViewStateIdRendering context parameter to true in the web.xml file.
<context-param> <param-name>com.sun.faces.enableViewStateIdRendering</param-name> <param-value>true</param-value> </context-param>