Import (data import) entity messages and methods
Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
This entity represents the status and ownership for the import job. The schema name for this entity is Import. To view the entity metadata for your organization, install the Metadata Browser solution described in Browse the metadata for your organization. You can also view the metadata for an uncustomized organization in the Excel file called EntityMetadata.xlsx included in the top-level folder of the SDK download.
The following table describes the messages for this entity, which you use with the IOrganizationService.Execute method.
Message |
Description |
|---|---|
Creates a data import. You can also call the IOrganizationService.CreateRequest method. |
|
Deletes a data import. You can also call the IOrganizationService.Delete method. |
|
Shares a data import with another security principal (user or team). |
|
Submits an asynchronous job that uploads transformed data to the target server. The import records job imports all import files associated with the specified import (data import). Pass the ID of the associated import (data import) in the ImportId property of this request. The ID of the asynchronous job that runs in the background and performs uploading of data is returned in the AsyncOperationId property of the message response. |
|
Changes the access rights for a data import previously shared with another security principal (user or team). |
|
Submits an asynchronous job that parses all import files associated with the specified import (data import). Pass the ID of the associated import (data import) in the ImportId property of this request. The ID of the asynchronous job runs in the background and performs parsing of data is returned in the AsyncOperationId property of the message response. |
|
Retrieves a data import. You can also call the IOrganizationService.Retrieve method. |
|
Retrieves a collection of data imports. You can also call the IOrganizationService.RetrieveMultiplemethod. |
|
Retrieves the access the specified security principal (user or team) has to a data import. |
|
Retrieves the security principals (users or teams) that have access to a data import, and their access rights to the data import. |
|
Revokes access rights to the data import for the specified security principal (user or team). |
|
Submits an asynchronous job to transform the parsed data. Pass the ID of the associated import (data import) in the ImportId property of this request. The ID of the asynchronous job runs in the background and performs transformation of data is returned in the AsyncOperationId property of the message response. |
|
Updates a data import. You can also call the UpdateRequest method. |
Note
The parse table is not accessible after the asynchronous import records job is completed.
Use the following messages in this order:
ParseImport to parse data.
TransformImport to transform data.
ImportRecordsImport to upload data.
Don’t submit a request for the next job before the previous job has finished running successfully.
See Also
Data import entities
Privileges by entity
ImportFile entity messages and methods
Microsoft Dynamics 365
© 2016 Microsoft. All rights reserved. Copyright