Configuring the validation of friendly URLs for web content
After you enable the validation of friendly URLs for web content, you can choose from various configuration options. These options enable you to specify how the portal responds to friendly URLs that contain path information that does not identify an available content item. Learn about the parameter combinations you can specify and how the portal response varies based on these combinations.
You can specify the following parameters for the overall portal as properties and key value pairs in the portal Configuration Service or for individual pages as page parameters. Page parameters that you set for a specific page override any global settings that are specified in the portal Configuration Service. Page parameters are inherited by all child pages. For more information, see Configuration Service in the related links.
- friendly.pathinfo.validation.errorCode = (404)
- This key specifies the HTTP
status code that the portal returns if the path information of a friendly
URL cannot be resolved to a content item for the requested page. You
can specify one of the following values:
- 404
- The default value. This HTTP status code tells a caller, such as a search crawler or web browser, that no content is found for the friendly URL. The missing content might be temporarily or permanently missing.
- 410
- This HTTP status code informs a caller, such as a search crawler or a web browser, that the resource for the friendly URL is no longer available. This missing resource is permanently gone.
- friendly.pathinfo.validation.errorTextProvider
- This key specifies the text provider
of the localized HTTP status message to send as well as the configured
HTTP status code. If you configure a text provider and a request URL
has invalid path information, portal responds with a blank page that
displays only the HTTP status code and the corresponding localized
message that is specified by the text provider. The value of this
parameter must be the ID of an implementation of the com.ibm.workplace.wcm.api.plugin.textprovider.TextProvider interface.
To use the default messages of HCL Portal, specify the text
provider with the ID PathInfoValidationTextProvider.
If you implement a custom text provider, make sure that it supports
message keys that are composed of the prefix HTTP_STATUS_MESSAGE_ and
the configured HTTP status code, for example: HTTP_STATUS_MESSAGE_404. Important: Portal ignores this setting if you also specify the friendly.pathinfo.validation.errorURI property or page parameter.
- friendly.pathinfo.validation.errorResourceBundle
- This key specifies a Java resource
bundle as an alternative to implementing a custom text provider. If
you configure a Java resource bundle and a request URL has invalid
path information, portal responds with a blank page displays only
the HTTP status code and the corresponding localized message from
the Java resource bundle. The value of this setting must be the fully
qualified name of the Java resource bundle. If you provide a custom
Java resource bundle, make sure that it contains message keys that
are composed of the prefix HTTP_STATUS_MESSAGE_ and
the configured HTTP status code, for example: HTTP_STATUS_MESSAGE_404. Important: Portal ignores this setting if you also specify the friendly.pathinfo.validation.errorURI property or page parameter. Portal also ignores this setting if you set the value of the friendly.pathinfo.validation.errorTextProvider property or page parameter to a custom text provider ID.
- friendly.pathinfo.validation.errorURI
- This key specifies the piece of content
URI that portal resolves if the request URL has invalid path information.
The value of this parameter must be a piece of content URI that portal
can resolve, for example:
- nm:oid:unique_page_name
- This navigation model URI redirects the request to a specific portal page based on the unique name of the target page.
- custom:resolutionserviceuri
- This custom implementation of the com.ibm.portal.resolver.ResolutionService interface resolves invalid path information to a dynamically determined navigational state. When portal resolves the piece of content URI, the content path that failed the portlet validation is passed to the resolution service as the wcmContentPath parameter.
- friendly.pathinfo.validation.errorContentPath
- This key specifies the full content path that portal sets as public Web Content Manager context of the resolved page if the request URL has invalid path information. Web Content Viewer portlets on the resolved page that are configured to listen to other portlets can then render the content with the specified path. The value of this setting must be the path of a content item that is available to users, for example: /Web Content/home/human_resources/health/topic_not_found.
Portal response to invalid friendly URLs for web content: HTTP status code | Portal response to invalid friendly URLs for web content: Page | Portal response to invalid friendly URLs for web content: Web content | friendly.pathinfo.validation.errorCode | friendly.pathinfo.validation.errorTextProvider or friendly.pathinfo.validation.errorResourceBundle | friendly.pathinfo.validation.errorURI | friendly.pathinfo.validation.errorContentPath |
---|---|---|---|---|---|---|
404 | The page that is specified in the requested URL. | Web content is rendered according to the private or public Web Content Manager context, but not based on the path information. The path information was invalid and removed from the state. | N/A | N/A | N/A | N/A |
410 | The page that is specified in the requested URL. | Web content is rendered according to the private or public Web Content Manager context, but not based on the path information. The path information was invalid and removed from the state. | 410 | N/A | N/A | N/A |
404 | The page displays the following text: Error 404: The requested content does not exist. Please verify that the URL is correct. | N/A | N/A |
|
N/A | N/A |
404 | The page with the unique name missing.content displays. | Web content is rendered according to the private or public Web Content Manager context, but not based on the path information. The path information was invalid and removed from the state. | N/A | N/A | nm:oid:missing.content |
N/A |
404 | The page that is specified in the requested URL. | Web content is rendered according to the private Web Content Manager context of the Web Content Viewer portlet or /Web Content/Home/Missing Content. | N/A | N/A | N/A | /Web Content/Home/Missing Content |
410 | The page with the unique name missing.content displays. | Web content is rendered according to the private Web Content Manager context of the Web Content Viewer portlet or /Web Content/Home/Missing Content. | 410 | N/A | nm:oid:missing.content |
/Web Content/Home/Missing Content |