Sie befinden sich hier:
InsCensusServiceStd:findContacts
Suchen Sie nach vorhandenen Kontakten anhand von Vornamen, Nachnamen und E-Mails oder anhand eines Suchschlüssels und eines Gruppenaccounts.
Klasse: InsCensusServiceStd
Methode: findContacts
Funktionsweise
-
Wenn eine Serviceanforderungsnutzlast ein Array von Mitgliedern mit Vornamen, Nachnamen, E-Mail-Adressen und einem Gruppenaccount enthält:
-
Der Service fragt die Einheit "Kontakt" ab und ruft alle Kontakte mit übereinstimmendem Vornamen und/oder Nachnamen und/oder E-Mail-Adresse und Account ab.
-
Alle übereinstimmenden Kontakt-IDs, Vornamen, Nachnamen und E-Mails werden der Knotenliste "Kontakte" in der Antwort hinzugefügt.
-
-
Wenn eine Serviceanforderungsnutzlast einen searchKey und einen Gruppenaccount enthält:
-
Wenn der angegebene Suchschlüssel ein Wort enthält, fragt der Service die Einheit "Kontakt" ab und ruft alle Kontakte mit teilweise/genau übereinstimmenden Namen und Account ab. Die Teilübereinstimmung wird für Namen unterstützt, die mit dem angegebenen Suchwort beginnen.
-
Wenn der angegebene Suchschlüssel mehr als ein Wort enthält:
-
Der Service berücksichtigt nur die ersten beiden Wörter (durch ein Leerzeichen getrennt) für die Suche "Kontakte" und ignoriert die restlichen Wörter im Suchschlüssel.
-
Der Service fragt die Einheit "Kontakt" ab und ruft alle Kontakte mit entweder (Vorname beginnt mit dem ersten Wort und Nachname beginnt mit dem zweiten Wort des Suchschlüssels) oder (Vorname beginnt mit dem zweiten Wort und Nachname beginnt mit dem ersten Wort des Suchschlüssels) und Account ab.
-
-
Alle übereinstimmenden Kontakt-IDs, Vornamen, Nachnamen und E-Mails werden der Knotenliste "Kontakte" in der Antwort hinzugefügt.
-
Eingaben
| Eingabe | Beschreibung |
|---|---|
accountId
|
Erforderlich GroupAccountId der Kontakte. |
searchKey
|
Erforderlich, wenn keine Mitglieder verwendet werden. Ein oder mehrere Wörter, die zum Suchen von Kontakten mit einem Kontaktnamen verwendet werden, der Suchstichwörter enthält. |
members
|
Erforderlich, wenn searchKey nicht verwendet wird. Liste der Mitglieder, nach denen in Kontakten gesucht werden soll. |
| Mitgliedsknoten | |
FirstName
|
Vorname |
LastName
|
Nachname |
Email
|
|
Remote-Optionen
| Option | Beschreibung |
|---|---|
accountId
|
Pflichtangabe. GroupAccountId der Kontakte. |
searchKey
|
Erforderlich, wenn keine Mitglieder verwendet werden. Ein oder mehrere Wörter, die zum Suchen von Kontakten mit einem Kontaktnamen verwendet werden, der Suchstichwörter enthält. |
members
|
Erforderlich, wenn searchKey nicht verwendet wird. Liste der Mitglieder, nach denen in Kontakten gesucht werden soll. |
| Mitgliedsknoten | |
FirstName
|
Vorname |
LastName
|
Nachname |
Email
|
|
Input JSON
Hier ist die Beispiel-Eingabe-JSON:
{
"contacts":[
{
"Id":"003B000000LEreFIAT",
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com"
},
{
"Id":"003B000000M07HDIAZ",
"FirstName":"David",
"LastName":"Boon",
"Email":"cBoon@test.com"
}
] }
Ausgabe-JSON
Hier ist die Beispielausgabe-JSON:
{
"contacts":[
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000LEreFIAT"
},
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000M07HDIAZ"
},
...
] }