Installing Sage CRM .NET SDK

Before installing the Sage CRM .NET SDK, ensure that the following prerequisites are met:

Computer

Prerequisites

Computer on which you plan to develop custom .NET DLLs.
  • Sage CRM 2019 R1 or later with a valid license key
    The Sage CRM version must be the same as the one installed on the target Sage CRM server.
  • Sage CRM .NET SDK
  • Microsoft Visual Studio 2017 or later
    Other Visual Studio versions may also be suitable. In this case, you need to manually copy the templates, snippets, and example projects to the correct folder after installing the Sage CRM .NET SDK.
    For more information, see Manually copying C# project templates, snippets, and example projects.
  • Microsoft .NET Framework 2.0

Target Sage CRM server on which you plan to deploy your .NET DLLs.
  • Sage CRM 2019 R1 or later with a valid license key
  • Microsoft .NET Framework 2.0

To install the Sage CRM .NET SDK:

  1. Download the Sage CRM .NET SDK installation package for your version of Sage CRM.
    You can download the .NET SDK installation packages on the Sage CRM Partner Community.
  2. Extract the contents of the downloaded .zip file to a temporary folder on your local disk drive.
  3. Run the .exe file and complete the wizard that starts.

The Sage .NET SDK registers a number of DLLs that provide the runtime environment in the Global Assembly Cache (GAC).

On a computer where the .NET SDK is installed, these DLLs are located in the following folder:

%ProgramFiles(x86)%\Sage\CRM\CRMDotNet

Do not add or change the files in this location.

When you create a new C# project in Microsoft Visual Studio on a computer where the Sage CRM .NET SDK is installed, you can select one of the C# project templates installed with the Sage CRM .NET SDK. For more information, see Provided C# templates.

If you encounter errors while installing the Sage CRM .NET SDK or if the new C# project templates are not available in Microsoft Visual Studio or return errors (such as "This template attempted to load an untrusted component"), follow the instructions in the topics below: