This article describes the steps of connecting Project for the web to PPM Express.
In this scenario, we consider that you are importing your projects or linking projects from Project for the web to PPM Express for the first time.
When you import projects or link a project to Project for the web for the first time, select Project for the web connection from the list.
Project for the web connection account requirements
The connection account for Project for the web should meet the following requirements:
1. The account should be a member/a user of the tenant and the Power Platform Environment where the Project for the web is deployed.
2. The account should have any of the following licenses assigned:
- Project Plan P1.
- Project Plan P3 (previously called Project Online Professional).
- Project Plan P5 (previously called Project Online Premium).
Any of the following licenses is enough for read-only access to the Project for the web data:
- Microsoft 365 F3 and Office 365 F3
- Office 365 E1
- Microsoft 365 for business
- Microsoft E3 and Office 365 E3
- Microsoft E5 and Office 365 E5
- Microsoft Power Automate
3. The account should have Read-Write or Non-interactive Access Mode to the Power Platform Environment enabled.
4. Also, the account should have a security role in the Environment that allows reading all or personal Project for the web data (e.g. System Administrator (not required), Basic User, etc.).
5. The account should be a member of all projects in Project for the web (their Microsoft 365 groups) that need to be linked or imported. In case there are projects without associated groups, the account should be their creator or manager to be able to link them.
To connect to Project for the web for the first time, Microsoft 365 tenant Global Administrator consent is required to allow PPM Express to access your Microsoft 365 tenant.
Admin consent should be granted only once before adding the first Project for the web connection account. Once consent on behalf of the organization is granted, any user account credentials that meet the requirements can be used for connecting to Project for the web environment.
PPM Express application for Project for the web connection will be added to Microsoft 365 tenant.
The following API permissions will be granted:
- Microsoft Graph: User.ReadBasic.All
- Microsoft Graph: offline_access
- Dataverse (Common Data Service): user_impersonation
How to find Environment URL
To add Project for the web connection to PPM Express, Project for the web Environment URL is required.
To find your Environment URL, please perform the following:
With an admin account:
1) Open Microsoft Power Platform Admin Center by the link https://admin.powerplatform.microsoft.com. Log in to the Admin Center with an admin account.
2) Open the Environments page and select the Environment where Project for the web is deployed.
3) In the Environment Details section find the Environment URL and copy it as a link or as text.
4) The Environment URL can be used in one of the following formats: https://org111a22a1.crm.dynamics.com or org111a22a1.crm.dynamics.com.
With a user account:
1) Log in to Microsoft 365 with your account.
2) Open the App Launcher by clicking on its icon in the top left corner. Select to explore ‘All apps’.
3) Search for Power Apps in the apps list.
4) On the Power Apps page, click on the Apps tab => All apps and click Play next to the Project app to open it from the list.
5)Once the Project Power App is opened, copy the main part of its URL in the address bar, e.g.: https://org111a22a1.crm.dynamics.com.
6) The Environment URL can now be used for PPM Express in the following format: https://org111a22a1.crm.dynamics.com or org111a22a1.crm.dynamics.com.
Granting Permissions (Admin consent)
When you sign in for the first time, Microsoft 365 tenant Global Administrator consent is required to allow PPM Express to access your Microsoft 365 tenant. Admin consent should be granted only once, and then a regular account can be used to add a connection and for project linking/import.
To grant permissions, open the 'Connection' field drop-down in the Configure Connections window (or Import Projects window) and select the Grant Permissions option.
Enter tenant Global administrator credentials to grant the required permissions. If you do not have a Global administrator account for Project for the web, please refer to the Admin Team in your organization.
In the next window, click Accept to grant the PPM Express app the required permissions.
When the connection is established, PPM Express will have the following permissions for reading data from Project for the web:
- Read all users' basic profiles.
- Maintain access to data you have given it access to.
- Access Common Data Service as organization users.
Adding Project for the web connection
1. Once the permissions are granted, you can add a Project for the web connection by clicking 'Add a new connection'.
2. The 'Create connection' window will be opened.
Paste your Project for the web Environment URL.
Select the 'Enable Task Custom Fields Synchronization' checkbox to open the task custom fields synchronization settings. Only default task fields will be synchronized if the checkbox is not enabled and a token is not provided.
3. Click on the Token Generator link to download the file to generate a new token.
4. Open the downloaded file, and click Connect. Sign in using your Project for the web account.
5. Copy the token and click Close.
6. Paste the token to the PPM Express 'Task Custom Fields Token' field. Click Create.
7. Sign it to Project for the web using any account that meets the requirements for connecting to Project for the web environment.
Project for the web connection has been added. Now you can link and import projects from Project for the web to PPM Express.