Skip to main content

ImportOptions

  • Namespace: PPDS.Migration.Import
  • Assembly: PPDS.Migration
  • Kind: Class

Summary

Options for import operations.

Members

Properties

BypassCustomPlugins

CustomLogicBypass BypassCustomPlugins { get; set; }

Gets or sets which custom business logic to bypass during import.

BypassPowerAutomateFlows

bool BypassPowerAutomateFlows { get; set; }

Gets or sets whether to bypass Power Automate flows. Default: false

ContinueOnError

bool ContinueOnError { get; set; }

Gets or sets whether to continue on individual record failures. Default: true

CurrentUserId

Nullable<Guid> CurrentUserId { get; set; }

Gets or sets the current user's ID for fallback when user mappings can't resolve a reference.

ErrorCallback

Action<MigrationError> ErrorCallback { get; set; }

Gets or sets the callback for streaming errors as they occur.

ImpersonateOwners

bool ImpersonateOwners { get; set; }

Gets or sets whether to impersonate record owners during import. When true, records are created/updated as the original owner using caller-object-id impersonation. Default: false

MaxParallelEntities

int MaxParallelEntities { get; set; }

Gets or sets the maximum parallel entities within a tier. Must be at least 1. Default: 4

Mode

ImportMode Mode { get; set; }

Gets or sets the import mode. Default: Upsert

OutputManager

ImportOutputManager OutputManager { get; set; }

Gets or sets the output manager for checkpoint logging during import.

ResolveExternalLookups

bool ResolveExternalLookups { get; set; }

Gets or sets whether to resolve lookups to entities not in the migration schema by querying the target environment. Default: false

RespectDisablePluginsSetting

bool RespectDisablePluginsSetting { get; set; }

Gets or sets whether to disable plugins on entities marked with disableplugins=true in schema. Default: true (respects schema setting)

SkipMissingColumns

bool SkipMissingColumns { get; set; }

Gets or sets whether to skip columns that exist in exported data but not in the target environment.

SkipUnresolvedLookups

bool SkipUnresolvedLookups { get; set; }

Gets or sets whether to skip (null out) lookup references that cannot be resolved. When false, unresolved lookups cause an error. Default: true

StripOwnerFields

bool StripOwnerFields { get; set; }

Gets or sets whether to strip owner-related fields during import. When true, removes ownerid, createdby, modifiedby, and related fields, allowing Dataverse to assign the current user as owner. Use this when importing data to a different environment where source users don't exist. Default: false

SuppressDuplicateDetection

bool SuppressDuplicateDetection { get; set; }

Gets or sets whether to suppress duplicate detection. Default: false

UseBulkApis

bool UseBulkApis { get; set; }

Gets or sets whether to use modern bulk APIs (CreateMultiple, etc.). Default: true

UserMappings

UserMappingCollection UserMappings { get; set; }

Gets or sets the user mappings for remapping user references. If null, user references are not remapped.