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

Part Number E26692-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

28 Importing Data from Archives

This chapter provides information on using the Import function of the Archiver utility to retrieve files and Content Server information from an exported archive. Importing is typically used to obtain a copy of content from another Content Server instance or to restore data that has been in storage.

This chapter covers the following topics:

28.1 Understanding Importing Files

Using the Import function of the Archiver utility, archives can be imported to the Content Server instance according to specified rules and at specified times. The data in the files can be mapped to fields in the receiving Content Server instance, but care should be taken that the correct rules are applied during import.

The Content Server instance to which you are importing must have the same metadata fields, security groups, and accounts as the instance that the archive was exported from. Errors can result if there are mismatches.

Caution:

Do not use Archiver as your primary method of disaster recovery; use standard backup systems for the database and file system.

Note:

Imported revisions will not enter a workflow upon import, even if they meet the criteria for an active workflow.

Before beginning the import process, consider the following points:

This section covers these topics:

28.1.1 Import Uses

Typical uses for the Import function include:

  • Placing data archived from an intranet on an extranet for vendor or customer viewing.

  • Changing metadata for a large number of content items. For example, if an employee leaves the organization, you could export all of their content items and then import them with another user specified as the Author.

  • Restoring content that was inadvertently deleted or configuration information that was inadvertently changed.

  • Copying files, content types, and user attributes from a development Content Server archive to a production instance.

28.1.2 Import Methods

You can import archives in the following ways:

  • Manual: A one-time import initiated from Archiver by an administrator.

  • Automatic (Replication): Import from a local archive is initiated automatically, about once per minute.

For more information, see Section 28.3 and Chapter 30.

28.2 Import Rules

An import rule defines how revisions are added, replaced, or deleted during import.

This section covers these topics:

28.2.1 Update Import Rule

Use the Update import rule to replace existing revisions and insert new revisions.

Caution:

The Update import rule will replace existing revisions without saving the existing files. Be extremely careful when importing so you do not accidentally replace content you meant to keep.

  • If an imported revision has a different Content ID (dDocName) than any existing revision, the imported revision is inserted as a new revision.

  • If an imported revision has the same Content ID (dDocName) as an existing revision, the imported revision is inserted, ignored, or replaces the latest existing revision.

28.2.2 Insert Revision Import Rule

The Insert Revision import rule imports only revisions that have both the most recent revision number and the most recent release date.

  • If an imported revision has a different Content ID (dDocName) than any existing revision, the imported revision is inserted as a new revision.

  • If an imported revision has the same Content ID (dDocName) as an existing revision, but has a different Revision ID (dRevisionID) than any existing revision and a later release date (dInDate) than that of the latest existing revision, the imported revision is inserted as a new revision with a new revision label.

Figure 28-2 Import Rule: Insert Revision

Description of Figure 28-2 follows
Description of "Figure 28-2 Import Rule: Insert Revision"

28.2.3 Insert Create Import Rule

The Insert Create import rule imports only revisions that have the most recent release date, regardless of the revision number.

  • If an imported revision has a different Content ID (dDocName) than any existing revision, the imported revision is inserted as a new revision.

  • If an imported revision has the same Content ID (dDocName) as an existing revision, and the release date (dInDate) of the imported revision is later than that of the latest existing revision, the imported revision is inserted as a new revision with a new revision label.

Note:

When an Automatic Import occurs instead of a Manual Import, the Import rule is either "update" or "deleteRev". The "deleteRev" option is considered in case of an auto-export delete. In all the other cases, the Import rule becomes "update". If the import rule is set as 'Insert Create' and Automatic Import is used, the rule is not considered.

Figure 28-3 Import Rule: Insert Create

Description of Figure 28-3 follows
Description of "Figure 28-3 Import Rule: Insert Create"

28.2.4 Delete Revision Import Rule

Use the Delete Revision import rule to delete individual revisions.

  • If an imported revision has the same Content ID (dDocName) and Revision ID (dRevisionID) as an existing revision, the existing revision is deleted.

Figure 28-4 Import Rule: Delete Revision

Description of Figure 28-4 follows
Description of "Figure 28-4 Import Rule: Delete Revision"

