位址 （CustomerAddress） 資料表/實體參考 （Microsoft Dataverse）

地址和送貨信息。 用於儲存帳戶或聯絡人的其他地址。

Messages

下表列出 Address （CustomerAddress） 資料表的訊息。 訊息代表可以在表格上執行的作業。 它們也可能是事件。

名字 是事件嗎？	Web API 作業	SDK for .NET
Associate 事件：真實	關聯記錄	關聯記錄
Create 事件：真實	POST /客戶地址 請參閱 建立	建立記錄
Delete 事件：真實	DELETE /customeraddresses（客戶地址ID） 請參閱 刪除	刪除記錄
Disassociate 事件：真實	取消關聯記錄	取消關聯記錄
Retrieve 事件：真實	GET /customeraddresses（客戶地址ID） 請參閱 擷取	擷取記錄
RetrieveMultiple 事件：真實	GET /客戶地址 請參閱 查詢資料	查詢數據
Update 事件：真實	PATCH /customeraddresses（客戶地址ID） 查看 更新	更新記錄
Upsert 事件：False	PATCH /customeraddresses（客戶地址ID） 請參閱更新 插入表格列	UpsertRequest

屬性

下表列出 Address （CustomerAddress） 資料表的選取屬性。

房產	價值觀
DisplayName	位址
顯示集合名稱	地址
結構描述名稱	CustomerAddress
集合架構名稱	CustomerAddresses
實體集名稱	customeraddresses
邏輯名稱	customeraddress
邏輯集合名稱	customeraddresses
PrimaryId屬性	customeraddressid
PrimaryName屬性	name
表格類型	Standard
擁有權類型	None

可寫入的資料行/屬性

這些資料行/屬性會針對 IsValidForCreate 或 IsValidForUpdate 傳回 true （通常兩者）。 依 SchemaName 列出。

• 地址編號
• 地址類型代碼
• 城
• 國家/地區
• 縣
• 客戶地址標識符
• 傳真
• 貨運條款代碼
• 匯入序列號
• 緯度
• 第 1 行
• 第2行
• 行3
• 經度
• 名稱
• 物件類型代碼
• OverriddenCreatedOn
• 家長標識符
• ParentIdTypeCode
• 郵遞區號
• 郵政信箱
• 主要連絡人名稱
• ShippingMethod代碼
• 州或省
• 電話1
• 電話2
• 電話3
• 時區規則版本編號
• 交易貨幣標識符
• UPS區
• UTCConversionTimeZoneCode
• UTCOffset

地址編號

房產	價值觀
Description	顯示地址的號碼，以指出該地址是客戶的主要地址、次要地址還是其他地址。
顯示名稱	地址號碼
IsValidForForm	對
IsValidForRead	對
LogicalName	addressnumber
RequiredLevel	None
類型	整數
最大值	1000000000
最小值	0

地址類型代碼

房產	價值觀
Description	選取地址類型，例如主要地址類型或帳單地址類型。
顯示名稱	地址類型
IsValidForForm	對
IsValidForRead	對
LogicalName	addresstypecode
RequiredLevel	None
類型	選擇清單
預設形式值	-1
GlobalChoiceName	customeraddress_addresstypecode

AddressTypeCode 選項/選項

價值觀	標籤
1	賬單至
2	運送至
3	主要
4	其他

城市

房產	價值觀
Description	輸入客戶地址的城市，以協助識別位置。
顯示名稱	城
IsValidForForm	對
IsValidForRead	對
LogicalName	city
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Active
是可本地化	否
最大長度	80

國家

房產	價值觀
Description	輸入客戶地址的國家或地區。
顯示名稱	國家/地區
IsValidForForm	對
IsValidForRead	對
LogicalName	country
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Active
是可本地化	否
最大長度	80

縣

房產	價值觀
Description	輸入客戶地址的縣。
顯示名稱	縣
IsValidForForm	對
IsValidForRead	對
LogicalName	county
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Active
是可本地化	否
最大長度	50

客戶地址標識符

