2.2.3.185 Truncation
The Truncation element is an optional child element of the Options element in Sync command requests that specifies how the body text of a calendar, contact (1), email, or task item is to be truncated when it is sent from the server to the client.
If the Truncation element is omitted, no text is truncated. It is not possible to fetch calendar, contact (1), and task items after they have been truncated.
Elements referenced in this section are defined in the AirSync namespace, except where otherwise indicated by the presence of a namespace prefix (as defined in section 2.2.4).
|
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
|---|---|---|---|---|
|
Sync command request (section 2.2.1.21) |
Options (section 2.2.3.125.6) |
None |
unsignedByte ([MS-ASDTYPE] section 2.8) |
0...1 (optional) |
This truncation applies only to the calendar:Body element, as specified in [MS-ASCAL] section 2.2.2.7.2, the contacts:Body element, as specified in [MS-ASCNTC] section 2.2.2.7.2, the email:Body element, as specified in [MS-ASEMAIL] section 2.2.2.10.2, and the tasks:Body element, as specified in [MS-ASTASK] section 2.2.2.1.2.
The following table lists the valid values for the Truncation element.
|
Value |
Meaning |
|---|---|
|
0 |
Truncate all body text. |
|
1 |
Truncate body text that is more than 512 characters. |
|
2 |
Truncate body text that is more than 1,024 characters. |
|
3 |
Truncate body text that is more than 2,048 characters. |
|
4 |
Truncate body text that is more than 5,120 characters. |
|
5 |
Truncate body text that is more than 10,240 characters. |
|
6 |
Truncate body text that is more than 20,480 characters. |
|
7 |
Truncate body text that is more than 51,200 characters. |
|
8 |
Truncate body text that is more than 102,400 characters. |
|
9 |
Do not truncate body text. |
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 |
|