Customizing Profiling Values with a Subject Scheme Map

<topicref href="test.ditamap" format="ditamap" type="subjectScheme"/>

• You can create a hierarchy of profiling attribute values and use a DITAVAL file to filter or flag the tree of values.
• You can share the subject scheme files with others without having to share preferences or the entire project.
• The subject scheme offers validation support so you are notified if an undefined value is used.

1. Use the New Document wizard to create a new Subject Scheme document (Framework templates > DITA Map > map > Subject Scheme).
2. Use the controls in Author mode to define the hierarchical tree of values for your subject scheme (see the Author mode example below) or switch to Text mode and define it there if you prefer (see the Text mode example below).
   Note: The pre-defined subject scheme template includes Navigation Titles (<navtitle> element). This element is not required, but if you use it, the text that you enter for the <navtitle> will be used (instead of the name of the value) in the various places where profiling attributes are presented in Oxygen XML Editor. An example of when this might be helpful is if you want to use abbreviations for the name of a value, but you want to see its full name in Oxygen XML Editor.
3. Bind the particular attribute to the key you define for the tree of values using the <attributedef> and <subjectdef> elements inside the <enumerationdef> element. Notice that in the examples below, the audience attribute is bound to the audienceKey value.
   Tip: By default, attributes can accept multiple values, but you can use outputclass="single_value" to specify that a certain attribute only accepts a single value at a time and the attribute will be presented in Oxygen XML Editor with radio buttons instead of checkboxes. For example:

     <enumerationdef outputclass="single_value">
       <attributedef name="audience"/>
       <subjectdef keyref="audienceKey"/>
     </enumerationdef>

   You can also define a specific set of possible attribute values for a specific attribute name that is set on a specific element name. For example, you can define a specific set of @outputclass attribute values only for the <image> element:

    <enumerationdef>
       <elementdef name="image"/>
       <attributedef name="outputclass"/>
       <subjectdef keyref="imgOutputClassValuesKey"/>
     </enumerationdef>

4. If you want to filter out (reject) values for certain attributes, bind the attributes to a blank value (as you see for the props and otherprops attributes in the examples below). This means that those attributes will not appear in the various places where profiling attributes are presented in Oxygen XML Editor.
5. Save your subject scheme file.
6. Reference your subject scheme in the highest level of map (main DITA map) that will use the set of profiling values and set its type to subjectScheme. The easiest way to do this is:
   1. With your subject scheme file opened in the editor, go to the DITA Maps Manager view, right-click the main DITA map, and select Append Child > Reference to the currently edited file.
   2. In the Insert Topic Reference dialog box, go to the Attributes tab and in the Type field, enter or select subjectScheme.
   3. Click the Insert and Close button and save your main DITA map.

<val>
     <prop action="exclude" att="audience" val="surgeon"/>
</val>

<subjectScheme>
  <!-- A scheme that defines audience user values -->
  <subjectdef keys="audienceKey">
    <subjectdef keys="therapist"/>
    <subjectdef keys="oncologist"/>
    <subjectdef keys="physicist"/>
    <subjectdef keys="radiologist"/>
    <subjectdef keys="surgeon">
      <subjectdef keys="neuro-surgeon"/>
      <subjectdef keys="plastic-surgeon"/>
    </subjectdef>
  </subjectdef>
  <!-- Binding the audience attribute to the values defined in the key -->
  <enumerationdef>
    <attributedef name="audience"/>
    <subjectdef keyref="audienceKey"/>
  </enumerationdef>

  <!--Reject all possible values for other profiling attributes-->
  <enumerationdef>
    <attributedef name="props"/>
    <subjectdef/>
  </enumerationdef>
  <enumerationdef>
    <attributedef name="otherprops"/>
    <subjectdef/>
  </enumerationdef>
</subjectScheme>

• The Profiling tab of the Edit Properties dialog box.
• The Edit Profiling Attribute dialog box.
• The inline profiling controls in Author mode.
• The proposals for the attribute values in the Content Completion Assistant.