3.1.4.1 AddColleague

The AddColleague WSDL operation is used to update the specified user profile by adding a colleague association.

The operation of adding a colleague is unidirectional, meaning that when a colleague is added to the specified user, the user profile of the colleague will not be updated.

 <wsdl:operation name="AddColleague">
     <wsdl:input message="tns:AddColleagueSoapIn"/>
     <wsdl:output message="tns:AddColleagueSoapOut"/>
 </wsdl:operation>

The protocol client sends an AddColleagueSoapIn request WSDL message and the protocol server responds with an AddColleagueSoapOut response WSDL message.

If the user is not authorized to administer the user profile service and is not updating his or her own user profile, the protocol server MUST send a SOAP fault message.

Additionally, if the user does not have the Use Personalization Features permission, the protocol server MUST send a SOAP fault message. The Use Personalization Features permission is defined for users in the User Profile Service Application and governs the user’s access to view other’s profiles and view/edit their own profile.

Figure 3: AddColleague operation

The AddColleagueWithoutEmailNotification WSDL operation behaves identically to the AddColleague WSDL operation, except that the server will not send any email notifications upon successful addition of a new colleague.