Gretyl's Portal

Heretto Help

Show Page Sections

Heretto CCMS 22.29

The latest release of Heretto CCMS brings a number of enhancements and fixes that span across multiple areas of the system. Read through them to see what's changed! πŸ™Œ

Release Date

General Availability - October 28, 2022

Content Editor

The Content Editor got two enhancements: one is a new validation mechanism that prevents potential processing issues, the other makes adding a row to a table header simpler. 🎯

Enhanced

  • We added a validation mechanism that marks elements with ID attribute values that contain spaces as invalid. By definition, ID attribute values should not contain spaces or special characters because that can cause processing issues. For that reason, our Content Editor, Source Editor, and Content Library highlight elements that contain an ID attribute with a space as invalid.

    As a result, after you receive an upgrade to Heretto CCMS 22.29, you might notice validation errors on files that were perfectly valid before the upgrade. If that happens, it means that those files contain ID attributes with spaces that are now correctly marked invalid. It also means that you need to fix those IDs by removing the space(s) or replacing it with a hyphen (-) or underscore (_).

    Important:

    If an ID attribute that you need to fix belongs to an element that is reused or linked to, make sure to change the reference first. For example, if one of your content reference (conref) warehouse topics contains a note element with an invalid ID attribute, first use the reuse indicator in the warehouse topic to navigate to the topics that reuse that note and change the conref attribute, then update the note ID itself. That way you have an easy way of finding all files affected by this change.

    Other options that might be useful are:

    • Not Valid filter in the Search tab

    • DITA Attribute Report

    Changing the ID attribute for an element that is referenced may affect the following reference mechanisms:

    • content reference (conref)

    • content key reference (conkeyref)

    • key reference (keyref)

    • local link (link to an element in the currently edited file)

    • peer links (links to link content that is not available at build time)

    • contextual help links

    Figure 1. The Content Library shows a warning that explains that an ID attribute in the file is invalid
    The Content Library shows a warning that explains that an ID attribute in the file is invalid
    Figure 2. The Content Editor highlights an invalid element and shows a red line in the scroll bar to indicate the position of the issue in a topic or map
    The Content Editor highlights an invalid element and shows a red bar in the scroll bar to indicate the position of the issue on a topic or map
  • You can now add rows to a table header by using the Table toolbar. Previously, it was possible in only in the Source Editor. Enjoy!

    Figure 3. You can easily add rows to a table header
    You can easily add rows to a table header

Content Library

Working with metadata in the Resource Drawer has been improved. πŸ’ͺ🏽

Fixed

  • We corrected a behavior where the Resource Drawer refreshed and scrolled to the top every time you made a change in a file metadata. Now you can make edits to multiple metadata fields without having to scroll each time.

    Figure 4. You can access file metadata via the Resource Drawer
    You can access file metadata via the Resource Details Drawer

Localization

The Localization module informs you when a localization package was not uploaded correctly. πŸ‘πŸ»

Enhanced

  • We added a notification to the Localization module that informs you about a localization package upload that was unsuccessful. The notification is generic and we are working on more specific messaging. This error message can mean, for example, that your upload failed because your package was too large.

    Figure 5. Localization module notifies you about an unsuccessful package upload
    The Localization module notifies you about an unsuccessful package upload

Publishing

The Output tab can scroll to the very bottom of your publishing jobs list. πŸŽ‰

Fixed

  • We addressed a behavior that prevented you from scrolling down to older publishing jobs in the Output tab. Now, even when you have dozens of publishing jobs in the Output tab, you can scroll through them all the way down to the oldest ones.

Releases

Release details are nicely visible when viewing a release. πŸ₯°

Enhanced

  • We improved the release preview UI and now it shows much more detail about which release you're currently viewing. Whenever you view a release, you'll see a blue bar with the date of the release, the user who created the release, and the name of the release. We made sure that even very long release names fit in there! πŸ€“

    Figure 6. New info bar in release preview UI
    New info bar in release preview UI

Review Interface

Topics excluded from an assignment are collapsed again. πŸ€—

Fixed

  • If you use Only require attention on topics to filter out some topics from a map when creating assignments, you will be happy to learn that we fixed an issue that prevented topics excluded from an assignment from being collapsed in the Review interface. Even when you set your assignments to only require attention on topics in the Draft status, topics with other statuses were still visible in your assignment. We fixed that and now topics excluded from an assignment are correctly collapsed in the Review interface.

    Figure 7. This option enables you to narrow down the scope of an assignment by file modification date and status
    Only require attention on topics option in assignments
    Figure 8. Topic excluded from an assignment is collapsed
    Topic excluded from an assignment is collapsed