Login
Home CMS Documentation Home CMS 10 DITA Processing Pipeline Initial DITA Configuration DITA Administration DITA Map Management DITA Aliases Alias and DITA Content Updates

Alias and DITA Asset Updates

When DITA content contains new changes, the correlating alias structures automatically update after check-in to sync and reflect these changes in the Site Tree structure. The update syncs the changes while maintaining the original DITA alias IDs.

DITA content changes may alter alias structures when the CMS syncs them. Examples of DITA content changes that affect alias structures include:

  • File name, file title, or navigation title changes.

    If the title changes that the correlating alias uses, then the alias update will reflect this change in the Site Tree.

  • The addition, rearrangement, or deletion of file references or map group elements within the DITA map structure.

    If users add, reorder, or remove topic references from the DITA map structure, then the alias structure update will reflect these changes in the Site Tree. If the DITA map contains new aliases after the update, then the system generates IDs for the new aliases.

  • Document type refactoring on DITA files.

    If users refactor a DITA asset to a new document type, then the Toggle Content Subtype Information tool reflects the document type change of the DITA asset in the Assets Tree and the correlating alias in the Site Tree.

    For example, let's say a user refactors a DITA task topic to a DITA concept topic and then checks in the changes. When the alias update syncs the changes and the user selects the Toggle Content Subtype Information button, then the DITA alias displays as a concept instead of a task in the Site Tree.

Version Notes: CMS 10.6.378 vs. CMS 10.6.308–10.6.342
Alias update functionality differs between CMS 10.6.378 and CMS 10.6.308–10.6.342.

  • In CMS 10.6.378, alias structures are updated based on the DITA map's latest content version and versions marked to publishing targets. Additionally, any publish marking changes made to DITA content will trigger alias updates.

    To toggle between alias structure differences per publishing target, select the publishing target in the Site Tree target drop-down list.

  • In CMS 10.6.308–10.6.342, aliases are only updated based on the current version of the DITA map structure. If you mark an older version of the DITA map structure, the alias structure will not account for the map dependencies in that version.

See CMS DITA Versioning Functionality for more details about these changes.