#SharePoint Online and OneDrive

Refer to the following sections on how to search for and restore the archived content for SharePoint Online and OneDrive.

#Search for Archived Content

Refer to the following sections on how to search for the archived content for SharePoint Online and OneDrive.

#Via Search

To search for the archived site collections, under the Search tab, configure the following criteria, and then click Search. Search results are displayed.

• Content source – Select SharePoint Online and OneDrive.

• Object level – Select Site collection from the drop-down list.

• URL – Enter full or partial site collection ULR.

To search for the archived sites, lists/libraries, folders, or items, under the Search tab, configure the following criteria, and then click Search. Search results are displayed.

• Content source – Select SharePoint Online and OneDrive.

• Object level – Select an object level from the drop-down list.

• URL – Select a URL from the drop-down list.

• Name – Enter the name of the object.

To search for the archived documents or document versions, under the Search tab, configure the following criteria, and then click Search. Search results are displayed.

• Content source – Select SharePoint Online and OneDrive.

• Object level – Select an object level from the drop-down list.

• URL – Select a URL from the drop-down list.

• Name – Enter the name of the object.

• Created time – For the Document/Document version object level, you can specify a time range. Documents that were created within the time range will be searched out.

• Modified time – For the Document/Document version object level, you can specify a time range. Documents or document versions whose modified time is within the time range will be searched out.

• Created by – For the Document/Document version object level, you can specify a time range. Documents or document versions that were created within the time range will be searched out.

• Modified by – For the Document/Document version object level, you can specify a user. Documents or document versions that were modified by the user will be searched out.

• Archived time – For the Document/Document version object level, you can specify a date range. Documents or document versions that were archived within the date range will be searched out.

• Job ID – For the Document/Document version object level, you can enter a job ID. Documents or document versions that were archived by the job will be searched out.

• Soft deleted – For the Document/Document version object level, you can select an option from the drop-down list to filter documents or document versions that have been soft deleted or not.

  Please contact AvePoint Support to enable this feature in the backend if you want to use it. It is unavailable for AvePoint Storage.

If you want to restore all search results at one time, instead of scrolling through pages, you can click Select all search results below the table.

#Via Full Text Search

Opus supports the full-text search feature, allowing you to search for archived documents or document versions by their name and content.

To begin with, click Inclusion &exclusion lists to specify site collections where archived files will be able to be searched by their content. Use the inclusion list to enable content search only for specific site collections or use the exclusion list to exclude specific site collections from content search, leaving all other site collections searchable. Select a list type and then add site collection URLs. You can also export and import site collection URLs to the list. AvePoint Opus automatically runs a Full text index creation (Archive) job (at any time from 00:00 to 2:00 a.m. each day) to index the archived documents or document versions for search after you add the site collections.

In the eDiscovery tab, select a preferred search mode to search for archived documents or document versions:

• Simple search – In a simple search, you can search for archived documents using basic search criteria:

  • Keyword – Search for archived documents by their name, content, or custom metadata. The supported column types are: Single line of text, Multiple lines of text, Choice, Location, and Hyperlink or Picture.

  • Archived time – Search for archived documents by their archived time.

    Enter a value in the text box and then click the Search button. Search results are displayed.

• Advanced search – If you want to set multiple search criteria, click Advanced search to open the Advanced search mode. Configure the following search criteria, and click Search. Search results are displayed.

  • URL – The URLs of the archived site collections are displayed. Select a site collection from the drop-down list.

  • Object level – Select Document or Document version from the drop-down list.

  • Name – Enter the name of the document or document version.

  • Created time – Specify a time range. Documents or document versions created within the time range will be searched out.

  • Modified time – Specify a time range. Documents or document versions whose modified time is within the time range will be searched out.

  • Archived time – Specify a time range. Documents or document versions archived within the time range will be searched out.

  • Content – Enter keywords to search for the archived documents or document versions by their content.

  • Custom metadata – Enter keywords to search for the archived documents or document versions by their metadata.

    The supported column types: Single line of text, Multiple lines of text, Choice, Location, and Hyperlink or Picture.

