3.1.4.37.2.1 UpdateColleaguePrivacy

  • Article

The UpdateColleaguePrivacy element is the body of the request WSDL message for the UpdateColleaguePrivacy WSDL operation.

 <s:element name="UpdateColleaguePrivacy">
   <s:complexType>
     <s:sequence>
       <s:element minOccurs="0" maxOccurs="1" name="accountName" type="s:string" />
       <s:element minOccurs="0" maxOccurs="1" name="colleagueAccountName" type="s:string" />
       <s:element minOccurs="1" maxOccurs="1" name="newPrivacy" type="tns:Privacy" />
     </s:sequence>
   </s:complexType>
 </s:element>

accountName: A string that specifies the login name of the user profile to be updated. This value MUST be less than or equal to 400 characters in length. The protocol server MUST treat accountName in a case insensitive manner for retrieval of the user profile.

If accountName is not specified or does not have a value and there is not an existing user profile for the current user, then a new user profile MAY<16> be created which represents the current user and the protocol server MUST update that user profile.

If accountName is not specified or does not have a value and there is an existing user profile for the current user, then the protocol server MUST update that user profile.

If accountName is specified and does not match the login name of an existing user profile, then the protocol server MUST send a SOAP fault message.

colleagueAccountName: A string that specifies the login name of the user profile of the colleague to be updated. This string MUST be less than or equal to 400 characters in length. If this element is not specified or does not have a value, the protocol server MUST use the user profile of the current user. The user specified by colleagueAccountName MUST NOT be the same as the user specified by accountName; otherwise the protocol server MUST send a SOAP fault message. The protocol server MUST treat colleagueAccountName in a case insensitive manner for retrieval of the user profile.

If colleagueAccountName is not specified or does not have a value and there is not an existing user profile for the current user, then a new user profile MUST be created which represents the current user and the protocol server MUST send a SOAP fault message.

If colleagueAccountName is not specified or does not have a value and there is an existing user profile for the current user, then the protocol server MUST send a SOAP fault message.

If colleagueAccountName is specified and does not match the login name of an existing user profile, then the protocol server MUST send a SOAP fault message.

If colleagueAccountName is specified and does match the login name of an existing user profile but that user profile is not a colleague of the user with the user profile specified by accountName, the protocol server MUST send a SOAP fault message.

newPrivacy: A value that MUST correspond to a value in the Privacy (section 2.2.5.4) enumeration. If the current privacy level is not set to NotSet, this value MUST NOT be set to NotSet. If this value is set to "NotSet" when the current privacy level is not set to NotSet the server MUST return a SOAP fault message. This is the updated privacy level that will be assigned to the specified colleague relationship.