PPDS.Migration 1.0.0-beta.5

PPDS SDK

NuGet packages for Microsoft Dataverse development. Part of the Power Platform Developer Suite ecosystem.

Packages

Package	NuGet	Description
PPDS.Plugins		Declarative plugin registration attributes
PPDS.Dataverse		High-performance connection pooling and bulk operations
PPDS.Migration		High-performance data migration engine
PPDS.Auth		Authentication profiles and credential management
PPDS.Cli		Unified CLI tool (.NET tool)

Compatibility

PPDS.Plugins

Declarative attributes for configuring Dataverse plugin registrations directly in code.

dotnet add package PPDS.Plugins

[PluginStep(
    Message = "Create",
    EntityLogicalName = "account",
    Stage = PluginStage.PostOperation)]
[PluginImage(
    ImageType = PluginImageType.PreImage,
    Name = "PreImage",
    Attributes = "name,telephone1")]
public class AccountCreatePlugin : IPlugin
{
    public void Execute(IServiceProvider serviceProvider) { }
}

See PPDS.Plugins on NuGet for details.

PPDS.Dataverse

High-performance Dataverse connectivity with connection pooling, throttle-aware routing, and bulk operations.

dotnet add package PPDS.Dataverse

// Setup with typed configuration
services.AddDataverseConnectionPool(options =>
{
    options.Connections.Add(new DataverseConnection("Primary")
    {
        Url = "https://org.crm.dynamics.com",
        ClientId = "your-client-id",
        ClientSecret = Environment.GetEnvironmentVariable("DATAVERSE_SECRET")
    });
    options.Pool.DisableAffinityCookie = true; // 10x+ throughput improvement
});

// Usage
await using var client = await pool.GetClientAsync();
var account = await client.RetrieveAsync("account", id, new ColumnSet(true));

See PPDS.Dataverse documentation for details.

PPDS.Migration

High-performance data migration engine for Dataverse. Replaces CMT for automated pipeline scenarios with 3-8x performance improvement.

dotnet add package PPDS.Migration

// Setup
services.AddDataverseConnectionPool(options =>
{
    options.Connections.Add(new DataverseConnection("Target")
    {
        Url = "https://org.crm.dynamics.com",
        ClientId = "your-client-id",
        ClientSecret = Environment.GetEnvironmentVariable("DATAVERSE_SECRET")
    });
});
services.AddDataverseMigration();

// Export
var exporter = serviceProvider.GetRequiredService<IExporter>();
await exporter.ExportAsync("schema.xml", "data.zip");

// Import with dependency resolution
var importer = serviceProvider.GetRequiredService<IImporter>();
await importer.ImportAsync("data.zip");

Key Features:

• Parallel export (all entities exported concurrently)
• Tiered import with automatic dependency resolution
• Circular reference detection with deferred field processing
• CMT format compatibility (drop-in replacement)
• Security-first: no PII in logs, connection string redaction

See PPDS.Migration documentation for details.

PPDS.Cli

Unified CLI tool for Dataverse operations. Install as a .NET global tool:

dotnet tool install -g PPDS.Cli

# Create an auth profile (opens browser for login)
ppds auth create --name dev

# Select your environment
ppds env select --environment "My Environment"

# Export data
ppds data export --schema schema.xml --output data.zip

# Import data
ppds data import --data data.zip --mode Upsert

Commands:

• ppds auth - Authentication profiles (create, list, select, delete, update, who)
• ppds env - Environment discovery and selection (list, select, who)
• ppds data - Data operations (export, import, copy, schema, users, load)
• ppds plugins - Plugin registration (extract, deploy, diff, list, clean)
• ppds metadata - Entity browsing (entities, attributes, relationships, keys, optionsets)
• ppds query - Execute queries (fetch, sql)

See PPDS.Cli documentation for details.

Architecture Decisions

Key design decisions are documented as ADRs:

• ADR-0001: Disable Affinity Cookie by Default
• ADR-0002: Multi-Connection Pooling
• ADR-0003: Throttle-Aware Connection Selection
• ADR-0004: Throttle Recovery Strategy
• ADR-0005: DOP-Based Parallelism
• ADR-0006: Connection Source Abstraction
• ADR-0007: Unified CLI and Shared Authentication
• ADR-0008: CLI Output Architecture
• ADR-0009: CLI Command Taxonomy
• ADR-0010: Published vs Unpublished Default
• ADR-0011: Deployment Settings Format
• ADR-0012: Hybrid Filter Design
• ADR-0013: CLI Dry-Run Convention
• ADR-0014: CSV Mapping Schema

Patterns

• Connection Pooling - When and how to use connection pooling
• Bulk Operations - High-throughput data operations

Claude Code Integration

PPDS provides templates for Claude Code users developing Power Platform solutions:

• Consumer Guide - Best practices for PPDS development
• Recommended Settings - Permission configuration for PPDS commands
• Slash Commands - Quick reference commands

See templates/claude/INSTALL.md for installation instructions.

Related Projects

License

MIT License - see LICENSE for details.