2 Oracle Universal Content Management

Oracle® Univeral Content Management (Oracle UCM) provides a unified application for several different kinds of content management. This chapter discusses the following topics:

Oracle UCM is documented in the several manuals, which are noted throughout this chapter.

2.1 Oracle UCM and Oracle WebLogic Server

Oracle UCM is now deployed in WebLogic Server (WLS), resulting in many significant changes from previous releases of UCM. This section summarizes those changes.

2.1.1 Installation Changes

Oracle UCM uses the Oracle Universal Installer and the Repository Creation Utility (RCU). The following steps, detailed in the Oracle Fusion Middleware Installation Guide for Oracle Enterprise Content Management Suite are required to install the product:

  • Install WebLogic Suite

  • Install patch updates if needed

  • Set up a database schema

  • Unpack and run RCU

  • Unpack and run the ECM installer

  • Create a domain using the Configuration Wizard

  • Start the servers in the domain

Other optional tasks, such as modifying memory arguments for managed servers and setting up a node manager can also be done.

See the Oracle Fusion Middleware Installation Guide for Oracle Enterprise Content Management Suite for details about installation and options.

2.1.2 Administrative Changes

Oracle UCM uses a WLS datasource to communicate with the database where metadata and other information is stored. This database connectivity and the communication parameters are managed using the WebLogic Management Console, not Content Server's System Properties utility as was previously done.

Other administrative changes are summarized in this list:

  • Running in standalone mode: To run applications or utilities in a standalone mode the database connection information must be entered into the config.cfg file using the System Properties utility.

  • Connection pooling and management: The WLS datasource connection pooling mechanism handles database connections.

  • User administration: Oracle UCM uses the WLS user store to manage user names and passwords. Therefore user management must be performed using the WLS user management tools rather than the User Admin applet in Content Server. All user authentications are done against the WLS user store. You can use the Admin applet to create users and assign passwords, but the user must also be created and assigned a password in the WLS user store.

2.1.3 Other Changes

The following list provides a cursory overview of other important changes when using Oracle UCM in a WebLogic environment. Consult the product documentation for detailed information:

  • Admin Server use: Each Content Server instance will have one admin server instance. An Admin Server can only perform management tasks on the Content Server that is installed on the same WLS domain.

  • Proxy Server: A customer can install only one Content Server per WLS domain. Customers can no longer run a proxied Content Server instance.

  • Port: By default, Content Server no longer listens on any port. Configuration settings can be changed to use a specific port.

  • Login: Oracle UCM provides a form-based login mechanism rather than a Basic Auth login method. As a result, users can now log out of the Content Server without closing their browser.

  • Access mode: Oracle UCM is accessible via HTTP and HTTPS by default.

  • Internationalization: Users can specify a time zone using their profile page. If the locale is not specified in a profile, the system determines that from a HTTP header variable.

  • Services and WLST: Content Server cannot easily be run as a Windows service using WLS. Mbeans are provided that are accessible via WLST commands which can be used to view and set some configuration parameters.

  • Directory structure: the directory structure and location of files has changed significantly. Consult the product documentation for details.

2.2 Document Management

Oracle UCM products manage not only content but digital assets as well. This section describes those products that can be used to manage document content. It includes the following sections:

2.2.1 Content Server

Content Server is the foundation for a variety of Oracle content management products. It provides a flexible, secure, centralized, web-based repository that manages all phases of the content life cycle from creation and approval to publishing, searching, expiration, and archiving or disposition.

Every contributor throughout the organization can easily contribute content from native desktop applications, efficiently manage business content via rich library services, and securely access that content anywhere using a web browser.

A number of components providing advanced functionality are included with Content Server. These components may be rolled into the core or available to enable after installation.

All content, regardless of content type, is stored in the web repository or database for management, reuse and access. While stored in the repository, all types of content ranging from e-mail, discussions, documents, reports, spreadsheets and records to images, multimedia or other digital formats-receive the same set of fundamental core services.

The Content Server is documented in the following manuals: Folios and Folders

Content Folios and Content Folders are optional components that are automatically installed when Oracle UCM is installed. When enabled, they provide a convenient way to logically group and organize content. This section provides more details about both components. Folios

