{"type":"doc","content":[{"type":"rule"},{"type":"mediaSingle","attrs":{"layout":"center","width":443,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":443,"type":"external","url":"https://skysync-documentation.s3.us-east-2.amazonaws.com/Logos/Dryv+Logo.png","height":128}}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"On This Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"5ae974ca-8996-48b9-ad1a-9ed212ff5b70"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"8e5d4866-cb50-4a4f-8f78-e3a010b41659"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"DryvIQ supports connections to Microsoft Office 365 Government Community Cloud (GCC) High, an environment that provides compliance with US government requirements for cloud services platforms. Connections can be made using an administrator account with the proper privileges to manage configurations. DryvIQ creates this connection using the OAuth 2.0 flow to simplify login and connection management.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Do not select the “Microsoft Office 365 GccH (OAuth 2.0 Deprecated)” connector. That connector is an old connector that uses CSOM, which Microsoft is deprecating. Select the “Microsoft Office 365 GccH” connector when creating the connection since it uses Microsoft Graph API, which results in better job performance. ","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Create Connection | User Interface","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"Connections","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Add connection","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"Microsoft Office 365 GccH","type":"text","marks":[{"type":"strong"}]},{"text":" as the platform on the Add connection modal.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the connection information. Reference the table below for details about each field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"Sign in with Microsoft Office 365 GccH","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the email for the account being used to create the connection and click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":". You must use an admin account with the proper privileges to manage Microsoft 365 configurations.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the password for the account and select ","type":"text"},{"text":"Sign in","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You will see a \"Connection test succeeded\" message on the Add connection modal. (If you don't see this message, repeat the sign-in and authorization steps above.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"Done","type":"text","marks":[{"type":"strong"}]},{"text":" to finish creating the connection.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Add Connection Modal - Microsoft Office 365 GccH","type":"text","marks":[{"type":"textColor","attrs":{"color":"#97a0af"}},{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":558,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":478,"type":"external","url":"https://skysync-documentation.s3.us-east-2.amazonaws.com/Connections/Authenticated+Connections/Connections+-+Create+Connection+-+Microsoft+Office+365+GCCH+OAuth+2.0.png","height":726}}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"0d571406-7c6c-4605-8346-b2e1dc19820c"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1127.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"Display as","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1127.0]},"content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not add a display name, the connection will automatically be named.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Optional ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"URL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1127.0]},"content":[{"type":"paragraph","content":[{"text":"Enter the URL of your Microsoft 365 GCC High account. ","type":"text"}]},{"type":"paragraph","content":[{"text":"You can find the URL by logging into Microsoft 365 GCC High using the account you want to use to create the connection. The URL in the address bar is the correct URL to use.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff5630"}},{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"Token endpoint","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1127.0]},"content":[{"type":"paragraph","content":[{"text":"This setting is rare for most Microsoft connections and can be left blank. Your administrator will provide this value if needed. ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Optional","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"Graph API endpoint","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1127.0]},"content":[{"type":"paragraph","content":[{"text":"This setting is rare for most Microsoft connections and can be left blank. Your administrator will provide this value if needed. ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Optional","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"External users notifications","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1127.0]},"content":[{"type":"paragraph","content":[{"text":"This setting indicates whether you want to send notifications to external users. The default value is ","type":"text"},{"text":"No","type":"text","marks":[{"type":"strong"}]},{"text":", so no notifications will be sent. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If you select ","type":"text"},{"text":"Yes","type":"text","marks":[{"type":"strong"}]},{"text":", notifications will be sent to external users when they have been granted access to content based on permissions.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Optional","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"Behavior When Deleting Items","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1127.0]},"content":[{"type":"paragraph","content":[{"text":"Select the delete DryvIQ should perform when deleting items: Permanent or Soft. ","type":"text"},{"text":"Soft","type":"text","marks":[{"type":"strong"}]},{"text":" delete is the default delete behavior; however, ","type":"text"},{"text":"Permanent","type":"text","marks":[{"type":"strong"}]},{"text":" is the recommended behavior.","type":"text"}]},{"type":"paragraph","content":[{"text":"A soft delete marks items as deleted. You can still access them to restore or permanently delete the items.","type":"text"}]},{"type":"paragraph","content":[{"text":"A permanent delete removes the items. This deletion is not reversible.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Optional","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Microsoft Sign In Modal","type":"text","marks":[{"type":"textColor","attrs":{"color":"#97a0af"}},{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":874,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":877,"type":"external","url":"https://skysync-documentation.s3.us-east-2.amazonaws.com/Connections/Authenticated+Connections/Connections+-+Create+Connection+-+Sharepoint+OAuth+2.0+Login.jpg","height":615}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Features and Limitations ","type":"text"}]},{"type":"paragraph","content":[{"text":"Platforms all have unique features and limitations. DryvIQ’s transfer engine manages these differences between platforms, allowing you to configure actions based on Job Policies and Behaviors. Utilize the ","type":"text"},{"text":"Platform Comparison","type":"text","marks":[{"type":"link","attrs":{"href":"http://skysync.atlassian.net/wiki/spaces/S4D/pages/514916381/Platform+Comparison"}}]},{"text":" tool to see how your integration platforms may interact regarding features and limitations. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Files/Folders","type":"text"}]},{"type":"paragraph","content":[{"text":"OneDrive for Business has the following file/folder restrictions:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1388.0,"localId":"2dac6863-f4dc-4ea0-9abd-115a25aa6cd1"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"Supported Features ","type":"text","marks":[{"type":"strong"}]},{"type":"emoji","attrs":{"id":"atlassian-check_mark","text":":check_mark:","shortName":":check_mark:"}}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Unsupported Features ","type":"text","marks":[{"type":"strong"}]},{"type":"emoji","attrs":{"id":"atlassian-cross_mark","text":":cross_mark:","shortName":":cross_mark:"}}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Other Features/Limitations ","type":"text","marks":[{"type":"strong"}]},{"type":"emoji","attrs":{"id":"atlassian-warning","text":":warning:","shortName":":warning:"}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"Version preservation","type":"text","marks":[{"type":"link","attrs":{"href":"https://dryviq.atlassian.net/wiki/spaces/S4D/pages/462684246"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Mirror lock ownership","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/JAAOE"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Invalid characters","type":"text","marks":[{"type":"link","attrs":{"href":"https://dryviq.atlassian.net/wiki/spaces/S4D/pages/514981948"}}]},{"text":": | \" \\ / : * ? < >","type":"text"},{"type":"hardBreak"},{"text":"(See ","type":"text"},{"text":"Invalid Characters and Spaces","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/spaces/SSP/pages/1539178591/Microsoft+Office+365+GCC+High+Create+a+Connection#Invalid-Characters-and-Spaces"}}]},{"text":" below.)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"Timestamp preservation","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/tAC5Hg"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"File size maximum","type":"text","marks":[{"type":"link","attrs":{"href":"https://dryviq.atlassian.net/wiki/spaces/S4D/pages/515080196"}}]},{"text":": 250 GB Microsoft limit","type":"text"},{"type":"hardBreak"},{"text":"DryvIQ uses a file size limit of 249.999999 GB to ensure seamless transfers. ","type":"text"},{"type":"hardBreak"},{"text":"(Refer to ","type":"text"},{"text":"HTML Files","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/spaces/S4D/pages/1599307779/Microsoft+Office+365+GCC+High#HTML-Files"}}]},{"text":" below for additional file size limitations.)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"Author/Owner preservation","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/pYBFB"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Segment path length","type":"text","marks":[{"type":"link","attrs":{"href":"https://dryviq.atlassian.net/wiki/spaces/S4D/pages/514981948"}}]},{"text":": N/A","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"File lock propagation","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/JAAOE"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Path length maximum","type":"text","marks":[{"type":"link","attrs":{"href":"https://dryviq.atlassian.net/wiki/spaces/S4D/pages/517406820"}}]},{"text":": 400","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"Account map","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/H4BsGg"}}]},{"type":"hardBreak"},{"text":"(See ","type":"text"},{"text":"Mapping ","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/spaces/SSP/pages/1539178591/Microsoft+365+Government+GCCH+High+Create+a+Connection#Mapping"}}]},{"text":"below.)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Restricted types","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/8AC9Hg"}}]},{"text":": N/A","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"Group map","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/H4BsGg"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Maximum number of files per folder: 5000 ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"Permissions preservation","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/AwCrJ"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Maximum Enterprise Keyword length: 255 characters ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"User impersonation","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/UIGLCw"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Restricted characters in Enterprise Keywords: < and >","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"Metadata map","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/GQGJCw"}}]},{"type":"hardBreak"},{"text":"(See ","type":"text"},{"text":"Metadata Mapping","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/spaces/SSP/pages/1539178591/Microsoft+365+Government+GCCH+High+Create+a+Connection#Metadata-Mapping"}}]},{"text":" below.)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"No leading whitespace ","type":"text"},{"type":"hardBreak"},{"text":"(See ","type":"text"},{"text":"Invalid Characters and Spaces","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/spaces/SSP/pages/1539178591/Microsoft+Office+365+GCC+High+Create+a+Connection#Invalid-Characters-and-Spaces"}}]},{"text":" below.)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph","content":[{"text":"Tags map","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/WABvGg"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"No trailing periods and whitespace. ","type":"text"},{"type":"hardBreak"},{"text":"(See ","type":"text"},{"text":"Invalid Characters and Spaces","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/spaces/SSP/pages/1539178591/Microsoft+Office+365+GCC+High+Create+a+Connection#Invalid-Characters-and-Spaces"}}]},{"text":" below.)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"If a file extension is present, trailing periods and whitespace are allowed before the extension","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"No non-printable ASCII characters","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[464.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[462.0]},"content":[{"type":"paragraph","content":[{"text":"Transferring ","type":"text"},{"text":"Microsoft Lists","type":"text","marks":[{"type":"link","attrs":{"href":"https://support.office.com/en-us/article/introduction-to-lists-0a1c3ace-def0-44af-b225-cfa8d92c52d7"}}]},{"text":" is not supported.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"File and Folder Name Restrictions","type":"text"}]},{"type":"paragraph","content":[{"text":"The following are restricted file/folder names.","type":"text"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":25.0},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"_vti_test","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CON","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PRN","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AUX","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NUL","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COM0","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COM1","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COM2","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COM3","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COM4","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COM5","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COM6","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COM7","type":"text"}]}]}]}]},{"type":"layoutColumn","attrs":{"width":25.0},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COM8","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COM9","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LPT0","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LPT1","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LPT2","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LPT3","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LPT4","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LPT5","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LPT6","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LPT7","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LPT8","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LPT9","type":"text"}]}]}]}]},{"type":"layoutColumn","attrs":{"width":25.0},"content":[{"type":"paragraph"}]},{"type":"layoutColumn","attrs":{"width":25.0},"content":[{"type":"paragraph"}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"For more information on OneDrive for Business restrictions, see Microsoft’s official ","type":"text"},{"text":"documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://support.office.com/en-us/article/invalid-file-names-and-file-types-in-onedrive-onedrive-for-business-and-sharepoint-64883a5d-228e-48f5-b3d2-eb39e07630fa"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Connection Pooling","type":"text"}]},{"type":"paragraph","content":[{"text":"Microsoft Office 365 connections using OAuth 2.0 authentication may experience bandwidth throttling from Microsoft when using ","type":"text"},{"text":"connection pooling","type":"text","marks":[{"type":"link","attrs":{"href":"https://dryviq.atlassian.net/wiki/spaces/S4D/pages/193265984"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Delta Job Runs","type":"text"}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"HTML Files","type":"text"}]},{"type":"paragraph","content":[{"text":"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 DryvIQ will add an entry in the audit log with the following message: \"Unable to interpret the contents of this page because it exceeds the maximum page size of 268435456 bytes.”","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Impersonation with Batch Mode","type":"text"}]},{"type":"paragraph","content":[{"text":"When using Impersonation with ","type":"text"},{"text":"Batch Mode","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/W4BOB"}}]},{"text":", SharePoint Online shows “System Account” in the activity rather than the impersonated user. ","type":"text"},{"text":"This formatting is expected behavior for batch mode/bulk migration API. ","type":"text","marks":[{"type":"strong"}]},{"text":"With batch mode off, the impersonated user will be displayed in the activity panel.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Invalid Characters and Spaces","type":"text"}]},{"type":"paragraph","content":[{"text":"DryvIQ verifies file and folder names to identify unsupported characters based on the platform. DryvIq handles invalid characters according to the ","type":"text"},{"text":"Allow unsupported file names to be changed ","type":"text","marks":[{"type":"strong"}]},{"text":"setting for the job. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":1034,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1034,"alt":"image-20241021-155117.png","id":"3e5ce584-b664-49b4-9673-c623c2ddc964","collection":"contentId-1599307779","type":"file","height":238}}]},{"type":"paragraph","content":[{"text":"If the setting is disabled, DryvIQ will throw an exception when it encounters a file or folder that it cannot migrate due to an unsupported character in the name. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If enabled, DyvIQ will replace invalid characters with an underscore (_) or UTF-8 encoding based on the option selected. This setting allows DryvIQ to transfer the files and folders. 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.","type":"text"}]},{"type":"paragraph","content":[{"text":"DryvIQ will sanitize file names that contain combined Unicode characters by replacing the characters with an underscore (_).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Language Translation","type":"text"}]},{"type":"paragraph","content":[{"text":"DryvIQ does not support translation when migrating between SharePoint sites that have different default language configurations.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Link Remediation","type":"text"}]},{"type":"paragraph","content":[{"text":"DryvIQ currently supports file-based links only for OneDrive and SharePoint, so DryvIQ will remediate links that point directly to documents (such as Word documents, Excel workbooks, and PowerPoint presentations). However, DryvIQ does not remediate links to folders or entire SharePoint sites. If your documents contain folder paths or site URLs, you’ll need to update those links manually after the migration to ensure they point to the correct location.","type":"text"}]},{"type":"table","attrs":{"layout":"align-start","width":1800.0,"localId":"2a7e86bc-f2f0-4b16-a331-2d1765ce8fb4"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[431.0]},"content":[{"type":"paragraph","content":[{"text":"Microsoft Link Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1368.0]},"content":[{"type":"paragraph","content":[{"text":"Microsoft Link Format","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[431.0]},"content":[{"type":"paragraph","content":[{"text":"Links to personal or user-owned files stored in the OneDrive document library","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1368.0]},"content":[{"type":"paragraph","content":[{"text":"-my.sharepoint.com/:w:/r/personal//_layouts/15/Doc.aspx?sourcedoc={}&file=&action=default&mobileredirect=true","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[431.0]},"content":[{"type":"paragraph","content":[{"text":"Links to team-based or site-owned files stored in libraries managed by SharePoint sites","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1368.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":">.sharepoint.com//","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":">.sharepoint.com//","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":">.sharepoint.com/_layouts/15/Doc.aspx?sourcedoc={}&action=","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":">.sharepoint.com/:x:/r/_layouts/15/Doc.aspx?sourcedoc={}&file=&action=&mobileredirect=true","type":"text"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Mapping","type":"text"}]},{"type":"paragraph","content":[{"text":"When creating ","type":"text"},{"text":"CSV mapping files","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/spaces/S4D/pages/647692658/Account+Map+Group+Map+CSV+File+Guidelines"}}]},{"text":" for import, usernames must be in lowercase to adhere to the search requirements of the connector properly.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Metadata Mapping","type":"text"}]},{"type":"paragraph","content":[{"text":"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 job runs. If you have files stuck in a flagged state due to missing metadata, you may need to transfer the files and add the required metadata manually. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"OneNote Files","type":"text"}]},{"type":"paragraph","content":[{"text":"Microsoft has specific standards regarding migrating OneNote files (defined in the ","type":"text"},{"text":"Microsoft documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://learn.microsoft.com/en-us/sharepoint/dev/apis/onenote-migration-service"}}]},{"text":"), and DryvIQ adheres to these standards. DryvIQ converts the OneNote files during the initial folder transfer. If a folder is a valid OneNote folder, DryvIQ will convert it to a OneNote file on Microsoft 365. The item status in the DryvIQ Platform will be “Revised” to indicate DryvIQ converted it. If it is not a valid OneNote folder, DryvIQ will not convert the folder and will transfer it as a regular folder to Microsoft 365. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Updates to the files will not result in the folder type changing, so DryvIQ will not update the folder type based on events in the folder after initial transfer. For example, if a folder contains a non-OneNote file, DryvIQ transfers it as a regular folder on the initial transfer. If you remove the non-OneNote files from the source folder, DryvIQ will not detect the change and will not attempt to convert the folder on subsequent job runs.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Timestamps","type":"text"}]},{"type":"paragraph","content":[{"text":"There is a discrepancy in ","type":"text"},{"text":"timestamps","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/tAC5Hg"}}]},{"text":" for the SharePoint Online Folder Created Date when using CSOM and ","type":"text"},{"text":"Batch Mode","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/W4BOB"}}]},{"text":". ","type":"text"},{"text":"This behavior is a known issue within OneDrive for Business/Office 365.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"DryvIQ will attempt to ","type":"text"},{"text":"preserve timestamps","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/tAC5Hg"}}]},{"text":" on folders when using both CSOM and the ","type":"text"},{"text":"batch API","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysync.atlassian.net/wiki/x/W4BOB"}}]},{"text":". However, SharePoint Online updates the folder's modified dates whenever a file is uploaded into it. As a result, when using CSOM, timestamps are preserved when the folder is initially created, but they are updated after every file that gets uploaded. When using the batch API, it preserves the timestamps on the folders after all of the files within the batch are committed. This process is the cause of the discrepancy between the two methods.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Version Deletes","type":"text"}]},{"type":"paragraph","content":[{"text":"Version deletes are supported. ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Corrupt Files","type":"text"}]},{"type":"paragraph","content":[{"text":"If you see “Error=Value=CobaltAllZerosDetected” errors in the logs, the file that triggered the error will not be uploaded to SharePoint Online. Microsoft produces this error for files it considers to be corrupt. ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Transfer Content to SharePoint Online Shared Document Library | Connection URI and Path Example","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PlatformType in Connection: office365","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"URI Pattern in Connection: ","type":"text"},{"text":"https://company.sharepoint.com/","type":"text","marks":[{"type":"link","attrs":{"href":"https://skysyncdesktop.sharepoint.com/"}}]},{"text":"[SiteNameWhereLibraryExists]/","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Target/Path in Job: Connection Config: /[LibraryName]","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This configuration will transfer data to the destination library specified. Connection will take it down to the site-specific level. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Path in the 'Job:Connection:Target' should be the Document Library.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the Library name found in the URI. You do not need to escape/encode spaces; enter a space if that exists in the library name.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"If a path is not specified, DryvIQ will transfer files to the default library for the site selected.","type":"text"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Create Connection | REST API","type":"text"}]},{"type":"paragraph","content":[{"text":"You will need to add the relevant connection information to the GET request. The following GET request will return a Microsoft login link. Use this link to complete logging into your account and grant DryvIQ access to the account. ","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET {{url}}v1/connections/platforms/office365-graph-gcch/new?domain={{YOUR URL}}&name={{YOUR CONNECTION NAME}}&client_id={{YOUR CLIENT ID}}&client_secret={{YOUR CLIENT SECRET}}","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Create Job | Impersonation with Admin Connection","type":"text"}]},{"type":"paragraph","content":[{"text":"As an Office 365 administrator, you can impersonate a user using the path that relates to their content. Then, use their information in the impersonate_as block. (See ","type":"text"},{"text":"Impersonation","type":"text","marks":[{"type":"link","attrs":{"href":"http://skysync.atlassian.net/wiki/spaces/S4D/pages/193691984/Impersonation"}}]},{"text":" for more information on how to impersonate users.)","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\":\"Basic job with impersonation\",\n \"kind\": \"transfer\",\n \"transfer\": {\n \"audit_level\": \"trace\",\n \"transfer_type\": \"copy\",\n \"source\": {\n \"connection\": { \"id\": \"{{source_connectionID}}\" },\n \"target\": {\n \"path\": \"/sourcePath\" \n }\n },\n \"destination\": {\n \"connection\": { \"id\": \"{{O365GCCH_destination_connectionID}}\" },\n \"impersonate_as\": {\n \"id\": \"00\",\n \"name\": \"Joe Smith\",\n \"email\": \"jsmith@company.onmicrosoft.com\"\n },\n \"target\": {\n \"path\": \"/destinationPath\"\n }\n },\n \"simulation_mode\": false\n },\n \"schedule\": {\n \"mode\": \"manual\"\n },\n \"stop_policy\": {\n \"on_success\": 5,\n \"on_failure\": 5,\n \"on_execute\": 25\n },\n \"category\": {\n \"name\": \"category name\"\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}