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

Send documentation feedback to Micro Focus

_FT_HTML5_bannerTitle.htm