Oracle^® Business Intelligence Presentation Services Administration Guide > Administering Oracle BI Presentation Services >

Managing Oracle BI Presentation Services URL Generation and Resource File Location

You can override how Oracle BI Presentation Services generates URLs and where resource files are located by modifying the Oracle BI Presentation Services configuration file (instanceconfig.xml) to add the following entries:

• Specifying How Oracle BI Presentation Services Command URLs Are Generated
• Specifying How Oracle BI Presentation Services Static URLs Are Generated
• Specifying the Location of Oracle BI Presentation Services Primary Resource Files
• Specifying the Path to Oracle BI Presentation Services Primary Resource Files
• Specifying the Location of Oracle BI Presentation Services Nonprimary Resource Files
• Specifying the Path to Oracle BI Presentation Services Nonprimary Resource Files
• Specifying Whether Oracle BI Presentation Services Generates Fully Qualified URLs

You need to create the elements <URL> and </URL> after the <ServerInstance> element, and place your entries between the <URL> and </URL> elements.

For information about working in the Oracle BI Presentation Services configuration file (instanceconfig.xml), read Making Oracle BI Presentation Services Configuration Changes.

NOTE:  Most of the URL entries are interrelated.

Specifying How Oracle BI Presentation Services Command URLs Are Generated

You can specify how Oracle BI Presentation Services generates command URLs.

If you explicitly specify an entry, it must be of the following form:

protocol://server/virtualpath

where virtualpath is the complete virtual path to Oracle BI Presentation Services. The default is determined separately for each client, based on the URL sent by the client to Oracle BI Presentation Services.

The following entry is an example:

<URL>
   <AbsoluteCommandURLPrefix>value</AbsoluteCommandURLPrefix>
</URL>

Specifying How Oracle BI Presentation Services Static URLs Are Generated

You can specify how Oracle BI Presentation Services generates URLs for static resources such as images, script files, style sheets, and other user-specified files. The default is protocol://server from the URL\AbsoluteCommandURLPrefix setting, described in Specifying How Oracle BI Presentation Services Command URLs Are Generated.

If you explicitly specify an entry, it must be of this form:

protocol://server

If you specify a virtual path, it is removed.

This entry designates a separate Web server for delivering static resources, thereby reducing the load on the main Web server. This prefix will be used for the resources that have a fully qualified virtual path of the form '/Path/file'. If a resource file has a relative virtual path of the form 'Path/file', the prefix used is the same used for commands to the Oracle BI Presentation Services extension.

The following entry is an example:

<URL>
   <ResourceServerPrefix>value</ResourceServerPrefix>
</URL>

Specifying the Location of Oracle BI Presentation Services Primary Resource Files

You can override the physical location of Oracle BI Presentation Services' primary resource files (these are the resource files distributed with Oracle BI Presentation Services, not user-customized files such as custom styles or skins). The internal default is $(SAROOTDIR)\web\app\res.

You must provide a full path. Oracle BI Presentation Services must have read permission to this path. For example, if this is a shared network resource, you need to make sure that the user under which Oracle BI Presentation Services is running has read access to the share, as well as read access to the file system the share is exported from.

NOTE:  If the value for this entry is different from the physical location of the Oracle BI Presentation Services DLLs, you must specify a setting for URL\ResourceVirtualPath, described in Specifying the Path to Oracle BI Presentation Services Primary Resource Files.

The following entry is an example:

<URL>
   <ResourcePhysicalPath>value</ResourcePhysicalPath>
</URL>

Specifying the Path to Oracle BI Presentation Services Primary Resource Files

You can override the virtual path used for Oracle BI Presentation Services' primary resource files as specified by the setting URL\ResourcePhysicalPath, described in Specifying the Location of Oracle BI Presentation Services Nonprimary Resource Files. These resource files and customer-defined resource files must be served from the same Web server.

For generating relative URLs, the virtual path defaults to Res, assuming that the resource folder is present under the same virtual directory as the Oracle BI Presentation Services DLL files.

For generating absolute URLs, the entry of the value URL\AbsoluteCommandURLPrefix is used as the default.

The value must be a fully qualified virtual path of this form:

'/VirtualPath'

If you omit the leading slash, one will be added.

The following entry is an example:

<URL>
   <ResourceVirtualPath>value</ResourceVirtualPath>
</URL>

Specifying the Location of Oracle BI Presentation Services Nonprimary Resource Files

You can override the physical location of resource files that are not part of a default installation. Such resource files include customized styles and skins. The internal default is $(SADATADIR)\web\app\res.

You must provide a full path. Oracle BI Presentation Services must have read permission to this path. For example, if this is a shared network resource, you need to make sure that the user under which Oracle BI Presentation Services is running has read access to the share, as well as read access to the file system the share is exported from.

The following entry is an example:

<URL>
   <CustomerResourcePhysicalPath>value</CustomerResourcePhysicalPath>
</URL>

Specifying the Path to Oracle BI Presentation Services Nonprimary Resource Files

You can override the virtual path used for resource files that are not part of a default installation as specified in the setting URL\CustomerResourcePhysicalPath, described in Specifying the Location of Oracle BI Presentation Services Nonprimary Resource Files. The internal default is Res.

The following entry is an example:

<URL>
   <CustomerResourceVirtualPath>value</CustomerResourceVirtualPath>
</URL>

Specifying Whether Oracle BI Presentation Services Generates Fully Qualified URLs

You can override whether Oracle BI Presentation Services always generates fully qualified URLs for resource files that have fully qualified virtual paths. The internal default is No.

When set to No, resources and the Oracle BI Presentation Services extension are served from one server. When set to Yes, default resources are served from the same server as the Oracle BI Presentation Services extension, and customer resources are served from another server. Depending on the value of the other settings described in this section, you could also set it up to have default and customer resources served from one server, and the Oracle BI Presentation Services extension served from another server.

The following entry is an example:

<URL>
   <ForceAbsoluteResourceURL>value</ForceAbsoluteResourceURL>
</URL>