This article explains how to set up the integration between Power Apps entities and OnePlan plans.
Before beginning, the following assumptions are made in order for this integration setup to be successful:
-
Office 365 is up and running
-
A Power Apps or Dynamics environment is up and running
-
OnePlan group is set up in the same Office365 tenant
To complete the OnePlan setup, you need to be an admin (user with Owner permissions) in OnePlan.
-
Log into your OnePlan group using your OnePlan login credentials.
-
Access the Admin pages by clicking on the settings (gear) icon at the top right of the browser.
-
Navigate to the Integration section in the left-hand navigation panel.
-
Next to the Authentication Keys section click the + Add Key button.
-
Provide a descriptive name or title for the Authentication Key to denote its purpose, then click ADD.
- Store the OnePlan group name and the Authentication Key securely. This grants access to your OnePlan group for any program. Please note that the key will no longer be visible after the page is refreshed
OneConnect Setup Process
To complete the OneConnect setup, you need have Administrator or Editor privileges in the OneConnect group you wish to set the integration up in.
-
Go to https://my.oneconnect.ai (or https://eu.oneconnect.ai for European customers utilizing eu.oneplan.ai)
-
Configure the following integration: Power Apps Entities to OnePlan. Click Configure.
-
Authorization
-
By having the client’s Microsoft Tenant Admin click Authorize and use their credentials, they agree to use the default Power Apps app registration.
Note
See How to approve consent for more information.
-
-
Client Id (Azure App Id)
-
Only use this field if you are not using the default Power Apps app registration for this integration. Enter your App Id. See Step 8: Complete the PowerApps setup actions for instructions on how to create and collect your own Application Registration Id.
-
-
Power Apps URL
-
Enter the URL of the Power Apps environment environment (e.g., https://{OrganizationName}.crm.dynamics.com/).
-
-
Username
-
Enter the username.
- Note: Ensure that the provided username does not have Multi-Factor Authentication (MFA) associated with it. It is recommended to use a dedicated service account to access the Power Apps environment. Best practice dictates one service account per integration to avoid data throttling and potential strategy failures by Microsoft.
-
-
Password
-
Enter the password.
-
-
Additional Options
-
Expand the section for additional configuration options.
-
- All Entity Names to be Synchronized
- Please review Entity Options for more information.
- Test Connection
- Click Test to verify the correctness of the connection settings to Power Apps.
- A notification indicating Connected Successfully should appear in the top-right corner of the browser upon successful testing.
- Save Changes
-
Click Save.
-
-
Group Name
-
Input the name of the OnePlan Group name you intend to integrate with.
-
-
Authentication Key
-
Paste the generated OnePlan Authentication Key obtained from OnePlan.
-
-
Additional Options
- Expand the section for additional configuration options.
-
(Optional) Alternate OnePlan Environment URL
- If using an environment other than the default (https://my.oneplan.ai), select the appropriate URL from the available options:
- (Optional) OnePlan Default Plan Type
- Specify a default plan type if the integration doesn’t automatically provide a plan type for plan-level work items in OnePlan. Enter a single value for this purpose.
- Test Connection
- Click Test to verify the correctness of the connection settings to OnePlan.
- A notification indicating Connected Successfully should appear in the top-right corner of the browser upon successful testing.
- Save Changes
-
Click Save.
-