To export search results, click Export searchresults and then click OK. An Export search results in Restore center job will start, and you can navigate to Job monitor to view details. A download process will start in Download center. When the download process is completed, you can download the file by clicking Download.

#Manage Site Mappings

Before performing a restore, you can configure site mappings between source and destination site collections to handle site collection URL changes. Make sure the source and destination site collections belong to the same content source.

Click Site mappings and perform one of the following actions:

• Add mapping – Add mappings individually.

• Export – Export all existing mappings locally.

• Import – Import mappings in bulk by configuring the mapping information in an Excel file and browsing the configured file to Opus. When importing site mappings, you can now choose whether to overwrite existing site mappings.

#Restore Archived Content

To restore the archived content, select the archived content that you want to restore, and click Restore to open the Restore page. There are three restore types:

• In place restore – This option will return the archived content to the original locations.

  There are some limitations:

  • The stub left in SharePoint will be automatically deleted after the original document has been restored.

  • If a OneDrive site collection has been deleted in Microsoft 365, you cannot restore the OneDrive and all content within via the in place restore type.

  • AvePoint Opus does not support restoring Teams private or shared channel site collections and all content within via the in place restore type.

  • AvePoint Opus does not support restoring Teams channel folders and all content within via the in place restore type.

• Restore to storage location – This option will allow you to restore the archived content to a storage location. The restored content will be compressed into a .zip file protected with a password. You need to use the password to extract the .zip file.

• Restore to a library or folder – When Object level is set to Document, Document version, or Folder, this option will be available. This option allows you to restore the archived content to a specified library or folder in SharePoint Online/OneDrive.

#In Place Restore

Refer to the following steps to restore the archived content to the original location:

1. Restore type – Select In place restore.

2. Document versions – Enter a number to define the number of latest versions to restore or choose to restore all versions. Note that this option will be available when you choose to restore documents.

3. Conflict resolution – If the name of an archived item/document is the same as that of an existing item in the destination, a conflict will occur. Conflicts can be addressed in three ways:

   • Overwrite – This will replace the existing item/document in the destination with the archived item/document.

   • Skip – This will not restore the archived item/document, and instead keep the existing item/document in the destination.

   • Append – This will keep the original item/document as it is and copy the archived item/document to the original location by adding a suffix (_1, _2, _3, …) to the item title/document name.

4. Apps conflict resolution – If the instance ID of an archived app is the same as that of an existing app in the destination, a conflict will occur. Conflicts can be addressed in two ways:

   • Overwrite will replace the existing app in the destination with the archived app.

   • Skip will not restore the archived app, and instead keep the existing app in the destination.

5. Configure additional options:

   • Include workflow definition – Choose whether to restore the definition of existing workflows for the selected content.

   • Include sharing link – Specify whether to restore sharing links for the content. After the restore, the sharing links will be changed, and OneDrive users can navigate to OneDrive > Shared library to view the content shared with you and shared by you. The links generated by the Copy link function in Microsoft 365 are also regarded as sharing links.

     NOTE

     Currently, the original sharing link's permissions are preserved on the restored file, but the URL itself is not. The restored file will have a completely new sharing link. As a result, the original sharing link will no longer be valid or accessible.

   • Designate a site administrator for the site (only one user account is permitted) – When Object level is set to Site collection, this setting will be available. Choose if you want to assign a specific Microsoft 365 user to the Site admins group of the site collection you are going to restore. After enabling it, enter keywords of the Microsoft 365 user account, and then select the target user from the suggestion list.

6. Priority – AvePoint Opus allows up to four jobs to run concurrently, excluding Enforce Rule Actions jobs. Any additional jobs that are waiting to be executed will appear on the Job queue page. As soon as one of the running jobs completes, the next job in the queue will begin automatically. By default, this job is assigned with normal priority. If you need it to run before others in the queue, you can change its priority.

7. Click Save to save the configured settings. An In place restore job will start to restore the content.

#Restore to Storage Location

Refer to the following steps to restore the archived content to a storage location:

1. Restore type – Select Restore to a library or folder, and then enter the full path of the destination location.

