This is a
playground to test code. It runs a full
Node.js environment and already has all of
npm’s 400,000 packages pre-installed, including
generator-nullfactory-xrm with all
npm packages installed. Try it out:
This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.
Dynamics CRM / 365 Project Structure Generator
A yeoman generator for scaffolding Solution Packager-compatible Dynamics 365 project structures.
The project structure is built around the Solution Packager (provided as part of the official SDK) and the Microsoft.Xrm.Data.PowerShell module. It facilitates the quick creation of team builds and release strategies with minimal effort and enables you to maintain a single source of truth for your CRM solutions.
npm install -g yo npm install -g generator-nullfactory-xrm
Then generate your new project:
Template questions and their purpose:
The visual studio solution filename.
The prefix for the projects generated. This can be an organization name or preferred convention.
This is the source CRM server url. Example:[https://sndbx.crm6.dynamics.com](https://sndbx.crm6.dynamics.com)
The name of the CRM solution to be extracted.
Specifies if a new project should be created to manage the web resouces.
Specifies if a new plugin project should be created.
Specifies if a new workflow project should be created
Start off by running the
_RunFirst.ps1 powershell script located in the generated root folder. This script would restore and update the packages used by the
Next, if you opted to add either a plugin or workflow project, ensure that the assembly is signed with a new key.
Optionally, install the
Microsoft.Xrm.Data.PowerShell powershell module. On a Windows 10 or later, do this by executing the included powershell script
Nullfactory.Xrm.Tooling\_Install\Install-Microsoft.Xrm.Data.PowerShell.ps1 or manually running the following command:
Install-Module -Name Microsoft.Xrm.Data.PowerShell -Scope CurrentUser -Force
Even if you skip this step, the sychrnoization PowerShell script would attempt to install it automatically. The PowerShell scripts require a minimum of PowerShell 5.0 and Microsoft.Xrm.Data.PowerShell 2.5.
If the underlying repository is git, run the following command to install a customised version of the gitignore file. This file is structured to include the binaries within the
Anytime the CRM solution needs to be pulled down into the project structure, execute the script located at
Edit the mapping file to map to the appropriate resource project. They are located in the
More information on the structure of the mapping file can be found here
The repackaging the extracted solution is integrated as a post-build step of the solution class library. Simply build it to output both a managed as well as unmanaged CRM solution package.
Use the following command and prompts in order to generate a tailored YAML CI build file.
Currently supports only Visual Studio Team Services.
More information on source control management, setting up continuous integration builds and automated releases:
Please submit any feature requests or issues found to https://github.com/shanec-/generator-nullfactory-xrm/issues
Copyright © Shane Carvalho. Licensed under the GPL-3.0 License.