Import Ditaval files

You can import Ditaval files in IXIASOFT CCMS.

These files must follow the standard Ditaval format defined in the Oasis standard. See the following link for more information:

http://docs.oasis-open.org/dita/v1.2/os/spec/common/about-ditaval.html

When you import a Ditaval file, its file name is added to the object's metadata in the originalFileName index and the path relative to its containing map is added to the object's metadata in the originalRelativePath index.

Note: Any document you import is automatically assigned to you.

Specifying a Ditaval title and description

You can specify the Ditaval title and description inside processing instructions before importing the Ditaval file. This ensures that a meaningful title and description are associated with this Ditaval file.

To specify the title and description, add the following processing instructions to your Ditaval file before importing it:

  • ixiasoft.ditaval.title
  • ixiasoft.ditaval.description

For example:

<?xml version="1.0" encoding="UTF-8"?>
<?ixiasoft.ditaval.title Internal User Guide for Linux ?>
<?ixiasoft.ditaval.description Conditions for publishing the User Guide for Linux to an internal audience ?><val>
	<prop action="include" att="product"/>
	<prop action="include" att="audience"/>
	<prop action="include" att="rev"/>
	<prop action="include" att="platform"/>
	<prop action="exclude" att="audience" val="External"/>
	<prop action="include" att="audience" val="Internal"/>
	<prop action="include" att="platform" val="Linux"/>
</val>

Import options

You can specify the following options when importing Ditaval files:

Option Description
Update existing documents

When it imports a document, the system determines if this document already exists by checking:

  1. That a document exists in the repository with the same name as the original file name of the imported document.
  2. If a document with the same name exists, and the Use relative path along with file name to match documents to update option is selected, the system also checks that the base path of the imported document also matches the base path of the document in the repository.

If a document already exists and the Update existing documents option is selected, the existing document is updated with the contents of the imported document. If this option is not selected, a new document is created, with a new file name.
Import options
  Import Base Path: Specifies the base path to use when replacing existing documents.
Important: The filename and base path of the imported object are important when you intend to replace an existing object. See Reimporting the same file into the Content Store for more information.

To import one or more Ditaval files:

  1. Select File > Import.
    The Import dialog appears.
  2. Open the DITA CMS folder and select Import Ditaval.
  3. Click Next.
    The Import Ditaval(s) dialog appears.
    Import Ditavals
  4. Click Browse.
    The Open dialog appears.
  5. Navigate to the folder that contains the Ditaval file(s), select the file(s), and click Open.
    The selected Ditaval file(s) appear in the Ditavals to import list.
  6. To replace existing documents with the contents of the imported documents, select the Update existing documents checkbox. To also use the relative path to match the documents to update, select Use relative path along with file name to match documents to update.
    Important: If you select Use relative path along with file name to match documents to update, you must specify the base path of the imported file in the Import base path box. The base path of the imported file must match the base path of the object in the Content Store (originalRelativePath index).
  7. Click Next.
  8. In the Import base path box, type the base path to use when replacing existing documents.
  9. Click Finish.