Configuring the Proposals for Attribute and Element Values

1. Create a new resources folder (if it does not already exist) in the frameworks directory for the particular document type (for example, OXYGEN_INSTALL_DIR/frameworks/dita/resources).
2. Open the Preferences dialog box (Options > Preferences) and go to Document Type Association. Select the particular document type, click the Edit button, and in the Classpath tab add a link to that resources folder (if it does not already exist).
3. Create a new configuration file or edit an existing one.
   1. To easily create a new configuration file, you can use the Content Completion Configuration document template that is included in Oxygen XML Author (File > New > Framework templates > Oxygen Extensions > Content Completion Configuration). The document template includes details about how each element and attribute is used in the configuration file.
   2. If a configuration file (cc_config.xml) already exists for the particular document type (in the resources folder), you can modify this existing file.

   3. If you extend a framework, you need to copy the content of the cc_config.xml file from the base framework and modify it (e.g. create a resources folder in your framework extension folder and place the file there). You also need to make sure that the folder that contains the cc_config.xml file in your extension (e.g. resources) is listed in the Classpath tab before the one from the base framework.

      If you only want to make small changes or add extra rules in your custom content completion configuration file, you need to name it cc_config_ext.xml and all the rules inside it are merged with the base cc_config.xml file. The merging is done by taking all the rules specified in the cc_config_ext.xml file into consideration after processing the set of rules from the base cc_config.xml file.

4. Make the appropriate changes to your custom configuration file.
5. Save the file in the resources folder for the particular document type, using the fixed name: cc_config.xml (for example, OXYGEN_INSTALL_DIR/frameworks/dita/resources/cc_config.xml).
6. Restart the application and open an XML document. In the Content Completion Assistant you should see your customizations.
   Tip: In some cases, you can simply use the Refresh (F5) action to test your customizations, without having to restart the application.
   Attention: In the Classpath tab, if you have references to multiple resources folders, each with its own cc_config.xml file, the first reference listed in the Classpath tab takes precedence and the multiple configuration files are not combined.

• path - A path within the document that matches the element or attribute that will have its content completion proposals changed. For example:

  • path="title" matches all the <title> elements in the document.
  • path="chapter/title" matches only the <title> elements that are direct children of the <chapter> element.
  • path="@xml:lang" matches all the @xml:lang attributes in the document.
  • path="title/@xml:lang" matches only the @xml:lang attributes that appear on <title> elements.
  You can use simplified forms of XPath in this attribute.

  The XPath expressions can accept multiple attribute conditions and inside each condition you can use AND/OR boolean operators and parentheses to override the priority.

  You can use one or more of the following attribute conditions (default attribute values are not taken into account):

  • element[@attr] - Matches all instances of the specified element that include the specified attribute.
  • element[not(@attr)] - Matches all instances of the specified element that do not include the specified attribute.
  • element[@attr = "value"] - Matches all instances of the specified element that include the specified attribute with the given value.
  • element[@attr != "value"] - Matches all instances of the specified element that include the specified attribute and its value is different than the one given.
  Example: The following are examples of how you could use multiple boolean operators and parentheses inside an attribute condition:

  *[@a and @b or @c and @d]
  *[@a and (@b or @c) and @d]

  The following are just examples of how simplified XPath expressions might look like:

  • elementName
  • //elementName
  • /elementName1/elementName2/elementName3
  • //xs:localName
  • //xs:documentation[@lang="en"]

  Note: Using a namespace prefix requires that you declare it on the <elementProposals> element or on an ancestor element. For example:

  <elementProposals xmlns:db5="http://docbook.org/ns/docbook"
    path="db5:listitem" insertElements="db5:para" />

• editable - Specifies the editable state of the attribute values, as reflected in the Attributes view and the In-place Attributes Editor. The possible values for the @editable attribute are:
  • true - The attribute values can be edited by choosing from a combo box or manually providing a value.
  • false - The attribute values cannot be edited.
  • onlyAllowedItems - The attribute values can be edited, but only by choosing from a list of proposed values, in a non-editable combo box.

• One or more <item> elements, which are grouped inside an <items> element.
  Tip: The <item> element can have a @listValue attribute, which can be set to true if you want those items to be part of a list attribute value (such as attr="item1 item2").
• An <xslt> element that references an XSLT script that gets executed and must return an <items> element.

• append - Adds new values to appear in the proposals list (default value).
• addIfEmpty - Adds new values to the proposals list only if no other values are contributed by the schema.
• replace - Replaces the values contributed by the schema with new values to appear in the proposals list.

<!-- Replaces the values for an element with the local name "lg",
      from the given namespace -->
<valueProposals path="x:lg" xmlns:x="http://www.oxygenxml.com/ns/samples">
  <items action="replace">
    <item value="stanza"/>
    <item value="refrain"/>
  </items>
</valueProposals>

<!-- Adds two values for an attribute "type", from no namespace -->
<valueProposals path="@type" editable="onlyAllowedItems">
    <items>
        <item value="stanza"/>
        <item value="refrain"/>
    </items>
</valueProposals>

<valueProposals path="property[@name='color']">
  <items>
    <item value="red"/>
    <item value="blue"/>
  </items>
</valueProposals>

<valueProposals path="property[@name='shape']">
  <items>
    <item value="rectangle"/>
    <item value="square"/>
  </items>
</valueProposals>

<xslt href="../xsl/get_values_from_db.xsl" useCache="false" action="replace"/>

<sampleArticle>
  <!-- The possible values for @value should be "red" and "blue" -->
  <property name="color" value=""/>
  <!-- The possible values for @value should be "square" and "rectangle" -->
  <property name="shape" value=""/>
</sampleArticle>

<config xmlns="http://www.oxygenxml.com/ns/ccfilter/config">
    <valueProposals path="property/@value">
      <xslt href="get_values.xsl" useCache="false" action="replace"/>
    </valueProposals>
</config>

<xsl:stylesheet 
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  exclude-result-prefixes="xs"
  version="3.0">
  
  <xsl:param name="documentSystemID" as="xs:string"></xsl:param>
  <xsl:param name="contextElementXPathExpression" as="xs:string"></xsl:param>
  
  <xsl:template name="start">
    <xsl:apply-templates select="doc($documentSystemID)"/>
  </xsl:template>
  
  <xsl:template match="/">
   <xsl:variable name="propertyElement" as="element()">
     <xsl:evaluate xpath="$contextElementXPathExpression" context-item="./*"/>
   </xsl:variable>
    
   <items>
     <xsl:if test="$propertyElement/@name = 'color'">
       <item value='red'/>
       <item value='blue'/>  
     </xsl:if>
     <xsl:if test="$propertyElement/@name = 'shape'">
       <item value='rectangle'/>
       <item value='square'/>  
     </xsl:if>
   </items>
  </xsl:template>
</xsl:stylesheet>