Under maintenance

Heretto Help

Show Page Sections

Filter Portal Content

You can filter content on your portal by adding a DITAVAL to the associated sitemap.

Tip: You can filter out your internal or in-progress content from your public Heretto Portal instance for every portal visitor.
  • Ensure that the content that you delivered or want to deliver to the portal is profiled.

    For more information, see Profile Topic Elements and Profile Map Elements.

  • Locate the main sitemap associated with your portal.

    For more information, contact your Heretto CCMS administrator.

  1. Create a new DITAVAL or locate the existing DITAVAL with which you want to filter your portal content.
    For more information on how to create DITAVAL files, see Create a DITAVal.
  2. Associate the DITAVAL with the sitemap by doing the following:
    1. In the Content Library double-click the sitemap that you want to modify to open it in the Content Editor.
    2. With the map open, navigate to the DITAVAL file.
    3. While holding the Shift keyboard key, drag and drop the DITAVAL file at the end of the sitemap.
      Inserting a DITAVAL file
    4. From the dialog, select Data and click Insert.
    5. In the left pane, hover over the DITAVAL and click Edit element properties .
    6. In the window that opens, in the name field, enter content-api-default-audience

      For details about content-api-default-audience, see What is Content Filtering?.

    7. If needed, clear the scope field by clicking the corresponding trash icon.

Your DITAVAL file is now added to your main sitemap and looks like this:

<data href="ditaval-file-name.ditaval" name="content-api-default-audience" value=""/>

Your Heretto Portal environment(s) configured as active sync deployments will reflect the DITAVAL settings almost instantaneously. To see changes on instances with manual deploy configured, publish that deployment in the Administration interface.

Profile Topic Elements

Use the Content Editor to apply conditional processing attributesto elements in a topic for conditional publishing.

The default conditional processing attributes are: audience, rev, platform, product, props, and otherprops.
  1. In the Content Library double-click a topic or a map.
  2. Place your cursor in the element you want to set a conditional processing attribute values on.
    Note: We recommend profiling grammatically independent elements, not individual words or phrases. This is especially important when localizing the content, since at least a complete sentence provides sufficient context for accurate translation memory and machine translation matching. This is true even if you reuse text across alternative elements for different conditions. When localizing content, it's always best to think of it grammatically first, then structurally.
  3. Click Attributes to open the Attributes tab.
  4. Navigate to the conditional processing attribute that you want to define, for example audience.
  5. Enter the values for each conditional processing attribute that defines the condition to which the profiled content applies.
    Tip: To add multiple values for conditional processing attributes, insert a space between each value.
  6. Press the Enter keyboard key to apply attribute values.
Depending on the action defined for a specific value at publish time, content is either flagged, excluded, or included. If you do not specify an action for a specific value, the default is to include the content (unless your publishing profile sets the default to exclude).

Profile Map Elements

Use the Content Editor to set conditional processing attribute values and profile an entire topic (topicref element) or a submap (mapref element) for conditional publishing.

The default conditional processing attributes are: audience, rev, platform, product, props, and otherprops.
Note: When you apply a conditional processing attribute to a parent topic (topicref element), the same attribute applies to all children of that topic.
  1. In the Content Library, double-click a map.
  2. In the left pane, hover over the element you want to set the conditional processing attributes for and click the wrench icon.
  3. Enter the values for each conditional processing attribute that defines the condition to which the profiled content applies.
    Tip: To add multiple values for conditional processing attributes, insert a space between each value.

Create a DITAVal

Create a DITAVAL containing include or exclude rules to filter content at publish or during editing.

  1. In the Content Library, navigate to a folder and click Create New.
  2. Select DITAVal to open the Create new window.
  3. Add a meaningful file name.
    Note:

    The valid characters for file and folder names are:

    • lowercase letters (a-z)

    • uppercase letters (A-Z)

    • numbers (0-9)

    • underscore (_), hyphen (-), and period (.)

    This applies to creating files and folders and renaming files and folders.

  4. Optional: Save the file in a folder different from the current folder by clicking Change and selecting a new location.
  5. Optional: Assign the file to collections by clicking Collections and selecting collections from the list.
  6. Optional: Assign metadata to the file by filling in the Metadata fields.
  7. Click Create & Edit.
  8. Edit or remove the default property, or click Add Prop to add a new action.
You can use this DITAVAL to publish or filter your content as you edit or review files in your Content Library. For more information, see Filter Content in Content Editor with a DITAVAL and Create an Assignment.