房產	價值觀
Description	客戶地址的唯一識別碼。
顯示名稱	位址
IsValidForForm	否
IsValidForRead	對
LogicalName	customeraddressid
RequiredLevel	系統必要
類型	Uniqueidentifier

傳真

房產	價值觀
Description	輸入與客戶地址相關聯的傳真號碼。
顯示名稱	傳真
IsValidForForm	對
IsValidForRead	對
LogicalName	fax
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	停用
是可本地化	否
最大長度	50

貨運條款代碼

房產	價值觀
Description	選擇運費條款以確保運費得到正確處理。
顯示名稱	運費條款
IsValidForForm	對
IsValidForRead	對
LogicalName	freighttermscode
RequiredLevel	None
類型	選擇清單
預設形式值	-1
GlobalChoiceName	customeraddress_freighttermscode

FreightTerms代碼選擇/選項

價值觀	標籤
1	離岸價格
2	免費

ImportSequenceNumber

房產	價值觀
Description	建立此記錄之資料匯入或資料移轉的唯一識別碼。
顯示名稱	匯入序號
IsValidForForm	否
IsValidForRead	對
LogicalName	importsequencenumber
RequiredLevel	None
類型	整數
最大值	2147483647
最小值	-2147483648

緯度

房產	價值觀
Description	輸入客戶地址的緯度值，用於地圖和其他應用程式。
顯示名稱	緯度
IsValidForForm	對
IsValidForRead	對
LogicalName	latitude
RequiredLevel	None
類型	Double
Ime模式	Disabled
最大值	90
最小值	-90
精確度	5

第 1 行

房產	價值觀
Description	輸入客戶地址的第一行，以協助識別位置。
顯示名稱	街道 1
IsValidForForm	對
IsValidForRead	對
LogicalName	line1
RequiredLevel	申請必填
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Active
是可本地化	否
最大長度	250

第 2 行

房產	價值觀
Description	輸入客戶地址的第二行。
顯示名稱	街道 2
IsValidForForm	對
IsValidForRead	對
LogicalName	line2
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Active
是可本地化	否
最大長度	250

第 3 行

房產	價值觀
Description	輸入客戶地址的第三行。
顯示名稱	3號街
IsValidForForm	對
IsValidForRead	對
LogicalName	line3
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Active
是可本地化	否
最大長度	250

經度

房產	價值觀
Description	輸入客戶地址的經度值，用於地圖和其他應用程式。
顯示名稱	經度
IsValidForForm	對
IsValidForRead	對
LogicalName	longitude
RequiredLevel	None
類型	Double
Ime模式	Disabled
最大值	180
最小值	-180
精確度	5

名稱

房產	價值觀
Description	輸入客戶地址的描述性名稱，例如公司總部。
顯示名稱	地址名稱
IsValidForForm	對
IsValidForRead	對
LogicalName	name
RequiredLevel	申請必填
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	200

ObjectTypeCode

房產	價值觀
Description	顯示客戶記錄的類型代碼，以指出地址是否屬於客戶帳戶或連絡人。
顯示名稱	物件類型
IsValidForForm	否
IsValidForRead	對
LogicalName	objecttypecode
RequiredLevel	系統必要
類型	實體名稱

OverriddenCreatedOn

房產	價值觀
Description	移轉記錄的日期和時間。
顯示名稱	記錄建立日期
IsValidForForm	否
IsValidForRead	對
LogicalName	overriddencreatedon
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	DateOnly
Ime模式	停用
來源類型遮罩	0

家長標識符

房產	價值觀
Description	選擇客戶的地址。
顯示名稱	父母
IsValidForForm	否
IsValidForRead	對
LogicalName	parentid
RequiredLevel	系統必要
類型	查詢
Targets	帳戶、聯絡方式

ParentIdTypeCode

房產	價值觀
Description
顯示名稱	父物件類型
IsValidForForm	否
IsValidForRead	對
LogicalName	parentidtypecode
RequiredLevel	None
類型	實體名稱

郵遞區號

房產	價值觀
Description	輸入地址的郵遞區號或郵遞區號。
顯示名稱	郵遞區號
IsValidForForm	對
IsValidForRead	對
LogicalName	postalcode
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	停用
是可本地化	否
最大長度	20

