您位於此處:
InsCensusServiceStd:createUpdateAccounts
使用此服務為指定普查中的成員建立「個人帳戶」。此外也會使用 duplicateKeys 參數更新現有的個人帳戶。
類別:InsCensusServiceStd
方法:createUpdateAccounts
使用此服務時,必須在組織中啟用個人帳戶。
運作方式
若要為指定普查中的成員建立個人帳戶,此服務會:
- 以
censusMemberIds.為依據的檢索GroupCensusMember記錄清單 - 為每個
GroupCensusMember建立「個人帳戶」。 -
下列四個欄位以及對應會從
GroupCensusMember複製到「帳戶」記錄。GroupCensusMember 帳戶 名字 名字 姓氏 LastName 電子郵件 PersonEmail 生日 PersonBirthdate -
如果您在輸入中提供
duplicateKeys參數,則服務會使用「帳戶」物件的逗號分隔欄位清單來識別重複的記錄。如果有現有的「帳戶」記錄具有這些欄位的相同值,則服務會使用現有的「帳戶」記錄。如果沒有duplicateKeys參數,則服務會為每個普查成員建立新的「帳戶」記錄。-
在
duplicateKeys中傳遞的欄位必須是複製到「帳戶」記錄的欄位子集。如果您傳遞任何其他欄位,則會在偵測重複期間忽略這些欄位。
-
-
更新普查成員的
AccountId和ContactId欄位。 -
將
GroupCensusMember.AccountId設為新建立「個人帳戶」的識別碼,將GroupCensusMember.ContactId設為對應的「連絡人」記錄。 -
服務會為其
IsPortalUser為 true 的GroupCensusMember記錄建立使用者記錄。它會使用emailEncoding、localeSID、languageLocale、timeZoneSID和profileId欄位來建立「使用者」記錄。
遠端選項
| 選項 | 描述 |
|---|---|
censusMemberIds |
必要。 建立帳戶記錄的「 |
duplicateKeys
|
帳戶物件的逗號分隔欄位字串,用於根據現有帳戶記錄檢查重複項目。範例: |
personAccountRecordType |
選擇性。 個人帳戶的記錄類型。 如果未傳送該值,則預設為「個人帳戶」。 |
emailEncoding |
必要。 用於建立使用者記錄的編碼格式。 |
localeSID |
必要。 地理位置的安全性識別碼。 |
languageLocale |
必要。 語言的安全性識別碼。 |
timeZoneSID
|
必要。 時區的安全性識別碼。 |
profileId |
必要。 與使用者記錄相關聯的設定檔記錄識別碼。 |
輸出 JSON
輸出 JSON 是成功建立或更新 GroupCensusMember 記錄的帳戶識別碼清單。
GroupCensusMember 記錄的識別碼:
{
"censusMemberIds": [
"0r6RO0000000430YAA",
"0r6RO000000042vYAA"
],
"duplicateKeys": "FirstName,LastName"
"emailEncoding": "UTF-8",
"timeZoneSID": "America/New York",
"languageLocale": "en_US",
"localeSID": "en_US",
"profileId": "00eRO000000OUVRYA4",
}Contact 記錄識別碼:
{
"accountIds": [
"003RO000002yi8iYAA",
"003RO000002yi8dYAA"
]
}