数据导入（导入）表/实体引用（Microsoft Dataverse）

2025-10-04

导入作业的状态和所有权信息。

Messages

下表列出了数据导入（导入）表的消息。消息表示可以在表上执行的作。它们也可能是事件。

名称是事件？	Web API 操作	SDK for .NET
`Associate` 事件：True	关联记录	关联记录
`Create` 事件：False	`POST` /进口请参阅创建	创建记录
`Delete` 事件：False	`DELETE` /imports（importid）请参阅删除	删除记录
`Disassociate` 事件：True	取消关联记录	取消关联记录
`GrantAccess` 事件：False	GrantAccess	GrantAccessRequest
`ImportRecordsImport` 事件：False	ImportRecordsImport	ImportRecordsImportRequest
`ModifyAccess` 事件：False	ModifyAccess	ModifyAccessRequest
`ParseImport` 事件：False	ParseImport	ParseImportRequest
`Retrieve` 事件：False	`GET` /imports（importid）请参阅检索	检索记录
`RetrieveMultiple` 事件：False	`GET` /进口查看查询数据	查询数据
`RetrievePrincipalAccess` 事件：False	RetrievePrincipalAccess	RetrievePrincipalAccessRequest
`RetrieveSharedPrincipalsAndAccess` 事件：False	RetrieveSharedPrincipalsAndAccess	RetrieveSharedPrincipalsAndAccessRequest
`RevokeAccess` 事件：False	RevokeAccess	RevokeAccessRequest
`TransformImport` 事件：False	TransformImport	TransformImportRequest
`Update` 事件：False	`PATCH` /imports（importid）查看更新	更新记录
`Upsert` 事件：False	`PATCH` /imports（importid）请参阅更新插入表行	UpsertRequest

属性

下表列出了数据导入（导入）表的选定属性。

资产	价值
显示名称	数据导入
显示集合名称	数据导入
架构名称	`Import`
集合架构名称	`Imports`
实体集名称	`imports`
逻辑名称	`import`
逻辑集合名称	`imports`
PrimaryId属性	`importid`
PrimaryName属性	`name`
表类型	`Standard`
所有权类型	`UserOwned`

可写列/属性

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

电子邮件地址
ImportId
IsImport
ModeCode
名称
所有者 ID
所有者 IdType
SendNotification
状态代码

电子邮件地址

资产	价值
Description	键入导入完成通知必须发送到的电子邮件地址。
显示名称	电子邮件
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`emailaddress`
RequiredLevel	None
类型	String
Format	Email
格式名称	Email
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	100

ImportId

资产	价值
Description	导入作业的唯一标识符。
显示名称	进口
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`importid`
RequiredLevel	系统必填
类型	Uniqueidentifier

IsImport

资产	价值
Description	有关此导入作业的源是数据导入还是数据迁移的信息。
显示名称	是导入
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`isimport`
RequiredLevel	系统必填
类型	布尔
全局选择名称	`import_isimport`
默认值	假
真实标签	是导入
虚假标签	迁移

ModeCode

资产	价值
Description	选择是在导入作业期间在 dynamics 365 中创建还是更新Microsoft记录。
显示名称	模式
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`modecode`
RequiredLevel	系统必填
类型	选择列表
默认表单值	0
全局选择名称	`import_modecode`

ModeCode 选项/选项

价值	标签
0	创建
1	Update

Name

资产	价值
Description	根据导入文件和要导入的实体显示导入作业的名称。
显示名称	导入名称
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`name`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	256

OwnerId

资产	价值
Description	输入分配用于管理记录的用户或团队。每次将记录分配给其他用户时都会更新此字段。
显示名称	Owner
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`ownerid`
RequiredLevel	系统必填
类型	所有者
Targets	系统用户，团队

所有者 IdType

资产	价值
Description
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`owneridtype`
RequiredLevel	系统必填
类型	实体名称

SendNotification

资产	价值
Description	选择导入完成后是否向所选用户发送通知电子邮件。
显示名称	发送通知
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`sendnotification`
RequiredLevel	系统必填
类型	布尔
全局选择名称	`import_sendnotification`
默认值	假
真实标签	是的
虚假标签	否

