Delen via


2.2.3.67.2 Fetch (Sync)

The Fetch element is an optional child element of the Commands element in Sync command requests and an optional child element of the Responses element in Sync command responses. In a request, the Fetch element is used to request the application data of an item that was truncated in a synchronization response from the server. The complete item is then returned to the client in a server response.

The ItemOperations command (section 2.2.1.10) is the preferred way to fetch items.

All elements referenced in this section are defined in the AirSync namespace.

Command request/response

Parent elements

Child elements

Data type

Number allowed

Sync command request (section 2.2.1.21)

Commands (section 2.2.3.32)

ServerId (section 2.2.3.166.8)

container ([MS-ASDTYPE] section 2.2)

0...N (optional)

Sync command response

Responses (section 2.2.3.154)

ServerId

Status (section 2.2.3.177.17)

ApplicationData (section 2.2.3.11)

container

0...N (optional)

The Fetch element cannot be used to get truncated calendar, contact, note, recipient information, or task items from the server.

The server is not required to send an individual response for every operation that is sent by the client. The client only receives responses for successful additions, successful fetches, successful changes that include an attachment being added, and failed changes and deletions. When the client does not receive a response, the client MUST assume that the operation succeeded unless informed otherwise.

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

Yes

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes