Create a scoped view

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, Google Workspace 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.

Before you begin

Review Scoped view & mapping headers for file shares.

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.
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

In the Google Workspace Migrate platform, click Connections. You might have to click Menu first.
Next to your connection, click Scoped views .
In the top-right corner, click Add .
Enter a name for your scoped view.
Click Upload CSV file to upload a CSV file or drag a file to the box.
Click Create.

Update & validate a scoped view

Expand all | Collapse all

Update a scoped view

As you add entries to a scoped view, Google Workspace Migrate validates the source locations.

Point to your scoped view and click Entries .
Click Add Add entries manually.
Check the box next to the target locations. Click the Down arrow to expand your selection.
After you select all the locations, click NextAdd.

Delete a scoped view

Point to your scoped view and click Entries .
Next to the entry you want to remove, check the box and click Delete .

Check that your scoped view entries are valid

Point to your scoped view and click Entries .
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

_{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.}