Du är här:
InsCensusServiceStd:findContacts
Sök efter befintliga kontakter med förnamn, efternamn och e-post, eller med en söknyckel och ett gruppkonto.
Klass: InsCensusServiceStd
Metod: findContacts
Så här fungerar det
-
Om en servicebegäranbelastning innehåller en matris av medlemmar med förnamn, efternamn, e-postadress och ett gruppkonto:
-
Tjänsten frågar kontaktenheten och hämtar alla kontakter med matchande förnamn och/eller efternamn och/eller e-postadress och konto.
-
Alla matchade kontakters ID, förnamn, efternamn och e-postadress läggs till i nodlistan 'contacts' i svaret.
-
-
Om en servicebegäranbelastning innehåller en searchKey och ett gruppkonto:
-
Om den angivna söknyckeln innehåller ett ord frågar tjänsten kontaktenheten och hämtar alla kontakter med delvisa/exakta matchande namn och konto. Delvis matchning stöds för namn som börjar med det angivna sökordet.
-
Om den angivna söknyckeln innehåller mer än ett ord:
-
Tjänsten överväger endast de första två orden (avgränsade med ett blanksteg) för kontaktsökningen och ignorerar resten av orden i söknyckeln.
-
Tjänsten frågar kontaktenheten och hämtar alla kontakter med antingen (förnamn börjar med första ordet och efternamn börjar med andra ordet i söknyckeln) eller (förnamn börjar med andra ordet och efternamn börjar med första ordet i söknyckeln) och konto.
-
-
Alla matchade kontakters ID, förnamn, efternamn och e-postadress läggs till i nodlistan 'contacts' i svaret.
-
Indata
| Indata | Beskrivning |
|---|---|
accountId
|
Obligatoriskt GroupAccountId för kontakter. |
searchKey
|
Krävs om medlemmar inte används. Ett eller flera ord som används för att söka kontakter med kontaktnamn som innehåller nyckelord. |
members
|
Krävs om inte searchKey används. Lista över medlemmar att söka efter i kontakter. |
| medlemsnod | |
FirstName
|
förnamn |
LastName
|
efternamn |
Email
|
e-post |
Fjärralternativ
| Alternativ | Beskrivning |
|---|---|
accountId
|
Obligatoriskt. GroupAccountId för kontakter. |
searchKey
|
Krävs om medlemmar inte används. Ett eller flera ord som används för att söka kontakter med kontaktnamn som innehåller nyckelord. |
members
|
Krävs om inte searchKey används. Lista över medlemmar att söka efter i kontakter. |
| medlemsnod | |
FirstName
|
förnamn |
LastName
|
efternamn |
Email
|
e-post |
Indata-JSON
Här är exempel-JSON för indata:
{
"contacts":[
{
"Id":"003B000000LEreFIAT",
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com"
},
{
"Id":"003B000000M07HDIAZ",
"FirstName":"David",
"LastName":"Boon",
"Email":"cBoon@test.com"
}
] }
JSON för utdata
Här är exempelutdata-JSON:
{
"contacts":[
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000LEreFIAT"
},
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000M07HDIAZ"
},
...
] }