Analisi di valutazione della migrazione: URL di OneDrive

Informazioni su come risolvere i problemi relativi agli URL di OneDrive durante la migrazione.

Panoramica

Quando si sposta un sito di OneDrive dall'origine all'ambiente di destinazione, l'URL di OneDrive cambia i formati. Nella piattaforma di origine i siti di OneDrive sono nel formato https://onedrive.contoso.com/personal/domain_user. Nella piattaforma di destinazione, la parte Domain_User dell'URL cambia per usare l'UPN per l'utente. L'aspetto è simile a https://onedrive.contoso.com/personal/user_contoso_com.

Esempio:

Se è stato usato il file:

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

Il nome della directory del file sarà:

Personal/contoso_bobsmith/Documents/Folder1/Folder2

Nota

Esiste un limite di 400 caratteri per il percorso directory di un file in SharePoint.

Dopo la migrazione, il percorso file risulterà analogo al seguente.

Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

Si noti che l'URL è ora quattro caratteri più lungo di prima. A seconda di come vengono formati gli UPN nella società, la modifica alla lunghezza potrebbe essere maggiore.

Se il file precedente nell'ambiente di origine conteneva 255 caratteri, la lunghezza dopo la migrazione sarà di 259 caratteri.

Sono state identificate quattro posizioni diverse in cui è probabile che si verifichino errori a causa di URL lunghi. Di conseguenza, sono disponibili quattro diversi report relativi agli URL lunghi. La sezione Report dei risultati dell'analisi descrive ogni report insieme alla correzione da applicare.

Migrazione dei dati

La migrazione del contenuto di origine risultante negli URL lunghi ha esito negativo. Ciò causa l'esito negativo dei processi di migrazione, che prolungheranno inutilmente il progetto di migrazione.

Importante

[!IMPORTANTE] Qualsiasi sito configurato come "Nessun accesso" (bloccato) in SharePoint verrà ignorato. Per visualizzare un elenco di raccolte siti bloccate, vedere l'output di analisi Siti bloccati.

Preparazione per la migrazione

Esaminare i report e applicare la correzione consigliata per ogni report. In generale, la correzione comprende l'avvicinamento del contenuto alla radice della raccolta siti.

Post-migrazione

Verificare che sia stata eseguita la migrazione del contenuto.

Analizzare i report dei risultati

Questa analisi genera quattro file di output. Ogni file riguarda uno specifico problema relativo agli URL lunghi che causa errori di migrazione. LongODBUrl-AllDocs-detail.csv Esistono due limitazioni per la lunghezza del percorso di un determinato file:

  • Il percorso relativo del server alla cartella contenente il file ha un massimo di 400 caratteri. Se si usa il file di esempio seguente:

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

    Il nome della directory sarà:Personal/contoso_bobsmith/Documents/Folder1/Folder2.

    Dopo la migrazione, il percorso file risulterà analogo al seguente. L'URL attuale è più lungo del precedente: Personal/bobsmith_contoso_com/Documents/Folder1/Folder2.

  • Il percorso relativo del server a un file o a una cartella ha un massimo di 400 caratteri. Se si usa il file di esempio seguente:

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

    Il percorso relativo del server al file è simile al seguente: Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

Se in questo report sono elencati file, i proprietari devono spostare i file in percorsi più brevi o eliminare i file. Ad esempio, è possibile spostare ProjectA.docx in una cartella direttamente in Documenti oppure eliminare il file se non è più necessario.

