Apply new profiling attributes

Profiling lets you identify conditional text so that you can produce more than one version of a document when the versions differ in minor ways. Applying profiling attributes are helpful when you want to include all the ways a document varies in one component and select the variations you want to use for a specific output at production or publication time.

The last time you applied an attribute, Inspire remembered it. You can choose to re-apply the last profiling attribute you used. This is helpful if you don't want to select a new attribute and just use the last one you applied.

Follow the steps in Re-apply the last used profiling attribute.

If you want to limit the display of text in the component to the unfiltered text plus the attributes included in a selected filter, follow the steps in Filter content based on profiling attributes.

To apply a new profiling attribute:

  1. Click Components_TopMenuOpt Components.
  2. In the Folders pane, locate the component that you want to add a profiling attribute to.
  3. In the Components pane, right-click the component and then select Edit...

    You can access the same menu by clicking Action_Menu the Options menu.

  4. In the Oxygen editor, select the text where you want to apply one or more profiling attributes.
  5. In the toolbar, click the Oxygen_ProfilingAttributes Update Profiling Attributes menu , and select Update Profiling Attributes.
    To update profiling attributes, you can also use the key combination of Ctrl + Alt + P.
  6. On the Update profiling attributes screen, attribute categories are shown in bold, and all values are listed beneath.

    If the Update profiling attributes screen is blank, it means that text you selected is in a DITA element that doesn't allow for the use of profiling attributes. Select another DITA element or move the text to an element that allows for the use of profiling attributes.

    To find the attribute value you need, you can collapse categories and avoid scrolling through all sub-options. To use expand and collapse options, do any of the following:

    • To collapse all sub-options under a category, click the collapse all button .
    • To expand all category sub-options again, click the expand all button .
    • To collapse one category, click the blue down arrow .
    • To expand one category, click the blue sideways arrow .
  7. To apply one or more profiling attributes, do any of the following:

    • Select the checkbox next to an individual attribute. Repeat this action to select all the attributes you need.
    • To automatically select all values for an attribute, select the checkbox for the category that contains all the attributes. Category name are displayed in Bold.
    • Go to the top of the Filter Profiling Attributes screen and select from Saved Filters.

      If the collection of attributes you need isn't listed in the Saved Filters menu, you can create one. Create a collection of attributes to apply.

    • If an attribute is selected that you don't want to use anymore, clear its checkbox.
    • If you want to remove all profiling attributes, clear all checkboxes.

    Keep the following issues in mind:

    • If the option you select is listed in another category, Inspire selects it automatically there too.
    • The number of options you select is listed in parenthesis after the category name.
    • If you don't see a value you need, ask your administrator to add it.
  8. On the Update profiling attributes dialog, click Select.

    Results:

    • Profiling attributes are applied for the checkboxes you selected.
    • Profiling attributes values can be displayed by using the Display Attributes option.
      • Attribute values are shown in a yellow box below the green frame.
      • You see the name of the attribute in blue, followed by the values inside the brackets [ ].
      • For example, in this tool tip ProfilingAtt_ToolTips_smallthe attribute is Platform and the values are Windows_10 and Windows_8.
    • The saved filter is available to select on the following screens:
      • Update profiling attributes (Oxygen Editor)
      • Filter Profiling Attributes (Oxygen Editor, Publish Component screen, Create a Publishing Profile screen)