Du er her:
InsCensusServiceStd:findContacts
Søk etter eksisterende kontakter etter fornavn, etternavn og e-postadresse, eller etter en søknøkkel og en gruppekonto.
Klasse: InsCensusServiceStd
Metode: findContacts
Slik virker det
-
Hvis en tjenesteforespørselsbelastning inneholder en matrise med medlemmer med fornavn, etternavn, e-postadresse og en gruppekonto:
-
Tjenesten spør Kontakt-enheten og henter alle kontakter med samsvarende fornavn og/eller etternavn og/eller e-postadresse og konto.
-
Alle samsvarende kontakter-ID, fornavn, etternavn og e-postmelding legges til i kontakts-nodelisten i svaret.
-
-
Hvis lastingen av en tjenesteforespørsel inneholder en searchKey og en gruppekonto:
-
Hvis den gitte søkenøkkelen inneholder ett ord, spør tjenesten Kontakt-enheten og henter alle kontakter med delvise/eksakte samsvarende navn og konto. Delvis samsvar støttes for navn som starter med det gitte søkebegrepet.
-
Hvis den gitte søkenøkkelen inneholder flere enn ett ord:
-
Tjenesten vurderer bare de to første ordene (atskilt med et mellomrom) i Kontakter-søket, og ignorerer resten av ordene i søkenøkkelen.
-
Tjenesten spør Kontakt-enheten og henter alle kontakter med enten (første navn starter med første ord og etternavn starter med andre ord i søkenøkkelen) eller (første navn starter med andre ord og etternavn starter med første ord i søkenøkkelen) og konto.
-
-
Alle samsvarende kontakter-ID, fornavn, etternavn og e-postmelding legges til i kontakts-nodelisten i svaret.
-
Inndata
| Inndata | Beskrivelse |
|---|---|
accountId
|
Obligatorisk GroupAccountId for kontakter. |
searchKey
|
Kreves hvis du ikke bruker medlemmer. Ett eller flere ord som brukes til å søke i kontakter med kontaktnavn som inneholder søkenøkkelord. |
members
|
Kreves hvis searchKey ikke brukes. Liste over medlemmer som det skal søkes etter i kontakter. |
| medlemsnode | |
FirstName
|
fornavn |
LastName
|
etternavn |
Email
|
e-post |
Eksterne alternativer
| Alternativ | Beskrivelse |
|---|---|
accountId
|
Obligatorisk. GroupAccountId for kontakter. |
searchKey
|
Kreves hvis du ikke bruker medlemmer. Ett eller flere ord som brukes til å søke i kontakter med kontaktnavn som inneholder søkenøkkelord. |
members
|
Kreves hvis searchKey ikke brukes. Liste over medlemmer som det skal søkes etter i kontakter. |
| medlemsnode | |
FirstName
|
fornavn |
LastName
|
etternavn |
Email
|
e-post |
Inndata-JSON
Her er et eksempel på JSON-koden for inndata:
{
"contacts":[
{
"Id":"003B000000LEreFIAT",
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com"
},
{
"Id":"003B000000M07HDIAZ",
"FirstName":"David",
"LastName":"Boon",
"Email":"cBoon@test.com"
}
] }
Utdata-JSON
Her er et eksempel på JSON-koden for utdata:
{
"contacts":[
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000LEreFIAT"
},
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000M07HDIAZ"
},
...
] }