Open topic with navigation

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

© 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