2.2.2.10.2 Body (Email Namespace)
The Body element is an optional element that contains the body of an email message that is retrieved from the server. This element is defined in the Email 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 a message body. This conserves space and reduces data traffic when synchronizing email messages. The server sets the BodyTruncated element (section 2.2.2.13) in the Sync response to indicate whether the body of the email message has actually been truncated. The untruncated size of the message body is specified by the BodySize element (section 2.2.2.12).
When the client requests truncation, only the first part (or none) of each message body is included in a synchronization. The client can later request the full message body from the server. The client's user interface generally lets the user view the first part of the email message and choose to download the rest, either immediately or on the next synchronization.
If the client enables MIME support by setting the airsync:MIMESupport element, as specified in [MS-ASCMD] section 2.2.3.110.3, the server sends MIME data for some or all email messages, depending on the level of support indicated by the value of the airsync:MIMESupport element. The server uses the MIMEData, MIMESize, and MIMETruncated elements (sections 2.2.2.50, 2.2.2.51, and 2.2.2.52, respectively) instead of the Body, BodySize, and BodyTruncated elements when sending MIME data for email messages.
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.10.1) is used instead of the email:Body element with protocol versions 12.0, 12.1, 14.0, 14.1, 16.0, and 16.1.