Analyse de l’évaluation de la migration : URL OneDrive longues

Article
09/03/2023

Découvrez comment résoudre les problèmes liés aux URL OneDrive longues pendant la migration.

Vue d'ensemble

Lorsque vous déplacez un site OneDrive de votre source vers l’environnement cible, l’URL OneDrive change de format. Sur la plateforme source, les sites OneDrive sont au format .https://onedrive.contoso.com/personal/domain_user Sur la plateforme cible, la partie Domain_User de l’URL change pour utiliser l’UPN pour l’utilisateur. Cela ressemble à https://onedrive.contoso.com/personal/user_contoso_com.

Exemple :

Si vous avez utilisé ce fichier :

https://OneDrive.contoto.com/personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

Le nom du répertoire du fichier est le suivant :

Personal/contoso_bobsmith/Documents/Folder1/Folder2

Remarque

Dans SharePoint, le chemin d'accès du répertoire au fichier est limité à 400 caractères.

Après la migration, le chemin d'accès du fichier se présente comme suit.

Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

Notez que l’URL comporte désormais quatre caractères de plus qu’auparavant. Selon la manière dont votre entreprise définit les noms d'utilisateurs principaux, le changement de longueur peut être plus important.

Si le fichier précédent dans l’environnement source contenait 255 caractères, sa longueur après la migration serait de 259 caractères.

Nous avons identifié quatre emplacements différents dans lesquels des défaillances sont susceptibles de se produire en raison de longues URL. Par conséquent, nous avons quatre rapports différents concernant les URL longues. La section Rapports de résultats d'analyse couvre chaque rapport, de même que les corrections à apporter.

Migration des données

La migration du contenu source entraînant l’échec des URL longues. Cela entraîne l’échec des travaux de migration, ce qui prolongera inutilement le projet de migration.

Importante

Tout site configuré sur « Pas d'accès » (verrouillé) dans SharePoint est ignoré. Pour afficher la liste des collections de sites verrouillés, reportez-vous aux données d'analyse Sites verrouillés.

Préparation à la migration

Examinez les rapports et suivez les corrections recommandées pour chaque rapport. En règle générale, ces corrections impliquent le déplacement du contenu plus près de la racine de la collection de sites.

Après la migration

Vérifiez que votre contenu a migré.

Rapports de résultats d'analyse

Cette analyse génère quatre fichiers de sortie. Chaque fichier correspond à un problème d'URL trop longue spécifique entraînant des échecs de migration. LongODBUrl-AllDocs-detail.csv Deux limites s'appliquent à la longueur du chemin d'accès d'un fichier donné :

Le chemin d’accès relatif du serveur au dossier contenant le fichier comporte un maximum de 400 caractères. Dans l'exemple de fichier ci-dessous :

https://OneDrive.contoto.com/Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

Le nom du répertoire est le suivant : Personal/contoso_bobsmith/Documents/Folder1/Folder2.

Après la migration, le chemin d'accès du fichier se présente comme suit. Notez que l’URL est désormais plus longue que précédemment.Personal/bobsmith_contoso_com/Documents/Folder1/Folder2
Le chemin d’accès relatif du serveur à un fichier ou dossier comporte un maximum de 400 caractères. Dans l'exemple de fichier ci-dessous :

https://OneDrive.contoto.com/Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

Le chemin d’accès relatif du serveur au fichier ressemble à ce qui suit : Personnel/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

Si des fichiers sont répertoriés dans ce rapport, les propriétaires doivent déplacer les fichiers vers des chemins plus courts ou supprimer les fichiers. Par exemple, ils peuvent déplacer ProjectA.docx vers un dossier directement sous Documents, ou supprimer le fichier s’il n’est plus nécessaire.

