詳細情報:
InsCensusServiceStd:findContacts
名、姓、メールで既存の取引先責任者を検索するか、検索キーとグループ取引先で検索します。
クラス: InsCensusServiceStd
方法: findContacts
操作手順
-
サービス要求ペイロードに、名、姓、メールアドレス、グループアカウントを持つメンバーの配列が含まれている場合、次のようになります。
-
このサービスは Contact エンティティを照会し、名または姓、あるいはメールアドレスと取引先が一致するすべての取引先責任者を取得します。
-
一致したすべての取引先責任者 ID、名、姓、メールが応答の [取引先責任者] ノードリストに追加されます。
-
-
サービス要求ペイロードに searchKey とグループアカウントが含まれている場合:
-
指定された検索キーに 1 つの単語が含まれている場合、サービスは取引先責任者エンティティを照会し、名前と取引先が部分的/完全に一致するすべての取引先責任者を取得します。指定された検索語で始まる名前では、部分一致がサポートされます。
-
特定の検索キーに複数の単語が含まれている場合:
-
このサービスでは、取引先責任者検索で最初の 2 つの単語 (スペースで区切られている) のみが考慮され、検索キーの残りの単語は無視されます。
-
このサービスは Contact エンティティを照会し、(名が検索キーの最初の単語で始まり、姓が検索キーの 2 番目の単語で始まる) または (名が検索キーの 2 番目の単語で始まり、姓が検索キーの最初の単語で始まる) と account を使用してすべての取引先責任者を取得します。
-
-
一致したすべての取引先責任者 ID、名、姓、メールが応答の [取引先責任者] ノードリストに追加されます。
-
入力:
| 入力 | 説明 |
|---|---|
accountId
|
必須 取引先責任者の GroupAccountId。 |
searchKey
|
メンバーを使用していない場合は必須です。 取引先責任者名に検索キーワードが含まれる取引先責任者を検索するために使用される 1 つ以上の単語。 |
members
|
searchKey を使用していない場合は必須です。 取引先責任者で検索するメンバーのリスト。 |
| メンバーノード | |
FirstName
|
名 |
LastName
|
姓 |
Email
|
|
リモートオプション
| オプション | 説明 |
|---|---|
accountId
|
必須。 取引先責任者の GroupAccountId。 |
searchKey
|
メンバーを使用していない場合は必須です。 取引先責任者名に検索キーワードが含まれる取引先責任者を検索するために使用される 1 つ以上の単語。 |
members
|
searchKey を使用していない場合は必須です。 取引先責任者で検索するメンバーのリスト。 |
| メンバーノード | |
FirstName
|
名 |
LastName
|
姓 |
Email
|
|
Input 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"
},
...
] }