Вы находитесь здесь:
InsCensusServiceStd:findContacts
Найдите существующие контакты по личному имени, фамилии и электронной почте или по ключу поиска и организации группы.
Класс: InsCensusServiceStd
Метод: findContacts
Принцип работы
-
Если полезные данные запроса на обслуживание содержат массив участников с именем, фамилией, адресом эл. почты и организацией группы:
-
Служба запрашивает объект «Контакт» и извлекает все контакты с совпадающими именем и/или фамилией и/или адресом эл. почты и организацией.
-
Все совпадающие код контактов, личное имя, фамилия и электронная почта добавляются в список узлов «контакты» в ответе.
-
-
Если полезные данные запроса на обслуживание содержат searchKey и организацию группы:
-
Если данный ключ поиска содержит одно слово, служба запрашивает объект «Контакт» и извлекает все контакты с частичными/точными совпадающими именами и организацией. Частичное совпадение поддерживается для имен, начинающихся с заданного поискового слова.
-
Если данная клавиша поиска содержит более одного слова:
-
Служба учитывает только первые два слова (разделенные пробелом) для поиска контактов и игнорирует остальные слова в ключе поиска.
-
Служба отправляет запрос объекту «Контакт» и извлекает все контакты с либо (имя начинается с первого слова, а фамилия начинается со второго слова ключа поиска), либо (имя начинается со второго слова, а фамилия начинается с первого слова ключа поиска) и организацией.
-
-
Все совпадающие код контактов, личное имя, фамилия и электронная почта добавляются в список узлов «контакты» в ответе.
-
Вводные данные
| Ввод | Описание |
|---|---|
accountId
|
Обязательно GroupAccountId контактов. |
searchKey
|
Обязательно, если не используются участники. Одно или несколько слов, используемых для поиска контактов с именем контакта, содержащим ключевые слова поиска. |
members
|
Обязательно, если не используется searchKey. Список участников для поиска в контактах. |
| узел member | |
FirstName
|
имя |
LastName
|
фамилия |
Email
|
эл. почта |
Удаленные параметры
| Параметр | Описание |
|---|---|
accountId
|
Обязательно. GroupAccountId контактов. |
searchKey
|
Обязательно, если не используются участники. Одно или несколько слов, используемых для поиска контактов с именем контакта, содержащим ключевые слова поиска. |
members
|
Обязательно, если не используется searchKey. Список участников для поиска в контактах. |
| узел member | |
FirstName
|
имя |
LastName
|
фамилия |
Email
|
эл. почта |
JSON ввода
Ниже указан пример ввода JSON:
{
"contacts":[
{
"Id":"003B000000LEreFIAT",
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com"
},
{
"Id":"003B000000M07HDIAZ",
"FirstName":"David",
"LastName":"Boon",
"Email":"cBoon@test.com"
}
] }
Вывод JSON
Ниже указан образец вывода JSON:
{
"contacts":[
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000LEreFIAT"
},
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000M07HDIAZ"
},
...
] }