PPDS.Plugins 1.1.0

PPDS.Plugins

Plugin development attributes for Microsoft Dataverse. Part of the Power Platform Developer Suite ecosystem.

Overview

PPDS.Plugins provides declarative attributes for configuring Dataverse plugin registrations directly in your plugin code. These attributes are extracted by PPDS.Tools to generate registration files that can be deployed to any environment.

Installation

dotnet add package PPDS.Plugins

Or via the NuGet Package Manager:

Install-Package PPDS.Plugins

Usage

Basic Plugin Step

using PPDS.Plugins;

[PluginStep(
    Message = "Create",
    EntityLogicalName = "account",
    Stage = PluginStage.PostOperation)]
public class AccountCreatePlugin : IPlugin
{
    public void Execute(IServiceProvider serviceProvider)
    {
        // Plugin implementation
    }
}

Plugin with Filtering Attributes

[PluginStep(
    Message = "Update",
    EntityLogicalName = "contact",
    Stage = PluginStage.PreOperation,
    Mode = PluginMode.Synchronous,
    FilteringAttributes = "firstname,lastname,emailaddress1")]
public class ContactUpdatePlugin : IPlugin
{
    public void Execute(IServiceProvider serviceProvider)
    {
        // Only triggers when specified attributes change
    }
}

Plugin with Images

[PluginStep(
    Message = "Update",
    EntityLogicalName = "account",
    Stage = PluginStage.PostOperation)]
[PluginImage(
    ImageType = PluginImageType.PreImage,
    Name = "PreImage",
    Attributes = "name,telephone1,revenue")]
public class AccountAuditPlugin : IPlugin
{
    public void Execute(IServiceProvider serviceProvider)
    {
        // Access pre-image via context.PreEntityImages["PreImage"]
    }
}

Asynchronous Plugin

[PluginStep(
    Message = "Create",
    EntityLogicalName = "email",
    Stage = PluginStage.PostOperation,
    Mode = PluginMode.Asynchronous)]
public class EmailNotificationPlugin : IPlugin
{
    public void Execute(IServiceProvider serviceProvider)
    {
        // Runs in background via async service
    }
}

Attributes

PluginStepAttribute

Defines how a plugin is registered in Dataverse.

PluginImageAttribute

Defines pre/post images for a plugin step.

Enums

PluginStage

• PreValidation (10) - Before main system validation
• PreOperation (20) - Before main operation, within transaction
• PostOperation (40) - After main operation

PluginMode

• Synchronous (0) - Immediate execution, blocks operation
• Asynchronous (1) - Background execution via async service

PluginImageType

• PreImage (0) - Entity state before operation
• PostImage (1) - Entity state after operation
• Both (2) - Both pre and post images

Related Projects

• power-platform-developer-suite - VS Code extension
• ppds-tools - PowerShell deployment module
• ppds-alm - CI/CD pipeline templates
• ppds-demo - Reference implementation

License

MIT License - see LICENSE for details.