Scoped view and mapping headers for Box

Use the following headers when you're creating a CSV file for a scoped view or mapping for a Box® migration. 

CSV file format

  • All headers and entries are case-sensitive.
  • When using a mapping CSV file, make sure that the column headers belonging to the source connection are prefixed with Source and the target connection column headers are prefixed with Target.
  • Make sure the character encoding of the CSV file is set to UTF-8. 

Example scoped view CSV file for Box: 

Box scoped view

Example mapping CSV file for Box:

Mapping for Box

CSV file headers

CSV file headers for Box (source)
Header Use and examples
BoxUser To map data from a Box user, use the BoxUser header with the email address of the user.

Example
BoxUser
user1@source.com

BoxFolder

Must be preceded by a column with a BoxUser value

To map data from a Box folder, use the BoxFolder header with the ID of the folder. Find the ID value by navigating to the folder in Box and inspecting the URL. For example, the URL https://app.box.com/folder/74816025069 has an ID value of 74816025069.

Example
BoxFolder
74816025069

Note: The All Files folder has an ID of 0.

Other source CSV file headers
Header Use and examples
MapChildrenOnly

Must be preceded by a column with a folder value

To map the contents of the folder, but not the folder itself, use the MapChildrenOnly header with the (case-insensitive) string "true". To map the folder and its content, omit the column or use the (case-insensitive) string "false".

Example
MapChildrenOnly
true

CSV file headers for G Suite (target)
Header Use and examples

GDrive

Must be preceded by a GUser column and value

To map data to a user’s My Drive or to a shared drive, use the GDrive header with one of the following strings:
  • GMyDrive
  • GSharedDrives

Example
GDrive
GMyDrive

GFolder

Must be preceded by a GUser column and value

To map data to a user’s My Drive folder, use the GFolder header with the Drive folder’s ID. Find the ID value by navigating to the folder in Drive and inspecting the URL. For example, the URL https://drive.google.com/drive/u/0/folders/BDEz25J3DzFb has an ID value of BDEz25J3DzFb.

Example
GFolder
Drive_Folder_ID

GGroup To map data to a group in Google Groups, use the GGroup header with the group’s email address.

Example
GGroup
group1@gsuitedomain.com

GOrgUnit To map data to a specific organizational unit, use the GOrgUnit header and the path to the organizational unit.

Example
GOrgUnit
/Org_Unit/Sub_Org_Unit

GService

Must be preceded by a GUser column and value

To map data to a user’s G Suite service, use the GService header with one of the following strings:

  • GDrive
  • GCalendarService
  • GContactService
  • GMailService
  • GSitesService

Example
GService
GMailService

GSharedDrive

Must be preceded by a GUser column and value

To map data to a shared drive, use the GSharedDrive header with the shared drive folder ID. Find the ID value by navigating to the folder in Drive and inspecting the URL. For example, the URL https://drive.google.com/drive/u/0/folders/BDEz25J3DzFb has an ID value of BDEz25J3DzFb.

Example
GSharedDrive
Shared_drive_folder_ID

GUser To map data to a G Suite user, use the GUser header with the email address of the G Suite user.

Example
GUser
user1@gsuitedomain.com

Sub Path To map data to a folder that doesn't currently exist in your G Suite account, use the Sub Path header. Add the path and name of the new folder below. During a migration, G Suite Migrate creates the path and folder and migrates the data to the new folder. 

Example
Sub Path
Folder1#Folder2

Related topics