Follow the steps in this article to install North52 for Power Pages/Dynamics 365 Portals.
Prerequisites
- It is assumed that you have already installed North52 with a valid licence key in your Dynamics 365 environment
- It is assumed that you configured and installed a Power Pages template.
When you deploy North52 for Power Pages several records will be deployed in your Dynamics 365 environment. The record naming convention for each record will generally follow this template:
North52 Formula Calculation - <Portal Site name> - <Portal Language>
Example
Using a site called Customer Self-Service and the language is English then the naming convention will be:
North52 Formula Calculation - Customer Self-Service - English
Pre-Deployment Step
During deployment North52 for Power Pages will install a JavaScript file connected to a Web File, therefore we need to temporarily allow JS file extensions during the deployment. To do this we need to remove js from the list of blocked file extensions (you will re-add it at the end of the deployment process):
- Go to admin.powerplatform.microsoft.com and select your environment
- Select Settings > Product > Privacy + Security
- Find and delete js; from the list of Blocked Attachments
- Click OK
Deployment
Use the information found the previous section to build the Command String needed for deployment. Each information parameter is separated by the pipe symbol | like in the following template:
websitename|language|parentpagename|publishstate|webrolename
In our example the command string will be composed of the following records:
- Website Name: Community Portal
- Language: English
- Parent Page: Home
- Publishing State: Published
- Web Role: Authenticated Users
Command String
Community Portal|English|Home|Published|Authenticated Users
- Open the North52 App and select Administration Operations
- Select Portal Install from the listed options
- This will populate the Comments box with sample data
- Paste your command string into the Parameters box
- Click Execute
This will install all the necessary components for North52 to operate in Power Pages.
The installation process can take around 60 seconds to complete.
Instructions on how to find the required information is located https://support.north52.com/knowledgebase/article/KA-10546-dynamics-crm-365-Installing-North52-BPA-for-Dynamics-Portals-Finding-Required-Data/en-us
Post Deployment Step
When the save completes, re-open Settings > System > Administration > System Settings and add js; to the list of Set blocked file extensions for attachments again.
An additional post-deployment check will be to open 2 of the newly created records and verify that web roles have been allocated to them:
- Table Permission
- North52 Formula Calculation Global Read
- Web Page Access Control Rule
- Read Access for the North52 Formula Configuration
What Gets Installed
When you deploy North52 for Power Pages the following records will be installed:
- Web Template
- Page Template
- Web Page
- Web Page Access Control Rule
- Web File
- Annotation (note) on the Web File
- Entity Permission
To deploy North52 you need to know the name of the following records:
- Website name - (adx_website or mspp_website)
- Language - (adx_language or mspp_language)
- Root web page name - (adx_webpage or mspp_webpage)
- Publish state - (adx_publishingstate or mspp_publishingstate)
- Webrole name - (adx_webrole or mspp_webrole)
This information will be used in the deployment process.
In this example we deploy North52 to a website that is already set up with the name Customer Self-Service.