您位於此處:
InsCensusServiceStd:findAccounts
依名字、姓氏和電子郵件搜尋現有個人帳戶,或依搜尋索引鍵和群組帳戶搜尋。
類別:InsCensusServiceStd
方法:findAccounts
運作方式
-
如果服務要求裝載包含具有名字、姓氏、電子郵件地址和群組帳戶的成員陣列:
-
此服務會查詢「帳戶」實體,並取用所有具有相符名字和/或姓氏和/或電子郵件地址和帳戶的個人帳戶。
-
所有相符的個人帳戶識別碼、名字、姓氏和電子郵件都會新增至回應中的「帳戶」節點清單。
-
-
如果服務要求裝載包含 searchKey 和群組帳戶:
-
如果指定的搜尋索引鍵包含一個字,則服務會查詢「帳戶」實體,並檢索具有部分/完全相符名稱和帳戶的所有個人帳戶。名稱開頭為指定的搜尋字詞支援部分比對。
-
如果指定的搜尋索引鍵包含一個以上的字:
-
此服務只會考量「帳戶」搜尋的前兩個字 (以空格分隔),並忽略搜尋索引鍵中的其餘字。
-
此服務會查詢「帳戶」實體,然後使用 (名字以搜尋索引鍵的第一個字開頭,姓氏以搜尋索引鍵的第二個字開頭) 或 (名字以第二個字開頭,姓氏以搜尋索引鍵的第一個字開頭) 和「帳戶」來檢索所有個人帳戶。
-
-
所有相符的個人帳戶識別碼、名字、姓氏和電子郵件都會新增至回應中的「帳戶」節點清單。
-
輸入
| 輸入 | 描述 |
|---|---|
accountId
|
必要。 個人帳戶的 GroupAccountId。 |
searchKey
|
如果未使用成員,則為必要。 用於搜尋個人帳戶且帳戶名稱包含搜尋關鍵字的一或多個字詞。 |
members
|
如果未使用 searchKey,則為必要。 搜尋帳戶的成員清單。 |
| 成員節點 | |
members.FirstName
|
名字 |
members.LastName
|
姓氏 |
members.PersonEmail
|
遠端選項
| 選項 | 描述 |
|---|---|
accountId
|
必要。 連絡人的 GroupAccountId |
searchKey
|
如果未使用成員,則為必要。 用來搜尋個人帳戶且連絡人名稱包含搜尋關鍵字的一或多個字詞。 |
members
|
如果未使用 searchKey,則為必要。 搜尋個人帳戶的成員清單。 |
| 成員節點 | |
FirstName
|
名字 |
LastName
|
姓氏 |
PersonEmail
|
輸入 JSON
以下是範例輸入 JSON:
{
"accounts":[
{
"Id":"001B000001QZObgIAH",
"FirstName":"Christine",
"LastName":"Boon",
"PersonEmail":"cBoon@test.com"
},
{
"Id":"001B000001QZObgIAJ",
"FirstName":"David",
"LastName":"Boon",
"PersonEmail":"cBoon@test.com"
}
] }輸出 JSON
以下是範例輸出 JSON:
{
"accounts":[
{
"FirstName":"Christine",
"LastName":"Boon",
"PersonEmail":"cBoon@test.com",
"Id":"001B000001QZObgIAJ"
},
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"PersonEmail":"001B000001QZObgIAR"
},
...
] }