Colonna Descrizione
SiteId Identificatore univoco della raccolta siti interessata.
SiteURL URL della raccolta siti interessata.
SiteOwner Proprietario della raccolta siti.
SiteAdmins Elenco di utenti indicati come amministratori della raccolta siti.
SiteSizeInMB Dimensioni della raccolta siti in megabyte [MB]
NumOfWebs Numero di Web esistenti nella raccolta siti.
ContentDBName Nome del database del contenuto che ospita la raccolta siti.
ContentDBServerName Sistema SQL Server che ospita il database del contenuto.
ContentDBSizeInMB Dimensioni del database del contenuto che ospita la raccolta siti.
LastContentModifiedDate Data/ora di modifica del contenuto della raccolta siti.
TotalItemCount Numero totale di elementi trovati nella raccolta siti.
Hits Numero di richieste registrate per la raccolta siti. Si basa sui dati del servizio di registrazione dei dati di utilizzo. Se il servizio di registrazione dell'utilizzo è disabilitato, questa riga mostra N/D.
DistinctUsers Numero di utenti distinti che hanno eseguito l'accesso alla raccolta siti. Si basa sui dati del servizio di registrazione dei dati di utilizzo. Se il servizio di registrazione dell'utilizzo è disabilitato, questa riga mostra N/D.
DaysOfUsageData Numero di giorni per cui il servizio di registrazione dei dati di utilizzo conserva i dati. Fornisce il contesto per Hits e DistinctUsers. Ad esempio, se corrisponde a 14 giorni, i dati di Hits e DistinctUsers riguardano gli ultimi 14 giorni.
UPN UPN usato per determinare la differenza di lunghezza dell'URL. Se l'UPN è "****" che indica che il proprietario non ha un userPrincipalName impostato nel profilo di SharePoint. Di conseguenza, è stata usata la lunghezza media dei valori UserPrincipalName nell'archivio profili di SharePoint.
URLLengthDifference Quantità di aumento dell'URL quando il sito viene rinominato.
File File da correggere.
ScanID Identificatore univoco assegnato a una specifica esecuzione dello strumento di valutazione della migrazione di SharePoint.

LongODBUrl-NavNodes-detail.csv I nodi di navigazione hanno un limite di lunghezza dell'URL di 260 caratteri. È quindi possibile che il campo dell'URL superi la lunghezza massima.

Ad esempio, un sito di OneDrive è disponibile in https://OneDrive.contoso.com/personal/contoso_bobsmith. Questo sito ha un collegamento nella barra di avvio veloce denominato Report e l'URL del collegamento punta a https://onedrive.contoso.com/personal/contoso_bobsmith/documents/folder1/...folderN/Reports. Durante la migrazione, SharePoint aggiorna l'URL in modo che punti a /bobsmith_contoso_com/. La lunghezza aggiuntiva aggiunta all'URL può comportare una lunghezza superiore a 260 caratteri, il che causerà l'esito negativo della migrazione.

Per risolvere questo problema, è possibile spostare la cartella dei report vicino alla radice della raccolta /documents/, quindi aggiornare il collegamento nella barra di avvio veloce. In alternativa, è possibile rimuovere il collegamento nella barra di avvio veloce.

Colonna Descrizione
SiteId Identificatore univoco della raccolta siti interessata.
SiteURL URL della raccolta siti interessata.
SiteOwner Proprietario della raccolta siti.
SiteAdmins Elenco di utenti indicati come amministratori della raccolta siti.
SiteSizeInMB Dimensioni della raccolta siti in megabyte [MB]
NumOfWebs Numero di Web esistenti nella raccolta siti.
ContentDBName Nome del database del contenuto che ospita la raccolta siti.
ContentDBServerName Sistema SQL Server che ospita il database del contenuto.
ContentDBSizeInMB Dimensioni del database del contenuto che ospita la raccolta siti.
UPN UPN usato per determinare la differenza di lunghezza dell'URL. Se l'UPN è "****" che indica che il proprietario non ha un userPrincipalName impostato nel profilo di SharePoint. Di conseguenza, è stata usata la lunghezza media di UserPrincipalName nell'archivio profili di SharePoint.
URLLengthDifference URLLengthDifference Amount l'URL aumenta quando il sito viene rinominato.
WebURL URL della pagina Web che contiene il nodo di navigazione.
NavigationNodeLocation Titoli del nodo di navigazione che mostrano la posizione del nodo di navigazione. È possibile avere più livelli per i nodi di navigazione e ciò consente di individuare il nodo danneggiato.
NavigationNodeTitle Titolo del nodo di navigazione interessato.
NavigationNodeURL L'URL che sarà troppo tempo dopo la ridenominazione del sito.
ScanID Identificatore univoco assegnato a una specifica esecuzione dello strumento di valutazione della migrazione di SharePoint.

