Data Import (Import) table/entity reference (Microsoft Dataverse)

2025-08-28

Status and ownership information for an import job.

Messages

The following table lists the messages for the Data Import (Import) table. Messages represent operations that can be performed on the table. They may also be events.

Name Is Event?	Web API Operation	SDK for .NET
`Associate` Event: True	Associate records	Associate records
`Create` Event: False	`POST` /imports See Create	Create records
`Delete` Event: False	`DELETE` /imports(importid) See Delete	Delete records
`Disassociate` Event: True	Disassociate records	Disassociate records
`GrantAccess` Event: False	GrantAccess	GrantAccessRequest
`ImportRecordsImport` Event: False	ImportRecordsImport	ImportRecordsImportRequest
`ModifyAccess` Event: False	ModifyAccess	ModifyAccessRequest
`ParseImport` Event: False	ParseImport	ParseImportRequest
`Retrieve` Event: False	`GET` /imports(importid) See Retrieve	Retrieve records
`RetrieveMultiple` Event: False	`GET` /imports See Query data	Query data
`RetrievePrincipalAccess` Event: False	RetrievePrincipalAccess	RetrievePrincipalAccessRequest
`RetrieveSharedPrincipalsAndAccess` Event: False	RetrieveSharedPrincipalsAndAccess	RetrieveSharedPrincipalsAndAccessRequest
`RevokeAccess` Event: False	RevokeAccess	RevokeAccessRequest
`TransformImport` Event: False	TransformImport	TransformImportRequest
`Update` Event: False	`PATCH` /imports(importid) See Update	Update records
`Upsert` Event: False	`PATCH` /imports(importid) See Upsert a table row	UpsertRequest

Properties

The following table lists selected properties for the Data Import (Import) table.

Property	Value
DisplayName	Data Import
DisplayCollectionName	Data Imports
SchemaName	`Import`
CollectionSchemaName	`Imports`
EntitySetName	`imports`
LogicalName	`import`
LogicalCollectionName	`imports`
PrimaryIdAttribute	`importid`
PrimaryNameAttribute	`name`
TableType	`Standard`
OwnershipType	`UserOwned`

Writable columns/attributes

These columns/attributes return true for either IsValidForCreate or IsValidForUpdate (usually both). Listed by SchemaName.

EMailAddress
ImportId
IsImport
ModeCode
Name
OwnerId
OwnerIdType
SendNotification
StatusCode

EMailAddress

Property	Value
Description	Type the email address that the import completion notification must be sent to.
DisplayName	Email
IsValidForForm	True
IsValidForRead	True
LogicalName	`emailaddress`
RequiredLevel	None
Type	String
Format	Email
FormatName	Email
ImeMode	Auto
IsLocalizable	False
MaxLength	100

ImportId

Property	Value
Description	Unique identifier of the import job.
DisplayName	Import
IsValidForForm	False
IsValidForRead	True
LogicalName	`importid`
RequiredLevel	SystemRequired
Type	Uniqueidentifier

IsImport

Property	Value
Description	Information about whether the source of this import job is data import or data migration.
DisplayName	Is Import
IsValidForForm	False
IsValidForRead	True
LogicalName	`isimport`
RequiredLevel	SystemRequired
Type	Boolean
GlobalChoiceName	`import_isimport`
DefaultValue	False
True Label	Is Import
False Label	Is Migration

ModeCode

Property	Value
Description	Select whether to create or update records in Microsoft Dynamics 365 during the import job.
DisplayName	Mode
IsValidForForm	True
IsValidForRead	True
LogicalName	`modecode`
RequiredLevel	SystemRequired
Type	Picklist
DefaultFormValue	0
GlobalChoiceName	`import_modecode`

ModeCode Choices/Options

Value	Label
0	Create
1	Update

Name

Property	Value
Description	Shows the name of the import job, based on the import file and the entity being imported.
DisplayName	Import Name
IsValidForForm	True
IsValidForRead	True
LogicalName	`name`
RequiredLevel	None
Type	String
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	256

OwnerId

Property	Value
Description	Enter the user or team who is assigned to manage the record. This field is updated every time the record is assigned to a different user.
DisplayName	Owner
IsValidForForm	True
IsValidForRead	True
LogicalName	`ownerid`
RequiredLevel	SystemRequired
Type	Owner
Targets	systemuser, team

OwnerIdType

Property	Value
Description
DisplayName
IsValidForForm	False
IsValidForRead	True
LogicalName	`owneridtype`
RequiredLevel	SystemRequired
Type	EntityName

SendNotification

