Box (CMIS Binding)

This article is about the current version of Grooper.

Note that some content may still need to be updated.

2025

2023

Box is a connection option for cloud CMIS Connections. It Grooper to the Box content management system for import and export operations.

You may download the ZIP(s) below and upload it into your own Grooper environment (version 2025). The first contains one or more Projects with resources used in examples throughout this article. The second contains one or more Batches of sample documents.

Please note the Projects ZIP does not contain the configured CMIS Connection or Export Behaviors that are referenced in this article. You will need your own Box account to fully configure these resources.

About

The "Box" binding gives Grooper access to files and folders in the Box content management platform. Box connections are how you import content from and export content to a Box account.

You must have an enterprise Box account to connect to Grooper. Connection to personal accounts is not supported.

The Box binding can be selected as a connection option when configuring a CMIS Connection. After configuring the connection, Box folders are exposed to Grooper as a CMIS Repository. CMIS Repository nodes are created as children of the CMIS Connection by importing a reference to their source location.

The Box CMIS Repository mimics Box's file system hierarchy as well. Once a CMIS Repository is created, you can import, export, search, and browse documents from Grooper.

The Box binding can be used for import operations via CMIS Import using "Import Descendants" or "Import Query Results".
It can be used for export operations via CMIS Export.
- Box can be used for simpler "unmapped" exports, if you just want to export Grooper documents as files to a folder in Box.
- Box can also be used for "mapped" exports.
  - Box's "Metadata Templates" allow the platform to store additional document data as fields.
  - Extracted Data Field values in Grooper can be exported to fields in a Metadata Template along with the document's file.
  - In the CMIS Export setup, a Data Field in Grooper is mapped to a corresponding field in the Box Metadata template. When the document is exported the value is copied from Grooper and entered into the mapped field in Box.

Box account setup

BE AWARE: Connecting to Box requires some setup in your Box account before configuring a CMIS Connection

There are two ways a Grooper CMIS Connection can connect to a Box account.

With an account ID ("Box User ID").
The Box account ID is entered into the "Box User ID" property in the Box Connection Settings.
With a JSON Web Token ("Custom App Settings").
The custom app's App Settings JSON is entered into the "Custom App Settings" property in the Box Connection Settings.

Both of these options require some additional setup in Box. If you are integrating Box with Grooper for the first time, your Box administrator will need to add Grooper as a "Custom App" before connecting.

Option 1: Connecting using a Box account ID - Box User ID

Sceenshot of the "Add App" dialogue in the Box Admin Console

This is the easiest method for most users. It will add a Grooper app to your Box account. This app is pre-approved by Box, meaning you don't have to wait for Box to approve the custom app.

Using the Box Admin Console, go to "Apps" then "Custom Apps" to add Grooper.
As part of the setup, you will be prompted to enter a "Client ID", listed below:
```
z9iyazstefwydilz4x3abdi3w79wogow
```

Option 2: Connecting using JWT - Custom App Settings

The "Custom App Settings" route is preferable for smaller Box accounts.

Connecting with a Box account ID ("Box User ID" in Grooper) will consume one of your Box user accounts. This can cause connection issues for organizations using only the minimum of 3 user accounts in Box.
Instead, these users should use the "Custom App Settings" method of connecting in Grooper. This will not consume one of your user accounts.

This will require you to create a custom "platform app" in Box.

After creating the custom platform app, Box approves it, and you activate it, you will copy the "App Settings" JSON from Box into the Custom App Settings property in Grooper.
For more information on how to create a custom platform app in Box. Visit the articles below:
https://developer.box.com/guides/applications/app-types/platform-apps/

https://developer.box.com/guides/authorization/custom-app-approval/

https://developer.box.com/guides/authentication/jwt/

About the resources used in this article

This article assumes you already have a Box account and have completed any required setup in Box to integrate with Grooper.

Understanding Box as a file system

At its core, Box is a cloud-based file system.

It is a storage repository consisting of files in folders.
Files and folders are accessed from the web app at box.com.
Box is a cloud native platform. There is no on-premise version of Box.

Understanding Box as a data storage platform

As well as a basic file system, Box can store data in fields using "Metadata Templates".

Metadata Templates are assigned to files or folders in Box.

