Build Windows client applications using the XRM tools


Applies To: Dynamics CRM 2013

XRM tooling is a set of new APIs built on top of the Microsoft Dynamics CRM APIs that provide support for building Windows client applications for Microsoft Dynamics CRM. It provides the following capabilities:

  • Supports all the authentication modes to sign in to CRM, except OAuth.

  • Provides Windows PowerShell support for authentication and connection to CRM.

  • Provides thread safety for actions performed in CRM in a multithreaded environment. More information: Multithreading in Components, Thread-Safe Components

  • Provides a common Windows Presentation Foundation (WPF) (WPF) login control for CRM for consistent sign-in experience to CRM from your Windows client applications.

  • Supports secure storage of the sign-in credentials and reuse of the stored credentials to automatically sign in to CRM after initial sign in.

  • Provides built-in diagnostic tracing and performance reporting of the actions performed in CRM, which you can configure based on your organization’s requirements.

Components of XRM tooling

XRM tooling has the following three components:

  • Interface for CRM APIs: This provides the low-level interaction and wrapper methods for the CRM APIs. It is an instrumented API that provides a thread safe environment for making calls to Microsoft Dynamics CRM with built-in diagnostic capabilities to help you determine the performance of individual calls. It also provides a standard set of trace listeners for debugging support. The namespace for this component is Microsoft.Xrm.Tooling.Connector.

  • Common login control: This is a WPF user control that provides a common user interface for the sign in experience to Microsoft Dynamics CRM. The login control supports all the authentication modes, except OAuth. The common login control has built-in encryption for securely storing your credentials/profile, and then reusing it at runtime to automatically sign in to CRM. The namespace for this component is Microsoft.Xrm.Tooling.CrmConnectControl.

  • Web resource utility: This provides support for accessing information from the following two types of web resources in CRM: Image and XML. You can access an image from a CRM web resource and return it as WPF BitmapImage objects. Similarly, you can return an XML web resource as a string. The namespace for this component is Microsoft.Xrm.Tooling.WebResourceUtility.

Client applications that use XRM tooling

The following applications in the current version of CRM use the common WPF login control for authenticating users while signing in to CRM from the client application:

In This Section

Use XRM tooling to connect to CRM

Use PowerShell cmdlets for XRM tooling to connect to CRM

Use XRM tooling to execute actions in CRM

Use XRM tooling with classes generated by using the code-generation tool

Use the XRM tooling common login control in your client applications

Configure tracing for XRM tooling

See Also

Sample: Quick start for XRM Tooling API
Write applications and server extensions