OneDrive (CMIS Binding)

This article is about the current version of Grooper. Note that some content may still need to be updated.
2025	2023	2.72

OneDrive is a connection option for cloud CMIS Connections. It connects Grooper to Microsoft OneDrive cloud services for import and export operations.

The OneDrive binding provides access to OneDrive Personal or OneDrive for Business drives and SharePoint Online or SharePoint Server 2016 document libraries. More or less, all you have to do is sync Grooper and OneDrive by logging in using your OneDrive credentials and you can import from and export to your OneDrive folders.

The OneDrive binding can be selected as a connection option when configuring a CMIS Connection. After configuring the connection, OneDrive drives and SharePoint document libraries 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 OneDrive CMIS Repository mimics the drive's file system hierarchy as well. Once a CMIS Repository is created, you can import, export, search, and browse documents from Grooper.

• The OneDrive 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.
  • The OneDrive binding only has one writable property for exported documents: "Name". As such, this binding is unsuitable for "mapped exports". However, you can still export metadata as a "buddy file" by adding a metadata format in your CMIS Export definition.
  • If you are wanting to map data to field columns in SharePoint document libraries, you should use a SharePoint connection instead. The SharePoint binding is suitable for mapped exports.

Version Differences

When the OneDrive binding was added in version 2.72, it did not support full text querying. Full text searching is now possible as of Grooper version 2023.

• Use the CONTAINS() predicate in a CMIS Query to search document content in a One Drive repository based on a search string.

How To: Create a New Microsoft OneDrive Connection

Click here for an interactive walkthrough

1. Expand the "Infrastructure" node. 
2. Right click the "CMIS Connections" folder. 
3. Mouse over "Add" and select "CMIS Connection...".
4. In the "Connection Properties" panel, select "OneDrive" from the "Connection Type" drop down list.
5. Expand the "Connection Settings" heading and the "Login" heading under that. 
6. Select "Authentication" and press the ellipsis button at the end of the line.
7. Log in using credentials with a Microsoft account.
8. After you "Save", press the "List Repositories" button to show the folder paths you just added as repositories.

Importing and Exporting with a OneDrive CMIS Connection

Importing

Configuring the Import Behavior

Click here for an interactive walkthrough

1. Select a Content Type Object; this can be a Content Model, Document Type, or Content Category, but a Content Model is the most common place to configure an Import Behavior.
2. Click ... at the end of the Behaviors property.
3. Click the Add button within the Behaviors List window and select Import Behavior.
4. Define the import by clicking ... at the end of the Import Definitions property after it appears on the right side of the Behaviors List window.
5. Click the Add button that appears within the Import Definitions window and select CMIS Import from the dropdown list.
6. Select the OneDrive CMIS Repository.
7. Choose the Content Type you'll be importing.
8. Configure Read Mappings and/or Write Mappings if necessary.
9. When finished, click OK.
10. Click OK to finalize the Import Behavior.
11. Save.

Submitting an Import Job

Click here for an interactive walkthrough

1. Click the Imports icon.

   • IMPORTANT: You will need an Import Watcher service installed and running in order to submit an Import Job.

2. On the Imports screen, click the Add New Jobs button.
3. Enter a Description for the Import Job.
4. Select the Import Provider.
5. Select the OneDrive Repository.
6. If you choose Import Descendants for your Provider, configure the Import Filter; for Import Query Results, configure the CMIS Query.
   • Regardless of what Provider you have chosen, the purpose of the Import Filter/CMIS Query is to enable users to narrow down what file contents they want to import into Grooper.
7. If you plan to process the Batch upon import, then configure the Batch Creation property. If not, click Submit.
8. Once your Batch has been imported, you can view it by going to the Design page and clicking Batches --> Test --> Imported Batches
   • This is for Batches that have not been processed upon import. To view a processed Batch, you will need to look in the Production folder.

Exporting

Configuring the Export Behavior

1. Select the Content Type Node Object where you wish to configure the Import Behavior.
   • Note that Behaviors can be configured on any Content Type Node Object, be it a Content Model, Document Type, or Content Category; it's just more common to configure a Behavior on the Content Model.
2. Select the Behaviors property and click "..." to open the Behaviors Editor Window.
3. Click the Add button and select Export Behavior from the dropdown list.
4. Select the Export Definitions property and click "..." to open the Export Definitions Editor Window.
5. Click the Add button and select CMIS Export from the dropdown list.
6. Select the CMIS Repository property and click "☰" to access the dropdown list.
7. Click down through the list and select the OneDrive Repository.
8. Configure the Target Folder if need be - otherwise, the Documents will be exported to the root level of the OneDrive
9. Choose the Object Type.
10. Click OK on the Export Definitions Editor window when finished.
11. Click OK on the Behaviors Editor window.
12. Save changes made.

See Also

For more information to use your CMIS Connection once its created, see the following articles:

• CMIS Export
• CMIS Import