_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>

_HP_HTML5_bannerTitle.htm