xrm-ex

XrmEx: Dynamics 365 TypeScript eXtensions

Welcome to XrmEx, a powerful TypeScript framework designed for Dynamics 365 Client API. This library is intended to ease the usage of the formContext and the Xrm Object, reducing the amount of code you have to write, thus enhancing maintainability and minimizing errors.

With XrmEx, you'll find a set of intuitive and robust TypeScript wrappers that bring the power of Dynamics 365 Client API into the TypeScript ecosystem in a developer-friendly way. This library is designed to boost your productivity, allowing you to focus on what matters most: creating amazing applications.

Getting Started

Install devDependencies

npm install

To get started with XrmEx, you'll first need to reference the library in your TypeScript project and create an early bound fields Class. Create a variable which is going to hold the instance of your fields Class. Assign the executionContext OnLoad to XrmEx.Form.formContext and create a new instance of your fields class and you're good to go: Reference script

/// <reference path="XrmEx.d.ts" />
let Form = XrmEx.Form;
class Fields {
    Firstname = new XrmEx.Field("firstname"),
    Lastname = new XrmEx.Field("lastname")
};
var fields: Fields;
export async function OnLoad(executionContext:Xrm.Events.EventContext){
fields = new Fields();
XrmEx.Form.formContext = executionContext;
}

You can then use the library to interact with the Dynamics 365 Client API. Here's a simple example:

export async function OnLoad(executionContext:Xrm.Events.EventContext){
fields = new Fields();
XrmEx.Form.formContext = executionContext;

if(Form.IsCreate) return;

fields.Firstname.Value = "Joe";
fields.Lastname.setVisible(false).setDisabled(false).setRequired(true);
}

Installation

XrmEx can be easily installed via npm:

npm install --save xrmex

Documentation

For a comprehensive guide to using XrmEx, please check out the full documentation.

Contribution Guidelines

We welcome contributions from the community! If you're interested in contributing, please follow these steps:

1. Fork the repository
2. Create a new branch for your changes
3. Make your changes
4. Submit a pull request

For more information, please see our contribution guide.

XrmEx is released as an open-source project. We welcome contributions from the developer community. Whether it's a bug report, new feature, or a correction, we greatly appreciate any help you can provide.

Leverage the power of Dynamics 365 Client API with less code and fewer errors. Get started with XrmEx today!