Metadata Templates are added in Box by your Box Admin.
The Metadata Template in this image is very simple. It has just three fields ("ID", "First Name" and "Last Name").
Any number of custom metadata fields can be added to a Metadata Template.
Multiple Metadata templates may also be applied to a single file and/or folder.

With a Metadata Template attached to a file or folder, values for each field can be saved in Box. With a "mapped export", you can marry data Grooper collects in a document's Data Model with a corresponding field in the Metadata Template with an Export activity.

More information on creating a "mapped export" can be found in the Configuring a "mapped" Box export section of this article.

Understanding Grooper for Mapped Exports

When setting up a CMIS Export, you can define "Write Mappings" to platforms like Box that have custom metadata fields for their files. Configuring a "Write Mapping" will map the value of a Data Field for the document in Grooper to a field in a Box Metadata template. When the Export activity runs, the document and the data are exported. A file is created in Box and the Data Field's value is mapped to the field in its Metadata Template in Box.

We call this kind of export a "mapped export" in Grooper (as opposed to an "unmapped export" that exports the document only).

This is an example Content Model we're going to use to show you the basics of mapped exports in Box.

The purpose of this Content Model (and its Data Model) is to extract three Data Fields from a document in Grooper. Once those fields are extracted in Grooper, they can be mapped to fields in Box on Export.

The three fields in the Data Model are: "ID" "First Name" and "Last Name"
They correspond to the three fields in the Box Metadata Template: "ID" "First Name" and "Last Name").
On executing the Export activity, Grooper will both export the document to a folder location in Box and export the data it collects to the Metadata Template Box attaches to the exported file.

More information on creating a "mapped export" can be found in the Configuring a "mapped" Box export section of this article.

Mapped Export Prereq: Extracted Data

Please note! Before the Export activity can send data, it must have data to send! In other words, the Extract activity must collect data first.

In a production scenario, this will be accomplished by an Extract step of a Batch Process.
However, take care when you're testing your configuration to ensure documents have extracted data before exporting to Box.
- It's easy to get in the habit of testing extraction on a Data Field or a Data Model and feel good about the results, but it must be understood that the information displayed when doing so is in memory, or temporary.
- When the Extract activity is successfully run against a classified document, it creates "index data" and marries it to the document via a JSON file called Grooper.DocumentData.json.

You can verify a document has extracted data follows:

Click here for an interactive walkthrough

