Connector Framework Server 25.4
Connector Framework Server Help

# IncludeRootPath

A Boolean value that specifies whether to include the node specified by DocumentRootPaths in the document. You might set this parameter to `TRUE` if your root node has attributes that you need to include in the document.

For example, consider the following XML:

    <xml>
       <documents>
          <document my_attribute="value">
             <metadata>
               <name>This is the name of the document</name>
               <created>28/02/15 11:01:17</created>
               <modified>28/02/15 15:23:00</modified>
             </metadata>
             <content>Here is some content</content>
           </document>
         </documents>
     </xml>

This can be parsed using the following configuration:

    [XMLParsing]
    DocumentRootPaths=documents/document
    ReferencePaths=metadata/name
    ContentPaths=content

With `IncludeRootPath=FALSE`, CFS produces a document that includes the following fields. The `document` node and `my_attribute` attribute are not included:

    <DOCUMENT>
      <DREREFERENCE>This is the name of the document</DREREFERENCE>
      <metadata>
        <created>28/02/15 11:01:17</created>
        <modified>28/02/15 15:23:00</modified>
      </metadata>
      <DRECONTENT>Here is some content</DRECONTENT>
    </DOCUMENT>

With `IncludeRootPath=TRUE`, CFS produces a document that includes the following fields. The `document` node and `my_attribute` attribute are included:

    <DOCUMENT>
      <DREREFERENCE>This is the name of the document</DREREFERENCE>
      <document my_attribute="value">
        <metadata>
          <created>28/02/15 11:01:17</created>
          <modified>28/02/15 15:23:00</modified>
        </metadata>
      </document>
      <DRECONTENT>Here is some content</DRECONTENT>
    </DOCUMENT>

Type: | Boolean
Default: | False
Required: | No
Configuration Section: | XMLParsing
Example: | `IncludeRootPath=TRUE`
See Also | DocumentRootPaths

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Connector Framework Server 25.4

Topic Title: IncludeRootPath