Configuring DITA Alias Auto-Update Setting


Prerequisites:
  • Ingeniux CMS 10.6 must be installed. See CMS Statistics to check the site version.


When DITA assets contain new checked-in changes, the correlating DITA alias structures require an update to sync and reflect these changes in the Site Tree structure. Use the DITA alias auto-update setting in local-appsettings.config to determine whether the CMS automatically updates DITA aliases or requires users to manually execute the update action in the CMS UI.

To configure the DITA alias auto-update setting:

  1. Navigate to [Drive:]\[path-to-cms-site-instance]\.
  2. Open local-appsettings.config in a text editor, and navigate to the AliasAutoUpdate key.
    Note

    The AliasAutoUpdate key setting looks similar to the following.

    <!-- Alias system to auto update aliases when Asset is checked in with actual content change -->
    <add key="AliasAutoUpdate" value="true"/>
  3. Set the AliasAutoUpdate key to one of the following settings.

    Value

    Description

    true

    The value is true by default.

    If set to true, the DITA alias auto-update feature becomes enabled. When users check in new content changes to DITA assets, the CMS automatically updates the correlating DITA alias structures in the Site Tree.

    false

    If set to false, the DITA alias auto-update feature becomes disabled. After users check in new content changes to DITA assets, the CMS requires users to manually execute an update action to sync the changes with correlating DITA alias structures.

    See Alias Manual Updates for details to execute DITA alias update actions in the CMS UI.

  4. Save and close local-appsettings.config.
  5. Recycle the CMS instance application pool by completing the following steps.
    1. Open Internet Information Services Manager (IIS), and navigate to the CMS instance's application pool.
    2. Right-click the application pool, and select Recycle.

    The CMS instance application pool recycles, and the CMS registers the local-appsettings.config changes.