Skip to main content

Power2CM Installation Guide

Raise a support ticket

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​

  1. Create a folder to house the license file (.lic) on the IIS Server

  2. Place the license file in this folder

    Note

    You 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:

  1. Run command prompt as an administrator and launch the fybpower2cm-100.msi

  2. Click on the Next button

    2020-08-10_16-31-57.png

  3. On the Web Application Settings screen, select a Site to host the application.

  4. Click on the Next button

    2023-03-01_15-14-45.png

    Note

    The 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 Directory

    The application must be installed under the dedicated site as an application. It cannot be installed at the site level

    image.png

  5. On the Application Pool Settings screen, enter the domain, username, and password for the Application Pool identity

  6. Click on the Next button

    2020-08-10_16-34-07.png

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

2024-05-09_9-29-10.png

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

    2023-03-01_15-24-46.png

  2. On the Custom Setup screen select the install location

  3. Click on the Next button

    2023-03-01_15-25-50.png

  4. From the Confirm Installation window click on the Install button

    2020-08-10_16-42-40.png

  5. Once the installation is complete click on the Finish button

2020-08-10_16-43-22.png

COMMAND-LINE ARGUMENTS (OPTIONAL)​

The following command-line arguments can be passed to the MSI if required.

ARGUMENTPURPOSE
WEB_APP_POOL_IDENTITY_DOMAINSets the App Pool domain for the application pool
WEB_APP_POOL_IDENTITY_NAMESets 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_PWDSets the App Pool password for the account running the application pool. Use "" around the username if there are any special characters
DBIDSets the Database ID that connects to Content Manager dataset to run the application
WORKGROUP_SERVERSets the Workgroup Server Name that connects to Content Manager dataset to run the application. This should be set to local
LICENSE_PATHSets the license that connects to the application
TEMP_PATHSets the temp path that connects to the application
REDIRECT_URLThe URL used in the Power2CM AzureAD application where Azure will send the authentication payload upon successful authentication.
APPLICATION_IDThe application ID for the Power2CM AzureAD application
TENANT_IDThe organization tenant unique identifier on AzureAD
FROM_ADDRESSSets the email address all notifications are sent from
MAIL_HOSTSets the mail host for all email notifications
MAIL_PORTSets the mail port
LIC_CONTACTSSets the license expiring contacts to be notified
ERROR_CONTACTSSets 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.

  1. From the Features View navigate to the Authentication button

    2023-03-01_15-54-57.png

  2. Ensure that only Anonymous Authentication option is enabled

    2023-03-01_15-56-44.png

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

    app.jpg

  4. Right click the App_Data folder and select the properties option

    prop.jpg

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

    permiss.jpg

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.

  1. In Content Manager, perform a search for all Additional fields

image.png

  1. Right-click and select New Additional Field from the right-click menu

    image.png

  2. Select String as the data format and click on the Next button

    image.png

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

    2020-08-14_15-30-44.png

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

    image.png

  5. 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.

Note

The installation package downloaded from the FYB hub will contain a power2cm-files.zip. Files from this zip are needed for the below steps.

  1. In Power Automate, navigate to the left pane menu

  2. Click Data, followed by clicking the sub option of Custom connectors

    2020-08-10_11-23-20.png

  3. Click New Custom Connector and click Import an OpenAPI file

    2020-08-10_11-31-03.png

  4. Enter Power2CM as the connector name

    2020-08-10_11-33-06.png

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

    2020-08-10_11-33-06.png

  6. Click the Continue button

    2020-08-10_11-39-38.png

  7. 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)

    2023-03-01_15-58-31.png

  8. Click on Upload connector icon

    2020-09-30_14-56-48.png

  9. Navigate to the Icons folder of the downloaded zip,

  10. Select the Power2CM Icon.PNG file and click the Open button

    2020-09-30_15-00-58.png 2020-09-30_15-03-10.png

  11. Click on Security

    2023-03-01_16-00-28.png

  12. Ensure the following fields are set.

    NAMEDESCRIPTION
    Authentication TypeOAuth 2.0
    Identity ProviderAzure Active Directory
    Client IDThe Azure Application ID of the Power2CM Connector Azure app registration
    Client SecretThe Azure Client Secret of the Power2CM Connector Azure app registration
    Authorization URLEnsure the value is set to https://login.windows.net
    Tenant IDCommon
    Resource URLReplace {Client ID} with the Power2CM Azure application ID. e.g. api://12345678
    Enable on-behalf-of loginfalse
    ScopeReplace {Client ID} with the Power2CM Azure application ID. e.g. api://12345678
  13. Click Create Connector

    2023-03-01_16-16-45.png

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

    2023-03-01_16-20-38.png

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

    2023-03-01_16-23-07.png

  16. Under Platform configurations, click on the Add a platform button

    2023-03-01_16-25-30.png

  17. Click on the Web option

    2023-03-01_16-26-44.png

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

    image.png

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

    2020-09-30_15-07-50.png

UNINSTALLATION​

To uninstall Power2CM manually please follow the steps below:

  1. Navigate to control panel

    controlpanel.jpg

  2. Click on uninstall a program

    uninstall.jpg

  3. Locate FYB Power2CM in the list of Programs and Features

  4. Right click on FYB Power2CM and click on Uninstall

    2020-08-10_16-57-24.png

  5. If a warning Prompt appears, click on the Continue button

    warning.jpg

  6. Click on the Yes button

    2020-08-10_16-58-51.png

  7. The uninstallation process will commence

    2020-08-10_16-59-31.png