28.2.5 Delete All Revisions Import Rule

Use the Delete All Revisions import rule to delete all revisions of a content item.

  • If an imported revision has the same Content ID (dDocName) as any existing revision, all existing revisions with that Content ID are deleted.

Figure 28-5 Import Rule: Delete All Revisions

Description of Figure 28-5 follows
Description of "Figure 28-5 Import Rule: Delete All Revisions"

28.3 Import Process

This section provides information about the import process and related tasks.

Tip:

To determine which archive contains the data you want to retrieve, you can prepare an Archive History report using the Web Layout Editor application.

You can also examine the files generated by the archive at the file system level, but preparing a report is more efficient if you frequently need to find archived data.

Important:

If you are using Sybase and you want to import an archive, you must perform the following tasks:

  1. Make sure you are logged in to the Content Server instance as an administrator.

  2. Choose Administration, then Admin Applets, then Repository Manager.

  3. Select the Indexer tab.

  4. In the Automatic Update Cycle section, click Configure.

  5. Make sure Indexer Auto Updates is deselected.

  6. Close Repository Manager.

  7. Use Archiver to import the archive.

  8. Open Repository Manager and select Indexer Auto Updates again.

This section covers these topics:

28.3.1 Importing Archived Data Manually

To manually import archived data:

  1. In the Current Archives list, select the archive from which to retrieve data.

  2. Review the batch files in the archive. If necessary, remove revisions from the batch files. See Section 26.4.1.

  3. If you want to change metadata fields or values during the import, set up the field and value mappings. See Section 28.3.2 and Section 28.3.3.

  4. Set the general import options. See Section 28.3.4.

  5. Test the import mappings and rules on a few individual revisions. See Section 28.3.5.

  6. Initiate the import. See Section 28.3.6.

28.3.2 Setting Field Maps

Field maps specify how metadata values are copied from one metadata field to another during import. If you do not want to copy metadata values, do not specify any field maps.

To set up field maps:

  1. Open the archive collection. See Section 26.3.1.

  2. Select the archive in the Current Archives list.

  3. Click the Import Maps main window.

  4. Click Edit in the Field Maps section.

  5. In the Edit Field/Value Maps window, click Browse For Fields.

  6. In the Browse for Fields/Values window, select a source for the list of available metadata fields:

    • To retrieve the metadata fields from the local Content Server instance, select Local System.

    • To retrieve the metadata fields from a batch file, select Batch and select a batch file from the list.

  7. Click OK. The Export Field option list is populated with the metadata fields that are associated with the Content Server instance or the selected batch file.

  8. In the Export Field list, select the metadata field from which you want to copy metadata. The selected metadata field is displayed in the Export Field. (You can also edit this field directly; make sure to use the internal field name, such as dDocAuthor or xComments.)

  9. In the Target Field list, select the metadata field you want the Export metadata to be copied to.

  10. Click Add. The mapping expression is added to the Field Maps box.

  11. To add to the mapping expression, repeat steps 8 through 10.

  12. To update an existing mapping expression:

    1. Select the line to be changed in the Field Maps box.

    2. Edit the Export Field and Target Field as necessary.

    3. Click Update. The specified mapping expression replaces the selected line.

  13. To delete a line from the mapping expression:

    1. Select the line to be deleted in the Field Maps box.

    2. Click Delete. The selected line is deleted.

  14. Click OK. During import, the values from the Export field replace any existing values in the Target field.

  15. To test the results of your field maps, import a few individual revisions from an archive. See Section 28.3.5.

28.3.3 Setting Value Maps

Value maps specify how specific metadata values are to be changed during import. If you do not want to change metadata values, do not specify any value maps.

