Freigeben über


Referenz zur Tabelle/Entität Data Import (Import)

Hinweis

Unsicher bei Tabelle vs. Entität? Siehe Entwickler: Terminologie in Microsoft Dataverse verstehen.

Status and ownership information for an import job.

Nachrichten

Nachricht Web-API-Vorgang SDK-Klasse oder -Methode
Create POST [org URI]/api/data/v9.0/imports
Weitere Informationen finden Sie unter Erstellen
CreateRequest oder
Create
Delete DELETE [org URI]/api/data/v9.0/imports(importid)
Weitere Informationen finden Sie unter Löschen
DeleteRequest oder
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)
Weitere Informationen finden Sie unter Abrufen
RetrieveRequest oder
Retrieve
RetrieveMultiple GET [org URI]/api/data/v9.0/imports
Weitere Informationen finden Sie unter Daten abfragen
RetrieveMultipleRequest oder
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)
Weitere Informationen finden Sie unter Aktualisieren
UpdateRequest oder
Update

Eigenschaften

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

Schreibbare Spalten/Attribute

Diese Spalten/Attribute geben entweder für IsValidForCreate oder IsValidForUpdate (normalerweise beides) true zurück. Aufgelistet durch SchemaName.

EMailAddress

Eigenschaft Wert
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

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

IsImport

Eigenschaft Wert
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

IsImport Auswahlen/Optionen

Wert Etikett Beschreibung
1 Is Import
0 Is Migration

Standardwert: 0

ModeCode

Eigenschaft Wert
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

ModeCode Auswahlen/Optionen

Wert Etikett Beschreibung
0 Create
1 Update

Name

Eigenschaft Wert
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

Eigenschaft Wert
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

Eigenschaft Wert
Description
DisplayName
IsValidForForm False
IsValidForRead True
IsValidForUpdate False
LogicalName owneridtype
RequiredLevel SystemRequired
Type EntityName

SendNotification

Eigenschaft Wert
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

SendNotification Auswahlen/Optionen

Wert Etikett Beschreibung
1 Yes
0 No

Standardwert: 0

StatusCode

Eigenschaft Wert
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

StatusCode Auswahlen/Optionen

Wert Etikett Status
0 Submitted 0
1 Parsing 0
2 Transforming 0
3 Importing 0
4 Completed 0
5 Failed 0

Schreibgeschützt Spalten/Attribute

Diese Spalten/Attribute geben false zurück für sowohl IsValidForCreate als auch IsValidForUpdate. Aufgelistet durch SchemaName.

CreatedBy

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

CreatedByName

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

CreatedByYomiName

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

CreatedOn

Eigenschaft Wert
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

Eigenschaft Wert
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

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

CreatedOnBehalfByYomiName

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

ModifiedBy

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

ModifiedByName

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

ModifiedByYomiName

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

ModifiedOn

Eigenschaft Wert
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

Eigenschaft Wert
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

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

ModifiedOnBehalfByYomiName

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

OwnerIdName

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

OwnerIdYomiName

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

OwningBusinessUnit

Eigenschaft Wert
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

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

OwningTeam

Eigenschaft Wert
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

Eigenschaft Wert
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

Eigenschaft Wert
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

Eigenschaft Wert
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

StateCode Auswahlen/Optionen

Wert Etikett Standardstatuswert Invariante Name
0 Active 0 Active

Eins-zu-Viele-Beziehungen

Aufgelistet durch SchemaName.

Import_ImportFile

Wie die Import_ImportFile-Viele-zu-Eins-Beziehung für die importfile-Tabelle/-Entität.

Eigenschaft Wert
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

Wie die Import_BulkDeleteFailures-Viele-zu-Eins-Beziehung für die bulkdeletefailure-Tabelle/-Entität.

Eigenschaft Wert
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

Wie die Import_AsyncOperations-Viele-zu-Eins-Beziehung für die asyncoperation-Tabelle/-Entität.

Eigenschaft Wert
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

Viele-zu-Eins-Beziehungen

Jede Viele-zu-Eins-Beziehung wird durch eine entsprechende Viele-zu-Viele-Beziehungen mit der zugehörigen Tabelle definiert. Aufgelistet durch SchemaName.

lk_import_modifiedonbehalfby

Siehe die lk_import_modifiedonbehalfby-Eins-zu-Viele-Beziehung für die systemuser-Tabelle/-Entität.

team_Imports

Siehe die team_Imports-Eins-zu-Viele-Beziehung für die team-Tabelle/-Entität.

lk_importbase_modifiedby

Siehe die lk_importbase_modifiedby-Eins-zu-Viele-Beziehung für die systemuser-Tabelle/-Entität.

BusinessUnit_Imports

Siehe die BusinessUnit_Imports-Eins-zu-Viele-Beziehung für die businessunit-Tabelle/-Entität.

SystemUser_Imports

Siehe die SystemUser_Imports-Eins-zu-Viele-Beziehung für die systemuser-Tabelle/-Entität.

lk_import_createdonbehalfby

Siehe die lk_import_createdonbehalfby-Eins-zu-Viele-Beziehung für die systemuser-Tabelle/-Entität.

lk_importbase_createdby

Siehe die lk_importbase_createdby-Eins-zu-Viele-Beziehung für die systemuser-Tabelle/-Entität.

Siehe auch

Dataverse-Tabelle/-Entitätsreferenz Web-API-Referenz import EntityType