CMS 10.6.342: Alias URL Map Entry Paths Include DITA Maps

Statement of Issue

When publishing and replicating DITA maps to the DSS that have been checked in and marked for publish only once in CMS 10.6.342, alias URLs are generated for the maps in the DSS UrlMap.xml file. Additionally, map names are included in the paths of alias URLs generated for DITA topics.

Resolution

In CMS 10.6.378, alias URL map entries are no longer generated for DITA maps in the the DSS UrlMap.xml file. Also, DITA map names are no longer included in the paths of alias URL map entries generated for DITA topics.

Workaround

In CMS 10.6.342, ensure you check in aliased DITA maps and their dependencies for publish at least twice before you run DITA publishing pipeline processing. Check in the DITA content after you initially create or upload them, then check them in a second time before publish. This will prevent alias URL map generation from including the DITA maps.

If DITA maps are being included in alias URLs, remove the alias URL map entries from your CMS instance's Raven Database (RavdenDB) and then run a full publish and replication to regenerate them in the DSS URLMap.xml file.

Part 1: Remove Alias URL Map Entries

To remove alias URL map entries from RavenDB:

1. Log in to the CMS instance Content Store.
2. Click Databases in the leftmost pane's Server utility menu, then click the IGXContentStore database.

   

3. Click Indexes > Query in the leftmost pane's icon utility menu.

   

4. In the Query field, enter the following query string:
   Query string for alias URL map entries

   from 'UrlMapPageEntries' where SchemaName = "_alias_"

5. Press CTRL + ENTER to run the query.

   In the Results area, search results return containing all the alias URL map entries in the CMS database.

6. Click Delete Documents in the Results toolbar.
7. Confirm the deletion in the dialog that displays.

   RavenDB deletes all the alias URL map entries.

Part 2: Regenerate Alias URL Map Entries

1. Check in and mark all aliased DITA content at least twice.
   Important

   If you have aliased DITA content that has not been checked in more than once, delete the aliases, check in the DITA assets twice, then recreate the aliases.

2. Run a full publish and replication to the DSS, including the aliased DITA maps and all their dependencies.
3. When the publish and replication finish, go to the settings folder in the DSS instance's published content directory and then open the UrlMap.xml file in a text editor.
4. Review the alias URL map entries of the published aliased DITA content to confirm DITA maps are excluded from the URL paths.

Additional Information

If you experience further issues or have questions, contact Ingeniux Support.