Analyse de l’évaluation de la migration : URL OneDrive longues
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.docxLe 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/Folder2Le 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.docxLe 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. |