状态码

资产	价值
Description	显示说明导入作业状态的原因代码，用于标识导入过程的作业阶段，从将数据转换为已完成。
显示名称	状态描述
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`statuscode`
RequiredLevel	系统必填
类型	状态
默认表单值	0
全局选择名称	`import_statuscode`

StatusCode 选择/选项

价值	详细信息
0	标签：已提交状态：0 TransitionData：无
1	标签：分析状态：0 TransitionData：无
2	标签：转换状态：0 TransitionData：无
3	标签：导入状态：0 TransitionData：无
4	标签：已完成状态：0 TransitionData：无
5	标签：失败状态：0 TransitionData：无

只读列/属性

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

CreatedBy
创建时间
创建时BehalfBy
ModifiedBy
修改时间
ModifiedOnBehalfBy
所有者名称
OwnerIdYomiName
拥有业务单位
拥有团队
拥有用户
序列
州代码

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

ModifiedBy

资产	价值
Description	显示上次更新记录的人员。
显示名称	修改者
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`modifiedby`
RequiredLevel	None
类型	查找
Targets	systemuser

修改时间

资产	价值
Description	显示上次更新记录的日期和时间。日期和时间显示在 Microsoft Dynamics 365 选项中选择的时区中。
显示名称	修改时间
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	`owneridname`
RequiredLevel	系统必填
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	100

OwnerIdYomiName

资产	价值
Description
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`owneridyominame`
RequiredLevel	系统必填
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	100

拥有业务单位

资产	价值
Description	拥有导入作业的业务部门。
显示名称	拥有业务单位
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`owningbusinessunit`
RequiredLevel	None
类型	查找
Targets	业务单位

拥有团队

资产	价值
Description	拥有导入的团队的唯一标识符。
显示名称	拥有团队
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`owningteam`
RequiredLevel	None
类型	查找
Targets	团队

拥有用户

资产	价值
Description	拥有导入的用户的唯一标识符。
显示名称	拥有用户
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`owninguser`
RequiredLevel	None
类型	查找
Targets	systemuser

序列

资产	价值
Description	创建导入的顺序。
显示名称	序列
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`sequence`
RequiredLevel	系统必填
类型	整数
最大值	2147483647
最小值	-2147483648

StateCode

资产	价值
Description	显示导入作业的状态。默认情况下，导入作业处于活动状态，无法停用。
显示名称	地位
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`statecode`
RequiredLevel	系统必填
类型	State
默认表单值	0
全局选择名称	`import_statecode`

州代码选择/选项

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

多对一关系

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

BusinessUnit_Imports
lk_import_createdonbehalfby
lk_import_modifiedonbehalfby
lk_importbase_createdby
lk_importbase_modifiedby
owner_imports
SystemUser_Imports
team_Imports

BusinessUnit_Imports

一To-Many 关系：企业单位BusinessUnit_Imports

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

lk_import_createdonbehalfby

一To-Many 关系： systemuser lk_import_createdonbehalfby

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

lk_import_modifiedonbehalfby

单To-Many 关系： systemuser lk_import_modifiedonbehalfby

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

lk_importbase_createdby

一To-Many 关系： systemuser lk_importbase_createdby

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

lk_importbase_modifiedby

单To-Many 关系： systemuser lk_importbase_modifiedby

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

owner_imports

一To-Many 关系：所有者owner_imports

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

SystemUser_Imports

一To-Many 关系： systemuser SystemUser_Imports

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

team_Imports

一To-Many 关系：团队team_Imports

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

一对多关系

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

Import_AsyncOperations
Import_BulkDeleteFailures
Import_ImportFile

Import_AsyncOperations

多To-One 关系：异步Import_AsyncOperations

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

Import_BulkDeleteFailures

多To-One 关系： bulkdeletefailure Import_BulkDeleteFailures

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

Import_ImportFile

多To-One 关系： importfile Import_ImportFile

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

另请参阅

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

反馈

此页面是否有帮助？