Content Folios is an optional component that is automatically installed with Content Server. When enabled, it provides a quick and effective way to assemble, track, and access logical groupings of multiple content items from within the secure environment of Content Server. For example, all items relevant to an upcoming brochure, such as images, logos, legal disclosures, and ad copy, can be assembled and sent through a workflow process. Once approved, all associated content can be downloaded and sent for print.

Or perhaps a new project requires a virtual place to assemble all relevant content items in a particular hierarchy, whenever they are checked in, with restricted access to particular areas of the hierarchy. Or a video may need to be associated and tracked with release waivers and narration text. All this can be done with Content Folios.

Technically, a content folio is an XML file checked into the repository that uses elements to define a hierarchical structure of nodes, slots, and specified content items in Content Server. In practice, a content folio is a logical grouping, or a framework in which content stored in the repository can be structured. Simple folios are a flat container, while advanced folios can nest content in a hierarchy within folders. In an advanced folio, the hierarchy may be established prior to assembling content items, or it may be created during or subsequent to assembling the items.

Existing folios can have content added to them, or can be locked so that no changes can be made. Content items can be added to a simple folio by searching Content Server, and to an advanced folio by checking new items into the repository or by searching for content that has previously been checked in, all through the folio interface. An advanced folio can even contain hyperlinks to outside resources such as web sites or shared network drives. Folders

Folders is an optional component that is automatically installed with Content Server. When enabled, it provides a hierarchical folder interface to content in Content Server in the form of virtual folders (also called hierarchical folders).

Virtual folders have the following benefits:

  • Users can apply default metadata to content items by checking them in through a particular folder.

  • The system administrator can control the default metadata applied to content items by appropriately setting up folders.

  • Users can find content by drilling down through a familiar folder-type interface. Preset default metadata is applied to content items when users check them in through a particular folder (set up by the system administrator). Desktop Integration Suite

Desktop Integration Suite provides a set of embedded applications that help you seamlessly integrate your desktop experience with Content Server. More specifically, it provides convenient access to the repository from Microsoft Windows Explorer, desktop applications like Microsoft Word and Excel, and e-mail clients like Microsoft Outlook and Lotus Notes.

As a result, you can easily manage files in the repository and share files with users directly from your desktop instead of logging into Content Server and using a web browser.

See the Oracle Fusion Middleware User's Guide for Desktop Integration Suite for details. Dynamic Converter

Dynamic Converter is a transformation technology and on-demand publishing solution for critical business documents. With Dynamic Converter, you can easily convert any business document into a Web page for a specified audience without use of the application used to create that document. The benefits are immediate. Information can be exchanged freely without the bottleneck of proprietary applications.

When a Web browser first requests a document, a set of rules are applied to determine how that document should appear as a Web page. These rules can be defined in a template, a core component of Dynamic Converter.

Dynamic Converter offers a number of benefits to the user:

  • Business documents can be easily viewed in a Web browser.

  • Native applications (such as Adobe Acrobat, Microsoft Word, etc.) are not required.

  • Multiple renditions of a document are available for different devices (Web browsers, wireless devices, etc.)

  • Numerous business document types, including legacy formats, are supported.

See the Oracle Fusion Middleware Administration Guide for Dynamic Converter and the Oracle Fusion Middleware Administration Guide for Dynamic Converter for details. Content Categorizer

Content Categorizer provides organizations with the capability to use one or more taxonomies within Content Server. In addition to its out-of-the-box categorization tools and functionality, Content Categorizer provides an open API for third-party categorization engines. With this open architecture, users can take advantage of the rule sets and taxonomies provided by third-party categorization tools. As a result, organizations can choose the categorization engine that best fits their business needs. For example, organizations can use their existing vertical industry taxonomy to organize their managed content into specific categories and subcategories.

Content Categorizer enables administrators and content contributors to automatically, uniformly and intelligently categorize content as it is checked into the repository. Perfect for loading large amounts of existing content into Content Server, Content Categorizer can be used in batch mode, freeing administrators of the responsibility of assigning metadata to each individual content item. End users, on the other hand, will appreciate Content Categorizer for its ability to suggest appropriate metadata as they check in new pieces of content.