Navigate to the Batch in the node tree.
Click on the Viewer tab.
Press the Review button.
- This will open the Batch in a "Review" page with three default Review Views: a Folder Viewer, a Data Viewer, and a Thumbnail Viewer.
Select "Data View" to open the Data Viewer.
The Data Viewer has two panels: the Data Grid and the Document Viewer
- The Data Grid shows the fields, sections and tables in a document's Data Model.
- The Document Viewer displays the document (including all available renditions such as the "Text Rendition" that shows OCR'd or extract text from the Recognize activity).
If the fields in the Data Grid have data present, data has been extracted and saved to the document.
If the fields are empty, run the Extract activity on the document to collect and store its index data.
- You can run the Extract activity from the Data Grid (unless that permission has been restricted by your administrator).

Creating a Box CMIS Connection

Creating and configuring a CMIS Connection is the first step to importing and exporting with Box.

BE AWARE! There are actually two ways Grooper can connect to Box. We only describe one in this article.

There are two ways a CMIS Connection can connect to Box.

With an account ID ("Box User ID").
- This is entered into the "Box User ID'" property in the Box Connection Settings.
- This is the route described in this article.
With a JSON Web Token ("Custom App Settings").
- This requires your organization to create a custom "platform app" in Box.
- The custom app's App Settings JSON is entered into the "Custom App Settings" property in the Box Connection Settings.

Both of these methods require setup in your Box account (performed by your Box administrator). See above for more information

We will detail the simpler method in this article: Using an account ID from Box and the "Box User ID" property in the Box Connection Settings.

Prereqs: Account ID from Box

In order to connect to Box in Grooper you will need and enterprise account and what Box refers to as an Account ID.

Click here for an interactive walkthrough

When logged into Box, click the icon for your account to expose a drop-down menu.
Click on Account Settings.
Scroll to the bottom of this page and take note of the Account ID.

Create the Box CMIS Connection in Grooper

Click here for an interactive walkthrough

Create a CMIS Connection

Right-click a Project in the node tree (or a folder in the Project.
Select "Add", then "CMIS Connection..."
Enter a name for the CMIS Connection.
Select "Execute".

Configure the CMIS Connection for Box

Once your CMIS Connection has been created, set your "Connection Settings" to Box. This defines settings for Grooper to connect to Box.

Select "Box User ID" and enter your Box Account ID.
- If you are unsure of where to find your Box Account ID, please see the previous section (#Prereqs: Account ID From Box).
If needed, you can edit the "Metadata Format" property. This defaults to "Normal" which is appropriate for most users.
- If you want to perform a "mapped export", your Metadata Format will need to be "Normal".
- For more information on mapped exports, see the Configuring a "mapped" Box export section of this article.
Save the CMIS Connection.

Import Your Box Repository

Having saved your connection settings, Grooper has established a connection to your Box account, and you can now import the Box storage location into Grooper. This will create a CMIS Repository node Grooper can use to navigate Box's folder and file structure. To do so:

Select the CMIS Connection and press the "List Repositories" button.
- "CMIS Repositories" and "CMIS Connections" are two different things in Grooper.
- CMIS Connections only connect Grooper to Box.
- CMIS Repositories represent the files and folders in Box.
The "List Repositories" button lists available CMIS Repositories that can be imported into Grooper. Select the CMIS Repository you wish to import. For Box, you should only ever see one repository: "All Files"
- At this time, the value under "Imported" will be "False", and the dot next to it will be red. Once imported, this value will change to "True", and the dot will turn green.
Press the "Import Repository" button to import the storage location into Grooper.
In the pop-up window, ensure the listed repository is the one you wish import, and press the "Execute" button.
This will add a CMIS Repository node to the CMIS Connection (as its child).
Grooper will use this CMIS Repository node when importing files from or exporting Grooper documents to folder locations in Box.
- The CMIS Connection only initiates the connection from Grooper to Box.
- The CMIS Repository is a node that represents a specific folder in Box. This node allows Grooper to interoperate with the folder location in Box.

Import documents using Box

WIP

COMING SOON!!

Export documents using Box

You can export processed documents from Grooper using a Box connection by configuring an "Export Behavior". Export Behaviors are required to tell the Export activity how to export Batch Folder content based on its Document Type. Because Grooper connects to Box using a CMIS Connection, we will configure a "CMIS Export" definition for the Export Behavior.

Configuring a basic ("unmapped") Box export

Box is in a special category of CMIS Bindings that allow you to perform a "mapped export". Mapped exports allow users to export data collected in Grooper to fields in Box (by "mapping" Grooper Data Fields to fields in a Box metadata template).

However, you can also perform a simpler "unmapped" export. This will simply export files to a folder for each Batch Folder exported.

The steps required for unmapped exports will also apply to mapped exports.
- Unmapped exports only export files (PDFs, TIFFs, CSVs, XMLs etc.).
- Mapped exports export both files and map data to fields in the CMS platform.
Mapped Box exports are detailed in the Configuring a "mapped" Box export section below.

Add the Export Behavior and CMIS Export Definition

To export documents using a Box connection, you need to configure an Export Behavior and add a CMIS Export definition.

Export Behaviors can be added to any Grooper Content Type but are often added to Content Models.
Adding an Export Behavior to a Content Model will apply the Export Behavior to any Document Type in the Content Model (as long as the Document Type doesn't have its own Export Behavior configured).
Whenever the Export activity runs, Grooper will export a Batch Folder's document and/or data content according to the Export Behavior's configuration.

More information on Export Behaviors and exporting in general can be found in the Export article.

Click here for an interactive walkthrough

To add an Export Behavior to a Content Model:

Select your Content Model.
Select the "Behaviors" property and press the ellipsis button.
This brings up the Behaviors editor. Press the "Add" button.
In the drop-down menu, select "Export Behavior".
Select the "Export Definitions" property and press the ellipsis button.
This brings up the Export Definitions editor. Press the "Add" button.
Select "CMIS Export".
- There are many different types of Export Definitions in Grooper. They all export Batch Folder document/data content to different platforms using different protocols. CMIS Export is the appropriate choice for Box exports. CMIS Export is used to export content to platforms using CMIS Repositories.

Configure the CMIS Export definition

After adding the CMIS Export definition, you must configure it!

Adding an "Export Behavior" is just the first step.
- When the Export activity runs, it looks at each Batch Folder. If the Batch Folder has a Document Type with an Export Behavior, it knows its going to Export it.
- Besides that, an Export Behavior is really just a container for Export Definitions.
The Export Definition is where the action is. Export Definitions define:
- What Batch Folder content should be exported (the document's images, attached files, and/or data in its Data Model)
- If a file is generated, what format that file should be (for example PDF or TIFF or CSV or several other format options)
- Where the files and data are going (a CMS platform, a Windows file system, a database, etc.).
CMIS Export is an Export Definition for content exported over a CMIS Connection to a CMIS Repository. In this case, to Box.

Click here for an interactive walkthrough

To configure an unmapped CMIS Export for Box:

Select the "CMIS Repository" property and click the hamburger icon.
Use the dropdown menu to select the CMIS Repository you wish to export to.
- In our case, this is our Box CMIS Connection's only child CMIS Repository: "All Files". This represents the root folder of our Box account.
The "Target Folder" and "Subfolder Path" properties allow you to control what folder documents are exported to.
- Target Folder: Use this property to select existing folders in Box. Press the ellipsis button to bring up a folder browser.
- Subfolder Path: Use this property to dynamically traverse and create folder locations using code expressions. Press the ellipsis button to bring up a code editor.
Next, you must choose the "Object Type" you're exporting. "File" is the only option for Box.
Configure the "Export Formats" as needed.
- This property will not appear until "File" is selected for "Object Type".
- Export Formats define what file format (PDF, TIFF, TXT etc) is exported for each Batch Folder.
When finished, click "OK" to finalize the CMIS Export settings.
In the Behaviors editor, click "OK" to finalize the Export Behavior settings.
Save changes to the Content Model (or whichever Content Type you are configuring).

More on Export Formats

Export Formats are critical to exporting documents. It determines what kind of file Grooper creates (PDF, TIFF, CSV, XML etc.) and what Batch Folder content is used to create that file (child Batch Page images, a file attached to the Batch Folder, or data collected from its Data Model).

There are too many Export Formats to detail fully in this article (You can visit the Export article for more information about Export Formats). However, there is one critical thing you should understand about Export Formats and CMIS Export.

One Export Format is added by default: "Attached File". With no further configuration, this will attach the Batch Folder's "main attachment file". Be aware of two common scenarios.

Common scenario 1: In Batch Processes where a Merge step runs before Export, this will export the file generated by Merge.

This is typically ideal.
In typical configurations, the Merge activity replaces the Batch Folder's "main attachment file" (if present) with the PDF or TIFF it generates. So, no further Export Format configuration is required to export a Grooper generated PDF or TIFF document.

Common scenario 2: In Batch Processes where a Batch is created by an Import Job and a Merge step is not present, this will export whatever file was imported at the start of the Batch Process.

This is not always ideal.
When an Import Job imports a file into Grooper, a Batch Folder is created and the file is attached to it. This is the Batch Folder's "main attachment file".
- If you simply want to export the same file you imported to export location, no further Export Format configuration is required.
- However, if you want to export a new file generated by Grooper you will need to (1) delete the Attached File format and (2) add one of your choosing (most typically a PDF Format).

Configuring a "mapped" Box export

Mapped exports allow users to map data Grooper extracts from Batch Folders to fields in a Box metadata template.

Box's "metadata templates" allow the platform to store additional document data as fields.
Extracted Data Field values in Grooper can be exported to fields in a metadata template along with the document's file.
In the CMIS Export setup, a Data Field in Grooper is mapped to a corresponding field in the Box metadata template. When the document is exported the value is copied from Grooper and entered into the mapped field in Box.
Data can be mapped to a single metadata template or multiple metadata templates.

Mapping to a single Box metadata template

This tutorial will show you how to set up "mapped export" for CMIS Export to a Box CMIS Repository. A single metadata template will be used in this scenario. Files and folders in Box can have multiple metadata templates assigned to them. However, they commonly will only have one.

This tutorial assumes you've already added an Export Behavior to a Content Type (Content Model, Content Category or Document Type).
This tutorial assumes you've already configured a CMIS Export definition for "unmapped" export.

Click here for an interactive walkthrough

Mapped exports are configured as part of your "CMIS Export" definition in an Export Behavior.

Open the "Behaviors" editor for the Content Type.
- Export Behaviors are configured on Content Types (Content Models, Content Categories and Document Types).
- In this tutorial our Export Behavior is configured on our Content Model.
With the Export Behavior added and selected, open the "Export Definitions" editor.
With the CMIS Export definition selected, open the "Secondary Types" editor.
- Note: The "Secondary Types" property only appears for Box CMIS Repositories, after setting the "Object Type" property to "File".
- "Secondary Types" for Box connections are metadata templates. Choosing a Secondary Type will add the selected metadata template to the file in Box
Use the Secondary Types editor to select the Box metadata template you want to assign to the exported documents.
Once selected, click OK.
Once you've selected a Secondary Type, open the "Write Mappings" editor.
The Write Mappings editor is a property grid used to map Box metadata fields to Grooper Data Fields or values calculated by code expressions.
- Box properties and field names are on the left.
  - "Name", "Description", and "Tags" are editable properties for all Box files, even when you do not select a Box metadata template.
  - After these properties, metadata template fields are listed one-by-one in the following format: "Template Name • Field Name"
- Values are mapped using each property's editor on the right.
There are two ways to map data from Grooper to a field or property in Box:
- Selecting Data Fields from a dropdown list.
  - Press the hamburger button at the end of the Box property to expose the list of available Grooper Data Fields. Select the one you want to map to the Box property.
  - Make sure the Grooper Data Field's value type matches the Box field's value type. If the Box field is a string field, the Data Field needs to be a string field. If the Box field is a date field, the Data Field needs to be a DateTime field. And so on.
  - There's a shortcut if Grooper Data Field names match the field names in the metadata template. Right click anywhere in the grid to use the "Auto Map" command. This will automatically map fields if their names match (Otherwise you will need to configure each mapping individually).
- Entering a code expression.
  - To enter an expression, expand the Box property in the Write Mappings property grid. Then, either enter the expression in the "Expression" property or open the "Expression" editor to enter the expression. Whatever the expression evaluates to will be what Grooper exports to Box.
  - Make sure the value type the expression evaluates to matches the field's value type in Box. If the Box field is a string field, the expression will need to evaluate to a string value. If the Box field is a date field, the expression will need to evaluate to a DateTime value. And so on.
  - It is common to use an expression for the "Name" field in Box. This will evaluate to the exported file's name.
After you've completed your Write Mappings, press "OK".
Press "OK" in the Export Definitions to finalize changes to CMIS Export.
Press "OK" in the Behaviors editor to finalize changes to the Export Definitions.
Press the "Save" button.

Mapping to multiple Box metadata templates

Note: For this section, we've changed the original document, and are using a different Content Model that has more Data Fields.

While mapping to a single metadata template in Box is common, you can also add multiple metadata templates to a single file in Box. You will simply select multiple metadata templates in the Secondary Types editor. When you configure the Write Mappings, fields for both templates can be mapped to Grooper Data Fields.

This tutorial assumes you've already added an Export Behavior to a Content Type (Content Model, Content Category or Document Type).
This tutorial assumes you've already configured a CMIS Export definition for "unmapped" export.
This tutorial assumes you're familiar with mapping to a single metadata template in Box.

Click here for an interactive walkthrough

Select your Secondary Types
Click OK.
- While the convention is the same, we've changed the Name property to avoid any confusion for Box when we export.
Similar to the preceding section, once your Name property has been set up, you'll begin matching the object in Write Mappings with the piece of Metadata you want to map to.
- While there is more to match this time around, it's still the same process.
Once everything is matched, click OK.
- Note that while our Repository and Target Folder appear the same as those of the earlier section, a different CMIS Repository was created. The document will still be exported to the same place in Box, however.
- The obvious difference is in the Secondary Types and Write Mappings sections. Since we mapping to multiple Metadata types, we have two CMIS Type References and seven additional properties that are associated with the Grooper Wiki - Additional Info Secondary type.
Click OK.
Save.

Now, we have an exported file mapped to two Metadata Templates. Wonder why we didn't do anything with the tables? Unfortunately, Box cannot read tables, it can only read instances of single value. Hence, why we chose the data we did.

Bonus: Testing the export and viewing the final results

After configuring anything in Grooper, it's usually a good idea to test it out before you put it into production.

In production, Export Behaviors are executed by the Export step in a Batch Process.

But you don't have to put a document through an entire Batch Process to test it. You can test your Export Behavior (and its CMIS Export configuration) in two ways:

"Click command testing" - You right-click a single document (Batch Folder) and apply the Export activity.
"Step testing" - You can select an Export step in a Batch process and use the "Activity Tester" tab to export one or more documents.
Be aware: In either case, the document must be classified and have data extracted before exporting.
- It must be classified to export its Document Type's Export Behavior.
- It must have data extracted if performing a mapped export or the extracted data is used in the Subfolder Path expression.

Click command testing

You can right-click a Batch Folder and apply any Grooper Activity from any Batch Viewer. This includes the Export activity.

Click here for an interactive walkthrough

For example:

Select your Batch.
Go to the "Viewer" tab.
Apply the Export activity.
- Right-click the document. Then, select "Run Activity", then "Document Processing", and then "Export".
A window will pop up to configure the "Export" activity.
- As long as the Document Type assigned to the Batch Folder has an Export Behavior configured (or inherits one from a parent Content Type), no configuration is required. All export logic will be defined by the Document Type's Export Behavior.
- While it is possible to configure Export Behaviors in the Export activity itself, we do not advise doing so. It is best practice to configure Export Behaviors on Content Types. The ability to configure Export Behaviors local to the Export activity exists for backwards compatibility. This is to ensure upgrade compatibility for older versions of Grooper where Export Behaviors did not exist.
Press the "Execute" button.

From this point on, you will need to set up your Export Definition exactly as depicted above in the "Configuring a Mapped Export" Section. To see those steps, click here: Configuring a "mapped" Box export

The view from Box

Once your document has been exported, you will see it displayed on the homepage of your Box account.

Selecting the newly imported document, you will be able to view the Metadata mapped to the document from Grooper.

FYI

Now that the document has been exported you may notice a link icon next to the attached file. This link indicates Grooper "knows" something about where this document is outside of Grooper. The document's exported file path location in Box is now stored in the document Batch Folder's properties.

Step testing

This section will detail texting export using an Export step's "Activity Tester".

Click here for an interactive walkthrough

Select the Export step of a Batch Process
- For the purposes of this article, we have simply made a Batch Process with a single step (which is an Export activity)
ONLY if you have NOT configured an Export Behavior already, configure the Export activity's Export Behavior .
- Export Behaviors may be configured in one of two ways:
  - Using the the Behaviors settings of a Content Model and/or its Document Types and Content Categories
  - Locally to the Export step using its Export Behaviors property.
  - We consider it best practice to configure Export Behaviors on a Content Model and/or its Document Types and Content Categories.
    The ability to configure Export Behaviors on an Export step is largely present for upgrade compatibility for older versions of Grooper before Export Behaviors existed.
    
    For more information on Export Behaviors, visit the Export article.
Navigate to the "Activity Tester" tab.
Select a document in the Batch you wish to export.
Click the "Test Activity" button.
- This will apply the selected Batch Process step to the selected document.
- In our case, this will export the selected document to Box.

Testing with the "Test Activity" button is a "single-threaded" operation. Even if you select multiple documents, only a single processing thread will be used.

If you have a large number of documents you want to export, you can use the "Submit Job" button.
- This will run the test "multi-threaded".
- Submit Job will submit all Export activity tasks to your running Activity Processing services for processing.

Known issues & limitations

File and folder limitations in Box

To mitigate problems when exporting to Box, users should be aware of the following limitations in Box:

No single folder can contain more than 15,000 files. For the best performance, a single folder should have at most 10,000 files.
Folder names should not be longer than 100 characters.
File paths should not be longer than 255 characters.

Box CMISQL Query limitations

The Box API has some built in requirements to perform search queries. This is not something Grooper can get around. In the past, this has caused Grooper users a lot of confusion when configuring WHERE clauses in CMISQL search queries.

To avoid confusion the following properties are not queryable at this time:

Created by (cmis:createdBy)
Modified by (cmis:lastModifiedBy)

Upgrade issues

There is a known issue upgrading Box CMIS Repositories from 2.9 to 2021 and beyond. The way Import and Export Mappings are configured changed radically from version 2.9 to 2021. Further, the Box binding was dramatically improved in version 2021.

Due to this, you may experience issues with your Import or Export Mappings when upgrading to 2021 and beyond. You may need to manually reconfigure your Import or Export Mappings upon upgrading. If you are using a Box connection, please validate your mappings and test them upon upgrading to ensure they behave appropriately.