Connector Framework Server 12.11

# 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 2022 Micro Focus or one of its affiliates
Version 12.11 | Last updated February 2022

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 swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Connector Framework Server 12.11

Topic Title: IncludeRootPath