列映射（ColumnMapping）表/实体引用（Microsoft Dataverse）

2025-10-04

数据映射中的列的映射。

Messages

下表列出了列映射（ColumnMapping）表的消息。消息表示可以在表上执行的作。它们也可能是事件。

名称是事件？	Web API 操作	SDK for .NET
`Associate` 事件：True	关联记录	关联记录
`Create` 事件：False	`POST` /columnmappings 请参阅创建	创建记录
`Delete` 事件：False	`DELETE` /columnmappings（columnmappingid）请参阅删除	删除记录
`Disassociate` 事件：True	取消关联记录	取消关联记录
`Retrieve` 事件：False	`GET` /columnmappings（columnmappingid）请参阅检索	检索记录
`RetrieveMultiple` 事件：False	`GET` /columnmappings 查看查询数据	查询数据

属性

下表列出了列映射（ColumnMapping）表的选定属性。

资产	价值
显示名称	列映射
显示集合名称	列映射
架构名称	`ColumnMapping`
集合架构名称	`ColumnMappings`
实体集名称	`columnmappings`
逻辑名称	`columnmapping`
逻辑集合名称	`columnmappings`
PrimaryId属性	`columnmappingid`
PrimaryName属性	`sourceattributename`
表类型	`Standard`
所有权类型	`None`

可写列/属性

这些列/属性为 IsValidForCreate 或 IsValidForUpdate （通常两者）返回 true。按 SchemaName 列出。

ColumnMappingId
ImportMapId
Introduced版本
ProcessCode
SourceAttributeName
SourceEntityName
状态代码
TargetAttributeName
TargetEntityName

ColumnMappingId

资产	价值
Description	列映射的唯一标识符。
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`columnmappingid`
RequiredLevel	系统必填
类型	Uniqueidentifier

ImportMapId

资产	价值
Description	关联的数据映射的唯一标识符。
显示名称	数据映射 ID
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`importmapid`
RequiredLevel	申请必填
类型	查找
Targets	importmap

IntroducedVersion

资产	价值
Description	在其中引入组件的版本。
显示名称	引入版本
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`introducedversion`
RequiredLevel	None
类型	String
Format	版本号
格式名称	版本号
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	48

ProcessCode

资产	价值
Description	有关是否需要处理列映射的信息。
显示名称	流程代码
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`processcode`
RequiredLevel	系统必填
类型	选择列表
默认表单值	-1
全局选择名称	`columnmapping_processcode`

ProcessCode 选项/选项

价值	标签
1	过程
2	忽略
3	内部

SourceAttributeName

资产	价值
Description	源属性的名称。
显示名称	源属性
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`sourceattributename`
RequiredLevel	申请必填
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	160

SourceEntityName

资产	价值
Description	源实体的名称。
显示名称	源实体名称
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`sourceentityname`
RequiredLevel	申请必填
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	160

状态码

资产	价值
Description	列映射状态的原因。
显示名称	状态描述
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`statuscode`
RequiredLevel	系统必填
类型	状态
默认表单值	-1
全局选择名称	`columnmapping_statuscode`

StatusCode 选择/选项

价值	详细信息
1	标签：活跃状态：0 TransitionData：无

TargetAttributeName

资产	价值
Description	Microsoft Dynamics 365 属性的名称。
显示名称	目标属性
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`targetattributename`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	160

TargetEntityName

资产	价值
Description	Microsoft Dynamics 365 实体的名称。
显示名称	目标实体
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`targetentityname`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	160

只读列/属性

这些列/属性为 IsValidForCreate 和 IsValidForUpdate 返回 false。按 SchemaName 列出。

ColumnMappingIdUnique
组件状态
CreatedBy
创建时间
创建时BehalfBy
是托管的
ModifiedBy
修改时间
ModifiedOnBehalfBy
覆盖时间
解决方案 ID
州代码
支持解决方案 Id

ColumnMappingIdUnique

资产	价值
Description	列映射的唯一标识符。
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`columnmappingidunique`
RequiredLevel	系统必填
类型	Uniqueidentifier

组件状态

资产	价值
Description	仅供内部使用。
显示名称	组件状态
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`componentstate`
RequiredLevel	系统必填
类型	选择列表
默认表单值	-1
全局选择名称	`componentstate`

ComponentState 选择/选项

价值	标签
0	已发布
1	未发布
2	已删除
3	已删除，未发布

CreatedBy

资产	价值
Description	创建列映射的用户的唯一标识符。
显示名称	创建者
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`createdby`
RequiredLevel	None
类型	查找
Targets	systemuser

CreatedOn

资产	价值
Description	创建列映射的日期和时间。
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`createdon`
RequiredLevel	系统必填
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	日期和时间
ImeMode	未激活
源类型掩码	0

