Skip to main content

Gathering Prerequisites for Dynamics 365 On-Premises

This section reviews what you will want to have prepared before you begin with the integration steps in the next section.

Required Files​

The following files should be downloaded from our support website's downloads section before you begin:

  • InRule for Microsoft Dynamics 365 Integration Framework.zip
  • InRule Catalog Installer – InRule Installer.exe

Please download and extract each of these archives to corresponding subdirectories within a working folder.

When you are finished, you should have a directory structure that looks like this:

│   InRule For Microsoft Dynamics 365 Integration Framework.zip
│
└───InRuleForMicrosoftDynamicsCRMIntegrationFramework
│
├───DynamicsDeployment
│ │ Deploy-CrmPackage.ps1
│ │ ...(many other supporting files)
│ │
│ ├───PkgFolder
│ └─ ...(many other supporting files)
│
├───RuleApplications
│ DynamicsRules.ruleapp
│
├───RuleExecutionAzureService
│ Register-AzureApp.ps1
│ InRule.Dynamics.Service.json
│ InRule.Dynamics.Service.parameters.json
│ InRule.Crm.WebJob.zip
│
├───RuleExecutionOnPremService
│ DeployScript.ps1
│ InRule.Crm.WebService.deploy-readme.txt
│ InRule.Crm.WebService.SetParameters.xml
│ ...(many other supporting files)
│
└───RuleHelperDeployment
│ InRule.Crm.RuleHelper.dll
└─ ...(many other supporting files)

The files Deploy-CrmPackage.ps1 and DeployScript.ps1 will be used directly in the walkthrough steps below.

Rule Authoring Environment​

A Rule Authoring Environment is used to upload a Rule Application to your catalog app service. A Rule Authoring Environment is a machine or virtual machine where irAuthor has been installed with the irX for Microsoft Dynamics 365 extension. If you followed the instructions outlined in irX for Microsoft Dynamics 365 Help Documentation, then you should already have a rule-authoring environment available to you.

We have made it a point to call out the rule authoring environment separately because it is important to be aware of the licensing implications of this step. You will need to utilize an irAuthor license and an irX for Microsoft Dynamics 365 license for the duration of this process.

Administrative Accounts​

Dynamics On-Prem Organization Service URI: You will want to have the root URL of the organization web service exposed by your Dynamics 365 instance. The server URL is usually in the format of http://crm-server:port/organization-name

Dynamics Service Account Login and Password: You will want to have a username and account created specifically for use by the InRule for Microsoft Dynamics 365 Framework Web Service.

Administrative Password to use for SQL Server: You should decide what username and password you want to use for administrative privileges on the SQL Server. This walkthrough will construct a connection string that will utilize these resources to connect to the catalog.

** This walkthrough will utilize the above administrative login and password for the Catalog Service to connect to the SQL Server Database. In a more secure environment, a separate SQL User should be created that only has access to the single database needed by the catalog. It is up to the reader of this document to go this more secure route.

Administrative Password to use for Catalog Service: You should decide what username and password you want to use for administrative privileges within Catalog.

** This walkthrough utilizes the default login of admin and password of password. It will be up to the reader to go through the process of utilizing the Catalog Manager to change these credentials to be more secure.

InRule License Keys​

You will need your InRule irServer license keys. These can be found at https://support.inrule.com/activations.aspx. You can contact support@InRule.com if you have questions about where to get your license keys. For guidance on how to activate your keys, reference License Management.