Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On This Page

Table of Contents

...

  1. Expand the Manage section in the left navigation menu.

  2. Click Connections.

  3. Click Add connection.

  4. Select Microsoft OneDrive for Business GccH as the platform on the Add connection modal.

  5. Enter the connection information. Reference the table below for details about each field.

  6. Click Sign in with Microsoft OneDrive for Business GccH.

  7. Enter the email for the account being used to create the connection and click Next. You must use an admin account with the proper privileges to manage Microsoft 365 configurations.

  8. Enter the password for the account and click Sign in.

  9. You will see a green "Connected” message on the bottom of the modal when DryvIQ establishes connection. (If the connection fails, verify the information you entered.)

  10. Click Done to finish creating the connection.


Add Connection Modal for Microsoft OneDrive for Business GccH

...

Field

Description

Required

Display as

Enter the display name for the connection. If you will be creating multiple connections, ensure the name readily identifies the connection. The name displays in the application, and you can use it to search for the connection and filter lists.

If you do not add a display name, the connection will automatically be named.

Optional 

URL

Enter the URL of your Microsoft OneDrive for Business GCCH High account. 

You can find the URL by logging into Microsoft OneDrive for Business GCCH High using the account you want to use to create the connection. The URL in the address bar is the URL you need to use.

Required

Token endpoint

This setting is rare for most Microsoft connections and can be left blank. If needed, this value will be provided by your administrator.

Optional 

Graph API endpoint

This setting is rare for most Microsoft connections and can be left blank. If needed, this value will be provided by your administrator.

Optional 

External users notifications

This indicates if you want to send notifications to external users. The default value is No, so no notifications will be sent. 

If you select Yes, notifications will be sent to external users when they have been granted access to content based on permissions.

Optional

Behavior When Deleting Items

Select the type of delete DryvIQ should perform when deleting items: Permanent or Soft. Soft delete is the default delete behavior; however, Permanent is the recommended behavior.

A soft delete marks items as a deleted. You can still access them to restore or permanently delete the items.

A permanent delete removes the items. This delete is not reversible.

Optional


Microsoft Login

...

Features and Limitations 

Platforms all have unique features and limitations. DryvIQ’s transfer engine manages these differences between platforms and allows you to configure actions based on Job Policies and Behaviors. Use the Platform Comparison tool to see how your integration platforms may interact regarding features and limitations. 

Supported Features

Unsupported Features

Other Features/Limitations

Version preservation

Mirror lock ownership

Invalid characters:  |   "   \   /   :   *   ?   <   >
See below for more information.

Timestamp preservation

File size maximum: 250 GB Microsoft limit
DryvIQ uses a file maximum size of 249.999999 GB files to ensure transfer. 
See below for more information.

Author/Owner preservation

Segment path length: N/A

File lock propagation

Path length maximum: 400

Account map
See below for more information.

Restricted types: N/A

Group map

Maximum number of files per folder: 5000 

Permission preservation

Maximum Enterprise Keyword length: 255 characters 

User impersonation

Restricted characters in Enterprise Keywords: < and >

Metadata map
See below for more information.

No leading whitespace 
See below for more information.

Tags map

No trailing periods and whitespace. 
See below for more information.

If a file extension is present, trailing periods and whitespace are allowed before the extension

No non-printable ASCII characters

Transferring Microsoft Lists is not supported.

File and Folder Name Restrictions

...

Microsoft Office 365 connections using OAuth 2 authentication may experience bandwidth throttling from Microsoft when using connection pooling.

Delta Job Runs

After the initial transfer of an item using a Microsoft SharePoint connection, DryvIQ will leverage Microsoft’s change tracking API on delta job runs to identify changes. This results in fewer Graph API requests and shorter job execution times.

HTML Files

SharePoint online does not support uploading HTML files larger than 256 MB. If your migration includes HTML files that exceed this limit, the file transfer will fail, and an entry will be logged in the audit with the following message: "Unable to interpret the contents of this page because it exceeds the maximum page size of 268435456 bytes.”

...

DryvIQ verifies file and folder names to identify unsupported characters based on the platform. It then replaces Invalid characters are handled according to the Allow unsupported file names to be changed setting for the job.

...

If the setting is disabled, DryvIQ will throw an exception when it encounters a file or folder that cannot be migrated due to an unsupported character in the name.

If enabled, DyvIQ will replace invalid characters with an underscore (_) so or UTF8 encoding based on the option selected. This will allow the files and folders can to be transferred. The  The logic includes leading and trailing spaces in file and folder names. DryvIQ replaces the space rather than trimming it because trimming the space could cause duplicate file names. Adding the underscore ensures the name remains unique.

DryvIQ will sanitize file names that contain combined Unicode characters by replacing the characters with an underscore (_).

Language Translation

DryvIQ does not support translation when migrating between SharePoint sites that have different default language configurations.

Mapping

When creating CSV mapping files for import, the usernames must be lowercase to properly adhere to the search requirements for the connector.

...

If a library requires specific metadata but the metadata is missing from a file being copied into the library, the file will be flagged and will not transfer on subsequent jobs runs. If you have files stuck in a flagged state due to missing metadata, you may need to manually transfer the files and add the required metadata.  

OneNote Files

DryvIQ supports transferring OneNote files from any source connector.

Timestamps

There is a discrepancy in timestamps for the SharePoint Online Folder Created Date when using CSOM and Batch ModeThis behavior is a known issue within OneDrive for Business/Office 365.

...