emailAlias Element
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
Specifies the e-mail alias of the user being located by the search request.
Syntax
<emailAlias>string value</emailAlias>
Element Information
Parent Element
Element |
Description |
---|---|
Searches for users. |
Remarks
This element searches for a user using their e-mail alias. It is important to note that a user also has a user alias and while that alias is an attribute of a user, it is only searched if the @ symbol is not specified. If a @ symbol is specified, the e-mail address and SIP URIs are searched.
user: bob-Kelly
email:bkelly@contoso.com
<emailAlias>bob-kelly</emailAllias> fails
<emailAlias>bob-kelly@</emailAllias> fails
<emailAlias>bkelly</emailAllias> works
<emailAlias>bkelly@</emailAllias> works
Examples
A user named Bob Kelly is part of the enterprise where the logged-on user works. Bob Kelly has an e-mail alias of 'b-Kelly' and a user alias of 'bob-Kelly'. The logged-on user is doing a search to find Bob Kelly and initiate an IM conversation with him.
<search>
<emailAlias>bob-kelly</emailAlias>
<search>
This search does not result in a find because the user has chosen the value of Bob Kellys user alias instead of the emailAlias value.
<search>
<emailAlias>b-kelly</emailAlias>
<firstName>Bob</firstName>
<function>and</function>
<search>
This search returns the expected results because the user has specified the correct e-mail alias of Bob Kelly. In addition, the firstName element has been added to ensure that only Bob Kelly is returned and Madeleine Kelly is not returned.