object element

The object element describes an object to retrieve. Object elements can be nested within the collection or within other objects.

Attribute Description Required
name The name of the object to retrieve. Yes

Example

In the following example, the connector retrieves the owninguser object:

<?xml version="1.0" encoding="utf-8"?>
<spec>
  <collection name="accounts">
    <item name="accountid" />
    <item name="name" />
    <item name="description" />
    <object name="owninguser">
      <item name="employeeid" />
      <item name="fullname" />
    </object>
  </collection>
</spec>

An example of a document produced by this specification appears below:

<DOCUMENT>
  <DREREFERENCE>http://host/Dynamics/api/data/v8.1/accounts(34b8ffd0-4232-e611-80c5-0050569248a7)</DREREFERENCE>
  <accountid>34b8ffd0-4232-e611-80c5-0050569248a7</accountid>
  <description>This is the description</description>
  <name>Hewlett Packard Enterprise</name>
  <owninguser>
    <employeeid>0123456</employeeid>
    <fullname>John Smith</fullname>
  </owninguser>
</DOCUMENT>

Objects can also be nested within other objects, for example:

<?xml version="1.0" encoding="utf-8"?>
<spec>
  <collection name="accounts">
    <item name="accountid" />
    <item name="name" />
    <item name="description" />
    <object name="owninguser">
      <object name="...">
         <item name="..." />
      </object> 
      <item name="employeeid" />
      <item name="fullname" />
    </object>
  </collection>
</spec>