編輯

共用方式為

Data Import (Import) table/entity reference

  • 發行項

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
Create
Event: False		 POST /imports
See Create		 Create records
Delete
Event: False		 DELETE /imports(importid)
See Delete		 Delete 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

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

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

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

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

See also

Dataverse table/entity reference
Dataverse Web API Reference
import