To suggest a category or specific value for each of the metadata fields, Content Categorizer uses a set of rules to analyze content items. Some automatic categorization rules include: direct correlation using file properties or text references; score computations based on word matching; sentence or paragraph summaries automatically pulled from files; or certain language pattern recognition. Rule sets can also be used from other third party categorization engines.

This functionality is documented in the Oracle Fusion Middleware Application Administrator's Guide for Content Server. Content Tracker

Content Tracker allows website administrators to use key metrics to define reports for analyzing usage of Content Server. Content Tracker's tight integration with Content Server makes it possible to run reports based on specific user profile information, groups of users, or on any set of content that can be defined by a query or group of metadata values. This flexibility allows for extremely granular content analysis, giving web teams crucial information to more strategically manage and improve upon their site.

Content Tracker uses data gathered in the web server log files, web filter log files, and Content Server's database tables to generate information regarding the content items accessed. This information could include metadata, user profile data as well as information from the users themselves. Content Tracker then populates this information into database tables in any RDBMS database such as Oracle or Microsoft SQL Server. Once this database is populated, customized reports can be generated according to the needs of the user.

This functionality is documented in the Oracle Fusion Middleware Application Administrator's Guide for Content Server. PDF Watermark

PDF Watermark is an optional component that is automatically installed with Content Server. If enabled, it allows watermarks to be applied to PDF files generated by PDF Converter (static watermarking) and returned to the repository.

Existing PDF files already residing on the repository can also be watermarked (dynamic watermarking). Dynamic watermarks are generated as needed and can contain variable information (for example, user name, date and time of download, or file name). System administrators can define variables and set up specific conditions for generating dynamic watermarks.

PDF Watermark can also add security features to PDF files as they are downloaded for viewing. Access settings can be enabled or disabled, such as printing or modifying the file.

Static watermarking is conducted in cooperation with Inbound Refinery and PDF Converter. Only content that is converted to PDF by the PDF Converter can be watermarked. You can request a static watermark for content that you expect to be converted to PDF by entering a valid PDF Watermark Template ID (dDocName) in the xPdfwTemplateID metadata field during checkin.

Content checked in by an automated process, for example WebDAV or BatchLoader, can also be given a static watermark, subject to the IBR/PDFC restriction described above and provided the xPdfwTemplateID field contains a valid template ID.

Dynamic watermarking of PDF content is rules-based.The PDF Watermark Administration screen is provided to define rulesets via the Rules tab. If a given request for a PDF document satisfies one of the pre-defined rules, the template associated with that rule is used to watermark a copy of the content before the copy is returned to the requesting user. Only the weblayout form will be watermarked, the original PDF file is unchanged in its vault location.

See the Oracle Fusion Middleware Application Administrator's Guide for Content Server and the Oracle Fusion Middleware User's Guide for Content Server for details.

2.2.2 Content Integration Suite

Content Integration Suite (CIS) enables communication with Content Server and is deployable on a number of J2EE application servers, in addition to working in non-J2EE environments. CIS provides an interface to the fine-grained services of the servers through an object-oriented services API called the Universal Content and Process Management API (referred to as the UCPM API).

The Remote Intradoc Client (RIDC) provides a thin communication API for communication with Content Server. This API removes data abstractions to the Content Server while still providing a wrapper to handle connection pooling, security, and protocol specifics. See "Remote Intradoc Client (RIDC)" for more details.

See the Oracle Fusion Middleware Developer's Guide for Content Integration Suite for Oracle Enterprise Content Management Suite for details about CIS.

2.2.3 Content Basket

Content Basket enables you to quickly find, group, and download multiple content items. For example, you may need to send an organization's logo along with several articles for your newsletter to a printing agency, or e-mail a group of documents to a vendor. With Content Basket, you can select items to add to your content basket from any content information or search results page.

After an item is added to your content basket, you can access the content basket from the My Content Server tray and download a single compressed file of the content items you need.

2.2.4 Application Adapters

Two adapters can be used in conjunction with UCM within the Oracle Application Extension Frame (AXF).

2.3 Digital Asset Management

Several solutions are available for managing digital assets and converting those assets for use in a Content Server repository.

This section discusses the following topics:

2.3.1 Oracle Conversion Server

Several different conversion products are available to publish native content items in different formats as needed at your site. The following conversion products are discussed in this section:

See the Oracle Fusion Middleware User's Guide for Content Server and the Oracle Fusion Middleware Administrator's Guide for Conversion for details. Inbound Refinery

Inbound Refinery is an add-on module to Content Server that manages all file conversions at the input side of Content Server (hence ”Inbound”), and also provides the ability to generate thumbnails (small preview images of content). Files are converted upon check-in of the content into Content Server.

Inbound Refinery includes Outside/In Image Export, which can be used for the following:

  • To create thumbnails of files checked into the repository. Thumbnails are small preview images of content. Outside In Image Export can also be used to create thumbnails of PDF files generated by PDF Converter.

  • To convert files checked into the repository to multi-page TIFF files as the primary web-viewable rendition.

In addition to the conversions that Inbound Refinery can perform using Outside In Image Export, several conversion add-ons are available for purchase and use with Inbound Refinery. The additional types of files that Inbound Refinery can convert, and the result of each conversion, depend on the conversion add-ons that are installed on the Inbound Refinery computer. Basic Refinery Process

When a file is checked into the repository, a copy of the native file is stored in the native file repository (the 'vault' directory). The native file is the format in which the file was originally created (for example, Microsoft Word).

If the file format is configured to be converted, it is placed in a queue for further processing. At set intervals, Inbound Refinery checks the queue. If a file is present, Inbound Refinery calls the appropriate conversion add-on to perform the actual conversion. The exact conversion process depends on how Inbound Refinery is set up. In some situations, conversion may be done entirely in the background, with no noticeable interaction. In others, a file may be opened in its native application and printed to a PostScript file, which is subsequently translated into a different format (for example, a PDF file). In that case, windows are automatically opened and closed on the Inbound Refinery machine. The converted file (for example, a web-viewable PDF file) is then copied to the web-viewable file repository (the 'weblayout' directory). Users can then view the file through their web browser.

If the file format is not set up to be converted (or if the conversion fails), no web-viewable file is created and a copy of the native file is placed in the weblayout directory. This means that the file is passed through to the library in its native format. Users must then have the native application installed on their computer to view the file. PDF Converter

PDF Converter enables the automatic publishing of native content items to web-viewable PDF (Portable Document Format) files. A PDF rendition of the native format is immediately generated upon check-in of new content into the repository. This PDF rendition allows web viewing of that content item without requiring users to install native applications. PDF Converter converts over 35 file formats to PDF, such as Adobe Framemaker, Illustrator, InDesign, PageMaker, and Photoshop as well as Hangul, JustSystems Ichitaro, Lotus Smartsuite, Microsoft Office, Microsoft Visio, and Oracle OpenOffice.

PDF Converter optimizes non-optimized PDF files and also processes links such as Microsoft Word hyperlinks, 'mailto' links, and table-of-content links. XML Converter

XML Converter gives XML-based access to information in unstructured business content. With XML Converter, content contributed to Content Server is converted to XML at the time of check-in. XML Converter converts over 225 document types and supports the leading word processing formats, such as Microsoft Word, Lotus WordPro, and Corel WordPerfect. It also includes support for popular spreadsheet, presentation, and graphic formats.

When a new content item is checked into the repository, XML Converter converts the content to either a SearchML or FlexionDoc format. FlexionDoc is very verbose and captures all information, including attributes such as styles in a Microsoft Word document. From there, administrators have the ability to check in different XSL files that would then convert the SearchML or FlexionDoc document to any XML format.

Administrators also have the option to use a DTD (Document Type Definition) to validate the XML generated from the XSL transformation. If there is an error in conversion, all the relevant documents (for example, the original SearchML or FlexionDoc file, the XML file generated after XSL transformation, and the error report) are all checked in and can be sent through a workflow for the developer/administrator to debug.

Because the XML file is stored and managed within the web-based repository, it can be accessed from any location using a web browser, making it available for other enterprise applications, data exchange, re-use and further conversion into additional formats. XML Converter provides an out-of-the box XML solution with enterprise level performance, while ensuring compatibility with the W3C standards specifications. Tiff Converter

Tiff Converter enables organizations to check TIFF (Tagged Image File Format) files into Content Server and then publish these as multiple-page PDF files.

