Операция FindPeople
Найдите сведения об операции FindPeople EWS.
Операция FindPeople возвращает все объекты persona из указанной папки Contacts или извлекает контакты, соответствующие указанной строке запроса.
Эта операция появилась в Exchange Server 2013.
Использование операции FindPeople
Операция FindPeople возвращает агрегированные контактные данные.
Операция FindPeople основана на существующих функциональных возможностях сложных типов Restriction и BaseShape , добавляя ограничение агрегирования и возможность возвращать дополнительные свойства. Используя ограничение, клиент может указать такие фильтры, как "возвращать только результаты с адресом обмена мгновенными сообщениями". Поведение поиска по умолчанию предназначено как для личного почтового ящика указанного пользователя, так и для глобального списка адресов. При поиске глобального списка адресов в качестве основной папки поиска необходимо указать строку запроса вместо ограничения, так как эта операция не позволяет просматривать глобальный список адресов.
Заголовки SOAP операции FindPeople
Операция FindPeople может использовать заголовки SOAP, перечисленные в следующей таблице.
| Имя заголовка | Элемент | Описание |
|---|---|---|
| Олицетворения |
ExchangeImpersonation |
Определяет пользователя, которого олицетворяет клиентское приложение. Этот заголовок применим к запросу. |
| RequestVersion |
RequestServerVersion |
Определяет версию схемы для запроса операции. Этот заголовок применим к запросу. |
| ServerVersion |
ServerVersionInfo |
Определяет версию сервера, который ответил на запрос. Этот заголовок применим к ответу. |
Пример запроса операции FindPeople
В следующем примере запроса операции FindPeople показано, как вернуть первые 100 контактов из папки Contacts.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="https://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>
Текст SOAP запроса содержит следующие элементы:
В следующем примере запроса операции FindPeople показано, как вернуть первые 100 контактов из глобального списка контактов с помощью строки запроса. Если параметру DistinguishedFolderId присвоено значение "directory", в качестве основного источника персон выполняется поиск в глобальном списке адресов.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="https://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>
Успешный ответ на операцию FindPeople
В следующем примере показан успешный ответ на запрос операции 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="https://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="https://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="https://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<People>
<Persona xmlns="https://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>
Текст SOAP ответа содержит следующие элементы:
Ответ на ошибку операции FindPeople
Коды ошибок, которые являются универсальными для EWS, см. в разделе ResponseCode.
См. также
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по