Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

3.1.4.80 SetUserPreferenceSerializeHelper

SharePoint

This operation is used by the protocol client to associate a preference with a user.

<wsdl:operation name="SetUserPreferenceSerializeHelper">
  <wsdl:input wsam:Action="http://tempuri.org/ISearchSiteAdministrationServiceApplication/SetUserPreferenceSerializeHelper" message="tns:ISearchSiteAdministrationServiceApplication_SetUserPreferenceSerializeHelper_InputMessage"/>
  <wsdl:output wsam:Action="http://tempuri.org/ISearchSiteAdministrationServiceApplication/SetUserPreferenceSerializeHelperResponse" message="tns:ISearchSiteAdministrationServiceApplication_SetUserPreferenceSerializeHelper_OutputMessage"/>
</wsdl:operation>

The protocol client sends an ISearchSiteAdministrationServiceApplication_SetUserPreferenceSerializeHelper_InputMessage request message and the protocol server responds with an ISearchSiteAdministrationServiceApplication_SetUserPreferenceSerializeHelper_OutputMessage response message, as follows:

  • The protocol client MUST specify the userID and preference, corresponding to the user and the preference that MUST be associated to the user.

  • On receipt, the protocol server MUST check if the user and the preference are already associated with each other. If the association does not already exist, the protocol server MUST add an association between them. On success, the protocol server MUST increment the value of preference.Version by 1 and return this value.

  • If the association between the user and the preference already exists, the protocol server MUST check if the version of the associated preference is same as preference.Version. If both the versions are same, the protocol server MUST increment preference.Version by 1 and MUST replace the already associated preference with the given preference (with incremented version). On success, the protocol server MUST return this new value of preference.Version.

  • If both the versions are not same, the protocol server MUST NOT update the already associated preference and MUST return this original value of preference.Version (which is same as the initial value).

  • On error, the protocol server MUST return a FaultException<ExceptionDetail> error message.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.