Tiff Converter uses either CVISION CVista PdfCompressor or Adobe Acrobat Capture to convert single-page TIFF files, multiple-page TIFF files, or zip files containing multiple TIFF files (TIFZ, TIZ or ZIP file extensions) to a single PDF file. Additionally, during the TIFF to PDF conversion, Optical Character Recognition (OCR) is performed, enabling users to perform full-text searches of managed TIFF files in Content Server.

Tiff Converter is very useful in scanning applications. It automatically converts TIFF images to PDF format upon check-in to the repository for easy viewing of legacy content. The conversion of the released TIFF image can occur on the client side or server side and uses the Adobe Acrobat Capture technology. With TIFF Converter, users can easily view and access managed legacy content (scanned documents) via a browser with the Adobe Reader.

2.3.2 Digital Asset Manager

Digial Asset Manager (DAM) enables you to define and provide images and videos in specified formats and sizes for download by the people in your organization who need them. This helps your organization maintain consistent standards for branding and digital content use.

DAM creates multiple formats of digital assets automatically when an image or video is checked into Content Server and lists the formats under one content ID. This ensures that the asset, such as a corporate logo or promotional video, maintains a standard size and quality in the multiple formats required by your organization, while providing the content management and workflow features of Content Server. For example, one person can download images of the logo for use on a web-site, and another can download and bundle images of the same logo for use in office presentations or print collateral, all from a single digital asset checked into the repository.

Digital assets are valuable electronic images and videos to be made available within your organization in multiple output formats, called a rendition. The quantity and type of renditions are defined by the system administrator in rendition sets. A user selects a rendition set used to create renditions of a digital asset at the time the asset is checked into the repository.

For DAM to work, Inbound Refinery must be installed and properly configured to work with the Content Server on which DAM is installed. Image Manager

Image Manager enables users to quickly find, group, and download images of various sizes and resolutions. For example, an organization's logo may need to be available in a variety of sizes for advertisements, web pages, and presentation. At check-in, the image is automatically converted into the defined formats and sizes. Users can then search for the image using standard metadata, group renditions into a content basket, and download a single compressed file of the image renditions they need. Renditions

Image Manager installs six pre-defined rendition sets for use with Image Alchemy:

  • DefaultGraphicSet: Required Default Rendition Set

  • CorporateImage: Common Corporate Format Requirements

  • ProductCatalog: CMYK HiRes and Proof Images for Print

  • DigitalPhoto: Process Digital Photos

  • WebImages: Renditions for web applications and web images

  • Print: Renditions for productivity and layout applications Video Manager

Video Manager enables users to quickly find, group, and download videos of various sizes and resolutions. For example, a company training video may need to be available in a variety of sizes for streaming on an intranet, presenting to an audience, or copying to tape. At check-in, the video is automatically converted into the defined formats and sizes. Users can then search for the video using standard metadata, group renditions into a content basket, and download a single compressed file of the video renditions they need. FlipFactory, a third-party conversion application, is required to convert video files to multiple formats.

2.4 Web Content Management

Oracle UCM provides several tools that can be used to manage content on web sites, including how that content is deployed and stored.

This section discusses the following topics:

2.4.1 Site Studio

Site Studio is the application most often used for designing websites. It offers site developers and designers a built-in methodology for building websites as well as a customizable library to easily reuse custom code and fragments, enabling them to create and deploy robust websites quickly. Additionally, Site Studio enables companies to design and develop websites for dynamic contribution and viewing, as well as publish these sites as static representations built and delivered with HTML code on standard web servers.

Some of the website creation and contribution features include:

  • In-context contribution and updates directly from the website

  • Hierarchical website structure and navigation

  • Template-based pages comprised of multiple regions

  • Separation of content and presentation

  • Separation of navigational structure and its presentation

  • Secure, regional-level content authoring and editing

  • WYSIWYG XML-based contribution forms

  • Reusable content and XML-based fragments

  • Single-source content management

  • Multi-site management

Organizations may also prefer to build websites using Site Studio if they would like to distribute website development to multiple site designers, yet still have a centralized team of developers maintain control over the brand and look-and-feel. Site Studio gives developers the ability to create customizable libraries to provide site designers with reusable drag-and-drop layouts, fragments, navigation, and code that integrates with back-end applications for developing their own unique websites.

