Getting started

Getting started

Get up and running with XrmDefinitelyTyped in a few minutes by following this guide.

Prerequisities

• TypeScript 2.0 - 2.3.3 installed
• TypeScript is set up to compile .ts files in your project

Video Guide

Step-by-step

Setup:

1. Install the package via NuGet
2. Edit the appSettings in the configuration file (XrmDefinitelyTyped.exe.config) to fit your Dynamics CRM environment and needs (see [arguments available to XDT](Tool usage)).

Usage:

1. Run XrmDefinitelyTyped.exe*. This will generate the desired declaration files at the specified location (or in the current folder if none specified)
2. Make sure your tsconfig.json file includes the generated typings in the TypeScript context
3. Create a TypeScript file, or convert your old .js files to .ts
4. Making form logic? Cast the Xrm.Page object to the form you are coding towards
5. Start coding!

*: Since .exe files can not be run directly from Visual Studio (out-of-the-box at least), script files are included in the package to enable you to run it from the IDE (Powershell: Run.ps1, or F#: Run.fsx).

Recommended form script file-setup

Either make a new variable (i.e. Page), and set it to Xrm.Page casted to the desired form type:

namespace DG.Contact {
    const Page = <Form.contact.Main.Information>Xrm.Page;
    export function onLoad() {
        // Code here..
        Page.getAttribute("firstname");
    }
}

Or declare the Xrm object to be the form your want it to match:

namespace DG.Contact {
    declare var Xrm: Xrm<Form.contact.Main.Information>;
    export function onLoad() {
        // Code here..
        Xrm.Page.getAttribute("firstname");
    }
}