2.2.3.131 Partial

The Partial element is an optional child element of the Sync element in Sync command requests that indicates to the server that the client sent a partial list of collections, in which case the server obtains the rest of the collections from its cache.

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)

Sync (section 2.2.3.180)

None

None

0...1 (optional)

The Partial element is an empty tag element, meaning it has no value or data type. It is distinguished only by the presence or absence of the <Partial/> tag.

The client MUST NOT send a Partial element without any other elements in the Sync request. A Sync command request is valid with only a Partial element and either a Wait element (section 2.2.3.198) or HeartbeatInterval element (section 2.2.3.88.2), a WindowSize element (section 2.2.3.199), a Collections element (section 2.2.3.31.2), or any combination of the three. A Sync command request requires, at least, either a Partial element or a Collections element.

When a Sync command request includes a Partial element but does not specify some collections, the settings and synchronization key for each of those unspecified collections specified in the previous Sync request remain the same as specified in the previous request. Such a request is equivalent to a request that specifies each of these collections with the same settings and synchronization key as in the previous request. This enables the client to modify some aspect of the previous request (one of the collections, the wait time, the global window size, and so on) without sending up every unchanged collection.

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

12.0

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes

Show: