Create a map

This procedure shows you how to create various types of maps.

DITA CMS offers you templates for the standard ditamaps and IXIASOFT's referable_content_library ditamap. In addition, your system may contain custom templates designed for use in your particular working environment. You will see them in the Map template pane whenever you create a map.

If your working environment has a large number of templates, these may be organized into folders, which will appear in the Map Template pane.

When you create a map, you have the option of assigning your own ID to the map. You can then use this ID – or any portion of the ID – to search for the map in the repository. For example, if you create the ID "Interim_version_3" you can search for the map using "Interim" or "version" or "3". You can obtain this user-defined ID using the Copy ID procedure.
Note: Map IDs must follow the w3.org naming conventions.
Note: Any document that you create is automatically assigned to you.
  1. Do one of the following:
    • Press CTRL+ALT+M.
    • On the Document Creation toolbar, click the Create Map button ().
    • From the menu bar, select DITA CMS > Create Map.
    The Create Map dialog appears. The ID field displays the system-assigned ID.
  2. If you want—and if the field is available—you can assign the map an ID of your own.
    If the field is greyed out, this means that your system administrator has disabled this feature.
  3. In the Map title box, type a title.
    Titles do not have to be unique.
  4. In the Language list, click a language.
  5. In the Map template box, select a map template:
    • bookmap.ditamap: creates a Bookmap ditamap, which contains elements needed to produce a book output.
    • map.ditamap: creates a Map ditamap, which contains elements for a general purpose map.
    • referable_component_library.ditamap: creates Map ditamap that includes the <data name="referable_component_library"/>element, which is used to contain a collection of referable-content topics.
    • subjectScheme.ditamap: create a subjectScheme ditamap, which is used to define a list of controlled values for the conditional processing attributes.
    Templates provide you with the basic structure for the type of map you are creating and define the rules for building the map.
  6. In the Labels pane, click Select to add labels.
    The labels that you select are listed in the Labels pane.
  7. If the map template contains variables, the defined variable names appear in the Template Variables section. Click in the Values column and type or select the values for each variable as required.
  8. Do one of the following:
    • If you want to edit the new map immediately, select Open map in DITA Map view. If you choose not to edit the new map, you will need to use Search and open it from the Search Results view when you are ready to edit it.
    • If you have a map open and locked in the DITA Map view, you can select the option Add to current map as sub-map.
  9. Optional: To save the settings you have selected for Language, Map Template, and Open map in DITA Map view, click Save Settings.
    Your selections are saved and used as the default values in the Create Map dialog. You'll see them there the next time you create a map.
  10. The next steps depend on whether the Dynamic Release Management module is enabled in your deployment:
    • If you see the Next button at the bottom of the Create Map dialog, this module is enabled in your deployment. Go to the next step to specify the release management details.
    • If you see the Create button at the bottom of the Create Map dialog, this module is not enabled. Click Create to create the map. You have completed this procedure.

The following steps are only for deployments with the Dynamic Release Management module enabled.

  1. Click Next.
    The Select Versions dialog box is displayed. If you selected the Add to current map as sub-map option, the version of the containing map is automatically selected in the Selected Products/Libraries, Releases, and Versions pane, since the sub-map must be added to this version.
  2. Do one of the following:
    • To add the map to a product, select Products in the Add Object To box.
    • To add the map to a library, select Libraries in the Add Object To box.
  3. In the All Products/All Libraries pane, select the product or library for which you would like to display the releases and versions.
    Use the filter at the bottom of the pane to filter the list by name.
    The releases and versions for the product or library selected are displayed in the Selected Products/Libraries, Releases, and Versions pane.
  4. To exclude products/libraries, releases, and versions according to the exclusion filters, click Apply global exclusion filter settings.
  5. In the Selected Products/Libraries, Releases, and Versions pane, select the versions in which the object can be used.
    Use the filter at the bottom of the pane to filter the versions in the list by release name.
    The Primary Version drop-down list is populated with the list of selected versions.
  6. In the Primary Version list, select the primary version for the object.

    The primary version is the version for which the object was initially created.

  7. Optional: To save the settings you have selected in this dialog, click Save Settings.
    Your selections are saved and used as the default values in the Select Versions dialog. You'll see them there the next time you create a map.
  8. Click Create.
    The map you created is added to the repository.
    Note: Any document that you create is automatically assigned to you.