import EntityType
Status and ownership information for an import job.
- Entity set path:
- [organization URI]/api/data/v9.2/imports
- Base type:
- crmbaseentity
- Display name:
- Data Import
- Primary key:
- importid
- Primary name column:
- name
- Operations supported:
- POST GET PATCH DELETE
Properties
Properties represent fields of data stored in the entity. Some properties are read-only.
| Name | Type | Details | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| createdon | Edm.DateTimeOffset |
Shows the date and time when the import was initiated. Display name: Created On Read only
|
||||||||||||||
| emailaddress | Edm.String |
Type the email address that the import completion notification must be sent to. Display name: Email |
||||||||||||||
| importid | Edm.Guid |
Unique identifier of the import job. Display name: Import |
||||||||||||||
| modecode | Edm.Int32 |
Select whether to create or update records in Microsoft Dynamics 365 during the import job. Display name: Mode
Default options
|
||||||||||||||
| modifiedon | Edm.DateTimeOffset |
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. Display name: Modified On Read only
|
||||||||||||||
| name | Edm.String |
Shows the name of the import job, based on the import file and the entity being imported. Display name: Import Name |
||||||||||||||
| sendnotification | Edm.Boolean |
Select whether to send a notification email message to a selected user after the import is completed. Display name: Send Notification
Default options
|
||||||||||||||
| sequence | Edm.Int32 |
Order in which the import was created. Display name: Sequence Read only
|
||||||||||||||
| statecode | Edm.Int32 |
Shows the status of the import job. By default, import jobs are active and can't be deactivated. Display name: Status Read only
Default options
|
||||||||||||||
| statuscode | Edm.Int32 |
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. Display name: Status Reason
Default options
|
Lookup properties
Lookup properties are read-only, computed properties which contain entity primary key Edm.Guid data for one or more corresponding single-valued navigation properties. More information: Lookup properties and Lookup property data.
| Name | Single-valued navigation property | Description |
|---|---|---|
| _createdby_value | createdby |
Shows who created the record. |
| _createdonbehalfby_value | createdonbehalfby |
Shows who created the record on behalf of another user. |
| _modifiedby_value | modifiedby |
Shows who last updated the record. |
| _modifiedonbehalfby_value | modifiedonbehalfby |
Shows who created the record on behalf of another user. |
| _ownerid_value | ownerid |
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. |
| _owningbusinessunit_value | owningbusinessunit |
Business unit that owns the import job. |
| _owningteam_value | owningteam |
Unique identifier of the team who owns the import. |
| _owninguser_value | owninguser |
Unique identifier of the user who owns the import. |
Single-valued navigation properties
Single-valued navigation properties represent lookup fields where a single entity can be referenced. Each single-valued navigation property has a corresponding partner collection-valued navigation property on the related entity.
| Name | Type | Partner |
|---|---|---|
| createdby | systemuser | lk_importbase_createdby |
| createdonbehalfby | systemuser | lk_import_createdonbehalfby |
| modifiedby | systemuser | lk_importbase_modifiedby |
| modifiedonbehalfby | systemuser | lk_import_modifiedonbehalfby |
| ownerid | principal | owner_imports |
| owningbusinessunit | businessunit | BusinessUnit_Imports |
| owningteam | team | team_Imports |
| owninguser | systemuser | SystemUser_Imports |
Collection-valued navigation properties
Collection-valued navigation properties represent collections of entities which may represent either a one-to-many (1:N) or many-to-many (N:N) relationship between the entities.
| Name | Type | Partner |
|---|---|---|
| Import_AsyncOperations | asyncoperation | regardingobjectid_import |
| Import_BulkDeleteFailures | bulkdeletefailure | regardingobjectid_import |
| Import_ImportFile | importfile | importid |
Operations
The following operations can be used with the import entity type.
| Name | Binding |
|---|---|
| GrantAccess | Not Bound |
| ImportRecordsImport | Bound to Entity |
| ModifyAccess | Not Bound |
| ParseImport | Bound to Entity |
| RetrievePrincipalAccess | Not Bound |
| RetrieveSharedPrincipalsAndAccess | Not Bound |
| RevokeAccess | Not Bound |
| TransformImport | Not Bound |