Colonne	Description
SiteId	Identificateur unique de la collection de sites concernée.
SiteURL	URL de la collection de sites concernée.
SiteOwner	Propriétaire de la collection de sites.
SiteAdmins	Liste des personnes répertoriées comme administrateurs de collection de sites.
SiteSizeInMB	Taille de la collection de sites, en mégaoctets (Mo).
NumOfWebs	Nombre de sites web figurant dans la collection de sites.
ContentDBName	Nom de la base de données de contenu qui héberge la collection de sites.
ContentDBServerName	Instance de SQL Server qui héberge la base de données de contenu.
ContentDBSizeInMB	Taille de la base de données de contenu qui héberge la collection de sites.
LastContentModifiedDate	Date/heure de modification du contenu de la collection de sites.
TotalItemCount	Nombre total d'éléments figurant dans la collection de sites.
Affichages	Nombre de requêtes consignées pour la collection de sites. Repose sur les données du service de journalisation de l'utilisation. Si le service de journalisation de l’utilisation est désactivé, cette ligne affiche N/A.
DistinctUsers	Nombre d'utilisateurs distincts qui ont accédé à la collection de sites. Repose sur les données du service de journalisation de l'utilisation. Si le service de journalisation de l’utilisation est désactivé, cette ligne affiche N/A.
DaysOfUsageData	Nombre de jours pendant lesquels le service de journalisation de l'utilisation conserve les données. Fournit du contexte aux paramètres Hits et DistinctUsers. Par exemple, si ce nombre est de 14 jours, les données des paramètres Hits et DistinctUsers concernent les 14 derniers jours.
UPN	Nom d'utilisateur principal utilisé pour déterminer la différence de longueur de l'URL. Si l’UPN est « **** », ce qui indique que le propriétaire n’a pas défini de UserPrincipalName dans son profil SharePoint. Dès lors, la longueur moyenne des valeurs UserPrincipalName du magasin de profils SharePoint a été utilisée.
URLLengthDifference	Montant que l’URL augmente lorsque le site est renommé.
Fichier	Fichier devant être corrigé.
ScanID	Identificateur unique attribué à une exécution spécifique de l'outil d'évaluation de la migration SharePoint.

LongODBUrl-NavNodes-detail.csv Les nœuds de navigation présentent une limite de longueur d'URL de 260 caractères. Dès lors, le champ d'URL peut dépasser la longueur maximale.

Prenons l'exemple d'un site OneDrive situé sous https://OneDrive.contoso.com/personal/contoso_bobsmith. Ce site possède un lien dans la barre d'outils Lancement rapide et l'URL de ce lien pointe sur https://onedrive.contoso.com/personal/contoso_bobsmith/documents/folder1/...folderN/Reports. Pendant la migration, SharePoint met à jour l’URL pour pointer vers /bobsmith_contoso_com/. La longueur supplémentaire ajoutée à l’URL peut entraîner une longueur supérieure à 260 caractères, ce qui entraînera l’échec de la migration.

Pour y remédier, déplacez le dossier des rapports près de la racine de la bibliothèque /documents/, puis mettez à jour le lien dans la barre d'outils Lancement rapide. Vous pouvez également supprimer le lien de la barre d'outils Lancement rapide.

Colonne	Description
SiteId	Identificateur unique de la collection de sites concernée.
SiteURL	URL de la collection de sites concernée.
SiteOwner	Propriétaire de la collection de sites.
SiteAdmins	Liste des personnes répertoriées comme administrateurs de collection de sites.
SiteSizeInMB	Taille de la collection de sites, en mégaoctets (Mo).
NumOfWebs	Nombre de sites web figurant dans la collection de sites.
ContentDBName	Nom de la base de données de contenu qui héberge la collection de sites.
ContentDBServerName	Instance de SQL Server qui héberge la base de données de contenu.
ContentDBSizeInMB	Taille de la base de données de contenu qui héberge la collection de sites.
UPN	Nom d'utilisateur principal utilisé pour déterminer la différence de longueur de l'URL. Si l’UPN est « **** », ce qui indique que le propriétaire n’a pas défini de UserPrincipalName dans son profil SharePoint. Dès lors, la longueur moyenne de la valeur UserPrincipalName du magasin de profils SharePoint a été utilisée.
URLLengthDifference	URLLengthDifference Quantité l’URL augmente lorsque le site est renommé.
WebURL	URL du site web contenant le nœud de navigation.
NavigationNodeLocation	Titres des nœuds de navigation indiquant l'endroit où se trouve le nœud de navigation. Vous pouvez disposer de plusieurs niveaux de nœuds de navigation, ce qui permet de mieux identifier le nœud posant problème.
NavigationNodeTitle	Titre du nœud de navigation concerné.
NavigationNodeURL	URL trop longue après que le site ait été renommé.
ScanID	Identificateur unique attribué à une exécution spécifique de l'outil d'évaluation de la migration SharePoint.

