Friendly URLs for UCM
By Kyle Hatlestad on Sep 15, 2009
When Site Studio got the feature of friendly URLs for websites, a nice "side-effect" component that came out of it was the WebUrlMapPlugin component. Since UCM 10gR3, it's been included as one of the standard components that gets installed when you install UCM, so I'm not sure if many folks are even aware it's there and what it does.
It's purpose is to map the long and complex looking URLs down to nice friendly short ones. By default, two mappings are already set up for you. One for Dynamic Conversion and one for the Content Information page. So for instance, instead of using the URL of:
it would look like:
In order to use it, a few changes may need to be made to the web server configuration. For IIS, no changes are needed. But for Apache or iPlanet, you'll need to register the prefixes to use the IdcSecurity. For instance on Apache, you configuration to get the example above to work would look something like:
(The 'idc' is whatever value you've defined for IdcUserDB)
This is very similar to the setup you do for Site Studio sites. And if you have this server dedicated to UCM, you can take the shortcut and have IdcSecurity watch everything. Then there is no need to update the web server with each new shortcut.
Once you have that configured, you can begin adding your mappings. As an administrator, go to Administration -> Filter Administration. At the bottom of the page, click the 'Edit the WebUrlMap' link.
The text box had directions on how to set up the mappings, so I won't go into detail here. But basically, you have a couple of variables to work with. <!--$cgipath--> and <!--suffix-->. The cgipath is your instance's particular path and whatever gets added after the shortcut value becomes the suffix.
Here are some additional example mappings I've found handy.
|w/||<!--$cgipath-->?IdcService=GET_FILE&dDocName=<!--$suffix-->&allowInterrupt=1&RevisionSelectionMethod=Latest&Rendition=web&noSaveAs=1||Web Viewable File|
|wcm/||<!--$cgipath-->-->?IdcService=WCM_PLACEHOLDER&dataFileDocName=<!--$suffix-->&placeholderDefinitionDocName=PD_MAIN||Display web content. In this case, a Placeholder Definition is defined (PD_MAIN) which can display any Region Definition|
|h/||?IdcService=GET_DYNAMIC_PAGE&PageName=dochistory&docid=<!--$suffix-->||Goes to a Document History Report page I have set up in the Library|