郵政信箱

房產	價值觀
Description	輸入客戶地址的郵政信箱號碼。
顯示名稱	郵政信箱
IsValidForForm	對
IsValidForRead	對
LogicalName	postofficebox
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	20

主要連絡人名稱

房產	價值觀
Description	輸入客戶地址的主要連絡人名稱。
顯示名稱	地址聯繫方式
IsValidForForm	對
IsValidForRead	對
LogicalName	primarycontactname
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	150

ShippingMethod代碼

房產	價值觀
Description	選取傳送至此地址的遞送方式。
顯示名稱	運送方式
IsValidForForm	對
IsValidForRead	對
LogicalName	shippingmethodcode
RequiredLevel	None
類型	選擇清單
預設形式值	-1
GlobalChoiceName	customeraddress_shippingmethodcode

ShippingMethod代碼選擇/選項

價值觀	標籤
1	空降
2	DHL公司
3	聯邦快遞
4	UPS的
5	郵政郵件
6	滿載
7	會打電話

StateOrProvince

房產	價值觀
Description	輸入客戶地址的州或省。
顯示名稱	州/省
IsValidForForm	對
IsValidForRead	對
LogicalName	stateorprovince
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Active
是可本地化	否
最大長度	50

電話1

房產	價值觀
Description	輸入客戶地址的主要電話號碼。
顯示名稱	主電話
IsValidForForm	對
IsValidForRead	對
LogicalName	telephone1
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	停用
是可本地化	否
最大長度	50

電話2

房產	價值觀
Description	輸入客戶地址的第二個電話號碼。
顯示名稱	電話 2
IsValidForForm	對
IsValidForRead	對
LogicalName	telephone2
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	停用
是可本地化	否
最大長度	50

電話3

房產	價值觀
Description	輸入客戶地址的第三個電話號碼。
顯示名稱	電話 3
IsValidForForm	對
IsValidForRead	對
LogicalName	telephone3
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	停用
是可本地化	否
最大長度	50

時區規則版本編號

房產	價值觀
Description	僅供內部使用。
顯示名稱	時區規則版本號碼
IsValidForForm	否
IsValidForRead	對
LogicalName	timezoneruleversionnumber
RequiredLevel	None
類型	整數
最大值	2147483647
最小值	-1

交易貨幣ID

房產	價值觀
Description	選擇記錄的當地貨幣，以確保以正確的貨幣報告預算。
顯示名稱	貨幣
IsValidForForm	對
IsValidForRead	對
LogicalName	transactioncurrencyid
RequiredLevel	None
類型	查詢
Targets	交易貨幣

UPS區

房產	價值觀
Description	輸入客戶地址的 UPS 區域，以確保運費計算正確，如果由 UPS 託運，則及時交付。
顯示名稱	UPS專區
IsValidForForm	對
IsValidForRead	對
LogicalName	upszone
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	4

UTCConversionTimeZoneCode

房產	價值觀
Description	建立記錄時使用的時區代碼。
顯示名稱	UTC 轉換時區代碼
IsValidForForm	否
IsValidForRead	對
LogicalName	utcconversiontimezonecode
RequiredLevel	None
類型	整數
最大值	2147483647
最小值	-1

UTCOffset

房產	價值觀
Description	選取地址的時區。
顯示名稱	UTC 偏移量
IsValidForForm	對
IsValidForRead	對
LogicalName	utcoffset
RequiredLevel	None
類型	整數
最大值	1500
最小值	-1500

唯讀資料行/屬性

這些資料行/屬性會針對 IsValidForCreate 和 IsValidForUpdate 傳回 false。 依 SchemaName 列出。

• 菊科
• 建立者
• 創建日期
• CreatedOnBehalfBy
• 匯率
• 修改者
• 修改時
• ModifiedOnBehalfBy
• 擁有者標識碼
• OwnerId類型
• 擁有業務單位
• 擁有用戶
• 版本編號

Composite

