Share via

3.1.4.5.3.1 ServerSyncFilter

  • Article 
 <s:complexType name="ServerSyncFilter">
   <s:sequence>
    <s:element minOccurs="0" maxOccurs="1" name="DssProtocolVersion" 
    type="s1:Version" />
     <s:element minOccurs="0" maxOccurs="1" name="Anchor" 
     type="s:string" />
     <s:element minOccurs="1" maxOccurs="1" name="GetConfig" 
     type="s:boolean" />
     <s:element minOccurs="1" maxOccurs="1" 
     name="Get63LanguageOnly" type="s:boolean" />
     <s:element minOccurs="0" maxOccurs="1" name="Categories" 
     type="s1:ArrayOfIdAndDelta" />
     <s:element minOccurs="0" maxOccurs="1" 
     name="Classifications" type="s1:ArrayOfIdAndDelta" />
     <s:element minOccurs="0" maxOccurs="1" name="Languages" 
     type="s1:ArrayOfLanguageAndDelta" />
   </s:sequence>
 </s:complexType>

DssProtocolVersion: This field is reserved for future use. It MUST NOT be sent by the DSS.

Anchor: This field MUST not be present for the first call to this operation. It SHOULD be set to the anchor returned in the last successful response from this operation. It identifies the point in time that the last GetRevisionIdList operation was completed successfully. This field is an opaque string that is not interpreted by the DSS.<35>

GetConfig: This field MUST be present. Set to TRUE if the DSS is requesting categories, update classifications, and detectoids that have changed since the time denoted by the anchor. MUST be set to FALSE if the DSS is requesting software updates.

Get63LanguageOnly: This field MUST be present if a DSS supports version 1.2 or higher of the protocol. This element is not defined in the ServerSyncFilter type for protocol version 1.1. It MUST NOT be present if the DSS supports version 1.1 of the protocol. MUST be set to TRUE if the DSS is requesting up to 63 languages, as specified in section 1.7. A USS implementing version 1.1 of the protocol MUST silently ignore this field.

Categories: This field MAY be present. The USS MUST ignore this field if the GetConfig field is set to TRUE. The format of the field is specified in section 3.1.4.5.3.2. If the array is not empty, it specifies a list of category IDs. In this case, the Classifications array MUST also contain at least one classification in order for the filter to work. The USS MUST only return update revisions for updates that belong to at least one of the categories and at least one of the classifications specified.

Classifications: This field MAY be present. The USS MUST ignore this field if the GetConfig field is set to TRUE. The format of the field is specified in section 3.1.4.5.3.2. If the array is not empty, it specifies a list of classification IDs. In this case, the Categories array MUST also contain at least one category in order for the filter to work. The USS MUST only return update revisions for updates that belong to at least one of the classifications and at least one of the categories specified.

Languages: This field SHOULD be present if the DSS supports version 1.3 or later of the protocol. This field MUST NOT be present if the DSS supports either 1.1 or 1.2 of the protocol. It format is specified in section 3.1.4.5.3.4.