Some application servers have restrictions on file names or a limit on the length of a path name.
Non-ASCII characters used in file names
If you use non-ASCII characters in the names that you assign to style sheets or images, you possibly cannot load these files by a URL, depending on your application server settings. For example, the Image builder and Image Button builder do not load image files (for example, .gif
files) that are named with non-ASCII characters.
Generated file names and path length
On some application servers, there is a limit of 255 characters on the length of path names (including the file name). In IBM® WebSphere® Portlet Factory, JSP files and Java classes are generated based on the model name and any profiles applied to the model. Typically, the file name lengths are under 255 characters.
However, when you use the model as a portlet in nested portals, the generated file name could cause the path length limitation to be exceeded.
To prevent the generation of file names that are too long, the profile names are converted to a unique ID. You can control the file name length at which the WebSphere Portlet Factory converts the profile name portion of a generated file name to an ID by setting the following property in the WEB-INF/config/cluster.properties
The default value for this property is 60.
value does not include the length of the whole file name, just the length of the profile name portion. As a result, set the maxKeyLength
value low enough to account for the portlet name, widget name, model name, and any other parts of the path to the generated file.
For example, the datatablepage
that is used as a portlet in a nested portal can have the following file name.
WebSphere Portlet Factory checks the length of the profile names embedded in the name. If the length exceeds the value of the maxKeyLength property, the profile names are converted to an ID.
The following is the result of converting the profile name in the previous example to an ID.
Parent topic: IBM WebSphere Portlet Factory Designer components