MWTech.Dataverse.PluginToolKit 1.0.0.8

MWTech.Dataverse.PluginToolKit 💡

A battle-tested, sugar-loaded plugin helper library for Dynamics 365 / Dataverse development — designed by developers, for developers ⚔️

🧩 What is this?

MWTech.Dataverse.PluginToolKit is your all-in-one toolbox for writing clean, maintainable, and efficient Dynamics plugins.

Skip the boilerplate. Focus on the logic. This kit does the rest.

✨ Features

✅ Plugin Base

• UltimatePluginBase — abstract base class for fast, structured plugin dev.
• PluginContext — all plugin services injected and ready to roll.

public class MyPlugin : UltimatePluginBase
{
    protected override void ExecutePluginLogic()
    {
        Logger.LogInfo("Plugin running!");        
        var name = Target?.Get<string>("name");
        //or
        var name = Target?.GetString("name");
    }
}

🔧 Extension Libraries

🧠 EntityExtensions

• entity.Get<T>("attribute")
• entity.Has("field")
• entity.GetLookupId("parentid")
• entity.HasChanged(preImage, "field")

⚙️ ExecutionContextExtensions

• context.IsCreate(), IsUpdate(), IsDelete()
• GetTargetEntity(), GetPreImage(), GetPostImage()

🔥 TracingServiceExtensions

• .LogInfo("...")
• .LogError(ex)
• .Log("CustomLevel", "message")

🌐 HttpHelper

• HttpHelper.Post<T>()
• HttpHelper.Get<T>()
• Supports headers (e.g., Bearer tokens)

🧙 ServiceExtensions

• service.RetrieveEntity("account", id, columns)
• service.SafeUpdate(entity)
• service.RetrieveMultipleEntities(query)

🧙‍♀️ FetchXmlExtensions

• service.Fetch<T>(fetchXml)
• service.FetchSingle<T>(fetchXml)
• Typed results from FetchXML with minimal effort

🧙‍♀️ Annotation Helpers

AnnotationHelper.AddSimpleNote( Service, Context.GetPrimaryEntityReference(), subject: "Plugin Ran", noteText: "Some useful note." );

AnnotationHelper.AttachAnnotation( Service, new EntityReference("contact", contactId), qrCodeBytes, "qrcode.png", "image/png", subject: "QR Code", noteText: "Auto-generated QR" );

📦 Installation

dotnet add package MWTech.Dataverse.PluginToolKit

Or from NuGet Package Manager UI:

Browse → Search MWTech.Dataverse.PluginToolKit → Install

🔥 Sample Plugin Usage

public class MyPlugin : UltimatePluginBase
{
    protected override void ExecutePluginLogic()
    {
        Logger.LogInfo("Plugin running!");        
        var name = Target?.Get<string>("name");
        //or
        var name = Target?.GetString("name");
    }
}

Built with ❤️ for real-world CRM developers by MWTech