OneDrive (CMIS Binding): Difference between revisions

Revision as of 10:40, 13 May 2025

This article is about the current version of Grooper.

Note that some content may still need to be updated.

2025

2023

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

It 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. OneDrive drives and SharePoint libraries can be individually imported as a CMIS Repository.

Each OneDrive CMIS Repository will expose themselves as hierarchical file system (HFS). Folders and files are represented by simple object types. As such, this binding is unsuitable for "mapped export". You can still export metadata as a "buddy file" by adding a metadata format in your Export Behavior.

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

Expand the "Infrastructure" node.
Right click the "CMIS Connections" folder.
Mouse over "Add" and select "CMIS Connection...".
In the "Connection Properties" panel, select "OneDrive" from the "Connection Type" drop down list.
Expand the "Connection Settings" heading and the "Login" heading under that.
Select "Authentication" and press the ellipsis button at the end of the line.
Log in using credentials with a Microsoft account.
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

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.
Click ... at the end of the Behaviors property.
Click the Add button within the Behaviors List window and select Import Behavior.
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.
Click the Add button that appears within the Import Definitions window and select CMIS Import from the dropdown list.
Select the OneDrive CMIS Repository.
Choose the Content Type you'll be importing.
Configure Read Mappings and/or Write Mappings if necessary.
When finished, click OK.
Click OK to finalize the Import Behavior.
Save.

Submitting an Import Job

Click here for an interactive walkthrough

Click the Imports icon.
- IMPORTANT: You will need an Import Watcher service installed and running in order to submit an Import Job.
On the Imports screen, click the Add New Jobs button.
Enter a Description for the Import Job.
Select the Import Provider.
Select the OneDrive Repository.
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.
If you plan to process the Batch upon import, then configure the Batch Creation property. If not, click Submit.
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.

@@ Line 1: / Line 1: @@
-#REDIRECT [[OneDrive (CMIS Connection Type)]]
+{{AutoVersion}}
+[[Category:CMIS Connection Type]]
+[[image:onedrive.png|frame]]
+<blockquote>{{#lst:Glossary|OneDrive}}</blockquote>
+It 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.  OneDrive drives and SharePoint libraries can be individually imported as a '''CMIS Repository'''.
+Each OneDrive CMIS Repository will expose themselves as hierarchical file system (HFS). Folders and files are represented by simple object types.  As such, this binding is unsuitable for "mapped export".  You can still export metadata as a "buddy file" by adding a metadata format in your [[Export Behavior]].
+<br clear=all>
+== 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 <code>CONTAINS()</code> 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 ==
+[https://app.supademo.com/demo/cm9h88dwu1lv0ljv5ojz2omwg Click here for an interactive walkthrough]
+#Expand the "Infrastructure" node.
+#Right click the "CMIS Connections" folder.
+#Mouse over "Add" and select "CMIS Connection...".
+#In the "Connection Properties" panel, select "OneDrive" from the "Connection Type" drop down list.
+#Expand the "Connection Settings" heading and the "Login" heading under that.
+#Select "Authentication" and press the ellipsis button at the end of the line.
+#Log in using credentials with a Microsoft account.
+#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 ====
+[https://app.supademo.com/demo/cma44n32401tp3b0i4to0a7os?step=1 Click here for an interactive walkthrough]
+# 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.
+# Click <code> ... </code> at the end of the Behaviors property.
+# Click the Add button within the Behaviors List window and select Import Behavior.
+# Define the import by clicking <code> ... </code> at the end of the Import Definitions property after it appears on the right side of the Behaviors List window.
+# Click the Add button that appears within the Import Definitions window and select CMIS Import from the dropdown list.
+# Select the OneDrive CMIS Repository.
+# Choose the Content Type you'll be importing.
+# Configure Read Mappings and/or Write Mappings if necessary.
+# When finished, click OK.
+# Click OK to finalize the Import Behavior.
+# Save.
+==== Submitting an Import Job ====
+[https://app.supademo.com/demo/cma4fgqud016nyc0i4fhh7hym?step=1 Click here for an interactive walkthrough]
+# Click the Imports icon.
+#:* <li class="fyi-bullet"> IMPORTANT: You will need an Import Watcher service installed and running in order to submit an Import Job. </li>
+# On the Imports screen, click the Add New Jobs button.
+# Enter a Description for the Import Job.
+# Select the Import Provider.
+# Select the OneDrive Repository.
+# 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.
+# If you plan to process the Batch upon import, then configure the Batch Creation property. If not, click Submit.
+# 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 ====
+== See Also ==
+For more information to use your '''CMIS Connection''' once its created, see the following articles:
+* [[CMIS Export]]
+* [[CMIS Import]]