Connector Framework Server 24.1

# 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 2023 Open Text
Version 24.1 | Last updated December 2023

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: IDOL Connector Framework Server 24.1

Topic Title: IncludeRootPath