Essentials for Office 365 2.13 - User Guide

Dropbox Business - Unsupported Objects

The following Dropbox Business objects are not supported when migrating to OneDrive for Business or SharePoint Online.

·Comments

·External user accounts are not supported. But if an external user is a collaborator and has permissions to some connection and was mentioned in the content metadata (core properties), then migration of this permission and metadata is supported.

·Objects in the "Deleted Files"

Dropbox Business - Core Properties

Migration of Created At/Created By and Modified At/Modified By is limited because of Dropbox API rules.

Dropbox API does not return information about the Created At and Created By fields, it only supports the preservation of the Modified By and Modified At fields.

To solve this problem the Essentials Tool sets the target user account as Created By. For most files, it is a valid account since most of the content is the personal content of this account. This means that for content that is not owned by the target user, Created By will also be set as the target user account and the original ownership would be lost. We recommend using the Skip non-owned content option in order to exclude the migration of such files. In global, you will copy this content correctly with valid ownership when you copy that particular account over. Select the option "Copy Permissions" to  preserve sharing - it will help to preserve the full original content structure when you copy all accounts over.

For the Created At problem, the Essentials Tool sets the value to Modified At because it would be the closest date to the original value. It will help to prevent Created At being newer than Modified At or to be completely out of activity time region.

Copy Dropbox to an Office 365 Group

This option allows Dropbox Business and Office 365 administrators to copy content from within Dropbox Business drives to an Office 365 Group's Site(s) in a single migration.

This operation has the following requirements for use:

·The account used to perform the migration from Dropbox Business needs to have Team Admin access to the Dropbox Business tenant.

·The account used to perform the migration into Office 365 Group Sites needs to be a minimum of Site Collection Administrator in this Office 365 tenant.

·The person performing the migration will need to know the relationship (user mapping) between each user's Dropbox user account and their corresponding Office 365 Group name and Office 365 user account.

·The Office 365 Group and its Site must already exist.

To migrate content of a Dropbox Business Account(s) to Office 365 Groups, perform the following:

1.On the Drives tab click Copy Dropox and select the "Copy Dropbox to Office 365 Groups" option.

2.Give your project a name.

3.Enter the username of your Dropbox Administrator.

4.Make sure Dropbox Business - Connection Requirements are met.

5.Use the information in the following table to determine the appropriate action to take.

If you receive any message other than Successfully connected to Dropbox, double check your supplied information and try again.  If you are still experiencing issues, please contact Support for further assistance.

