In this article, we will review the migration steps of the Trello -> Project for the web migration scenario.
Please note: All information in this article also applies to the Trello -> Planner (premium plans) migration scenario.
To launch the migration from Trello to Project for the web you will need to take several steps:
Step 1: Connect to source and target system
To start the migration process perform the following:
1. Open the Project Migrator home page and click on the corresponding scenario name or click the Start New Migration button.
2. To select the source system click on the Please Select System button and select Trello. If you selected the migration scenario on the home page, the systems will be preselected.
3. Click on the 'Connect' button to connect to your Trello account.
Provide your credentials and log in to Trello. Any Trello account can be used for migration from Trello to Project for the web, however, the provided account should have access to the workspaces and boards selected for migration. For detailed information about the account requirements for Trello please refer to this article.
Click 'Allow' in the 'Authorize Trello' window that appears.
Project Migrator will be successfully connected to your Trello account.
If you need to change the account you have provided, click on the Change button.
4. On the next step connect the target system. Click on the Please select system button and select Project for the web or Planner (premium plans).
5. Click on the 'Connect' button to connect to your Project for the web account.
In the Environment field provide the target URL of your Power Platform Environment where Project for the web is deployed. Please refer to the 'How to find the Environment URL for Project for web' article for detailed instructions on how to find the required URL.
Provide the credentials and log in to Project for the web using your Office 365 account.
Project migrator allows mapping Attachments task field from Trello to Project for the web system and creating custom fields in Project for the web. To use this functionality, it is required to generate a token when connecting to your Project for the web environment.
Please note: If you do not need to map the Attachments field or custom fields created in Project for the web, leave the 'Custom fields and attachments Token' field empty.
Click Proceed.
When connecting to Project for the web for the first time, Office 365 tenant Global Administrator consent (Admin Consent) is required to grant Project Migrator app permissions to access Office 365.
Admin Consent should be granted to Project Migrator only once. When the consent is granted by Global Admin, any other account that meets the requirements can be used to add more connections within the same Office 365 tenant.
When the source and target systems are added and connected you can proceed to the next step and select source data for migration.
Step 2 - Select source data
Project Migrator allows selecting all data for migration or only the required items from the list.
If you select 'All' option – all Public, Workspace Visible, Organization, and Private Boards that the Trello connection account has access to will be migrated.
'Selected' option allows migrating only the Boards which you select from the Available Boards list.
Click on the 'Selected' radio button.
Board Selection window will be opened displaying the available boards for selection. There are several fields on this page that you can use to filter the information out and make the selection faster.
Trello connection account you have provided in the first step will have access to the following boards:
- Public Boards where the connection account is added as a member.
- Workspace Visibility Boards - all Workspace Visible Boards where the account is added are available for selection (if the account is added to the Workspace, the Boards will be available for selection even if the account is not added as a member to the Board).
- Private Boards - only those Private Boards where the account is added as a member will be available for selection.
Please note: If the connection account is a Board member and is assigned for the Board Cards, but is not a member of the Workspace, such Boards will be available for selection with the 'Personal Cards' Workspace name.
Select the required boards from the list and click the 'Add Selected' button.
Please note: If you have not purchased any subscription plan yet, a free plan (for 2 projects) will be applied. If you have exceeded the limit of projects that you can select for migration according to your subscription plan (free or paid one), you can upgrade your plan from this page directly by clicking on the 'Upgrade to (number) of projects plan' button.
Please note: Trello Boards are counted as projects.
For more information please refer to the 'Project Migrator Subscriptions' article.
When the items are selected you can proceed to the next step: Step 3: Object Mapping.
Step 3 - Object mapping
1. Migration settings
Microsoft 365 Group Creation Mode: In this section, you can select whether to create groups with source workspace names, create groups using Board names, or create all Projects in one group (new or existing).
'Create groups using source workspace names’: this group creation mode allows preserving source workspace names for the selected Boards in the target. Target Microsoft 365 groups will be created with the same names as the source workspaces.
With this group creation mode, the Board members and users that are assigned to cards in the migrated source Board(s) will be added as members to the target Microsoft 365 group(s) on the condition they are mapped with the corresponding target users.
The Workspace and Boards Privacy will not be preserved for the target group and Project.
The users that are Workspace or Board Admins will not be added as owners to the target group(s).
Please note: If there is an existing group with the same name and mail nickname in the target tenant, but the connection account is not a member or an owner of that group, a new group will be created with a bit different mail nickname.
'Create groups using Board names': if this option is selected, each project will have a separate group created. The groups will be created with the same names as the Board names in this case.
If a group with the same name already exists in Project for the web, a new group will not be created. Project Migrator will find this group by name and will use it for migration (taking into account the setting below 'Create new or merge with existing Projects').
With this group creation mode, the Board members and users that are assigned to cards in the migrated source Board(s) will be added as members to the target Microsoft 365 group(s) on the condition they are mapped with the corresponding target users.
The Workspace and Boards Privacy will not be preserved for the target group and Project.
The users that are Workspace or Board Admins will not be added as owners to the target group(s).
If the 'Create all Projects in one group' option is selected, then all Boards/Projects will be added to the same group during migration.
Please note: With this group creation mode, all Board members and users that are assigned to cards in the migrated source Board(s) will be added as members to one target Microsoft 365 group on the condition they are mapped with the corresponding target users.
Members of the source Board workspaces and guest users from other Boards will not be added to the target group.
The Workspace and Board Privacy will not be preserved for the target group and Project. The users that are Workspace or Board Admins will not be added as owners to the target group.
In the Group Name field, you can provide the name of an existing group or a new group name to create a new group during migration.
‘Migrate all source workspace members’: this option is available for all the group creation modes. If it is enabled, all members of the source Workspace (even if they are not added to the Board Members or assigned to the Board cards) where the selected Boards are placed will be added to the target Microsoft 365 group members on the condition the corresponding users exist in the target tenant and are mapped correctly.
If that option is disabled, only the Board Members and users assigned to the cards in the migrated Boards will be added to the target group members. Other source workspace members and guests will not be added to the target groups. If new Microsoft 365 groups and Projects are created during the migration, the target migration account will be set as the group and Project owner and member.
Please note: If you are migrating the Boards to an existing Project for the web group (or to different groups but there is a group(s) in Project for the web with the matching name), the target migration account that you have provided in the Target System section should be a member or an owner of that group in Project for the web.
Project creation mode: In this section, you can select how projects should be created if there are Projects in Project for the web with the same names as Boards in the source system.
'Create new or merge with existing ones' option allows creating new Projects or merging the data to the existing Projects with the same names as the source Boards if any.
'Create new and remove existing Projects before creating' option allows creating new Projects from scratch deleting the existing ones with the same names as the source Boards if any. In this case, existing Projects with names that match selected source Board names will be removed together with all their tasks.
2. Board Field Mapping
In this section, you can review Board field mapping. The Board name corresponds to the Project name and the List name to the Bucket name.
3. Card Field Mapping
This section is used to map the card fields from source Boards with the target Project for the web task fields.
Default fields will be mapped automatically by name and compatible type once the connection to the source and target systems is established and items to migrate are selected. In case multiple source fields compatible with a target field are found by name they all are added for mapping.
It is also possible to add custom fields for the mapping. All the compatible source and target fields available for mapping are listed and can be selected in the drop-down menus in the Card Field Mapping.
You can also check the Multiple checkbox and select several fields for mapping.
If you select several source fields for mapping, you can also select the Join Values option. In this case, values from all the selected source fields will be added to the target field (for example, Notes and Description source fields can be mapped to one target field Notes, and the values from both the fields will be migrated and joined in the target field).
In case the Use First Found option is selected, the values from the first mapped item field, found in the source Board, will be migrated to the mapped target item field.
If a custom field that allows having multiple custom values (e.g. field of the Dropdown type) is selected for mapping, check the Use Custom Lookup option to map particular values of the source item field with values of the target field.
The Use Custom Lookup option is recommended to use for mapping values of such item fields as ‘Progress (Percent Complete)’ and ‘Priority’ that have a set of predefined values which may differ between the source and target systems. Existing custom field values can be selected in the field drop-down menu.
If you do not need to migrate any of the field values, you can remove such fields from the mapping.
Please note: You can create custom fields in Project for the web from the mapping page. For more details refer to the 'How to create task custom fields' article.
To use this functionality, it is required to generate a token when connecting to your Project for the web environment.
4. Card Migration Settings
Cards to migrate option allows selecting what cards to include in the migration:
Only Active (selected by default) will include only active cards in the migration.
Active&Archived will include all cards, active and archived.
When the Active&Archived option is selected, additional settings become available:
Archived cards progress:
- Set based on Card Fields Mapping: similar to active cards, the progress for archived cards will be set based on the Card Fields Mapping settings above.
- Mark Archived Cards as Completed: this option allows you to mark all archived cards as Completed, disregarding the card's progress.
Migrate archived cards to bucket:
- Create buckets using source List Names: the archived cards will be migrated to Project for the web, and new buckets will be created using the List names.
- Create all archived cards in one bucket (provide the bucket name below): this option allows you to create one Project for the web bucket and migrate all archived cards there.
Please note: All archived cards, including those archived as part of the List and separately archived ones, will be migrated to this bucket.
5. Users Mapping
This section is used to map the users from Trello to the target system.
Please note: User mapping will include users from all Workspaces that the connection account has access to, and Board members of the Board that the connection account has access to. If the connection account is a member of a Workspace that includes Private Boards where the connection account is not added, the members of the Private Boards will not be displayed in the User Mapping section.
Please note: Due to API limitations, only usernames from Trello are available, user emails cannot be seen in the User Mapping section. The users will be automatically mapped by their names.
It is possible to map the users manually, if the users were not mapped, you can find the required user manually in the User Mapping section.
User Mapping can be exported to an Excel file. You can map the users in the Excel file if needed and upload the mapping from the Excel file to Project Migrator, User Mapping section.
Please note: The users cannot be migrated from Trello to the target tenant. User accounts should already exist in the target environment (in the Active directory of your Project for the web tenant) before the migration starts. In this case Project Migrator will find the required users by their names and will map them automatically to migrate the assignments and other resources data to the target Project for the web environment.
If there is no corresponding account on the target system, then the line with such a user will be highlighted in red and will have a 'Not Mapped' status. Such users will not be taken for migration.
If there is incomplete correspondence for some of the users (for example, the email is the same but different user names), they will have the ‘Partial Match’ status and will be marked with yellow color. Pay attention to such lines and correct the mapping if needed.
If there is complete correspondence found, such users will be marked with green color with the 'Match' status.
You can review the mapping summary at the top of the section.
If at least one user is not mapped a corresponding warning will appear.
Step 4 - Launching the migration process
When you complete all steps: set up the connection between source and target, select data for migration, and perform mapping you can launch the migration process.
To launch the migration process click on the Proceed button under the 'User Mapping' section.
Migration Summary window will be opened. Review the information in the Migration Information section and click the 'Start Migration' button to launch the migration process.
Please note: If you have not purchased any subscription plan yet, a free plan (for 2 projects) will be applied. If you have exceeded the limit of projects that you can select for migration according to your subscription plan (free or paid one) and did not upgrade your plan while selecting the projects, you will see the 'Proceed to Checkout' button instead of the 'Start Migration' one. You can upgrade your plan by clicking on this button and then launching the migration process.
Data Migration Summary window will be opened displaying the Summary Information and the progress for the migrated groups and Projects as well as Migration Settings and Mapping. The migrated boards can be opened and reviewed in Project for the web system from the Migration Summary page.
