Migration Assessment Scan: Apps

Learn how to mitigate issues with SharePoint add-ins during migration.

Overview

Migrating SharePoint add-ins (formerly called apps) isn’t supported in the target environment. The site content will be migrated, but the add-ins will not. As a result, once the site is migrated, the add-ins will need to be reinstalled. If you purchased the add-in, you will need to reclaim the license from the Add-in store.

Data Migration

Site content will be migrated, but add-ins will need to be installed on the destination environment. If any add-ins stored data in the SharePoint App-web, that data will be orphaned and the add-in will be reinstalled cleanly.

Important: Any site that is configured as “No Access” (locked), in SharePoint will be skipped. To see a list of locked site collections see the Locked Sites scan output.

Preparing for Migration

Read through the provided report.

Post Migration

Site owners will need to reinstall the add-in during the user acceptance testing (UAT) process. If there was an add-in that was purchased, the user who purchased the add-in will need to recover the license.

Scan Result Reports

The following table describes the columns in the Apps-detail.csv report.

This scan report provides a list of all the add-ins installed in the environment.

Column

Description

SiteId

Unique identifier of the impacted site collection.

SiteURL

URL to the impacted site collection.

SiteOwner

Owner of the site collection.

SiteAdmins

List of people listed as site collection administrators.

SiteSizeInMB

Size of the size collection in megabytes [MB]

NumOfWebs

Number of webs that exist in the site collection.

ContentDBName

Name of the content database hosting the site collection.

ContentDBServerName

SQL Server hosting the content database.

ContentDBSizeInMB

Size of the content database hosting the site collection.

LastContentModifiedDate

Date/Time the site collection had content modified.

TotalItemCount

Total number of items found in the site collection.

Hits

Number of requests logged for the site collection. Relies on data from the usage logging service. If the usage logging service is disabled this row will show N/A.

DistinctUsers

Number of distinct users that have accessed the site collection. Relies on data from the usage logging service. If the usage logging service is disabled this row will show N/A.

DaysOfUsageData

Number of days the usage logging service retains data. This provides context for Hits and DistinctUsers. For example, if this is 14 days, the Hits and DistinctUsers data is for the last 14 days.

OwnerLogin

Owner of the site collection. [duplicate of Site Owner column]

OwnerTitle

Display name for the owner.

AppTitle

Title of the add-in.

AppSource

This is the location the application was installed from.

AppID

ID assigned to the add-in.

WebID

ID or the web hosting the add-in.

LaunchURL

URL used to launch the add-in. If this URL is ~appWebUrl, then the add-in runs on the SharePoint environment. If the URL is not associated with the SharePoint environment, then the add-in is a provider-hosted add-in that runs outside of the environment.

CreationTime

Time the add-in was installed.

RemoteAppURL

If the add-in is a provider-hosted add-in, this will contain the URL for the add-in.

SettingsPageURL

URL for the settings page associated with an add-in.

WebSiteTitle

Title of the web hosting the add-in.

WebURL

URL of the webhosting the add-in.

PageURL

If the add-in is an app part that sites on a page, this will be the URL to the page.

ScanID

Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool.

Connect with an expert
Contact us
Expand your skills
Explore training

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×