A 附錄：資料對應

Oracle Fusion REST API for Contacts and Accounts 可用來與 Oracle Utilities 客戶資訊系統中的「人員資訊同步 REST API」整合。

Oracle Utilities 客戶資訊系統中的「人員 ID」會被儲存為「來源系統參考值」，且其來源系統為 Fusion 關係方記錄上的客戶資訊系統。「Fusion 關係人編號」會被儲存為「客戶資訊系統人員」特性值，且其特性類型為「外部聯絡資訊 ID」C1-EXCID。

下表包含您在 Oracle Utilities 客戶資訊系統與 Oracle Customer Experience for Utilities 體驗之間同步名稱、聯絡點及特性值時的資料元素對應。

資料對應明細

此表格提供資料對應明細：

表格 A-1 資料對應明細

Fusion REST API	公用事業產業資料模型 API	CIS REST API	描述	資料對應
/contacts	/utilitiesCustomer/v1/individual	/customer/v-model/cxPersons	聯絡資訊是指身為客戶、客戶聯絡人、潛在客戶，或是其他有業務關係的個人。	在客戶資訊系統中，只有與計費帳戶相關之客戶的聯絡資訊，才會受到同步。
/accounts	/utilitiesCommercial/v1/organization	/customer/v-model/cxPersons	帳戶就是有客戶或銷售潛在客戶關係的業務實體或組織。	在客戶資訊系統中，只有與計費帳戶相關之客戶的帳戶，才會受到同步。
PartyId			聯絡資訊、帳戶或記錄的唯一索引鍵識別碼。
SourceSystem	sourceSystem		聯絡關係方整合之處的外部來源系統名稱。	Fusion 中的「客戶資訊系統」值。
SourceSystemReferenceValue	sourceSystemReferenceValue	personId	在屬性 SourceSystem 所指定之外部來源系統中，聯絡資訊或帳戶關係方記錄的唯一識別碼。在客戶資訊系統中，「人員 ID」是人員記錄的唯一系統指派索引鍵識別碼值。
PartyNumber		cxContactId	Fusion 中客戶記錄的關係人編號。這是用於 Fusion 聯絡資訊或帳戶記錄之路徑參數中的聯絡關係方替代索引鍵識別碼。	Fusion 關係人編號會被儲存為「客戶資訊系統」特性值，且其特性類型為「外部聯絡資訊 ID」C1-EXCID。
		personOrBusiness	指出實體是人員，還是公司，以及是否會影響客戶資訊系統中的驗證。	系統會將 "P" 值整合至個人 utilitiesCustomer 以作為 Fusion 聯絡資訊。"B" 值則會被整合至組織 utilitiesCommercial 以作為 Fusion 帳戶。
	primaryName	primaryName	人員的主要名稱會是該人員帳單及其他通訊上的收件人，除非遭到置換郵寄名稱的置換。
FirstName	firstName	firstName	個別人員的名字，不適用於組織。
LastName	lastName	lastName	個別人員的姓氏，不適用於組織。
ContactPoints	contactPoint	contactDetails	人員聯絡點會擷取聯絡資訊，例如電話號碼與電子郵件地址、URL、Messenger ID 等等。系統只會整合已受核准的現用聯絡點。
ContactPointId	id	contactExternalId	聯絡點記錄的唯一識別碼。
ContactPointType	pointType		聯絡點的類型。Fusion 標準查尋 COMMUNICATION_TYPE，以及「人員聯絡資訊類型」的可設定客戶資訊系統管理。範例值：PHONE、EMAIL、INSTANT_MESSAGING、WEB、SMS、TLX、EDI、EFT。客戶資訊系統有可延伸查尋 C1-CommRoutingMethodLookup，其值為 CSS (自助服務使用者)、EMAIL、FAX 及 PHONE。	公用事業組態：communicationType 範例： "ccsValue": "FAX", "faValue": "TLX"
EmailAddress PhoneNumber URL	value	contactDetailValue	包含特定的聯絡資訊值，例如電話號碼、電子郵件地址，或是採用相關聯格式的 URL。
EmailPurpose		personContactType	定義使用電子郵件聯絡點的目的。Fusion 標準查尋 CONTACT_POINT_PURPOSE。範例值：PERSONAL、BUSINESS、COLLECTIONS、ASSISTANT 等等。	公用事業組態：EMAIL_Purpose 範例： "ccsValue": "PRIMARYEMAIL", "faValue": "PERSONAL"
PhonePurpose		personContactType	定義使用電子郵件聯絡點的目的。Fusion 標準查尋 CONTACT_POINT_PURPOSE。範例值：PERSONAL、BUSINESS、COLLECTIONS、ASSISTANT 等等。	公用事業組態：PHONE_Purpose 範例： "ccsValue": "CELLPHONE", "faValue": "PERSONAL"
WebPurpose		personContactType	定義使用 WEB 聯絡點的目的。Fusion 標準查尋 CONTACT_POINT_PURPOSE_WEB。範例值：HOMEPAGE、RSS_FEED 等等。	公用事業組態：WEB_Purpose 範例： "ccsValue": "WEB", "faValue": "HOMEPAGE"
PhoneExtension	phoneExtension	contactDetailValueExtension	當聯絡資訊的聯絡途徑為電話或傳真時，如果有分機的話，這就會是該聯絡資訊的分機。
SourceSystem			聯絡點整合之處的外部來源系統名稱。	「客戶資訊系統」值
SourceSystemReferenceValue		contactPointId	在屬性 SourceSystem 中所指定的外部來源系統中，聯絡點的唯一識別碼。在客戶資訊系統中，「聯絡點 ID」是唯一系統指派識別碼值。
PrimaryFlag	primaryFlag	contactDetailPrimary	指出偏好的聯絡點。
Status		status	指出聯絡點的狀態是現用，還是停用。Fusion EndDate 會把 4712 年的未來日期反映為現用，並把 1900 年的過去日期反映為停用。
		characteristics	Oracle Utilities 客戶資訊系統支援特性類型的組態，以便將其他資料儲存在人員記錄物件上。您可以把此資料集合對應至 Fusion 關係方屬性，作為聯絡資訊或帳戶記錄的一部分。
		characteristicType	這是 Oracle Utilities 客戶資訊系統中的擴充欄位，您可視需要為每個實作設定該欄位來儲存其他的值。	CXIF 轉接器會將客戶資訊系統特性對應至指定的 Fusion 屬性。 公用事業組態：characteristics 範例： "ccsValue": "C2MBTHDT", "faValue": "DateOfBirth"
		characteristicValue	這是可延伸的資料屬性，會儲存實作所定義的類型/值配對的值。