Importing topic files
You can import topics authored outside IXIA CCMS Desktop and add them to the Content Store.
When you import a topic, the following happens:
- The topic and its dependencies are imported into the Content Store (such as all the topics and images it refers to)
- It is assigned an initial status (such as Authoring:work status)
- It is automatically assigned to you
- Its filename is added to the object's metadata in the
originalFileName
index - Its path relative to its containing map is added to the object's metadata in the
originalRelativePath
index
If one of the topic dependencies cannot be found (for example, one of its images is missing), the import is canceled and an error message is displayed.
If the map or topic being imported references a non-DITA resource such as PDF file or video, it is imported as a resource of the type "unknown", which allows it to be searchable from the Search view. Once imported, you can edit the resource to change the type from "unknown" to something more specific as required.
Import options
Option | Description | |
---|---|---|
Import As External |
When you import the document, it and its children (if any) are imported into the Content Store and assigned the Authoring:readonly status. |
|
Update existing documents |
When you import a document, the system determines if this document already exists. 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 filename. If the Use relative path along with file name to match documents to update option is also selected, the system also checks that the base path of the imported document matches the base path of the document in the Content Store. The system updates the existing document only if the paths match. When you re-import an external document, this option is always enabled and the existing document and its children (if any) are always updated. |
|
Default language |
All documents in the Content Store must have a designated language. If the documents you are importing do not have a language attribute, the system will assign them the language you select from this list. If the document you are importing has children, this language will also be assigned to these children. You can also set the Override unknown languages with default option. When you import documents that reference a language that’s not configured in your system, the system will replace these values with the default language specified if you select this option. |
|
Images options | If the topics you are importing reference
images, you need to specify the type and format of the images.
|
|
Labels | You can assign one or more labels to a document and its children (if any). Labels are added as metadata and improve searchability. | |
Import options | ||
Images: | If this option is selected and there are two (or more) images with the same filename, then the system imports just one of them (randomly). If you leave this checkbox empty, then all images are imported, they keep their duplicate titles, and the system assigns unique filenames. | |
Resources: | If this option is selected and there are two (or more) resources with the same filename, then the system imports just one of them (randomly). If you leave this checkbox empty, then all resources are imported, keep their duplicate titles, and the system assigns filenames. | |
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 Re-importing and updates to existing files for more
information.
|