Digitall.Plugins.Registration 2.0.0

Digitall.Plugins.Registration

NuGet package providing C# attributes for automated registration of Microsoft Dataverse plugin assemblies and workflow activities.

<p align="center"> <a href="LICENSE.md" target="_blank"> <img src="https://img.shields.io/github/license/DIGITALLNature/DigitallRegistrationPower.svg" alt="GitHub license"> </a> <a href="https://github.com/DIGITALLNature/DigitallRegistrationPower/releases" target="_blank"> <img src="https://img.shields.io/github/tag/DIGITALLNature/DigitallRegistrationPower.svg" alt="GitHub tag (latest SemVer)"> </a> <a href="https://www.nuget.org/packages/Digitall.Plugins.Registration" target="_blank"> <img src="https://img.shields.io/nuget/v/Digitall.Plugins.Registration" alt="NuGet"> </a> <a href="https://github.com/DIGITALLNature/DigitallRegistrationPower/graphs/contributors" target="_blank"> <img src="https://img.shields.io/github/contributors-anon/DIGITALLNature/DigitallRegistrationPower.svg" alt="GitHub contributors"> </a> </p>

Table of Contents

• Installation
• Usage
  • Plugin Registration
  • Custom API Registration
  • Custom Data Provider Registration
  • Workflow Registration
  • Managed Identity Registration
• API Reference
  • Attributes
  • Enums
• Requirements
• License

Installation

dotnet add package Digitall.Plugins.Registration

For a project in a subdirectory:

dotnet add src/MyProject package Digitall.Plugins.Registration

Usage

Add using Digitall.Plugins.Registration; to your file and decorate your plugin or workflow class with the appropriate attribute. A registration tool can then discover and apply these annotations automatically.

PluginRegistration

Use [PluginRegistration] on classes that implement IPlugin for standard plugin step registration. Multiple attributes can be stacked on one class to register multiple steps.

Constructor parameters (mandatory):

Optional named parameters:

using Digitall.Plugins.Registration;

[PluginRegistration(PluginExecutionMode.Asynchronous, "Create", PluginExecutionStage.PreOperation,
    PrimaryEntityName = "account", ExecutionOrder = 10)]
[PluginRegistration(PluginExecutionMode.Synchronous, "Update", PluginExecutionStage.PostOperation,
    PrimaryEntityName = "account",
    FilterAttributes = new[] { "name" },
    PreEntityImage = true, PreEntityImageAttributes = new[] { "name" })]
public class SamplePlugin : IPlugin
{
    public void Execute(IServiceProvider serviceProvider)
    {
        // ...
    }
}

CustomApiRegistration

Use [CustomApiRegistration] on classes that implement IPlugin and act as the handler for a Custom API. Multiple attributes can be stacked.

using Digitall.Plugins.Registration;

[CustomApiRegistration("dgt_calc_vacations")]
public class CalcVacationsPlugin : IPlugin
{
    public void Execute(IServiceProvider serviceProvider)
    {
        // ...
    }
}

CustomDataProviderRegistration

Use [CustomDataProviderRegistration] on classes that implement IPlugin and act as a virtual table data provider. Stack one attribute per event you want to handle.

using Digitall.Plugins.Registration;

[CustomDataProviderRegistration("dgt_virtual_table", DataProviderEvent.Create)]
[CustomDataProviderRegistration("dgt_virtual_table", DataProviderEvent.Update)]
public class HandleUpsertOnVirtualTable : IPlugin
{
    public void Execute(IServiceProvider serviceProvider)
    {
        // ...
    }
}

WorkflowRegistration

Use [WorkflowRegistration] on classes that derive from CodeActivity for workflow activity registration.

using Digitall.Plugins.Registration;

[WorkflowRegistration("Sample", "SampleGroup")]
public class SampleWorkflow : CodeActivity
{
    [Input(nameof(Email))]
    [RequiredArgument]
    [ReferenceTarget("email")]
    public InArgument<EntityReference> Email { get; set; }

    protected override void Execute(CodeActivityContext context)
    {
        // ...
    }
}

ManagedIdentityRegistration

Use [ManagedIdentityRegistration] at assembly level to associate a managed identity with the plugin assembly or package. Applied once per assembly.

Note: This attribute only handles the Dataverse-side registration. You still need to set up the managed identity in Azure and sign the assembly/package. See Microsoft Managed Identity overview.

using Digitall.Plugins.Registration;

[assembly: ManagedIdentityRegistration("00000000-0000-0000-0000-000000000000")]

API Reference

Attributes

Enums

PluginExecutionMode

PluginExecutionStage

DataProviderEvent

Requirements

• .NET Standard 2.0 or higher

License

Released under the Microsoft Public License (MS-PL).