The Import Maps wizard lets you add one or more maps authored outside the DITA CMS to the repository.
When you import a map, this map and its dependencies (for example, the map, topics, and images it refers to) are imported into the repository and assigned the initial status (for example, Authoring:Draft). 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. If one of the map dependencies cannot be found (for example, one of its topics is missing), the import is cancelled and an error message is displayed.
When you import a map, 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.
You can specify the following options when importing maps:
|Import As External||
When you import the document, it and its children (if any) are imported into the repository and assigned the Authoring:readonly status.
|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:
When you re-import an external document, this option is always enabled and the existing document and its children (if any) are always updated.
All documents in the DITA CMS 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. If you select this 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.
|Images|| If the maps 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.|
|MAP IDs: Retain root map IDs||If this option is not selected, the map is assigned a
new ID by the system. This will be used as both the file name and as the
map root ID. The imported map’s root ID is overwritten.
If this option is selected, then the value of the imported map ID remains unchanged. If no other map already has this file name, then this ID will also be used as the document file name. If there is a conflict with an existing map file name, the system will assign the imported map a unique file name, which will be different from the map ID.
|Topicrefs: Remove @navtitle and @type from <topicref> containing @href||If this option is selected, then navtitle and type attributes are removed from <topicref> elements containing an href attribute when the map is imported.
When you are authoring DITA documents, there are several ways that you can specify topic attributes such as type and title: at the map level and at topic level. DITA CMS does not maintain map attributes automatically. If you keep these in the map, then you’ll need to update them manually if, for example, you change the title of a topic.
|Images: Images have unique names||If this option is selected and there are two (or more) images with the same file name, then the system imports just one of them (randomly). If you leave this check box empty, then all images are imported, they keep their duplicate titles, and the system assigns unique file names.|
|Resources: Resources have unique names||If this option is selected and there are two (or more) resources with the same file name, then the system imports just one of them (randomly). If you leave this check box empty, then all resources are imported, keep their duplicate titles, and the system assigns file names.|
|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 DITA CMS for more information.
To import one or more maps and its dependencies:
. The Import dialog appears.
- Open the DITA CMS folder and select Import Maps.
The Import Map(s) dialog appears.
The Open dialog appears.
Navigate to the *.ditamap file(s), select them, and click
The selected maps appear in the Maps to import list.
To import as a read-only object, select the
Import As External checkbox.
Note: As a result of selecting this option, several other features are set to default values and disabled.
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).
- In the Default language list, choose the language you want set for the file. If you want to overwrite the language attribute set in the imported file with the selected language, select the Override unknown languages with default checkbox.
- In the Images options section, choose the type of images in the Type list and the output format in the Format list for the images referenced in the document.
- Optional: To assign a label, click Select and add one or more labels. Click OK when done.
- Click Next.
- Select the Map IDs checkbox to keep the existing IDs. Clear the checkbox if you want new IDs assigned upon import.
- Select the Topicrefs checkbox to remove the navtitle and type attributes from <topicref> elements that contain an href attribute upon import. Clear the checkbox if you do not want the attributes removed.
- Select the Images checkbox to import only one instance of images with the same file name. Clear the checkbox if you want all images imported and assigned unique file names.
- Select the Resources checkbox to import only one instance of resources with the same file name. Clear the checkbox if you want all resources imported and assigned unique file names.
- In the Import base path box, type the base path to use when replacing existing documents.
- Click Finish.