_OBJECT

The _OBJECT (or _OBJ) element is used to retrieve the object on the other side of each relationship (identified by the last _TO_RELATIONSHIP or _FROM_RELATIONSHIP element, further up the DocumentsXML XML hierarchy).

You can also use the elements _TO_OBJECT (_TO_OBJ), and _FROM_OBJECT (_FROM_OBJ) to retrieve the object on the specified side of the relationship. For example, to retrieve a related object from a relationship identified by a _TO_RELATIONSHIP element further up the XML hierarchy, use the _FROM_OBJECT element.

Attribute Description
is_kind_of

An additional filter to restrict the object types. This attribute is not usually required, because objects are filtered by type_pattern during retrieval of the relationships.

node_name

The name of the metadata field that is created for each object. If node_name is not specified the child metadata is added at the current depth in the document metadata. This attribute only adds structure to the metadata and does not affect the metadata itself.

Other attributes

Other attributes that are not reserved are output as metadata in the resulting document.

Example

The following examples result in identical output. The first example uses the node_name attribute:

<_TO_REL ...>
   <responsibility>
      <_OBJ node_name="manufacturer">
       ...
      </_OBJ>

      <attributes>
       ...
      </attributes>
   </responsibility>
</_TO_REL>

The following example does not use the node_name attribute:

<_TO_REL ...>
   <responsibility>
      <manufacturer>
         <_OBJ>
          ...
         </_OBJ>
      </manufacturer>

      <attributes>
       ...
      </attributes>
   </responsibility>
</_TO_REL>

Result

The following XML is output for each relationship (containing the related object data in the <manufacturer> element):

<responsibility>
   <manufacturer>
   ...
   </manufacturer>

   <attributes>
   ...
   </attributes>
</responsibility>

_HP_HTML5_bannerTitle.htm