创建时BehalfBy

资产	价值
Description	创建列映射的委托用户的唯一标识符。
显示名称	创建者（委托）
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`createdonbehalfby`
RequiredLevel	None
类型	查找
Targets	systemuser

IsManaged

资产	价值
Description	指定是否管理此组件的信息。
显示名称	州
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`ismanaged`
RequiredLevel	系统必填
类型	布尔
全局选择名称	`ismanaged`
默认值	假
真实标签	托管
虚假标签	非托管

ModifiedBy

资产	价值
Description	上次修改列映射的用户的唯一标识符。
显示名称	修改者
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`modifiedby`
RequiredLevel	None
类型	查找
Targets	systemuser

修改时间

资产	价值
Description	上次修改列映射的日期和时间。
显示名称	修改时间
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`modifiedon`
RequiredLevel	系统必填
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	日期和时间
ImeMode	未激活
源类型掩码	0

ModifiedOnBehalfBy

资产	价值
Description	上次修改列映射的委托用户的唯一标识符。
显示名称	修改者（委托）
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`modifiedonbehalfby`
RequiredLevel	None
类型	查找
Targets	systemuser

覆盖时间

资产	价值
Description	仅供内部使用。
显示名称	记录覆盖时间
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`overwritetime`
RequiredLevel	系统必填
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	DateOnly
ImeMode	未激活
源类型掩码	0

解决方案 ID

资产	价值
Description	关联解决方案的唯一标识符。
显示名称	Solution
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`solutionid`
RequiredLevel	系统必填
类型	Uniqueidentifier

StateCode

资产	价值
Description	列映射的状态。
显示名称	地位
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`statecode`
RequiredLevel	系统必填
类型	State
默认表单值	0
全局选择名称	`columnmapping_statecode`

州代码选择/选项

价值	详细信息
0	标签：活跃默认状态：1 不变量名称： `Active`

支持解决方案 Id

资产	价值
Description	仅供内部使用。
显示名称	Solution
IsValidForForm （形式有效）	假
IsValidForRead	假
LogicalName	`supportingsolutionid`
RequiredLevel	None
类型	Uniqueidentifier

多对一关系

这些关系是多对一的。按 SchemaName 列出。

ColumnMapping_ImportMap
lk_columnmapping_createdby
lk_columnmapping_createdonbehalfby
lk_columnmapping_modifiedby
lk_columnmapping_modifiedonbehalfby

ColumnMapping_ImportMap

一To-Many 关系： importmap ColumnMapping_ImportMap

资产	价值
引用实体	`importmap`
引用属性	`importmapid`
引用属性	`importmapid`
ReferencingEntityNavigationPropertyName	`importmapid`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `Cascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_columnmapping_createdby

一To-Many 关系： systemuser lk_columnmapping_createdby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`createdby`
ReferencingEntityNavigationPropertyName	`createdby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_columnmapping_createdonbehalfby

一To-Many 关系： systemuser lk_columnmapping_createdonbehalfby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`createdonbehalfby`
ReferencingEntityNavigationPropertyName	`createdonbehalfby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_columnmapping_modifiedby

单To-Many 关系： systemuser lk_columnmapping_modifiedby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`modifiedby`
ReferencingEntityNavigationPropertyName	`modifiedby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_columnmapping_modifiedonbehalfby

一To-Many 关系： systemuser lk_columnmapping_modifiedonbehalfby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`modifiedonbehalfby`
ReferencingEntityNavigationPropertyName	`modifiedonbehalfby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

一对多关系

这些关系是一对多的。按 SchemaName 列出。

LookUpMapping_ColumnMapping
PickListMapping_ColumnMapping

LookUpMapping_ColumnMapping

多To-One 关系：查找映射LookUpMapping_ColumnMapping

资产	价值
引用实体	`lookupmapping`
引用属性	`columnmappingid`
引用实体导航属性名称	`LookUpMapping_ColumnMapping`
IsCustomizable	`False`
关联菜单配置	可用离线：True 行为： `DoNotDisplay` 群： `Details` 标签： MenuId：空次序： QueryApi：空视图 ID： `00000000-0000-0000-0000-000000000000`

PickListMapping_ColumnMapping

多To-One 关系： picklistmapping PickListMapping_ColumnMapping

资产	价值
引用实体	`picklistmapping`
引用属性	`columnmappingid`
引用实体导航属性名称	`PickListMapping_ColumnMapping`
IsCustomizable	`False`
关联菜单配置	可用离线：True 行为： `DoNotDisplay` 群： `Details` 标签： MenuId：空次序： QueryApi：空视图 ID： `00000000-0000-0000-0000-000000000000`

另请参阅

Dataverse 表/实体引用
 Dataverse Web API 参考
 columnmapping

反馈

此页面是否有帮助？