LongODBUrl-Perms-detail.csv Le autorizzazioni impostate su un oggetto in SharePoint vengono registrate con l'URL dell'oggetto. Se si impostano le autorizzazioni per una cartella, SharePoint archivia il percorso relativo della cartella. Se si impostano le autorizzazioni per un elemento, SharePoint archivia il percorso relativo del server all'elemento.

Di conseguenza, durante la migrazione di un sito gli URL associati alle autorizzazioni verranno aggiornati. Questo può causare errori se il nuovo URL è troppo lungo.

La correzione per questo problema consiste nello spostare l'oggetto interessato più vicino alla radice della raccolta siti. In alternativa, è possibile rimuovere specifiche autorizzazioni dagli elementi nel report.

Colonna Descrizione
SiteId Identificatore univoco della raccolta siti interessata.
SiteURL URL della raccolta siti interessata.
SiteOwner Proprietario della raccolta siti.
SiteAdmins Elenco di utenti indicati come amministratori della raccolta siti.
SiteSizeInMB Dimensioni della raccolta siti in megabyte [MB]
NumOfWebs Numero di Web esistenti nella raccolta siti.
ContentDBName Nome del database del contenuto che ospita la raccolta siti.
ContentDBServerName Sistema SQL Server che ospita il database del contenuto.
ContentDBSizeInMB Dimensioni del database del contenuto che ospita la raccolta siti.
UPN UPN UserPrincipalName usato per determinare la differenza di lunghezza dell'URL. Se l'UPN è "****" che indica che il proprietario non ha un userPrincipalName impostato nel profilo di SharePoint. Di conseguenza, è stata usata la lunghezza media di UserPrincipalName nell'archivio profili di SharePoint.
URLLengthDifference Entità dell'aumento dell'URL quando il sito viene rinominato.
WebURL URL della pagina Web che ospita l'oggetto protetto.
SecuredObject URL dell'oggetto protetto che sarà troppo lungo dopo la ridenominazione del sito. Se si aggiungono le autorizzazioni a un file, questo è il percorso relativo del server per il file. Se si impostano le autorizzazioni su una cartella, questo è il percorso relativo del server per la cartella.
ScanID Identificatore univoco assegnato a una specifica esecuzione dello strumento di valutazione della migrazione di SharePoint.

LongODBUrl-Deps-detail.csv Alcuni file possono avere altre dipendenze. Le dipendenze vengono registrate con l'URL. Durante la migrazione se le informazioni sulle dipendenze sono troppo lunghe, la migrazione ha esito negativo.

Esistono due limitazioni nel report da tenere presenti:

  • FullURL ha un limite di 260 caratteri. Si tratta del file con le dipendenze. Per risolvere il problema della lunghezza, rimuovere il file o spostarlo in un percorso più vicino alla radice della raccolta siti.

  • DependencyDescription ha un limite di 270 caratteri. Si tratta della dipendenza associata a FullURL. Per risolvere il problema della lunghezza, rimuovere la dipendenza o spostarla in un percorso più vicino alla radice della raccolta siti.

Colonna Descrizione
SiteId Identificatore univoco della raccolta siti interessata.
SiteURL URL della raccolta siti interessata.
SiteOwner Proprietario della raccolta siti.
SiteAdmins Elenco di utenti indicati come amministratori della raccolta siti.
SiteSizeInMB Dimensioni della raccolta siti in megabyte [MB]
NumOfWebs Numero di Web esistenti nella raccolta siti.
ContentDBName Nome del database del contenuto che ospita la raccolta siti.
ContentDBServerName Sistema SQL Server che ospita il database del contenuto.
ContentDBSizeInMB Dimensioni del database del contenuto che ospita la raccolta siti.
UPN UPN usato per determinare la differenza di lunghezza dell'URL. Se l'UPN è "****", indica che il proprietario non ha impostato un userPrincipalName nel profilo di SharePoint. Di conseguenza, è stata usata la lunghezza media di UserPrincipalName nell'archivio profili di SharePoint.
URLLengthDifference Entità dell'aumento dell'URL quando il sito viene rinominato.
FullURL URL del file con le dipendenze
DependencyDescription DependencyDescription Descrizione associata alla dipendenza. Può trattarsi di un URL che viene rinominato.
ScanID Identificatore univoco assegnato a una specifica esecuzione dello strumento di valutazione della migrazione di SharePoint.