Import Content

Import, in combination with export, allows you to exchange content between libraries and database servers and restore backup copies of your content. You can import a content archive file from the Tools menu.

When importing, you can select a single archive file, identified by the extension odarc. The Developer validates the archive structure when you initiate the import process. Therefore, you cannot choose to import only specific pieces of an archive; you must import the entire archive as a unit.

Next, you specify the Library location into which the contents of the archive are to be imported. You can browse to select an existing folder or type a new folder name, including Library path if necessary, to create a new folder for the imported material.

Finally, you have the option to overwrite existing documents or not. You should choose the overwrite option if the archive contains updated versions of documents that are already in your Library. In contrast, you might choose not to overwrite existing documents to import only new documents from an archive containing some documents that are new and some that are already present in your Library. Skipping the existing documents in this way speeds the import process.

In general, the import process writes the contents of the archive file to your Library in the selected location, re-creating the documents and their Library structure as necessary, as well as links to and from the documents. A summary message appears if some of the documents you selected could not be processed. Clicking the View activity log link in the message displays a list of the results for each document.

The specific results of importing an archive depend on the contents of the archive, the existing contents and structure of the Library, and the specified import options, as detailed next.

The following table summarizes the results of import for different combinations of import options:

Content

Folder Structure

Overwrite

Results

New

New

NA

New folder structure is created in the specified Library location; new documents are created in these folders.

New

Existing with the root selected as the import location

NA

New documents are created in the existing folder structure (the folders are merged).

Existing

New or existing

No

Existing documents that are not overwritten are not imported.

Existing

New or existing

Yes

Existing documents are overwritten in their current Library locations.

Mixture of new and existing

New or existing with the root NOT selected as the import location

Yes

New folder structure is created in the specified import location, and new documents are created in these folders; existing documents are overwritten in their current Library locations.

Mixture of new and existing

Existing with the root selected as the import location

Yes

Existing documents are overwritten in their current Library locations, and new documents are created in the existing folder structure.

Selecting Cancel during import stops processing after completion of the current document and displays a message with a link to a list of the documents that have already been imported. Click the View activity log link in the message to display a list of the results for each document.

Also note that, during import, the Developer identifies all roles used in the imported content. It then compares these roles to the master role list of the same language. If any of these roles is not included in the appropriate master role list, the Developer attempts to add the role to the role list. If the role cannot be added to the list, for example, if the master role list is open in an editor, the role is still kept in the content but is not included in any role list. You can later update the master role list to include these roles, if desired.

networking icon Multi-user Considerations

For a document to be overwritten during import, it must be checked out. Therefore, before initiating the import process, you should ensure that any documents that must be overwritten are either checked out to you or checked in to the server. If you plan to import an archive while offline, you must check out all such documents before going offline.

However, if a document that needs to be overwritten is not checked out and you are online, the Developer automatically checks the document out to you and replaces it with the corresponding document from the archive. If the document cannot be checked out, for example, if it is open in another editor or checked out to another user, it is skipped.

Note that, if a document in the archive existed in the Library but had been deleted, overwriting moves the document from Deleted view to Library view, thus restoring the document. The document is restored in its original location, regardless of the selected import location.

Also note that, if the Developer needs to add roles to a master role list during import, this master role list must be checked out. If the role list is not checked out and you are online, the Developer automatically checks it out to you and adds the necessary roles. If the role list cannot be checked out, for example, if it is open in an editor or checked out to another user, the roles are kept in the imported content but are not added to the role list. You can later update the master role list to include these roles, if desired.

After you complete the import process, you should check in all affected documents (new and overwritten) to make them available to other authors and add the changes to the Developer's version control system. If a document was overwritten, its version number is incremented only if its contents have changed. That is, if a document in the archive was identical to the same document already in the Library, overwriting on import does not affect the document's version history.

procimageTo import content:

  1. On the Tools menu, point to Import and choose Documents.
  2. Set the import options.

    To exactly reproduce the folder structure of the Library from which the archive was created, select the root ("/") in the Import content to field.

  3. Click Import to execute the process.

    The import tool analyzes and processes the selected archive, adding the archive documents and re-creating their relative folder structure in the specified Library folder.

    If any errors occur, they are written to an activity log, and a Partial Import message box appears. You can click the View activity log link to view the results of the import or click OK to close the message box.

Related Topics

Export Content

Understand Developer Archives

Export Content for Localization

Import Localized Content