Create and manage a mapping

A mapping determines what content gets migrated and where it gets migrated to. As you add entries to a mapping, G Suite Migrate can validate that the source and target locations exist.

Create a CSV file to add multiple entries

You can add multiple entries using a CSV file. The file is similar to 2 scoped views. One scoped view specifies the source data, and the other specifies where the data should be on your new domain. Just like a scoped view, you can use multiple columns, each with a header. Before you begin, review the the mapping headers for Exchange, SharePoint, file shares, or Box.

Create the CSV file using the following format:

  • Preface source-connection column headers with Source.
  • Preface target-connection column headers with Target.
  • Format each entry according to the syntax requirements of the connection type.
  • All entries in a mapping are case-sensitive.
  • Make sure the character encoding of the CSV file is set to UTF-8. 

Step 1: Create or update a mapping

Create a mapping
  1. Before you begin, review the the mapping headers for Exchange, SharePoint, file shares, or Box.
  2. In the G Suite Migrate platform, click New New and then Mapping.
  3. Enter a name for the mapping.
  4. From the Source connection list, select the source connection.
  5. From the Target connection list, select the target connection.
  6. Click Upload CSV file or drag a file to the box.
  7. Click Create.

Note: If you point to the mapping and click Entries Entries, under Source validity and Target validity, you might see "Imported entry requires validation." You validate the entries in step 2

Update a mapping

Update a mapping using a CSV file

  1. In the G Suite Migrate platform, click Mappings.
  2. In the Mappings section, point to the mapping name and click Entries Entries.
  3. Click Add Add.
  4. Click Upload CSV file or drag a file to the box.
  5. Click Import.

Note: G Suite Migrate might reformat source and target locations after the CSV file is imported. 

Add individual entries to a mapping

  1. In the G Suite Migrate platform, click Mappings.
  2. In the Mappings section, point to the mapping name and click Entries Entries.
  3. Click Add Add and then Add entries manually.
  4. Check the box or boxes next to the source data you want to migrate. Click the Down arrow Down Arrow to expand your selection.
  5. Click Next.
  6. Check the box or boxes next to the target location. Click the Down arrow Down Arrow to expand your selection.
  7. Click Next.
  8. (Optional) To migrate the contents of a folder but not the folder, under Map content only, click Turn on Turn on .

    For example, say you want to map the Receipts folder to My Drive. If you turn on Map content only, everything in the Receipts folder is migrated to My Drive, but the Receipts folder itself is not migrated.

  9. Click Add.

    Delete a mapping entry

  1. Point to the mapping and click Entries Entries.
  2. Next to the entry, check the box.
  3. Click Delete Delete and then Delete.

Step 2: Validate a mapping entry

  1. Point to the mapping and click Entries Entries.
  2. Check all entries and click Validate Validate.
  3. If you see a:
    • Green check—Entry is valid.
    • Red cross—Entry is invalid. Check the error message.
    • Gray clock—Entry has expired. The entry must be revalidated before you run a bridge.

Note: Validation can take several minutes.

Next step

Create and manage an identity mapping for Exchange, SharePoint, file shares, or Box