Operación FindPeople
Busque información sobre la operación EWS FindPeople .
La operación FindPeople devuelve todos los objetos de persona de una carpeta Contacts especificada o recupera los contactos que coinciden con una cadena de consulta especificada.
Esta operación se introdujo en Exchange Server 2013.
Uso de la operación FindPeople
La operación FindPeople devuelve información de contacto agregada.
La operación FindPeople se basa en la funcionalidad existente de los tipos complejos Restriction y BaseShape agregando una restricción de agregación y la capacidad de devolver propiedades adicionales. Mediante el uso de una restricción, un cliente puede especificar filtros como "solo devolver resultados que tengan una dirección de MI". El comportamiento de búsqueda predeterminado tiene como destino tanto el buzón personal del usuario especificado como la lista global de direcciones (GAL). Al buscar la GAL como carpeta de búsqueda principal, debe especificar una cadena de consulta en lugar de una restricción, ya que esta operación no permite examinar la GAL.
Encabezados SOAP de la operación FindPeople
La operación FindPeople puede usar los encabezados SOAP que aparecen en la tabla siguiente.
| Nombre de encabezado | Elemento | Descripción |
|---|---|---|
| Suplantación |
ExchangeImpersonation |
Identifica al usuario al que suplanta la aplicación cliente. Este encabezado es aplicable a una solicitud. |
| RequestVersion |
RequestServerVersion |
Identifica la versión del esquema de la solicitud de operación. Este encabezado es aplicable a una solicitud. |
| ServerVersion |
ServerVersionInfo |
Identifica la versión del servidor que respondió a la solicitud. Este encabezado se aplica a una respuesta. |
Ejemplo de solicitud de operación FindPeople
En el ejemplo siguiente de una solicitud de operación FindPeople se muestra cómo devolver los primeros 100 contactos de la carpeta Contactos.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
</soap:Header>
<soap:Body>
<m:FindPeople>
<m:IndexedPageItemView BasePoint="Beginning" MaxEntriesReturned="100" Offset="0"/>
<m:ParentFolderId>
<t:DistinguishedFolderId Id="contacts"/>
</m:ParentFolderId>
</m:FindPeople>
</soap:Body>
</soap:Envelope>
El cuerpo SOAP de la solicitud contiene los siguientes elementos:
En el ejemplo siguiente de una solicitud de operación FindPeople se muestra cómo devolver los primeros 100 contactos de la GAL mediante una cadena de consulta. Al establecer DistinguishedFolderId en "directorio", se buscará la GAL como origen principal de las personas.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
</soap:Header>
<soap:Body>
<m:FindPeople>
<m:PersonaShape>
<t:BaseShape>IdOnly</t:BaseShape>
<t:AdditionalProperties>
<t:FieldURI FieldURI="persona:DisplayName"/>
<t:FieldURI FieldURI="persona:Title"/>
</t:AdditionalProperties>
</m:PersonaShape>
<m:IndexedPageItemView BasePoint="Beginning" MaxEntriesReturned="100" Offset="0"/>
<m:ParentFolderId>
<t:DistinguishedFolderId Id="directory"/>
</m:ParentFolderId>
<m:QueryString>adams</m:QueryString>
</m:FindPeople>
</soap:Body>
</soap:Envelope>
Respuesta correcta de la operación FindPeople
En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación FindPeople .
<?xml version="1.0" encoding="utf-8"?><s:Envelope
xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="349"
MinorBuildNumber="0"
Version="Exchange2013"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" />
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<FindPeopleResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<People>
<Persona xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
<PersonaId Id="AAQkAGQ1MjJjMTBkLTc4Y2UtNDA5Ny04ZjU5LWI3MTYzNGNkZmRkYQAQAOjFqObcLmtOlzlRnHdXQjo=" />
<CreationTime>2012-01-11T22:25:37Z</CreationTime>
<DisplayName>Terry Adams</DisplayName>
<DisplayNameFirstLast>Terry Adams</DisplayNameFirstLast>
<DisplayNameLastFirst>Adams Terry</DisplayNameLastFirst>
<FileAs>Adams, Terry</FileAs>
<GivenName>Terry</GivenName>
<Surname>Adams</Surname>
<EmailAddress>
<Name>terry@litwareinc.com</Name>
<EmailAddress>terry@litwareinc.com</EmailAddress>
<RoutingType>SMTP</RoutingType>
</EmailAddress>
<EmailAddresses>
<EmailAddress>
<Name>terry@litwareinc.com</Name>
<EmailAddress>terry@litwareinc.com</EmailAddress>
<RoutingType>SMTP</RoutingType>
</EmailAddress>
<EmailAddress>
<Name>tadams@contoso.com</Name>
<EmailAddress>tadams@contoso.com</EmailAddress>
<RoutingType>SMTP</RoutingType>
</EmailAddress>
</EmailAddresses>
<RelevanceScore>2147483647</RelevanceScore>
</Persona>
</People>
<TotalNumberOfPeopleInView>1</TotalNumberOfPeopleInView>
</FindPeopleResponse>
</s:Body>
</s:Envelope>
El cuerpo soap de respuesta contiene los siguientes elementos:
Respuesta de error de la operación FindPeople
Para obtener códigos de error genéricos para EWS, vea ResponseCode.