Property	Value
Description	Select whether to send a notification email message to a selected user after the import is completed.
DisplayName	Send Notification
IsValidForForm	True
IsValidForRead	True
LogicalName	`sendnotification`
RequiredLevel	SystemRequired
Type	Boolean
GlobalChoiceName	`import_sendnotification`
DefaultValue	False
True Label	Yes
False Label	No

StatusCode

Property	Value
Description	Shows the reason code that explains the import job's status to identify the job's stage of the import processes, from transforming the data to completed.
DisplayName	Status Reason
IsValidForForm	True
IsValidForRead	True
LogicalName	`statuscode`
RequiredLevel	SystemRequired
Type	Status
DefaultFormValue	0
GlobalChoiceName	`import_statuscode`

StatusCode Choices/Options

Value	Details
0	Label: Submitted State:0 TransitionData: None
1	Label: Parsing State:0 TransitionData: None
2	Label: Transforming State:0 TransitionData: None
3	Label: Importing State:0 TransitionData: None
4	Label: Completed State:0 TransitionData: None
5	Label: Failed State:0 TransitionData: None

Read-only columns/attributes

These columns/attributes return false for both IsValidForCreate and IsValidForUpdate. Listed by SchemaName.

CreatedBy
CreatedOn
CreatedOnBehalfBy
ModifiedBy
ModifiedOn
ModifiedOnBehalfBy
OwnerIdName
OwnerIdYomiName
OwningBusinessUnit
OwningTeam
OwningUser
Sequence
StateCode

CreatedBy

Property	Value
Description	Shows who created the record.
DisplayName	Created By
IsValidForForm	False
IsValidForRead	True
LogicalName	`createdby`
RequiredLevel	None
Type	Lookup
Targets	systemuser

CreatedOn

Property	Value
Description	Shows the date and time when the import was initiated.
DisplayName	Created On
IsValidForForm	False
IsValidForRead	True
LogicalName	`createdon`
RequiredLevel	SystemRequired
Type	DateTime
CanChangeDateTimeBehavior	False
DateTimeBehavior	UserLocal
Format	DateAndTime
ImeMode	Inactive
SourceTypeMask	0

CreatedOnBehalfBy

Property	Value
Description	Shows who created the record on behalf of another user.
DisplayName	Created By (Delegate)
IsValidForForm	False
IsValidForRead	True
LogicalName	`createdonbehalfby`
RequiredLevel	None
Type	Lookup
Targets	systemuser

ModifiedBy

Property	Value
Description	Shows who last updated the record.
DisplayName	Modified By
IsValidForForm	False
IsValidForRead	True
LogicalName	`modifiedby`
RequiredLevel	None
Type	Lookup
Targets	systemuser

ModifiedOn

Property	Value
Description	Shows the date and time when the record was last updated. The date and time are displayed in the time zone selected in Microsoft Dynamics 365 options.
DisplayName	Modified On
IsValidForForm	True
IsValidForRead	True
LogicalName	`modifiedon`
RequiredLevel	SystemRequired
Type	DateTime
CanChangeDateTimeBehavior	False
DateTimeBehavior	UserLocal
Format	DateAndTime
ImeMode	Inactive
SourceTypeMask	0

ModifiedOnBehalfBy

Property	Value
Description	Shows who created the record on behalf of another user.
DisplayName	Modified By (Delegate)
IsValidForForm	False
IsValidForRead	True
LogicalName	`modifiedonbehalfby`
RequiredLevel	None
Type	Lookup
Targets	systemuser

OwnerIdName

Property	Value
Description
DisplayName
IsValidForForm	False
IsValidForRead	True
LogicalName	`owneridname`
RequiredLevel	SystemRequired
Type	String
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	100

OwnerIdYomiName

Property	Value
Description
DisplayName
IsValidForForm	False
IsValidForRead	True
LogicalName	`owneridyominame`
RequiredLevel	SystemRequired
Type	String
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	100

OwningBusinessUnit

Property	Value
Description	Business unit that owns the import job.
DisplayName	Owning Business Unit
IsValidForForm	True
IsValidForRead	True
LogicalName	`owningbusinessunit`
RequiredLevel	None
Type	Lookup
Targets	businessunit

OwningTeam

Property	Value
Description	Unique identifier of the team who owns the import.
DisplayName	Owning Team
IsValidForForm	False
IsValidForRead	True
LogicalName	`owningteam`
RequiredLevel	None
Type	Lookup
Targets	team

OwningUser

Property	Value
Description	Unique identifier of the user who owns the import.
DisplayName	Owning User
IsValidForForm	False
IsValidForRead	True
LogicalName	`owninguser`
RequiredLevel	None
Type	Lookup
Targets	systemuser

Sequence

