2.2.2.7.2 Body (Contacts Namespace)

  • Article

The Body element is an optional element that contains the notes for a contact that is retrieved from the server. This element is defined in the Contacts namespace as a child of the airsync:ApplicationData element ([MS-ASCMD] section 2.2.3.11) in Sync command requests and responses ([MS-ASCMD] section 2.2.1.21).

The value of this element is a string data type, as specified in [MS-ASDTYPE] section 2.7.

A client can use the airsync:Truncation element, as specified in [MS-ASCMD] section 2.2.3.185, to request truncation of the contact notes. This conserves space and reduces data traffic when synchronizing contacts. The server sets the BodyTruncated element (section 2.2.2.9) in the Sync response to indicate whether the contact notes have actually been truncated. The untruncated size of the contact notes is specified by the BodySize element (section 2.2.2.8).

When the client requests truncation, only the first part (or none) of each contact's notes is included in a synchronization. The complete notes for a contact cannot be retrieved after a contact has been synchronized with truncated notes.

Protocol Versions

The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.

Protocol version

Element support

2.5

Yes

12.0

12.1

14.0

14.1

16.0

16.1

The airsyncbase:Body element (section 2.2.2.7.1) is used instead of the contacts:Body element with all protocol versions except 2.5.