Resources For IT Professionals
Page Details
  • First published by (dMV)
  • When: 18 Apr 2011 6:29 AM
  • Last revision by (eMicrosoft Community Contributo)
  • When: 28 May 2013 7:34 AM
  • Revisions: 4
  • Comments: 3
Options

Original

Wiki  >  TechNet Articles  >  Plugin Registration Console Application Tool for Microsoft Dynamics CRM 2011  >  Original
Plugin Registration Console Application Tool for Microsoft Dynamics CRM 2011
You are currently reviewing an older revision of this page.
Go to current version
The purpose this one is to allow for easy registration and un-registration from a post-build or automated build environment, like TFS or Cruise Control.NET.  It is created by Johan Küstner.

I recommend checking it out at CodePlex here: http://pluginregcrm2011.codeplex.com/

Here are is instructions:

This tool uses the API provided in the SDK of Microsoft Dynamics CRM 2011:

*Microsoft.Crm.Sdk.Proxy
*Microsoft.Xrm.Sdk

This tool is intended to be compiled by Visuals Studio 2010 within the .NET Framework 4.0 and is intended for Microsoft Dynamics CRM 2011..

The tool exists in a Visual Studio Solution called PluginRegistrationTool.sln and consists of a Console Application Project called PluginRegistrationTool.csproj and a Test Project calledPluginRegistrationToolTestProject.csproj.

The tool has the option of using an AssemblyRegistration.xml XML file providing the input parameters with an AssemblyRegistration.xsd schema. The tool also has the option of being called directly from code, as indicated by the Unit Test called RegisterTest in the RegistrationHelperTest Class in thePluginRegistrationToolTestProject Test Project.

It is also possible to add the registered plugins or CWAs to a specific solution, which can be specified in the XML file. This is provided in the SolutionUniqueName node within the relevant Registrationnode. Each Registration can therefore be linked to a different Solution.

The AssemblyRegistration.xml and AssemblyRegistration.xsd files correlate with theAssemblyRegistration.cs Class in the project.

The AssemblyRegistration XML consists of the following: 
  • A AssemblyRegistration node.
  • The AssemblyRegistration has a XrmServerDetails and Registrations node.
  • The XrmServerDetails node consists of a ServerAddress, OrganizationName andXrmCredentials node.
  • The XrmCredentials node consists of a Domain, UserName and Password node.
  • The Registrations node consists of one or more Registration nodes.
  • The Registration node consists of an AssemblyPath, AssemblySourceType,IsolationMode, Steps and SolutionUniqueName node.
  • The Steps node contains one or more PluginStep nodes.
  • The PluginStep node consists of a PluginName, UnsecureConfiguration,SecureConfiguration, Name, Mode, Rank, InvocationSource, PluginMessage,PrimaryEntity, SecondaryEntity, ImpersonatingUserDomainName, Stage,Deployment, Description and Images node.
  • The Images node contains one or more Image nodes.
  • The Image node contains an ImageType, EntityAlias, Attributes, MessageProperty andMerge node.
  • The Attributes node contains an array of strings.

The Console Application accepts the following parameters:
Parameter: Description:
/PATH: The full path to the XML containing the assembly array details.
/UNREGISTER: Only specify this switch to unregister the assembly array.
/Help or /?: Displays the help.


Remember that when you build the Solution in Visual Studio, the Console Application is created as an executable file called PluginRegistrationTool.exe in the the bin\debug or bin\release folder of the Project.

Examples of running the Console Application:
  • PluginRegistrationTool.exe /?
  • PluginRegistrationTool.exe /HELP
  • PluginRegistrationTool.exe
  • PluginRegistrationTool.exe /UNREGISTER
  • PluginRegistrationTool.exe /PATH=C:\AssemblyRegistration.xml
  • PluginRegistrationTool.exe /PATH=C:\AssemblyRegistration.xml /UNREGISTER
Revert to this revision