Condividi tramite


Risolvere i problemi relativi all'aggiornamento delle raccolte siti in SharePoint Server 2016

SI APPLICA A:no-img-132013 yes-img-162016 yes-img-192019 no-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

Quando si aggiorna una raccolta siti a SharePoint Server 2019, a volte possono verificarsi errori. Questo articolo è stato pensato per aiutare l'utente a capire e risolvere tali errori.

Controllare lo stato e i file di log dell'aggiornamento

Gli indicatori di stato e i file di log dell'aggiornamento forniscono un'indicazione dei problemi verificatisi durante il processo di aggiornamento. Si consiglia di esaminare con attenzione tutti gli errori riportati nei file di log. Gli avvisi non sempre indicano un problema, ma è consigliabile esaminarli tutti per determinare se una o più delle condizioni segnalate possono causare ulteriori problemi.

  1. Esaminare la pagina dello stato di aggiornamento relativa alla propria raccolta siti.

    Nella sezione Amministrazione raccolta siti della pagina Impostazioni sito fare clic su Aggiornamento raccolta siti. Nella pagina Aggiornamento raccolta siti fare clic su Esamina stato aggiornamento raccolta siti.

  2. Se non viene eseguito il rendering delle pagine, controllare la pagina Impostazioni sito. Se la pagina Impostazioni sito viene visualizzata correttamente e l'aggiornamento è stato completato senza errori, potrebbe essere presente un problema relativo alla pagina master o alla home page. Se invece la pagina Impostazioni sito non viene visualizzata correttamente, cercare informazioni sul problema nel file di log dell'aggiornamento della raccolta siti.

  3. Esaminare i file di log dell'aggiornamento della raccolta siti. È possibile esaminare i file di log dell'aggiornamento della raccolta siti dalle posizioni seguenti:

  • Per gli amministratori della raccolta siti: Sono inoltre presenti file di log per l'aggiornamento della raccolta siti archiviati all'interno della raccolta siti stessa, nel catalogo dei log di manutenzione in (http://<SiteName>/_catalogs/MaintenanceLogs/YYYYMMDD-HHMMSS-SSS.txt , dove AAAAMMGG è la data e HHMMSS-SSS è l'ora (ore in formato orologio 24 ore, minuti, secondi e millisecondi).

  • Per gli amministratori farm: il file di log dell'aggiornamento della raccolta siti e il file di log degli errori di aggiornamento si trovano in %COMMONPROGRAMFILES%\Microsoft Shared\Web server extensions\16\LOGS. I log sono denominati nel formato seguente: SiteUpgrade- AAAAMMGG-HHMMSS-SSS.log, dove AAAAMMGG è la data e HHMMSS-SSS è l'ora (ore in formato orologio 24 ore, minuti, secondi e millisecondi). Questi file di log del file system contengono maggiori informazioni se si desiderano i dettagli relativi ai problemi.

Problemi comuni

Controllare se uno dei problemi seguenti sta causando un errore di aggiornamento, un avviso o un problema nel sito.

D: Sulla pagina non vedo il controllo dell'interfaccia utente che precedentemente era presente

  • R: Ripristinare la versione predefinita della pagina, ossia ripeterne il ghosting.

L'esecuzione di modifiche nell'interfaccia utente del sito può determinare problemi negli aggiornamenti del sito. Se una pagina era stata personalizzata collocando un controllo per l'interfaccia utente in una posizione non standard, è possibile ripristinare la versione predefinita della pagina per recuperare il controllo.

Per ripristinare la pagina, è possibile utilizzare il collegamento Reimpostazione definizione del sito sotto Azioni sito nella pagina Impostazioni sito oppure il comando Reimposta in base a modello in SharePoint Designer.

D: La visualizzazione su un elenco esteso non funziona più

  • R: Creare colonne indicizzate, cartelle o nuove visualizzazioni per gli elenchi estesi. Potrebbe essere necessario aggiungere la colonna indicizzata alle visualizzazioni esistenti.

Se un elenco è molto esteso e gli utenti utilizzano una visualizzazione o eseguono una query che supera il limite o la soglia di limitazione, la visualizzazione o la query non sarà consentita. È possibile creare colonne indicizzate con visualizzazioni filtrate, organizzare gli elementi in cartelle, impostare un limite di elementi sulla pagina per una visualizzazione di grandi dimensioni o utilizzare un elenco esterno. Per altre informazioni sulla limitazione di elenchi di grandi dimensioni e su come risolvere i problemi relativi a elenchi di grandi dimensioni, vedere Gestire elenchi e raccolte con molti elementi.

D: Si è verificato un errore relativo a un nome di tipo di contenuto duplicato

  • R: Rinominare i tipi di contenuto o i campi in conflitto con i nomi predefiniti.

Talvolta gli elementi personalizzati, ad esempio un tipo di contenuto, possono avere un nome in conflitto con un nome nella nuova versione.

Nei file di log dell'aggiornamento potrebbe essere riportato un errore simile al seguente:

Nota

Se si rinomina o si rimuove un tipo di contenuto, eventuali personalizzazioni da esso dipendenti potrebbero smettere di funzionare.

D: Il sito ha un aspetto poco accattivante, non funziona come previsto o vengono segnalati errori di script

  • R: Modificare la pagina o ripristinarne la versione predefinita oppure rimuovere o sostituire i file personalizzati.

    Un problema con i file CSS o JavaScript personalizzati o inline può causare questi problemi.

D: Il contenuto personalizzato del sito è scomparso o non funziona

  • R: Modificare la pagina master o il contenuto in modo che non richieda zone specifiche.

    La pagina master potrebbe avere diversi layout di zona e il contenuto potrebbe non farvi più riferimento correttamente. Come ultima risorsa, è possibile ripristinare la versione predefinita della pagina. In tal caso, tuttavia, si potrebbe perdere il contenuto specifico della zona.

D: Viene visualizzato un messaggio di errore in cui è indicato che non è possibile eseguire il rendering di un controllo o di una pagina

  • R: Effettuare una delle operazioni seguenti:

    • Se una Web Part è stata aggiunta ma non installata, contattare l'amministratore farm perché venga installata. Se una Web Part non è più disponibile o non è più supportata, utilizzare la visualizzazione di manutenzione della Web Part per rimuoverla (e non semplicemente chiuderla) dalla pagina.

    • Se una pagina è stata modificata direttamente, modificarla di nuovo per rimuovere il controllo o la Web Part oppure ripristinare la versione predefinita della pagina.

      È possibile che sia stata aggiunta alla pagina una Web Part o un altro controllo non installato o non più supportato. Una Web Part è stata aggiunta a una zona o la pagina è stata modificata direttamente per aggiungere un riferimento a un controllo o a una Web Part direttamente inline, probabilmente su una pagina master.

      Potrebbe essere necessario attivare una caratteristica di SharePoint. Per altre informazioni, vedere Abilitare o disabilitare le funzionalità della raccolta siti e Aprire e usare la pagina di manutenzione della web part.

D: Non viene eseguito il rendering del sito aggiornato e viene visualizzato un "errore imprevisto" con un ID di correlazione

R: È possibile che la personalizzazione utilizzi una pagina master personalizzata contenente un segnaposto di contenuto personalizzato.

Se la pagina master personalizzata contiene un segnaposto di contenuto personalizzato e se anche i layout di pagina personalizzati contengono questo segnaposto del contenuto personalizzato, un errore potrebbe impedire il rendering della home page del sito dopo l'aggiornamento. Al contrario, dopo l'aggiornamento, potrebbe essere visualizzato il messaggio di errore "Si è verificato un errore imprevisto".

Vedere anche

Concetti

Aggiornare una raccolta siti a SharePoint Server 2019