Compartir a través de


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

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

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

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

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