To set up value maps:

  1. Open the archive collection. See Section 26.3.1.

  2. Select the archive in the Current Archives list.

  3. Click the Import Maps main window.

  4. Click Edit in the Value Maps section.

    • In the Edit Field/Value Maps window, to change all metadata values for a particular field, select All. Continue with step 11.

    • To change a specific metadata value, click Browse For Values.

  5. In the Browse for Fields/Values window, select a batch file from the From Batch File list.

  6. Select a metadata field from the From Field list.

  7. Click OK. The Input Value option list is populated with the values that are associated with the selected metadata field in the selected batch file.

  8. In the Input Value list, select the metadata value to be changed.

  9. In the Field list, select the metadata field to be changed.

  10. In the Output Value field, enter the new metadata value.

    • You can use Idoc Script in the output value. For example, to set the expiration date one week in the future for all imported revisions, you could use <dateCurrent(7)$>. For more information, see Oracle Fusion Middleware Developing with Oracle WebCenter Content.

    • To delete all values from the input metadata field, leave the output value blank.

  11. Click Add. The mapping expression is added to the Value Maps box.

  12. To add to the mapping expression, repeat steps 5 through 13.

  13. To update an existing mapping expression:

    1. Select the line to be changed in the Value Maps box.

    2. Edit the Input Value, Field, and Target Value as necessary.

    3. Click Update. The specified mapping expression replaces the selected line.

  14. To delete a line from the mapping expression:

    1. Select the line to be deleted in the Value Maps box.

    2. Click Delete. The selected line is deleted.

  15. Click OK. During import, the specified Input Values in the specified metadata Fields will be replaced with the Target Values.

  16. To test the results of your value maps, import a few individual revisions from an archive. See Section 28.3.5.

28.3.4 Setting Import Options

To set general import options:

  1. Open the archive collection. See Section 26.3.1.

  2. Select the archive in the Current Archives list.

  3. Click the General tab on the Archiver window.

  4. Click Edit in the Import Options section.

  5. In the Edit Import Options (Select Rules) window, select an option in the Override Import Rules list to specify how existing revisions are added, replaced, or deleted during import. For detailed descriptions, see Section 28.2.

    Caution:

    The Update import rule will replace existing revisions without saving the existing files. Be extremely careful when importing so that you do not accidentally replace content you meant to keep.

  6. Specify whether option list values are validated during import:

    • To import only revisions with valid option list values (validated option lists only), select Import only revisions with valid option list values.

    • To skip option list validation, deselect Import only revisions with valid option list values.

      Tip:

      The Import only revisions with valid option list values check box applies to all validated option lists. If you want to validate some option list fields but not all of them, you can change the Option List Type in the Configuration Manager. Use Select List Validated for option lists you want to validate; use Select List Not Validated for option lists you do not want to validate.

  7. Specify whether to recalculate times in metadata date fields to reflect the time zone of the target Content Server instance:

    • To recalculate times, select Translate the dates to the current system time zone.

      For example, if the time zone of the source (export) Content Server instance is Central Standard Time and the time zone of the target (import) Content Server instance is Eastern Standard Time, the release times, create times, expiration times, and any custom times will be changed to one hour later.

    • To leave times unchanged, deselect Translate the dates to the current system time zone.

  8. Click OK.

  9. To test the results of your import options, import a few individual revisions from an archive. See Section 28.3.5.

28.3.5 Importing an Individual Revision

To import a specific revision:

Tip:

Before importing an entire batch file, use this procedure to import a few individual revisions to test the results of your import maps and rules.

  1. Open the archive collection. See Section 26.3.1.

  2. Select the archive in the Current Archives list.

  3. In the General tab of the Archiver window, click View Batch Files.

  4. In the Removing Revisions from a Batch File window, select the batch file that contains the file you want to import.

  5. Click Edit.

  6. In the View Exported Content Items window, use the Filter feature and the navigation buttons to display the revision to be imported.

  7. Select the revision.

  8. Click Import. If the revision was imported successfully, a confirmation message is displayed.

28.3.6 Initiating the Import

To initiate import of content and configuration information:

  1. Open Archiver for the Content Server instance that you want to import to.

  2. Open the archive collection that you want to import from. (This collection must be accessible through the file system.) See Section 26.3.1.

  3. Select the archive in the Current Archives list.

  4. From Actions, choose Import.

  5. In the Import Archiver window, specify the information to be imported:

    • To import content, select Import Batched Revisions.

    • To import content and tables, select Import Tables.

      Note:

      The User Configuration and Content Configuration options are available only if the selected archive includes this information (users.hda or doctypes.hda file).

  6. Click OK. The import process is initiated, and the status bar at the bottom of the Archiver page displays progress messages.