LongODBUrl-Perms-detail.csv Dans SharePoint, les autorisations définies sur un objet sont suivies par l'URL de cet objet. Si vous définissez des autorisations sur un dossier, SharePoint stocke le chemin d’accès relatif au dossier. Si vous définissez des autorisations sur un élément, SharePoint stocke le chemin d’accès relatif du serveur à l’élément.

Par conséquent, lors d’une migration de site, les URL associées aux autorisations sont mises à jour. Cela peut entraîner des échecs si la nouvelle URL est trop longue.

Pour y remédier, il suffit de déplacer l'objet concerné plus près de la racine de la collection de sites. Une autre solution consiste à supprimer les autorisations distinctes des éléments du rapport.

Colonne	Description
SiteId	Identificateur unique de la collection de sites concernée.
SiteURL	URL de la collection de sites concernée.
SiteOwner	Propriétaire de la collection de sites.
SiteAdmins	Liste des personnes répertoriées comme administrateurs de collection de sites.
SiteSizeInMB	Taille de la collection de sites, en mégaoctets (Mo).
NumOfWebs	Nombre de sites web figurant dans la collection de sites.
ContentDBName	Nom de la base de données de contenu qui héberge la collection de sites.
ContentDBServerName	Instance de SQL Server qui héberge la base de données de contenu.
ContentDBSizeInMB	Taille de la base de données de contenu qui héberge la collection de sites.
UPN	Nom d'utilisateur principal utilisé pour déterminer la différence de longueur de l'URL. Si l’UPN est « **** », ce qui indique que le propriétaire n’a pas défini de UserPrincipalName dans son profil SharePoint. Dès lors, la longueur moyenne de la valeur UserPrincipalName du magasin de profils SharePoint a été utilisée.
URLLengthDifference	Longueur de l'URL une fois le site renommé.
WebURL	URL du site web hébergeant l'objet sécurisé.
SecuredObject	URL de l'objet sécurisé trop longue une fois le site renommé. Si vous ajoutez des autorisations à un fichier, il s'agit du chemin d'accès relatif du serveur au fichier. Si vous définissez des autorisations pour un dossier, il s'agit du chemin d'accès relatif du serveur au dossier.
ScanID	Identificateur unique attribué à une exécution spécifique de l'outil d'évaluation de la migration SharePoint.

LongODBUrl-Deps-detail.csv Certains fichiers peuvent avoir d’autres dépendances. Ces dépendances sont suivies par l'URL. Pendant la migration, si les informations de dépendance sont trop longues, la migration échoue.

Dans ce rapport, deux limitations existent :

FullURL présente une limite de 260 caractères. Il s'agit du fichier avec les dépendances. Pour corriger une valeur FullURL trop longue, supprimez le fichier ou déplacez-le plus près de la racine de la collection de sites.
DependencyDescription présente une limite de 270 caractères. Il s'agit de la dépendance associée à la valeur FullURL. Pour corriger la valeur DependencyDescription, supprimez la dépendance ou déplacez-la plus près de la racine de la collection de sites.

Colonne	Description
SiteId	Identificateur unique de la collection de sites concernée.
SiteURL	URL de la collection de sites concernée.
SiteOwner	Propriétaire de la collection de sites.
SiteAdmins	Liste des personnes répertoriées comme administrateurs de collection de sites.
SiteSizeInMB	Taille de la collection de sites, en mégaoctets (Mo).
NumOfWebs	Nombre de sites web figurant dans la collection de sites.
ContentDBName	Nom de la base de données de contenu qui héberge la collection de sites.
ContentDBServerName	Instance de SQL Server qui héberge la base de données de contenu.
ContentDBSizeInMB	Taille de la base de données de contenu qui héberge la collection de sites.
UPN	Nom d'utilisateur principal utilisé pour déterminer la différence de longueur de l'URL. Si l’UPN est « **** », cela indique que le propriétaire n’a pas défini de UserPrincipalName dans son profil SharePoint. Dès lors, la longueur moyenne de la valeur UserPrincipalName du magasin de profils SharePoint a été utilisée.
URLLengthDifference	Longueur de l'URL une fois le site renommé.
FullURL	URL du fichier contenant les dépendances.
DependencyDescription	Description de la valeur DependencyDescription associée à la dépendance. Il peut s'agir d'une URL à laquelle un nouveau nom est en cours d'attribution.
ScanID	Identificateur unique attribué à une exécution spécifique de l'outil d'évaluation de la migration SharePoint.