Open topic with navigation

# _INCLUDE_CHILDREN

The `_INCLUDE_CHILDREN` element reverses the action of the`_INCLUDE` element by including the children of the last `_INCLUDE` element that was processed.

`_INCLUDE_CHILDREN` provides a straightforward way to return to the previous location in the XML and continue processing without requiring a reverse XPATH expression. The current object and relationship, and the position in the document metadata are not changed.

A subsequent `_INCLUDE_CHILDREN` results in inclusion of the children of an even earlier `_INCLUDE` element (and not of the children of an `_INCLUDE_CHILDREN` element).

As a result the children of an `_INCLUDE_CHILDREN` element are always ignored unless explicitly included by an XPATH expression.

Attribute | Description
--- | ---
Other attributes | Other attributes that are not reserved can be used to replace values in the included XML. The attribute names identify the string to be replaced. The name should be unique and chosen to target only the desired text. The attribute values specify the replacement text. Replacement attributes are inherited from previous `_INCLUDE` elements but can be overridden by redefinition.

## Example

    <DOCUMENTS>
       <DOCUMENT ...>
          <mydoc>
             <obj_attrs>
              ...
             </obj_attrs>
             <_INCLUDE xpath="/DOCUMENTS/RELATION/*" _REL_TYPE_="Is Represented By" _OBJ_TYPE_="Manufacturer Part">
                <_OBJ node_name="object" object_type="_OBJ_TYPE_">
                   <obj_attrs>
                    ...
                   </obj_attrs>
                   <_INCLUDE xpath="/DOCUMENTS/RELATION/*" _REL_TYPE_="Manufacturing Responsibility" _OBJ_TYPE_="Manufacturer"/>
                </_OBJ>
             </_INCLUDE>
          </mydoc>
       </DOCUMENT>

       <RELATION>
          <_TO_REL rel_pattern="_REL_TYPE_" type_pattern="_OBJ_TYPE_" node_name="relation" relation_type="_REL_TYPE_">
             <rel_attrs>
              ...
             </rel_attrs>

             <_INCLUDE_CHILDREN/>
         </_TO_REL>
      </RELATION>
    </DOCUMENTS>

Result

    <mydoc>
      <obj_attrs>
       ...
      </obj_attrs>

      <relation>
        <relation_type>Is Represented By</relation_name>
        <rel_attrs>
          ...
        </rel_attrs>

        <object>
          <object_type>Manufacturer Part</object_type>
          <obj_attrs>
           ...
          </obj_attrs>
          <relation>
             <relation_type>Manufacturing Responsibility</relation_name>
             <rel_attrs>
              ...
             </rel_attrs>
          </relation>
        </object>
      </relation>
    </mydoc>

© 2018 Micro Focus or one of its affiliates | Send documentation feedback to Micro Focus Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm