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. |