Installation

Installation

Command

npm install -g @hso/d365-cli

Prerequisites

• Install Node. Read more
• Install ESLint plugin. Read more
• Install Fiddler. Read more
• Configure Application Registration

Node

Node is the Node Package Manager used by the projects to install JavaScript/TypeScript packages

ESLint

When using Visual Studio Code as IDE, have Visual Studio Code ESLint plugin installed. The projects have an ESLint Configuration to lint/validate the code build and compile time. The ESLint plugin is for build time.

Fiddler

Fiddler is recommended for debugging. It is a proxy and will serve local files instead of server files. Fiddler needs some settings in general and rules for every project. See Debugging for adding rules.

Fiddler settings:

• Start Fiddler and click 'Tools' and 'Options...'
• Click 'HTTPS' tab
  • Select 'Capture HTTPS CONNECTs', 'Decrypt HTTPS traffic', 'Ignore server certificate errors (unsafe)
  • Select '...from browsers only' in dropdown
  • In 'Skip descryption for the following hosts:' add *.microsoft.com; *.microsoftonline.com; *.live.com; *.office.net;
• Click 'Connections' tab
  • Select 'Reuse client connections', 'Reuse server connections', 'Act as system proxy on startup', 'Monitor all connections', 'DefaultLAN'
  • In 'Bypass Fiddler for URLs that start with:' add <-loopback>;*office.net; office365.com; live.com;.microsoft.com;.microsoftonline.com;

Configure Application Registration

By default the project uses an Application Registration provided by HSO, which is multi-tenant and will be fine for most projects. If an IT department does not allow that, they have to create an Application Registration in their own tenant and the project needs the clientId and Redirect url:

1. In Azure Active Directory create an Application Registration
2. In API Permissions assign Dynamics CRM (user_imporsonate)
3. Set Redirect url equal to the project tools/crm.json/adal/redirectUri
4. Copy client Id and put in the project tools/crm.json (adal/clientId)