위치:
InsCensusServiceStd:findContacts
이름, 성, 이메일 또는 검색 키 및 그룹 계정별로 기존 연락처를 검색합니다.
클래스: InsCensusServiceStd
방법: findContacts
작동 방법
-
서비스 요청 페이로드에 이름(성 없이), 성(姓), 이메일 주소, 그룹 계정이 있는 구성원 배열이 포함된 경우:
-
서비스가 연락처 엔티티를 쿼리하고 이름(성 없이)과 성(姓), 이메일 주소 및 계정이 일치하는 모든 연락처를 검색합니다.
-
일치하는 모든 연락처 ID, 이름(성 없이), 성(姓), 이메일이 응답의 '연락처' 노드 목록에 추가됩니다.
-
-
서비스 요청 페이로드에 searchKey 및 그룹 계정이 포함된 경우:
-
지정된 검색 키에 단어가 하나 포함되어 있는 경우 서비스에서 연락처 엔티티를 쿼리하고 일부/정확하게 일치하는 이름과 계정이 있는 모든 연락처를 검색합니다. 일부 일치는 지정된 검색어로 시작하는 이름에 대해 지원됩니다.
-
지정된 검색 키에 단어가 두 개 이상 포함된 경우:
-
서비스는 연락처 검색에 대해 처음 두 개의 단어(공백으로 구분)만 고려하고 검색 키의 나머지 단어를 무시합니다.
-
서비스는 연락처 엔티티를 쿼리하고 모든 연락처(성 없이 이름이 첫 번째 단어로 시작하고 성으로 검색 키의 두 번째 단어로 시작) 또는(성 없이 이름이 두 번째 단어로 시작하고 성으로 검색 키의 첫 번째 단어로 시작) 및 계정을 검색합니다.
-
-
일치하는 모든 연락처 ID, 이름(성 없이), 성(姓), 이메일이 응답의 '연락처' 노드 목록에 추가됩니다.
-
입력
| 입력 | 설명 |
|---|---|
accountId
|
필수 연락처의 GroupAccountId입니다. |
searchKey
|
구성원을 사용하지 않는 경우 필수입니다. 검색 키워드를 포함하는 연락처 이름이 있는 연락처를 검색하는 데 사용되는 단어입니다. |
members
|
searchKey를 사용하지 않는 경우 필요합니다. 연락처에서 검색할 구성원의 목록입니다. |
| 구성원 노드 | |
FirstName
|
이름 |
LastName
|
성 |
Email
|
이메일 |
원격 옵션
| 옵션 | 설명 |
|---|---|
accountId
|
(필수) 연락처의 GroupAccountId입니다. |
searchKey
|
구성원을 사용하지 않는 경우 필수입니다. 검색 키워드를 포함하는 연락처 이름이 있는 연락처를 검색하는 데 사용되는 단어입니다. |
members
|
searchKey를 사용하지 않는 경우 필요합니다. 연락처에서 검색할 구성원의 목록입니다. |
| 구성원 노드 | |
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"
},
...
] }