ImportFile entity messages and methods

 

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

This entity represents a logical source file that is used in data import. The schema name for this entity is ImportFile. 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

AssignRequest

Assigns an import file to another user or team.

CreateRequest

Creates an import file. You can also call the IOrganizationService.Create method.

DeleteRequest

Deletes an import file. You can also call the IOrganizationService.Delete method.

GetDistinctValuesImportFileRequest

Returns distinct values for a column in the source file that contains list values. Use this message only after you have created a parse table by using the ParseImport message. Don’t use this message after you use the ImportRecordsImport message. You can’t access the parse table after the import job submitted by the ImportRecordsImport message has finished running.

GetHeaderColumnsImportFileRequest

Retrieves source file column headings, or system-generated column headings if the source file doesn’t contain column headings.

GrantAccessRequest

Shares an import file with another security principal (user or team).

ModifyAccessRequest

Changes the access rights for an import file previously shared with another security principal (user or team).

RetrieveRequest

Retrieves an import file. You can also call the IOrganizationService.Retrieve method.

RetrieveMultipleRequest

Retrieves a collection of import files. You can also call the IOrganizationService.RetrieveMultiplemethod.

RetrieveParsedDataImportFileRequest

Retrieves the data from the parse table. Use this message only after you have created a parse table by using the ParseImport message. Do not use this message after you use the ImportRecordsImport message. You cannot access the parse table after the import job submitted by the ImportRecordsMessage message has finished running.

RetrievePrincipalAccessRequest

Retrieves the access rights that the specified security principal (user or team) has to an import file.

RetrieveSharedPrincipalsAndAccessRequest

Retrieves all the security principals (users or teams) that have access to an account, and their access rights to the import file.

RevokeAccessRequest

Removes all access rights to an import file for the specified security principal (user or team).

UpdateRequest

Updates an import file. You can also call the IOrganizationService.Update method.

See Also

Data import entities
Privileges by entity
ImportLog entity messages and methods

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright