Skip Headers
Oracle® Fusion Middleware Developer's Guide for Oracle Universal Content Management
11g Release 1 (11.1.1)

Part Number E10807-03
Go to Documentation Home
Go to Book List
Book List
Go to Table of Contents
Go to Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Go to current chapter
Go to next page
View PDF

1 Introduction to Customizing Your Oracle UCM Instance

This chapter provides an overview of Oracle Universal Content Management (Oracle UCM) customization and describes the tools you need and the resources that are available.

This chapter includes the following sections:

1.1 Customization Types

Three major types of alterations can be made to the core Oracle Content Server instance:

1.2 Customization Planning

Before approaching customization, it is important to clarify exactly why the customization is being undertaken. For example, to add corporate branding, you can use the Modify Layout Samples to do so. Or to change security features, you can use components to modify the default security settings.

Customization often occurs to make Oracle Content Server match the business practices of an organization. Often, after evaluating your business processes, you may find that sometimes it is more efficient to slightly alter your procedures before customizing Oracle Content Server.

There are six major stages in customization:

  1. Determine why you want to customize. Is there corporate personalization to be done? Is there a better way to present navigation options or material? Depending on what type of need you find, you can determine which tools are best to use.

    Oftentimes the cosmetic details that you change are the ones that can most satisfy your users; changing items such as layout, colors, and images often provide the effect that users are looking for.

  2. Plan the customization carefully, taking into account those aspects of the Oracle Content Server environment that might be changed even peripherally by the customization. All customization should be done in a test environment, separate from the site's production environment.

  3. Check to see if a solution may be available. The Samples on the Support web site contain many types of customization. It's possible that there may be an existing component that can be used with just a little editing. A number of 'samples' are provided on an as-is basis. These are components or files that demonstrate, enhance or extend the functionality of your Oracle UCM products.

  4. Evaluate the problem and how essential it is to solve. Some problems may require more effort to fix than will provide payback. Perhaps customization is not needed, but simply a minor change in business practices.

  5. Test the customization thoroughly in a separate environment. If possible, have end users assist with the testing. When the testing has passed all criteria for release, inform users about the changes and how to implement them.

  6. Document the customization that you create. All alterations should be documented as completely as possible, both within the actual customization (for example, as a comment in a dynamic server page or in a component) and as a separate README document. This provides an historical audit trail for others who may need to add to the customization later.

1.3 Recommended Skills and Tools

Oracle UCM brings together a wide variety of technologies to deliver advanced functionality. To modify the system, certain experience and skills with some or all of these technologies is required.

The technical skills required to customize your content management system can vary depending on the complexity of the customization. For example, much customization can be accomplished with knowledge of HTML and Idoc Script.

This list describes, in descending order of importance, the technologies and experience you may need to modify Oracle Content Server:

You may find the following tools useful when customizing Oracle Content Server:

1.4 Troubleshooting

Several troubleshooting aids are available to help evaluate Oracle Content Server pages as they are used. The following sections discuss three broad types of troubleshooting aids:

1.4.1 Viewing Server Errors

Syntax errors and other mistakes in component files or dynamic server pages can cause errors in Oracle Content Server. If the Oracle Content Server instance fails, it reports the error in the following locations:

  • If you run Oracle Content Server from a command prompt, you can view the error in the console window.

  • If you can log in to Oracle Content Server and display the Admin Server page, you can view the Oracle Content Server log by selecting the Oracle Content Server instance and then clicking View Server Output.

  • You can view the Oracle Content Server log files in the DomainHome/ucm/cs/weblayout/groups/secure/logs directory.

1.4.2 Viewing Page Data

The IsJava setting displays the local data of an Oracle Content Server web page.

  • In a web browser, add the following code in the Address box to the end of the page's URL:

  • On a template page or in an include, use the following code:


The IsPageDebug setting displays a tree structure view of all includes being called on an Oracle Content Server web page. The debug trace appears at the bottom of the web page.

  • In a web browser, add the following code in the Address box to the end of the page's URL:

  • On a template page or in an include, use the following code:



    You can also set the IsPageDebug variable in the config.cfg file if you want the setting to apply for the whole server.
  • To place a marker in the script debug trace, place the following code at the point where you want to see a value or perform a step:

    <$trace("marker code")$>

    For example, you can use the following code to insert the current user name in the debug trace (the eval function must be used to evaluate Idoc Script):

    <$trace(eval("The user name is <$UserName$>")$>

IsJava and IsPageDebug are discussed in detail in the Oracle Fusion Middleware Idoc Script Reference Guide.

1.4.3 Monitoring Resource Loading

Three configuration settings enable you to view the loading of resources when you run Oracle Content Server from a command line. Set any of these variables equal to 1 in the IntradocDir/config/config.cfg file:

  • TraceResourceLoad logs all resources loaded, resource overrides, resource conflicts, and resource merges.

  • TraceResourceOverride logs when a system resource is overridden by a component resource or a component resource is loaded twice.

  • TraceResourceConflict logs when a system resource is overridden twice by component resources.

These configuration settings are discussed in detail in the Oracle Fusion Middleware Idoc Script Reference Guide.

The following example shows the command line output when TraceResourceLoad=1.

Loading Java Resources
Loading ConflictTester Component
Loading ConflictTester2 Component
Loading Compression Component
Merging  into Filters
*MERGE* [validateStandard, compression.ConversionParamsFilter, null, 1]
Loading Html Resources
Loading System Resource
Loading System Resource
Loading System Resource

Loading System Resource
Loading ConflictTester Component
Loading ConflictTester2 Component
*OVERRIDE* conflict_tester_include
***CONFLICT*** ConflictTester_Table
Loading Compression Component
*OVERRIDE* searchapi_result_definitions
*OVERRIDE* searchapi_thumbnail_result_doc_href_start
*OVERRIDE* searchapi_result_table_content_begin
Loading Compression Component
Merging ConflictTester_Templates into IntradocTemplates
Merging ConflictTester_Templates into IntradocTemplates
Merging CompressionIntradocTemplates into IntradocTemplates
Merging CompressionHandlers into ServiceHandlers
*MERGE* [FileService, compression.CompressionFileServiceHandler, 100]
*MERGE* [FileService, DocCommonHandler, 100]
*MERGE* [DocService, compression.CompressionFileServiceHandler, 100]