1.In the Target Office 365 Connection Parameters section, specify your tenant SharePoint Administration Center URL and then click Connect (i.e. https://tenantadmin.sharepoint.com). When prompted, enter your Administrator login and password. Click Connect. If you receive any message other than Successfully connected to Admin, double check the URL and make sure you are supplying an Administrator login for this tenant.

If you are still experiencing issues, please contact Support for further assistance.

7.Click the Load from Dropbox button to load in a list of available Dropbox Business drives to include with this migration.  For performance reasons, if you have a large number of Dropbox Business drives in your tenant you may wish to CSV file with the user accounts and choose the option to "Load from CSV" instead . Select the Dropbox Business drives that you wish to include with this migration.

8.You can also choose to Load and Apply report option, which allows you to load and apply an Analyze Dropbox report, which then sets the Migration Priority for each user mentioned in the report. Click Next to continue.

9.Select Re-Map Users option and load your mapping CSV file.  Group mapping is required (user mapping may also be included) so the software can properly resolve the differences between your users' Dropbox account and the corresponding Office 365 Group name as well as maintain content authorship.  If your user accounts differ between Dropbox and Office 365 then you will want to add your user mapping to this same file.  

In the example below, lines 1-3 illustrate mapping a source Dropbox to an Office 365 Group by name while lines 4-5 in the same file are used to map the Dropbox user accounts to their respective Office 365 user accounts to maintain item authorship.

sales@company.com,Office365 Group Name
marketing@company.com,Office365 MarketingGroup
IT@company.com,IT Group
scott@company.com,swilson@contoso.com
bill@company.com,bgeorge@contoso.com

If you wish to migrate one or more source accounts to a single Group library while also remapping the user account for the purpose of metadata and sharing, please use the following format in your mapping file.

user@dropbox.com,Office 365 GroupName(user@contoso.com)

The software will migrate the content from the source drive "user@dropbox.com" to the Documents libary in the group "Office 365 GroupName".  The metadata and shared permissions of Dropbox user "user@dropbox.com" will be mapped to the Office 365 user account "user@contoso.com".

10.Click Check Office 365 Group in order to begin the validation process​. This process will validate that the supplied user mapping is correct (Office 365 Groups were located) and check to determine if each Group currently has a Site provisioned.  Click Next.

If the group is not found you may continue, however no content for this mapping will be migrated.  Alternatively, you may go back one page and remove the selected source Dropbox account or modify your mapping file, reload the CSV and click the Check button again.

11.If necessary, change content and file format conversion options​ as described below.
 
Content Options

Copy Content - A flag to determine if content is or is not included with this operation.  When not included the remainder of the options will become disabled.

Include Versions - The process in which Dropbox revision history will be converted into Office 365 Group versions.  Please note that this option is only referring to the major revisions (those shown as the "less detailed revisions") and not those that are automatically generated within Dropbox (those shown as the "more detailed" revisions).

Incremental Copy - When enabled, the migration process will identify and migrate only that content which was created, modified or versioned within the defined interval (days, weeks or months).

Skipped Non-Owned Folders - This option addresses the scenario where folders appear in a user's Dropbox account which are not owned by this user; meaning the user is a folder collaborator and not the folder "Owner".  Skipping these folders will prevent duplicates from being migrated into Office 365 Groups because the folder will be migrated only once when the folder "Owner" is migrated.  Please refer to the in-application Help button for additional details.
 
Migrate to Folder - When this option is enabled, you can create a (or use an existing) root folder structure in the destination library where your source content will be migrated. You will need to define the path like this example:

/My Source Content/2017

In the above example, the folder "My Source Content" and subfolder "2017" will be created in the root library of your destination and all source content will be migrated to this folder location.

Apply Filter - Optionally, select from a series of filterable parameters to include or exclude specific content during migration.

Advanced Options:

 

Enable Azure Turbo Mode: When enabled, this option utilizes Microsoft's SharePoint Online Migration API to increase the migration performance and throughput. A recommendation for optimal use of this API is larger sets of data; the more content, the better the throughput. Please review the User Manual for additional information as well as recommended configuration as this process is a resource intensive operation.

Because this API uses Azure storage as a staging area for the migration, it requires that you provide an Azure storage location. The options are to either utilize Microsoft supplied storage or to provide your own Azure storage location. If you wish to use your own Azure account, you must provide both the Azure Account Name as well as the corresponding Acces Key. If you cannot supply this information, please search our online Knowledge Base, User Manual or contact Support for additional information before proceeding or consider using the Microsoft Supplied Storage option. For more information please see the Azure Turbo Mode section.

·Microsoft Provided Storage: This option allows you to use Microsoft provided Azure storage instead of providing your own for the purpose of utilizing Azure Turbo Mode.

·User Provided Storage: This option allows you to provide your own Azure Storage instead of using one provided by Microsoft for the purpose of utilizing Azure Turbo Mode. It requires that you provide both your Azure Blob Storage Account Name as well as its corresponding Access Key by clicking the "Select" button to the right. If you cannot supply this information, please search our online Knowledge Base, User Manual or contact Support for additional information before proceeding.

Send Notification: When selected, this feature will send emails to the listed recipients once Migrations are completed. Enter a specific user email address. For two or more, separate each email address with a comma. Set up User Notifications here in order to use this feature. 

Create User Specific Log File - If you would like a user specific log file (.txt format) created for each migrated Google Drive that will be saved directly to that Group's Documents library, check this option before you finish.  This log file will contain all the content that was included in the migration with both source and target URLs as well as any file renaming that took place and skipped files due to lack of ownership.
NOTE: Create user Specific log file is disabled if Azure Turbo Asynchronous mode is on. Supported only for CSOM or Azure Turbo Synchronous modes.

12. Click Finish to begin the migration.

Copy Dropbox to Microsoft Teams

This option allows Dropbox Business and Office 365 administrators to copy content from within Dropbox Business drives to an Microsoft Teams site in a single migration.

This operation has the following requirements for use:

·The account used to perform the migration from Dropbox Business needs to have Team Admin access to the Dropbox Business tenant.

·The account used to perform the migration into Microsoft Teams needs to be a minimum of Site Collection Administrator in this Office 365 tenant.

·The person performing the migration will need to know the relationship (user mapping) between each user's Dropbox user account and their corresponding Microsoft Teams name and account.

·The Microsoft Team must already exist.

To migrate content of a Dropbox Business Account(s) to Microsoft Teams, perform the following:

1.On the Drives tab click Copy Dropox and select the "Copy Dropbox to Microsoft Teams" option.

2.Give your project a name.

3.Enter the username of your Dropbox Administrator.

4.Make sure Dropbox Business - Connection Requirements are met.

5.Use the information in the following table to determine the appropriate action to take.

If you receive any message other than Successfully connected to Dropbox, double check your supplied information and try again.  If you are still experiencing issues, please contact Support for further assistance.

6.In the Target Office 365 Connection Parameters section, specify your tenant SharePoint Administration Center URL and then click Connect (i.e. https://tenant-admin.sharepoint.com).  When prompted, enter your Administrator login and password. Click Connect.  If you receive any message other than Successfully connected to SharePoint Admin, double check the URL and make sure you are supplying a Administrator login for this tenant.  If you are still experiencing issues, please contact Support for further assistance.

7.Click the Load from Dropbox button to load in a list of available Dropbox Business drives to include with this migration.  For performance reasons, if you have a large number of Dropbox Business drives in your tenant you may wish to CSV file with the user accounts and choose the option to "Load from CSV" instead.  Select the Dropbox Business drives that you wish to include with this migration.

8.You can also choose to Load and Apply report option, which allows you to load and apply an Analyze Dropbox report, which then sets the Migration Priority for each user mentioned in the report. Click Next to continue.

9.Select Re-Map Users option and load your mapping CSV file.  Group mapping is required (user mapping may also be included) so the software can properly resolve the differences between your users' Dropbox account and the corresponding Microsoft Teams name as well as maintain content authorship.  If your user accounts differ between Dropbox and Microsoft Team then you will want to add your user mapping to this same file.  

In the example below, lines 1-3 illustrate mapping a source Dropbox to an Microsoft Team by name while lines 4-5 in the same file are used to map the Dropbox user accounts to their respective Microsoft Teams user accounts to maintain item authorship.

sales@company.com,MicrosoftTeam Name
marketing@company.com,MicrosoftTeam MarketingGroup
IT@company.com,IT Group
scott@company.com,swilson@contoso.com
bill@company.com,bgeorge@contoso.com

If you wish to migrate one or more source accounts to a single Group library while also remapping the user account for the purpose of metadata and sharing, please use the following format in your mapping file.

user@dropbox.com,MicrosoftTeam GroupName(user@contoso.com)

The software will migrate the content from the source drive "user@dropbox.com" to the Documents libary in the group "Microsoft Team GroupName".  The metadata and shared permissions of Dropbox user "user@dropbox.com" will be mapped to the Microsoft Team user account "user@contoso.com".
 
If you would like to migrate source accounts to a target Teams channel, use the following mapping.
 
scott@company.com,swilson@contoso.com,ChannelName
 
The third column in this CSV will map the users to the specific target channel.

10.Click Check MS Team in order to begin the validation process​. This process will validate that the supplied user mapping is correct (MS Teams were located) and check to determine if each Team currently has a Site provisioned.  Click Next.

If the group is not found you may continue, however no content for this mapping will be migrated.  Alternatively, you may go back one page and remove the selected source Dropbox account or modify your mapping file, reload the CSV and click the Check button again.

11.If necessary, change content and file format conversion options​ as described below.
 
Content Options

Copy Content - A flag to determine if content is or is not included with this operation.  When not included the remainder of the options will become disabled.

Include Versions - The process in which Dropbox revision history will be converted into Microsoft Teams versions.  Please note that this option is only referring to the major revisions (those shown as the "less detailed revisions") and not those that are automatically generated within Dropbox (those shown as the "more detailed" revisions).

Incremental Copy - When enabled, the migration process will identify and migrate only that content which was created, modified or versioned within the defined interval (days, weeks or months).

Skipped Non-Owned Folders - This option addresses the scenario where folders appear in a user's Dropbox which are not owned by this user; meaning the user is a folder collaborator and not the folder "Owner".  Skipping these folders will prevent duplicates from being migrated into Microsoft Teams because the folder will be migrated only once when the folder "Owner" is migrated.  Please refer to the in-application Help button for additional details.
 
Migrate to Folder - When this option is enabled, you can create a (or use an existing) root folder structure in the destination library where your source content will be migrated. You will need to define the path like this example:

/My Source Content/2017

In the above example, the folder "My Source Content" and subfolder "2017" will be created in the root library of your destination and all source content will be migrated to this folder location.

Apply Filter - Optionally, select from a series of filterable parameters to include or exclude specific content during migration.

Advanced Options:

 

Enable Azure Turbo Mode: When enabled, this option utilizes Microsoft's SharePoint Online Migration API to increase the migration performance and throughput. A recommendation for optimal use of this API is larger sets of data; the more content, the better the throughput. Please review the User Manual for additional information as well as recommended configuration as this process is a resource intensive operation.

Because this API uses Azure storage as a staging area for the migration, it requires that you provide an Azure storage location. The options are to either utilize Microsoft supplied storage or to provide your own Azure storage location. If you wish to use your own Azure account, you must provide both the Azure Account Name as well as the corresponding Acces Key. If you cannot supply this information, please search our online Knowledge Base, User Manual or contact Support for additional information before proceeding or consider using the Microsoft Supplied Storage option. For more information please see the Azure Turbo Mode section.

·Microsoft Provided Storage: This option allows you to use Microsoft provided Azure storage instead of providing your own for the purpose of utilizing Azure Turbo Mode.

·User Provided Storage: This option allows you to provide your own Azure Storage instead of using one provided by Microsoft for the purpose of utilizing Azure Turbo Mode. It requires that you provide both your Azure Blob Storage Account Name as well as its corresponding Access Key by clicking the "Select" button to the right. If you cannot supply this information, please search our online Knowledge Base, User Manual or contact Support for additional information before proceeding.

Send Notification: When selected, this feature will send emails to the listed recipients once Migrations are completed. Enter a specific user email address. For two or more, separate each email address with a comma. Set up User Notifications here in order to use this feature. 

Create User Specific Log File - If you would like a user specific log file (.txt format) created for each migrated Microsoft Team that will be saved directly to that Team's Documents library, check this option before you finish.  This log file will contain all the content that was included in the migration with both source and target URLs as well as any file renaming that took place and skipped files due to lack of ownership.

12. Click Finish to begin the migration.