Create a scoped view

If you're migrating from OneDrive for Business, follow the instructions for SharePoint unless specified.

You use a scoped view to define the source data accessed for a scan. Scoped-view entries work even if the source data is changed. For example, G Suite Migrate can resolve the scoped view entry if a mail folder is renamed.

Tip: If you have a lot of data to scan, use scoped views to manage data. A scoped view allows you to divide the data into chunks, allowing you to scan in manageable phases.

Step 1: Create a CSV file to add multiple entries

You can add multiple entries to a scoped view using a comma-separated values (CSV) file. Scoped-view CSV files must contain:

  • A header row specifying the object type. For details, see the scoped view headers for Exchange, SharePoint, file shares, G Suite, and Box
  • Rows under the header with locations for the specified types.

A scoped view can have multiple columns, each with a type-name header. If there's no value in a column, then that column is disregarded for the row. Make sure the character encoding of the CSV file is set to UTF-8. 

Step 2: Create a scoped view

  1. Before you begin, review the the scoped view headers for Exchange, SharePointfile sharesG Suite, or Box.
  2. In the G Suite Migrate platform, click Connections. You might have to click Menu "" first. 
  3. Next to your connection, click Scoped views "".
  4. In the top-right corner, click Add "".
  5. Enter a name for your scoped view.
  6. Click Upload CSV file to upload a CSV file or drag a file to the box.
  7. Click Create.

Update and validate a scoped view

Open all   |   Close all

Update a scoped view

As you add entries to a scoped view, G Suite Migrate validates the source locations.

  1. Point to your scoped view and click Entries "".
  2. Click Add ""and thenAdd entries manually
  3. Check the box next to the target locations. Click the Down arrow "" to expand your selection. 
  4. After you select all the locations, click Nextand thenand then Add.
Delete a scoped view
  1. Point to your scoped view and click Entries "".
  2. Next to the entry you want to remove, check the box and click Delete "".
Check that your scoped view entries are valid
  1. Point to your scoped view and click Entries "".
  2. Next to the entry you want to validate, check the box and click Validate "".

A green check indicates that the entry is validated.

Next step

Verify the connection for Exchange, SharePoint, file shares, G Suite, or Box.


Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.