• Import Content
  • Import Content
  • "1be3c2e0-433e-4084-b434-c082ef2a6c67
  • 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 an archive file(s), 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 Library folder structure represented in an archive corresponds to the absolute folder structure relative to the root of the Library from which the archive was created. During import, this folder structure is created relative to the import location specified in the Import dialog box. Therefore, to exactly reproduce the folder structure of the Library from which the archive was created, you should select the root ("/") as the import location.
  • If the Library folder structure represented in an archive already exists in the specified import location, the contents of the archive folders are written to the existing Library folders, which has the net effect of merging the corresponding folders. Otherwise, the archive folder structure is created in the specified location.
  • For the purpose of overwriting during import, documents are identified solely on the basis of Document ID, not title, language, or any other document property; location in the Library is also not important. Therefore, for a given document in an archive, the following three situations can arise:
  • A document with the same ID exists in the Library but overwrite is not selected - The archive document is skipped.
  • For the purpose of re-creating links during import, documents are again identified solely on the basis of Document ID; location in the Library is not important. Therefore, if a document links to a child document with a given ID and a document with the same ID as the child already exists in the Library (or is imported at the same time as the parent), the link is re-created. If no such child document exists, a broken link results.
  • If the imported content includes new documents that were stored in the System folder, the new documents are always imported into the System folder and not in the folder specified for the import.
  • The following information summarizes the results of import for different combinations of import options:
  • New content with new folder structure
  • New content with existing folder structure and root folder selected as the import location
  • Existing content with new or existing folder structure
  • Existing content with new or existing folder structure
  • Mixture of new and existing content with new or existing folder structure and the root not selected as the import location
  • Mixture of new and existing content with existing folder structure and the root selected as the import location
  • 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
  • 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.
  • restoring
  • update the master role list
  • check in
  • version control system
  • To import content:
  • On the
  • Tools
  • Import
  • Documents
  • Type the name and location of the .odarc file to import or browse to the file(s).
  • Type the destination location of the .odarc(s) or browse to the location.
  • Check the Overwrite existing documents box if you want to overwrite existing documents of the same name with the imported documents.
  • Click
  • Import
  • When importing multiple .odarc files of the same name, files are imported in the order of the date they were created. This insures the .odarc that was created last overwrites earlier versions if the Overwrite existing documents box is checked.
  • Note: