Referencia de tabla o entidad Data Import (Import)

Nota

¿No está seguro de tabla frente a entidad? Vea Desarrolladores: comprender la terminología en Microsoft Dataverse.

Status and ownership information for an import job.

Mensajes

Mensaje	Operación de API web	Método o clase de SDK
Create	POST [org URI]/api/data/v9.0/imports Vea Crear	CreateRequest o Create
Delete	DELETE [org URI]/api/data/v9.0/imports(importid) Vea Eliminar	DeleteRequest o Delete
GrantAccess	GrantAccess Action	GrantAccessRequest
ImportRecordsImport	ImportRecordsImport Action	ImportRecordsImportRequest
ModifyAccess	ModifyAccess Action	ModifyAccessRequest
ParseImport	ParseImport Action	ParseImportRequest
Retrieve	GET [org URI]/api/data/v9.0/imports(importid) Vea Recuperar	RetrieveRequest o Retrieve
RetrieveMultiple	GET [org URI]/api/data/v9.0/imports Vea Consultar datos	RetrieveMultipleRequest o RetrieveMultiple
RetrievePrincipalAccess	RetrievePrincipalAccess Function	RetrievePrincipalAccessRequest
RetrieveSharedPrincipalsAndAccess	RetrieveSharedPrincipalsAndAccess Function	RetrieveSharedPrincipalsAndAccessRequest
RevokeAccess	RevokeAccess Action	RevokeAccessRequest
TransformImport	TransformImport Action	TransformImportRequest
Update	PATCH [org URI]/api/data/v9.0/imports(importid) Vea Actualizar	UpdateRequest o Update

Propiedades

Propiedad	Valor
CollectionSchemaName	Imports
DisplayCollectionName	Data Imports
DisplayName	Data Import
EntitySetName	imports
IsBPFEntity	False
LogicalCollectionName	imports
LogicalName	import
OwnershipType	UserOwned
PrimaryIdAttribute	importid
PrimaryNameAttribute	name
SchemaName	Import

Columnas/atributos que se pueden escribir

Estas columnas o atributos devuelven true para IsValidForCreate o IsValidForUpdate (generalmente ambos). Listado por SchemaName.

• EMailAddress
• ImportId
• IsImport
• ModeCode
• Name
• OwnerId
• OwnerIdType
• SendNotification
• StatusCode

EMailAddress

Propiedad	Valor
Description	Type the email address that the import completion notification must be sent to.
DisplayName	Email
FormatName	Email
IsLocalizable	False
IsValidForForm	True
IsValidForRead	True
LogicalName	emailaddress
MaxLength	100
RequiredLevel	None
Type	String

ImportId

Propiedad	Valor
Description	Unique identifier of the import job.
DisplayName	Import
IsValidForForm	False
IsValidForRead	True
IsValidForUpdate	False
LogicalName	importid
RequiredLevel	SystemRequired
Type	Uniqueidentifier

IsImport

Propiedad	Valor
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

Elecciones/opciones de IsImport

Valor	Etiqueta	Descripción
1	Is Import
0	Is Migration

Valor predeterminado: 0

ModeCode

Propiedad	Valor
Description	Select whether to create or update records in Microsoft Dynamics 365 during the import job.
DisplayName	Mode
IsValidForForm	True
IsValidForRead	True
IsValidForUpdate	False
LogicalName	modecode
RequiredLevel	SystemRequired
Type	Picklist

Elecciones/opciones de ModeCode

Valor	Etiqueta	Descripción
0	Create
1	Update

Name

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

OwnerId

Propiedad	Valor
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
IsValidForUpdate	False
LogicalName	ownerid
RequiredLevel	SystemRequired
Targets	systemuser,team
Type	Owner

OwnerIdType

Propiedad	Valor
Description
DisplayName
IsValidForForm	False
IsValidForRead	True
IsValidForUpdate	False
LogicalName	owneridtype
RequiredLevel	SystemRequired
Type	EntityName

SendNotification

Propiedad	Valor
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

Elecciones/opciones de SendNotification

Valor	Etiqueta	Descripción
1	Yes
0	No

Valor predeterminado: 0

StatusCode

Propiedad	Valor
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

Elecciones/opciones de StatusCode

Valor	Etiqueta	Estado
0	Submitted	0
1	Parsing	0
2	Transforming	0
3	Importing	0
4	Completed	0
5	Failed	0

Columnas/atributos de sólo lectura

Estas columnas o atributos devuelven false tanto para IsValidForCreate como para IsValidForUpdate. Listado por SchemaName.

• CreatedBy
• CreatedByName
• CreatedByYomiName
• CreatedOn
• CreatedOnBehalfBy
• CreatedOnBehalfByName
• CreatedOnBehalfByYomiName
• ModifiedBy
• ModifiedByName
• ModifiedByYomiName
• ModifiedOn
• ModifiedOnBehalfBy
• ModifiedOnBehalfByName
• ModifiedOnBehalfByYomiName
• OwnerIdName
• OwnerIdYomiName
• OwningBusinessUnit
• OwningBusinessUnitName
• OwningTeam
• OwningUser
• Sequence
• StateCode

CreatedBy

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

CreatedByName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	createdbyname
MaxLength	100
RequiredLevel	None
Type	String

CreatedByYomiName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	createdbyyominame
MaxLength	100
RequiredLevel	None
Type	String

CreatedOn

Propiedad	Valor
DateTimeBehavior	UserLocal
Description	Shows the date and time when the import was initiated.
DisplayName	Created On
Format	DateAndTime
IsValidForForm	False
IsValidForRead	True
LogicalName	createdon
RequiredLevel	SystemRequired
Type	DateTime

CreatedOnBehalfBy

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

CreatedOnBehalfByName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	createdonbehalfbyname
MaxLength	100
RequiredLevel	None
Type	String

CreatedOnBehalfByYomiName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	createdonbehalfbyyominame
MaxLength	100
RequiredLevel	None
Type	String

ModifiedBy

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

ModifiedByName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	modifiedbyname
MaxLength	100
RequiredLevel	None
Type	String

ModifiedByYomiName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	modifiedbyyominame
MaxLength	100
RequiredLevel	None
Type	String

ModifiedOn

Propiedad	Valor
DateTimeBehavior	UserLocal
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
Format	DateAndTime
IsValidForForm	True
IsValidForRead	True
LogicalName	modifiedon
RequiredLevel	SystemRequired
Type	DateTime

ModifiedOnBehalfBy

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

ModifiedOnBehalfByName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	modifiedonbehalfbyname
MaxLength	100
RequiredLevel	None
Type	String

ModifiedOnBehalfByYomiName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	modifiedonbehalfbyyominame
MaxLength	100
RequiredLevel	None
Type	String

OwnerIdName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	owneridname
MaxLength	100
RequiredLevel	SystemRequired
Type	String

OwnerIdYomiName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	owneridyominame
MaxLength	100
RequiredLevel	SystemRequired
Type	String

OwningBusinessUnit

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

OwningBusinessUnitName

Propiedad	Valor
Description
DisplayName
FormatName	Text
IsLocalizable	False
IsValidForForm	False
IsValidForRead	True
LogicalName	owningbusinessunitname
MaxLength	160
RequiredLevel	None
Type	String

OwningTeam

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

OwningUser

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

Sequence

Propiedad	Valor
Description	Order in which the import was created.
DisplayName	Sequence
Format	None
IsValidForForm	False
IsValidForRead	True
LogicalName	sequence
MaxValue	2147483647
MinValue	-2147483648
RequiredLevel	SystemRequired
Type	Integer

StateCode

Propiedad	Valor
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

Elecciones/opciones de StateCode

Valor	Etiqueta	Estado predeterminado	Nombre invariable
0	Active	0	Active

Relaciones de uno a varios

Listado por SchemaName.

• Import_ImportFile
• Import_BulkDeleteFailures
• Import_AsyncOperations

Import_ImportFile

Igual que la relación de varios a uno Import_ImportFile de la tabla importfile.

Propiedad	Valor
ReferencingEntity	importfile
ReferencingAttribute	importid
IsHierarchical	False
IsCustomizable	False
ReferencedEntityNavigationPropertyName	Import_ImportFile
AssociatedMenuConfiguration	Behavior: DoNotDisplay Group: Details Label: Order:
CascadeConfiguration	Assign: NoCascade Delete: Cascade Merge: NoCascade Reparent: NoCascade Share: NoCascade Unshare: NoCascade

Import_BulkDeleteFailures

Igual que la relación de varios a uno Import_BulkDeleteFailures de la tabla bulkdeletefailure.

Propiedad	Valor
ReferencingEntity	bulkdeletefailure
ReferencingAttribute	regardingobjectid
IsHierarchical	False
IsCustomizable	False
ReferencedEntityNavigationPropertyName	Import_BulkDeleteFailures
AssociatedMenuConfiguration	Behavior: DoNotDisplay Group: Details Label: Order:
CascadeConfiguration	Assign: NoCascade Delete: Cascade Merge: NoCascade Reparent: NoCascade Share: NoCascade Unshare: NoCascade

Import_AsyncOperations

Igual que la relación de varios a uno Import_AsyncOperations de la tabla asyncoperation.

Propiedad	Valor
ReferencingEntity	asyncoperation
ReferencingAttribute	regardingobjectid
IsHierarchical	False
IsCustomizable	False
ReferencedEntityNavigationPropertyName	Import_AsyncOperations
AssociatedMenuConfiguration	Behavior: DoNotDisplay Group: Details Label: Order:
CascadeConfiguration	Assign: NoCascade Delete: NoCascade Merge: NoCascade Reparent: NoCascade Share: NoCascade Unshare: NoCascade

Relaciones de varios a uno

Cada relación de varios a uno se define mediante una relación de uno a varios correspondiente con la tabla relacionada. Listado por SchemaName.

• lk_import_modifiedonbehalfby
• team_Imports
• lk_importbase_modifiedby
• BusinessUnit_Imports
• SystemUser_Imports
• lk_import_createdonbehalfby
• lk_importbase_createdby

lk_import_modifiedonbehalfby

Consulte la relación de uno a varios lk_import_modifiedonbehalfby de la tabla systemuser.

team_Imports

Consulte la relación de uno a varios team_Imports de la tabla team.

lk_importbase_modifiedby

Consulte la relación de uno a varios lk_importbase_modifiedby de la tabla systemuser.

BusinessUnit_Imports

Consulte la relación de uno a varios BusinessUnit_Imports de la tabla businessunit.

SystemUser_Imports

Consulte la relación de uno a varios SystemUser_Imports de la tabla systemuser.

lk_import_createdonbehalfby

Consulte la relación de uno a varios lk_import_createdonbehalfby de la tabla systemuser.

lk_importbase_createdby

Consulte la relación de uno a varios lk_importbase_createdby de la tabla systemuser.

Consultar también

Referencia de tabla o entidad de Dataverse Referencia de la API web import EntityType