2. Document versions – Enter a number to define the number of latest versions to restore or choose to restore all versions. Note that this option will be available when you choose to restore documents.

3. Storage location – Select a storage location to restore the archived content to.

4. Users/groups to receive email notifications – Enter the names of users or groups who will receive an email notification.

5. Click Save to save the configured settings. A Restore to storage location job will start to restore the content.

6. After the Restore to storage location job is completed, the restored content will be compressed into a .zip file protected with a password. An email notification containing the password will be sent to you. You can use the password to extract the .zip file.

#Restore to Library or Folder

Refer to the following steps to restore the archived content to a library or folder in SharePoint Online/OneDrive:

1. Restore type – Select Restore to a library or folder and enter the full URL of the location to restore the archived content. This option will be available only when Object level is set to Document, Document version, or Folder.

2. Document versions – Enter a number to define the number of latest versions to restore or choose to restore all versions. Note that this option will be available when you choose to restore documents.

3. Conflict resolution – If the name of an archived item/document is the same as that of an existing item in the destination, a conflict will occur. Conflicts can be addressed in three ways:

   • Overwrite – This will replace the existing item/document in the destination with the archived item/document.

   • Skip – This will not restore the archived item/document, and instead keep the existing item/document in the destination.

   • Append – This will keep the original item/document as it is and copy the archived item/document to the original location by adding a suffix (_1, _2, _3, …) to the item title/document name.

4. Apps conflict resolution – If the instance ID of an archived app is the same as that of an existing app in the destination, a conflict will occur. Conflicts can be addressed in two ways:

   • Overwrite will replace the existing app in the destination with the archived app.

   • Skip will not restore the archived app, and instead keep the existing app in the destination.

5. Configure additional options:

   • Include workflow definition – Choose whether to restore the definition of existing workflows for the selected content.

   • Include sharing link – Specify whether to restore sharing links for the content. After the restore, the sharing links will be changed, and OneDrive users can navigate to OneDrive > Shared library to view the content shared with you and shared by you. The links generated by the Copy link function in Microsoft 365 are also regarded as sharing links.

     NOTE

     Currently, the original sharing link's permissions are preserved on the restored file, but the URL itself is not. The restored file will have a completely new sharing link. As a result, the original sharing link will no longer be valid or accessible.

6. Priority – AvePoint Opus allows up to four jobs to run concurrently, excluding Enforce Rule Actions jobs. Any additional jobs that are waiting to be executed will appear on the Job queue page. As soon as one of the running jobs completes, the next job in the queue will begin automatically. By default, this job is assigned with normal priority. If you need it to run before others in the queue, you can change its priority.

7. Click Save to save the configured settings. A job will start to restore the content.

#Specifications on Document Version Restoration

When restoring document versions, Opus preserves the version count (the number of historical versions) but does not preserve the original version numbers. The restored document's version history will be renumbered starting from the current version.

The restore results of document versions will be affected by the following conditions:

• Whether a document with the same name already exists in the destination

• Whether the current version is included in the restore scope

• The conflict resolution selected in the restore settings

When no document with the same name exists in the destination, the selected file versions will be restored, regardless of the conflict resolution you select.

When a document with the same name already exists in the destination, refer to the table below for details.

Whether the current version is included?	Selected Conflict Resolution	Restore Results
Does not include	Skip	The selected file version will be skipped in the restore and no changes will be made in SharePoint.
Does not include	Overwrite	The selected file version will be skipped in the restore and no changes will be made in SharePoint.
Does not include	Append	The selected file version will be added as a new version to the file in SharePoint.
Include	Skip	The selected file versions will be skipped in the restore and no changes will be made in SharePoint.
Include	Overwrite	The existing file in SharePoint will be deleted and the selected file versions in the scope will be restored to SharePoint.
Include	Append	A new file will be newly created in SharePoint with a suffix behind the current file name. For example, the current file name is file A, the newly created file will be named as file A_1 in the first restore, named as file A_2 in the next restore, etc. Other selected versions will be restored as history versions of the newly created file.