Script Construction Mapping URLs with WebUrlMapPlugin

Managing System Settings 4-57

4.4 Mapping URLs with WebUrlMapPlugin

An Oracle Content Server system uses an Oracle WebLogic server, which has a built-in web server, to filter pages through a web browser. User requests are authenticated with the Oracle WebLogic server user store and communicated with the Oracle Content Server system. The WebUrlMapPlugin component enables you to map shortened URLs to other URLs in g] using a substitution script for the mapping, which also enables you to map long URLs to abbreviated versions. The WebUrlMapPlugin component is installed enabled by default with the Oracle Content Server instance. This section covers these topics: ■ Section 4.4.1, Script Construction ■ Section 4.4.2, Supported Variables for Referencing ■ Section 4.4.3, AddEdit URL Mapping Entries ■ Section 4.4.4, Mapping Examples

4.4.1 Script Construction

The shortened URLs that you can create generally use the following format: http:myhostname.comprefixsuffix The actual mapping process is based on the part of the URL that follows the host name portion. To resolve the shortened URL, the Oracle Content Server instance compares the prefix to those in the list of defined WebUrlMapPlugin entries. If a match exists, the Oracle Content Server instance uses the map script that corresponds to the matching prefix to display the applicable document or Oracle Content Server page. For more information about the suffix, see Section 4.4.2, Supported Variables for Referencing. To construct a URL mapping entry using the WebUrlMaps Screen , you must establish a prefix and define the corresponding map. ■ Prefix The prefix portion of the mapping entry is any abbreviation you want to use to identify URLs of a certain form. For example, if you want your short URL to return the dynamic conversions of documents, you can use idc as your prefix for example, the abbreviated form of dynamic converter. When you create your prefix, do not enter a slash character at the beginning of it because the Oracle Content Server instance removes the first slash from the incoming URL before the prefix test is performed. ■ Map The map portion of the mapping entry is the Idoc Script code that the Oracle Content Server instance uses to resolve the shortened URL. You can use substitution tags --variable-- in the map portion. Examples include: – --cgipath-- Caution: Include a slash at the end of your URL map prefix. Otherwise, your mappings can apply to many more URLs and interfere with standard Oracle Content Server operations. 4-58 Oracle Fusion Middleware System Administrators Guide for Oracle Content Server – --internetuser-- – --suffix-- These substitution tags are variables that refer to the applicable parameters of a URL. Simple if constructions are also supported. For example, the following script segment performs a test to determine whether a value exists and is not empty: --if myconfigvar--something--endif--

4.4.2 Supported Variables for Referencing