Skip Headers
Oracle® Fusion Middleware Managing Oracle WebCenter Content
11g Release 1 (11.1.1)

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

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

16 The Oracle Content Server Adapter

An adapter provides a bridge between the Records system (which contains the record 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. This chapter discusses how to configure and use the Content Server Adapter.

An adapter sends information back to the Records 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 Record Adapter for Content Server (hereafter abbreviated as the Content Server Adapter) obtains these policies from the server and applies them to the content items stored in the vault.

Multiple adapters can be used with the Records system to manage an enterprise's content needs. This chapter discusses how to configure and use one specific adapter, the Content Server Adapter.

This chapter contains the following topics:

16.1 Understanding the Content Server Adapter

The major components involved in a typical Content Server Adapter installation include:

The Records system 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 Content Server 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 Content Server Adapter ensures that the record remains unalterable during the retention period. Upon request, the Content Server Adapter's content vault can purge the content at the end of the retention period.

The Content Server Adapter 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 the Records system.

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 Content Server Adapter enables the Records system to ensure deletions do not happen.

Note:

Content items that are non-records and are not subject to a litigation or audit hold are not transferred to the Records system. Instead, these documents remain in the Content Server Adapter vault and only their metadata is stored in the Records system.

The Content Server Adapter is the communications intermediary between the Records system and the Content Server Adapter repository. Content is stored in and remains in the Content Server Adapter vault while the Records system simultaneously enforces corporate retention policies, disposition processes, and legal holds on the stored content.

Figure 16-1 Content Server Adapter Retention Functions Overview

Surrounding text describes the adapter functions.
Description of "Figure 16-1 Content Server Adapter Retention Functions Overview"

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

16.2 Adapter Configuration

The initial step in setting up the Content Server Adapter is to access the Administration menu on the remote server where the adapter will reside. Choose Administration then Configure Record Settings then Adapter. Select the Adapter option.

When the Adapter option is chosen on the Configure Retention Settings page on a remote repository, the necessary component software is enabled. The system must then be restarted in order for the installation to be complete.

Next define an outgoing provider on the Adapter's server and register the repository source. The documents in that repository are managed using the Records system retention policies.

After registration of the source, a check is automatically made to compare content on the Content Server Adapter and the the Records system repository. A list is presented of items that do not match. At that time the items on the Content Server Adapter repository can be deleted so the two systems are in sync.

Next metadata fields should be mapped. The Content Server Adapter repository may contain a wide variety of documents and may have custom fields that do not directly correlate to those on the the Records system repository. When adapter documents are classified into groups, there can be a wide variety of retention categories associated with the content. The metadata fields between the two repositories must be mapped so the content is categorized correctly.

The Content Server Adapter does not synchronize security groups with the Records system. When using the Imaging functionality with the Adapter the security groups do not match if data is later synchronized with the Records system. The Imaging system creates new security groups dynamically, as needed for applications. Therefore, plan to set up the same security groups on the Imaging system and the Content Server Adapter that are used on the Records system.

The Access Control List (ACL) settings are also not synchronized between the Content Server Adapter and the Records system. This means that it is possible to have a higher ACL security setting on one system than on the other, or to have ACLs disabled on one system. The administrators for the systems should ensure that ACLs are set appropriately for the site's needs.

For complete details about defining and using providers, see Administering Oracle WebCenter Content.

Important:

Revisioning of external items differs from revision of items stored on Oracle WebCenter Content. For example, if an item is created on the adapter system and is synchronized to the Records system, it appears as a single item. However, if that item is revised on the adapter system then synchronized to the Records system, the item now appears in the category as two items, not one item with two revisions. Both items have the same content ID, which is the default behavior for external items.

This section describes the basic tasks needed to configure and use the Content Server Adapter:

16.2.1 Configuring Sources and Providers

Use these procedures to configure the source and provider.

16.2.1.1 Defining a New Outgoing Provider

Use this process to define an outgoing provider:

  1. Choose Records then Record Adapter. Choose Configure then Source Registration.

  2. On the Register Source page, click Add.

  3. On the Add or Edit New Provider page, enter the required information in the appropriate fields:

    • Provider Name: The name of the outgoing provider. Special characters are not allowed.

    • Provider Description: A description of the provider.

    • Server Host Name: Host name of the instance on the Records system server.

    • HTTP Server Address: The URL of the instance.

    • Server Port: The port on which the provider communicates with the instance.

    • Instance Name: Name of the instance on the Records system server.

    • Relative Web Root: The relative root of the instance.

  4. Click Add when done.

To use a 10g adapter with Records 11g, a connection string must be changed. Previous connection strings were similar to the following example:

http://myhost.mycompany.com:myport/URMinstance/idcplg

The new connection string should be similar to the following example:

http://myhost.mycompany.com:myport/_dav/URMinstance/idcplg

The addition of the _dav string is all that changes. The _dav string forces Content Server to use basic authentication instead of form-based authentication.

16.2.1.2 Editing an Outgoing Provider

Use this process to define an outgoing provider:

Note:

The Adapter does not allow you to edit the outgoing provider if it is linked to an external Records source. You must first undo this link before editing the outgoing provider.

  1. Choose Administration then Providers.

  2. On the Provider List page, navigate to the provider to edit and click Info.

  3. On the Provider Information page, click Edit. Edit the information as needed and when done, click Save.

16.2.1.3 Disabling the Adapter's Outgoing Provider

To disable an existing outgoing provider on the Adapter server:

  1. Choose Administration then Providers.

  2. On the Provider List page, navigate to the provider to disable and click Info.

  3. On the Provider Information page, click Disable.

  4. A prompt appears to confirm the choice. Click OK.

    The outgoing provider is disabled.

16.2.1.4 Deleting the Adapter's Outgoing Provider

To delete an existing outgoing provider on the Adapter server:

Note:

The Adapter does not allow you to delete the outgoing provider if it is linked to an external Records source. You must first undo this link before deleting the outgoing provider.

  1. Choose Administration then Providers.

  2. On the Provider List page, navigate to the provider to delete and click Info.

  3. On the Provider Information page, click Delete.

    A prompt appears to confirm the choice.

  4. Click OK. The outgoing provider is removed from the Providers table.

16.2.1.5 Registering an External Source

Only one source per adapter can be registered.

To register an external source:

  1. Choose Records then Record Adapter. Choose Configure then Source Registration.

  2. On the Register Source page, enter the required information in the appropriate fields:

    • Provider Name: Name of the outgoing provider that was configured for communication between the Adapter server and the Records system server.

    • Source Name: The name of the Records system source to be created on the Records system server.

    • Source Display Name: Name used in the user interface to identify the source.

    • Source Table Name: Prefix of the database tables created for the source.

  3. Click Register when done. Registration ensures that the Records system is aware of the Adapter and is ready to manage the stored content in the Adapter server's repository.

16.2.1.6 Unregistering and Removing an External Source

Important:

Unregistering a source clears the data on the external source. You should export and archive the data before unregistering a source.

To unregister an external source:

  1. Choose Records then Record Adapter. Choose Unregister Source.

  2. A prompt appears to confirm the action. Click OK to continue.

Follow this procedure to remove an external source and the database tables associated with the source.

Important:

If you remove an external source, you must reconfigure the external source in order to use it again.

  1. Choose Records then Configure. Choose Retention then Remove External Sources.

  2. Highlight the name of a source to remove and click Remove or click Reset to clear the highlighting. To remove multiple items, hold down the shift key and highlight multiple items.

  3. To delete the database tables associated with the source(s), select Delete External Source Database Tables. All database tables associated with the external source are deleted.

16.2.2 Managing Fields

Fields on the Adapter's remote source must be mapped to fields already in use on the Records system local source. If fields do not exist that match those on the Adapter, create a custom metadata field to accommodate the Adapter data.

To map a custom metadata field to a remote source:

  1. Choose Records then Record Adapter. Choose Configure then Custom Fields.

  2. On the Map Custom Fields page, click Add.

  3. A list of custom metadata from the remote source is available in a list. Select a metadata field for use from the list on the Map/Edit Custom Field dialog and enter a name and caption for that field to be stored in the Records system database table. You can also enter a different name. If entering a new name, the Adapter automatically creates a corresponding custom metadata field for the name.

  4. Click OK. The custom metadata field is added to the list of custom metadata fields on the Map Custom Fields page.

  5. To change the field order, use the Up or Down arrow keys to move the position of the field.

To edit a previously mapped field:

  1. Choose Records then Record Adapter. Choose Configure then Custom Fields.

  2. On the Map Custom Fields page, select a metadata field from the list, and click Edit.

  3. On the Map/Edit Custom Field dialog, alter information as needed and click Update.

  4. To change the field order on the Map Custom Fields page, use the Up or Down arrow keys to move the position of the field.

16.3 Synchronizing Data

After configuring the Adapter for use with the Records system, determine a synchronization schedule to ensure that content on both systems, the Adapter and the Records system, are consistently kept in sync. This section describes the tasks involved in establishing synchronization.

The systems can also be synchronized on an as-needed basis by selecting an option from the Content Server Adapter menu. These operations synchronize all items involved in the operation. For example, all content involved in freeze events are synchronized. Individual freeze events cannot be selected to be synchronized.

Important:

Revisioning of external items differs from revision of items stored on Oracle WebCenter Content. For example, if an item is created on the adapter system and is synchronized to the Records system, it appears as a single item. However, if that item is revised on the adapter system then synchronized to the Records system, the item now appears in the category as two items, not one item with two revisions. Both items have the same content ID, which is the default behavior for external items.

The following options can be synchronized:

The following sections discuss synchronization:

16.3.1 Performing As-Needed Synchronization

Follow this procedure to synchronize content based on specific synchronization operations:

  1. Choose Records then Record Adapter. Choose Synchronize then click the type of synchronization to perform.

  2. The operation is performed.

  3. If the operation completes successfully, a message is displayed. Click OK to continue.

  4. If an error occurs, a message is displayed. Check the synchronization logs to view the details of the operation and which items may have failed synchronization. For details, see Section 16.3.3.

16.3.2 Scheduling Synchronization

Follow this procedure to set up a schedule to perform regular synchronization:

  1. To access this page, choose Records then Record Adapter. Choose Configure then Scheduled Events.

  2. On the Configure Scheduled Events page, choose the unit of time measurement from the list and the amount of time to elapse between synchronizations.

  3. Choose a time for synchronization that will not affect system performance.

  4. Click Save when done.

16.3.3 Viewing Synchronization Logs

Follow this procedure to view logs that are automatically generated during any synchronization activity, either on-demand or scheduled.

  1. Choose Records then Record Adapter.

  2. Choose Logs then choose the type of log file to view.

  3. On the Synchronization Log page, to view additional details about the logged event, choose View Items from the operation's Actions menu.

  4. To rerun the operation, choose Rerun Task from the operation's Actions menu.