Power2CM Installation Guide
DISCLAIMER
Any advice FYB provides in relation to setting up any FYB App, FYB Add-in, FYB Connector and or advice in relation to opening access to your on-premise or in the cloud systems will be general advice only. This means that the advice is of a general nature and will not take into account your network setup, network infrastructure or any security requirements that you may have or in fact need. It is highly advised that you seek advice from internal or external providers to ensure that they are comfortable with what is required prior to going ahead with any deployment, setup or configuration for external access.
LICENSE DETAILS
Please contact FYB for a valid license if you are yet to obtain one for your Connector.
INSTALLATION COMPONENTS
The following installation components are required to ensure full functionality of the FYB Power2CM:
- FYB Power2CM is the API that the Power2CM Power Automate connector communicates with - This is a server-side installation.
- Power2CM Power Automate Connector is the connector deployed to Power Automate to push data to the API
INSTALLING FYB POWER2CM
LICENSE
-
Create a folder to house the license file (.lic) on the IIS Server
-
Place the license file in this folder
NoteYou will be asked to enter this location during the installation
TRUSTED USER ACCOUNT
Add the account that will run the application pool as a Trusted User Account in Enterprise Studio Please refer to your Enterprise Studio help file on adding trusted accounts.
If using a system account (application pool identity, network service etc) you will be required to enter the details as DOMAIN\ServerName$.
If using a dedicated windows service account, you will be required to enter the details as DOMAIN\username.
INSTALLATION
The FYB Power2CM MSI will:
- Deploy the installation files
- Setup the application pool and application in IIS
- Setup the temp folder
- Configure the application settings as specified by the user
To install the Power2CM, follow these steps:
-
Run command prompt as an administrator and launch the fybpower2cm-100.msi
-
Click on the Next button

-
On the Web Application Settings screen, select a Site to host the application.
-
Click on the Next button
NoteThe site the connector is being installed underneath must be https with a valid SSL certificate and able to receive requests from the Power Automate platform from outside your network.
IIS DirectoryThe application must be installed under the dedicated site as an application. It cannot be installed at the site level
-
On the Application Pool Settings screen, enter the domain, username, and password for the Application Pool identity
-
Click on the Next button

-
On the General Configuration Settings screen enter the required settings Please refer to the table below for configuration settings details

| FIELD | DESCRIPTION |
|---|---|
| Dataset ID | Content Manager two-character dataset identifier |
| Workgroup Server | Content Manager workgroup server name. This should generally be set to local |
| Workgroup Server | Content Manager workgroup server URL. |
| License Path | Local path to Power2CM license file |
| Temp Path | Local temporary directory used by the application to cache content manager documents. Please include the trailing slash, for example: C:\FYB Add-Ins\Power2CM\ |
| Redirect URL | The redirect URL of the Power2CM AzureAD application |
| Application ID | The application ID of the Power2CM AzureAD application |
| Tenant ID | The organization tenant's unique identifier on AzureAD |
-
On the Email Settings screen, enter the following fields

-
On the Custom Setup screen select the install location
-
Click on the Next button

-
From the Confirm Installation window click on the Install button

-
Once the installation is complete click on the Finish button

COMMAND-LINE ARGUMENTS (OPTIONAL)
The following command-line arguments can be passed to the MSI if required.
| ARGUMENT | PURPOSE |
|---|---|
| WEB_APP_POOL_IDENTITY_DOMAIN | Sets the App Pool domain for the application pool |
| WEB_APP_POOL_IDENTITY_NAME | Sets the App Pool username for the account running the application pool. Use "" around the username if there are any special characters |
| WEB_APP_POOL_IDENTITY_PWD | Sets the App Pool password for the account running the application pool. Use "" around the username if there are any special characters |
| DBID | Sets the Database ID that connects to Content Manager dataset to run the application |
| WORKGROUP_SERVER | Sets the Workgroup Server Name that connects to Content Manager dataset to run the application. This should be set to local |
| LICENSE_PATH | Sets the license that connects to the application |
| TEMP_PATH | Sets the temp path that connects to the application |
| REDIRECT_URL | The URL used in the Power2CM AzureAD application where Azure will send the authentication payload upon successful authentication. |
| APPLICATION_ID | The application ID for the Power2CM AzureAD application |
| TENANT_ID | The organization tenant unique identifier on AzureAD |
| FROM_ADDRESS | Sets the email address all notifications are sent from |
| MAIL_HOST | Sets the mail host for all email notifications |
| MAIL_PORT | Sets the mail port |
| LIC_CONTACTS | Sets the license expiring contacts to be notified |
| ERROR_CONTACTS | Sets the error contacts to be notified |
CONFIGURATION
IIS CONFIGURATION
After the installation process is complete, you will be able to locate the application installed within the site selected during installation.
-
From the Features View navigate to the Authentication button

-
Ensure that only Anonymous Authentication option is enabled

-
Right-click the application within IIS and select the explore option

-
Right click the App_Data folder and select the properties option

-
Navigate to the security tab and ensure users have read, write and modify permissions

CONTENT MANAGER CONFIGURATION
The Power2CM ID additional field is used to store a unique ID from Power Automate. This allows for existing records to be updated with new data and ensures no duplicates are created.
- In Content Manager, perform a search for all Additional fields
-
Right-click and select New Additional Field from the right-click menu
-
Select String as the data format and click on the Next button

-
Enter Power2CM ID to the Name field and click on the Next button

-
Enter 255 into the Maximum Length field and click on the Next button

-
Add this Additional Field to any record type that will be used by the Power2CM connector
DEPLOYING THE POWER AUTOMATE CONNECTOR
ADDING THE CONNECTOR TO POWER AUTOMATE
The following section will show you how to set up the Power2CM connector in Power Automate.
The installation package downloaded from the FYB hub will contain a power2cm-files.zip. Files from this zip are needed for the below steps.
-
In Power Automate, navigate to the left pane menu
-
Click Data, followed by clicking the sub option of Custom connectors

-
Click New Custom Connector and click Import an OpenAPI file

-
Enter Power2CM as the connector name

-
Click the Import button and select the Power2CM.swagger.json file taken from the downloaded zip

-
Click the Continue button

-
Update the Host value to be the hostname of the https protected site used in step 3 of the installation section. Do not include https:// only the hostname should be added (e.g. example.fyb.com.au and not https://example.fyb.com.au)

-
Click on Upload connector icon

-
Navigate to the Icons folder of the downloaded zip,
-
Select the Power2CM Icon.PNG file and click the Open button

-
Click on Security
-
Ensure the following fields are set.
NAME DESCRIPTION Authentication Type OAuth 2.0 Identity Provider Azure Active Directory Client ID The Azure Application ID of the Power2CM Connector Azure app registration Client Secret The Azure Client Secret of the Power2CM Connector Azure app registration Authorization URL Ensure the value is set to https://login.windows.net Tenant ID Common Resource URL Replace {Client ID} with the Power2CM Azure application ID. e.g. api://12345678 Enable on-behalf-of login false Scope Replace {Client ID} with the Power2CM Azure application ID. e.g. api://12345678 -
Click Create Connector

-
Navigate back to the Security tab and copy the Redirect URL value.

-
Navigate to the Power2CM Connector Azure App registration in Azure, then click Authentication

-
Under Platform configurations, click on the Add a platform button

-
Click on the Web option

-
Paste the copied Redirect URL value from step 13 into the Redirect URIs field click on the Configure button

-
The Power Automate Power2CM Connector configuration is now complete and the Power2CM connector will appear under Custom Connectors:

UNINSTALLATION
To uninstall Power2CM manually please follow the steps below:
-
Navigate to control panel
-
Click on uninstall a program
-
Locate FYB Power2CM in the list of Programs and Features
-
Right click on FYB Power2CM and click on Uninstall

-
If a warning Prompt appears, click on the Continue button

-
Click on the Yes button
-
The uninstallation process will commence