With Site Studio's customizable library as well as its built-in framework for designing websites, these site designers can create robust and well-architected sites with little or no knowledge of HTML or other programming languages.

Oracle Site Studio is documented in the following manuals:

2.4.2 Site Studio for External Applications

Site Studio for External Applications is a powerful, flexible web development tool that offers a comprehensive approach to designing, building, and maintaining enterprise-scale Web sites in an Application Server environment.

Web site development and template creation are performed in the JDeveloper environment. Site assets such as files and graphics are stored and managed in the Content Server. Page templates, region templates, and subtemplates (which are typically JSP/JSPX pages) are located in the WAR file of the web application associated with a JDeveloper project.

Site Studio for External Applications dramatically improves productivity and allows organizations to maintain accurate, timely, and current web content with consistent branding and presentation across all corporate sites. With Site Studio for External Applications, you can centralize control of site architecture and presentation, while distributing content development and ongoing maintenance to business units or other teams. Site Studio for External Applications can also be integrated with third party applications servers.

2.4.3 Content Portlet Suite

Oracle provides the ability to manage the content creation and distribution process through the use of portlets. These portlets can be enabled for different users based upon the user's roles and permissions within the organization. Depending on the permission level, the user may be allowed to browse or search content, contribute a new content item and view the progress of their content through workflow.

Integrating your portal and Content Server with Content Portal Suite provides an easier way to keep the portal up to date-resulting in greater utilization, lower maintenance costs and a larger return on your portal investment. Content Portal Suite provides access to content stored in the repository, enabling users to update, search, and view portal content in a way that is efficient and easy to use.

Content Portlet Suite is built on top of the Content Integration Suite and offers a number of pre-built reference portlets for the BEA WebLogic, IBM WebSphere, Plumtree, and Sun ONE portal servers. It uses the Remote Intradoc Client (RIDC) API to communicate with Oracle Content Server.

Portlet actions are mapped to a custom MVC framework that uses the RIDC API to perform tasks. This architecture enables the portlets to call RIDC methods and execute the requested content server service.

These suites leverage the Content Integration Suite as the foundation layer for integration. Each suite provides eight functional reference portlets:

  • Library

  • Authenticated Library

  • Basic Search

  • Authenticated Search

  • Saved Search

  • Contribution

  • Workflow Queue

  • Metadata Administration

These can be used immediately or as examples of how to implement a portlet.

See the Oracle Fusion Middleware Deployment Guide for Content Portlet Suite for Oracle Enterprise Content Management Suite for details.

2.4.4 Remote Intradoc Client (RIDC)

As mentioned, earlier, the Remote Intradoc Client (RIDC) provides a thin communication API for communication with Content Server. This API removes data abstractions to the Content Server while still providing a wrapper to handle connection pooling, security, and protocol specifics.

RIDC supports Intradoc socket-based communication and the HTTP protocol.

Intradoc communication is handled via the Content Server Intradoc port (typically 4444). This communication method requires a trusted connection between the client and Content Server. Intradoc communication can also be configured to run over SSL.

The implementation of the HTTP protocol uses Apache's Jakarta HttpClient. Communication with the content server using the HTTP protocol requires authentication credentials for each request.

See the Oracle Fusion Middleware Developer's Guide for Remote Intradoc Client for Oracle Enterprise Content Management Suite for details.

2.5 Retention Management

An adapter provides a bridge between Oracle Universal Records Management (Oracle URM), which contains the content management policies and an adapter server's content vault (which stores additional content). Corporations can then manage records, retention policies, and legal holds across multiple systems from a single location.

An adapter sends information back to the Oracle URM server so it can maintain an up-to-date catalog of the enterprise's important content. By doing so, companies can apply their records and retention policies to more content, more consistently, with less administrative effort and less disruption for users. These same benefits apply to litigation searches and holds. The Oracle UCM Adapter for Content Server (hereafter abbreviated as the UCM Adapter) obtains these policies from the server and applies them to the content items stored in the vault.

Multiple adapters can be used with Oracle URM to manage an enterprise's content needs. This section discusses one specific adapter, the UCM Adapter. See Chapter 4, "Oracle Universal Records Management" for details about Oracle URM.

2.5.1 Architecture

The major components involved in a typical UCM Adapter installation include:

  • Oracle URM: Enables organizations to manage their content and retention policies, disposition processes and litigation or audit holds in a central repository. These policies, dispositions, and holds can then be applied to external repository content through the UCM Adapter.

  • Content Server: Stores and manages content in a repository.

  • Oracle URM Adapter for Content Server: Communicates between Oracle URM and the UCM Adapter server's content vault. The UCM Adapter provides common retention functionality as follows:

    • Identifying the content in the repository that is of interest to Oracle URM.

    • Performing searches and declaring the applicable content items to Oracle URM.

    • Performing disposition actions on the existing content items when their retention periods end.

    • Establishing and removing holds and freezes on the content items, as necessary.

2.5.2 Oracle URM and the UCM Adapter

Oracle URM manages records and retention policies, disposition processes, and litigation holds or freezes in a central repository. Those policies, dispositions, and holds can be applied to content stored in multiple repositories by using adapters. The repositories may be any server or application that holds content whose retention is to be controlled.

The UCM Adapter server's content vault holds content that must be preserved for a retention period, specified in a corporate retention schedule, and then destroyed according to a corporate disposition process. The records are preserved in place because the UCM Adapter ensures that the record remains unalterable during the retention period. Upon request, the UCM Adapter server's content vault can purge the content at the end of the retention period.

The UCM Adapter server's vault may also hold content that does not need to be retained. When retention of this content is no longer necessary, it can be disposed of according to the disposition processes stored within Oracle URM.

There is an obligation to ensure that any material that is subject to a litigation or audit hold (freeze) is not deleted, either by a user or as part of a disposition process. The UCM Adapter enables Oracle URM to ensure deletions do not happen.


Content items that are non-records and are not subject to a litigation or audit hold are not transferred to Oracle URM. Instead, these documents remain in the UCM Adapter server's content vault and only their metadata is stored in Oracle URM.

The UCM Adapter is the communications intermediary between Oracle URM and the UCM Adapter server's repository. Content is stored in and remains in the UCM Adapter server's content vault while Oracle URM simultaneously enforces corporate retention policies, disposition processes, and legal holds on the stored content.

The following illustrations shows the relationship between URM and the UCM Adapter.

Description of cs_overview_ret_funct.gif follows
Description of the illustration cs_overview_ret_funct.gif

The UCM Adapter can be configured to provide the following basic retention functions:

  • Registration: The UCM Adapter self-registers with Oracle URM, ensuring that Oracle URM knows about the UCM Adapter server's content vault and is thus ready to manage the stored content within the repository.

  • Configuration: UCM Adapter configuration includes collecting the proper identification and credentials information for Oracle URM security and communications. Configuration information also includes mapping metadata fields and defining searches.

  • Query Oracle URM: The UCM Adapter queries Oracle URM for certain information. For example, it may need to retrieve retention schedules for specific items of interest. Or the UCM Adapter may need to request Oracle URM metadata for content items and obtain lifecycle information.

  • Manage Communications: The UCM Adapter monitors batch processes, handles communication errors with Oracle URM, and handles large work requests by grouping them into communication blocks and processing the response in chunks.

  • Repository Monitoring and Batch Declare: The UCM Adapter monitors its server's content vault by periodically searching the repository and informing Oracle URM of any changes in the repository that may affect disposition processes or audit holds. For example, the UCM Adapter will inform Oracle URM about new content checkins that need to be managed.

  • Perform Oracle URM Tasks: The UCM Adapter periodically checks Oracle URM for tasks to be performed within the repository. These tasks enable Oracle URM to abide by the corporate retention policies and disposition processes. Typical tasks include:

    • Oracle URM may use the UCM Adapter to perform a search within the UCM Adapter server's content vault and provide a list of items matching the search criteria.

    • When a litigation hold applies to managed content within the UCM Adapter server's content vault, Oracle URM may use the UCM Adapter to retrieve a list of affected items and preserve them to ensure that they are not edited or destroyed.

    • When a litigation hold is removed, the UCM Adapter can be used to stop preserving the affected items and dispose of them according to retention schedule rules and instructions.

  • Logging and Auditing: The UCM Adapter provides consistent logging for the activities it coordinates. The UCM Adapter contributes event information to the log files that are then uploaded to Oracle URM, consolidated, and stored.