Import Ditaval files
You can import Ditaval files in the DITA CMS.
These files must follow the standard Ditaval format defined in the Oasis standard. See the following link for more information:
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.
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.
<?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>
|Update existing documents||When it imports a document, the
DITA CMS determines if this document already exists by checking:
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.
Note that, to be updated, the document:
|Import Base Path:||Specifies the base path to use when replacing existing documents.|
To import one ore more Ditaval files:
The Import dialog appears.
- Open the DITA CMS folder and select Import Ditaval.
The Import Ditaval(s) dialog appears.
The Open dialog appears.
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.
- To replace existing documents with the contents of the imported documents, select Update existing documents. 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.
The Import Options dialog appears. Enter the Import Base Path if applicable.
- Click Finish.