Property	Value
Description	Order in which the import was created.
DisplayName	Sequence
IsValidForForm	False
IsValidForRead	True
LogicalName	`sequence`
RequiredLevel	SystemRequired
Type	Integer
MaxValue	2147483647
MinValue	-2147483648

StateCode

Property	Value
Description	Shows the status of the import job. By default, import jobs are active and can't be deactivated.
DisplayName	Status
IsValidForForm	True
IsValidForRead	True
LogicalName	`statecode`
RequiredLevel	SystemRequired
Type	State
DefaultFormValue	0
GlobalChoiceName	`import_statecode`

StateCode Choices/Options

Value	Details
0	Label: Active DefaultStatus: 0 InvariantName: `Active`

Many-to-One relationships

These relationships are many-to-one. Listed by SchemaName.

BusinessUnit_Imports
lk_import_createdonbehalfby
lk_import_modifiedonbehalfby
lk_importbase_createdby
lk_importbase_modifiedby
owner_imports
SystemUser_Imports
team_Imports

BusinessUnit_Imports

One-To-Many Relationship: businessunit BusinessUnit_Imports

Property	Value
ReferencedEntity	`businessunit`
ReferencedAttribute	`businessunitid`
ReferencingAttribute	`owningbusinessunit`
ReferencingEntityNavigationPropertyName	`owningbusinessunit`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

lk_import_createdonbehalfby

One-To-Many Relationship: systemuser lk_import_createdonbehalfby

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`createdonbehalfby`
ReferencingEntityNavigationPropertyName	`createdonbehalfby`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

lk_import_modifiedonbehalfby

One-To-Many Relationship: systemuser lk_import_modifiedonbehalfby

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`modifiedonbehalfby`
ReferencingEntityNavigationPropertyName	`modifiedonbehalfby`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

lk_importbase_createdby

One-To-Many Relationship: systemuser lk_importbase_createdby

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`createdby`
ReferencingEntityNavigationPropertyName	`createdby`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

lk_importbase_modifiedby

One-To-Many Relationship: systemuser lk_importbase_modifiedby

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`modifiedby`
ReferencingEntityNavigationPropertyName	`modifiedby`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

owner_imports

One-To-Many Relationship: owner owner_imports

Property	Value
ReferencedEntity	`owner`
ReferencedAttribute	`ownerid`
ReferencingAttribute	`ownerid`
ReferencingEntityNavigationPropertyName	`ownerid`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

SystemUser_Imports

One-To-Many Relationship: systemuser SystemUser_Imports

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`owninguser`
ReferencingEntityNavigationPropertyName	`owninguser`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

team_Imports

One-To-Many Relationship: team team_Imports

Property	Value
ReferencedEntity	`team`
ReferencedAttribute	`teamid`
ReferencingAttribute	`owningteam`
ReferencingEntityNavigationPropertyName	`owningteam`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

One-to-Many relationships

These relationships are one-to-many. Listed by SchemaName.

Import_AsyncOperations
Import_BulkDeleteFailures
Import_ImportFile

Import_AsyncOperations

Many-To-One Relationship: asyncoperation Import_AsyncOperations

Property	Value
ReferencingEntity	`asyncoperation`
ReferencingAttribute	`regardingobjectid`
ReferencedEntityNavigationPropertyName	`Import_AsyncOperations`
IsCustomizable	`False`
AssociatedMenuConfiguration	AvailableOffline: True Behavior: `DoNotDisplay` Group: `Details` Label: MenuId: null Order: QueryApi: null ViewId: `00000000-0000-0000-0000-000000000000`

Import_BulkDeleteFailures

Many-To-One Relationship: bulkdeletefailure Import_BulkDeleteFailures

Property	Value
ReferencingEntity	`bulkdeletefailure`
ReferencingAttribute	`regardingobjectid`
ReferencedEntityNavigationPropertyName	`Import_BulkDeleteFailures`
IsCustomizable	`False`
AssociatedMenuConfiguration	AvailableOffline: True Behavior: `DoNotDisplay` Group: `Details` Label: MenuId: null Order: QueryApi: null ViewId: `00000000-0000-0000-0000-000000000000`

Import_ImportFile

Many-To-One Relationship: importfile Import_ImportFile

Property	Value
ReferencingEntity	`importfile`
ReferencingAttribute	`importid`
ReferencedEntityNavigationPropertyName	`Import_ImportFile`
IsCustomizable	`False`
AssociatedMenuConfiguration	AvailableOffline: True Behavior: `DoNotDisplay` Group: `Details` Label: MenuId: null Order: QueryApi: null ViewId: `00000000-0000-0000-0000-000000000000`

Feedback

Was this page helpful?