房產	價值觀
Description	顯示完整地址。
顯示名稱	位址
IsValidForForm	對
IsValidForRead	對
LogicalName	composite
RequiredLevel	None
類型	備忘錄
格式	文字區域
格式名稱	文字區域
Ime模式	Auto
是可本地化	否
最大長度	1000

CreatedBy

房產	價值觀
Description	顯示記錄的建立者。
顯示名稱	創建者
IsValidForForm	對
IsValidForRead	對
LogicalName	createdby
RequiredLevel	None
類型	查詢
Targets	systemuser

創建日期

房產	價值觀
Description	顯示建立記錄的日期和時間。 日期和時間會以 Microsoft Dynamics 365 選項中選取的時區顯示。
顯示名稱	建立時間
IsValidForForm	對
IsValidForRead	對
LogicalName	createdon
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

CreatedOnBehalfBy

房產	價值觀
Description	顯示誰代表其他使用者建立記錄。
顯示名稱	建立者 （委派）
IsValidForForm	對
IsValidForRead	對
LogicalName	createdonbehalfby
RequiredLevel	None
類型	查詢
Targets	systemuser

匯率

房產	價值觀
Description	顯示記錄貨幣的轉換率。 匯率用於將記錄中的所有貨幣欄位從當地貨幣轉換為系統的預設貨幣。
顯示名稱	匯率
IsValidForForm	對
IsValidForRead	對
LogicalName	exchangerate
RequiredLevel	None
類型	Decimal
Ime模式	Disabled
最大值	100000000000
最小值	1E-12
精確度	12
來源類型遮罩	0

ModifiedBy

房產	價值觀
Description	顯示上次更新記錄的人員。
顯示名稱	修改者
IsValidForForm	對
IsValidForRead	對
LogicalName	modifiedby
RequiredLevel	None
類型	查詢
Targets	systemuser

修改時

房產	價值觀
Description	顯示記錄上次更新的日期和時間。 日期和時間會以 Microsoft Dynamics 365 選項中選取的時區顯示。
顯示名稱	修改於
IsValidForForm	對
IsValidForRead	對
LogicalName	modifiedon
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

ModifiedOnBehalfBy

房產	價值觀
Description	顯示上次代表其他使用者更新記錄的人員。
顯示名稱	修改者 （委派）
IsValidForForm	對
IsValidForRead	對
LogicalName	modifiedonbehalfby
RequiredLevel	None
類型	查詢
Targets	systemuser

擁有者標識碼

房產	價值觀
Description	輸入指派管理記錄的使用者或團隊。 每次將記錄指派給不同的使用者時，都會更新此欄位。
顯示名稱	Owner
IsValidForForm	對
IsValidForRead	對
LogicalName	ownerid
RequiredLevel	申請必填
類型	所有者
Targets	系統使用者、團隊

OwnerId類型

房產	價值觀
Description
顯示名稱
IsValidForForm	否
IsValidForRead	對
LogicalName	owneridtype
RequiredLevel	系統必要
類型	實體名稱

擁有業務單位

房產	價值觀
Description	顯示記錄擁有者所屬的業務單位。
顯示名稱	擁有業務單位
IsValidForForm	否
IsValidForRead	對
LogicalName	owningbusinessunit
RequiredLevel	None
類型	查詢
Targets	業務單位

擁有用戶

房產	價值觀
Description	擁有客戶地址之使用者的唯一識別碼。
顯示名稱	Owner
IsValidForForm	否
IsValidForRead	對
LogicalName	owninguser
RequiredLevel	None
類型	查詢
Targets	systemuser

版本編號

房產	價值觀
Description	客戶位址的版本號碼。
顯示名稱	版本號碼
IsValidForForm	否
IsValidForRead	對
LogicalName	versionnumber
RequiredLevel	None
類型	大國際
最大值	9223372036854775807
最小值	-9223372036854775808

多對一關聯

這些關係是多對一的。 依 SchemaName 列出。

• Account_CustomerAddress
• Contact_CustomerAddress
• lk_customeraddress_createdonbehalfby
• lk_customeraddress_modifiedonbehalfby
• lk_customeraddressbase_createdby
• lk_customeraddressbase_modifiedby
• TransactionCurrency_CustomerAddress

Account_CustomerAddress

一To-Many 關係： 帳戶Account_CustomerAddress

房產	價值觀
參考實體	account
參考屬性	accountid
ReferencingAttribute	parentid
ReferencingEntityNavigationPropertyName	parentid_account
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： Cascade 合併： Cascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

Contact_CustomerAddress

一To-Many 關係： 聯繫Contact_CustomerAddress

房產	價值觀
參考實體	contact
參考屬性	contactid
ReferencingAttribute	parentid
ReferencingEntityNavigationPropertyName	parentid_contact
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： Cascade 合併： Cascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_customeraddress_createdonbehalfby

一To-Many 關係： systemuser lk_customeraddress_createdonbehalfby

房產	價值觀
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	createdonbehalfby
ReferencingEntityNavigationPropertyName	createdonbehalfby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_customeraddress_modifiedonbehalfby

一To-Many 關係： 系統使用者lk_customeraddress_modifiedonbehalfby

房產	價值觀
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	modifiedonbehalfby
ReferencingEntityNavigationPropertyName	modifiedonbehalfby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_customeraddressbase_createdby

一To-Many 關係： 系統使用者lk_customeraddressbase_createdby

房產	價值觀
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	createdby
ReferencingEntityNavigationPropertyName	createdby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_customeraddressbase_modifiedby

一To-Many 關係： 系統使用者lk_customeraddressbase_modifiedby

房產	價值觀
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	modifiedby
ReferencingEntityNavigationPropertyName	modifiedby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

TransactionCurrency_CustomerAddress

一To-Many 關係： transactioncurrency TransactionCurrency_CustomerAddress

房產	價值觀
參考實體	transactioncurrency
參考屬性	transactioncurrencyid
ReferencingAttribute	transactioncurrencyid
ReferencingEntityNavigationPropertyName	transactioncurrencyid
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： Restrict 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

一對多關係

這些關係是一對多的。 依 SchemaName 列出。

• CustomerAddress_AsyncOperations
• CustomerAddress_BulkDeleteFailures
• customeraddress_principalobjectattributeaccess
• CustomerAddress_ProcessSessions
• CustomerAddress_SyncErrors

CustomerAddress_AsyncOperations

多To-One 關係： 非同步操作CustomerAddress_AsyncOperations

房產	價值觀
ReferencingEntity	asyncoperation
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	CustomerAddress_AsyncOperations
IsCustomizable	False
關聯功能表配置	可用離線：True 態度： DoNotDisplay 隊： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

CustomerAddress_BulkDeleteFailures

多To-One 關係： bulkdeletefailure CustomerAddress_BulkDeleteFailures

房產	價值觀
ReferencingEntity	bulkdeletefailure
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	CustomerAddress_BulkDeleteFailures
IsCustomizable	False
關聯功能表配置	可用離線：True 態度： DoNotDisplay 隊： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

customeraddress_principalobjectattributeaccess

多To-One 關係： principalobjectattributeaccess customeraddress_principalobjectattributeaccess

房產	價值觀
ReferencingEntity	principalobjectattributeaccess
ReferencingAttribute	objectid
參考實體導航屬性名稱	customeraddress_principalobjectattributeaccess
IsCustomizable	False
關聯功能表配置	可用離線：True 態度： DoNotDisplay 隊： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

CustomerAddress_ProcessSessions

多To-One 關係： processsession CustomerAddress_ProcessSessions

房產	價值觀
ReferencingEntity	processsession
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	CustomerAddress_ProcessSessions
IsCustomizable	False
關聯功能表配置	可用離線：True 態度： UseCollectionName 隊： Details 標籤： MenuId：空值 訂單： 110 QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

CustomerAddress_SyncErrors

多To-One 關係： syncerror CustomerAddress_SyncErrors

房產	價值觀
ReferencingEntity	syncerror
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	CustomerAddress_SyncErrors
IsCustomizable	True
關聯功能表配置	可用離線：True 態度： DoNotDisplay 隊： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

另請參閱

Dataverse 資料表/實體參考
Dataverse Web API 參考
customeraddress