Problemi di personalizzazione possibili quando si esegue l'aggiornamento a SharePoint 2013

Articolo
03/08/2023

SI APPLICA A: yes-img-13 2013 no-img-16 2016 no-img-19 2019 no-img-se Subscription Edition no-img-sop SharePoint in Microsoft 365

SharePoint 2013 presenta una nuova interfaccia utente semplificata, veloce e fluida. Questa è stata realizzata usando nuovi stili, temi e pagine master CSS. Per ottenere questa nuova esperienza, è necessario effettuare l'aggiornamento alla nuova interfaccia utente. Ma le modifiche significative apportate per supportare la nuova interfaccia utente potrebbero creare problemi di aggiornamento in alcuni scenari in cui si usano le personalizzazioni.

In Prodotti SharePoint 2010, il sito può essere stato personalizzato in uno dei seguenti modi:

Applicazione di un foglio di stile personalizzato nel sito che sovrascrive gli stili predefiniti di SharePoint.
Applicazione di un tema personalizzato (file THMX) al sito.
Copia e modifica di una pagina master inclusa in SharePoint 2013.
Creazione di una pagina master personalizzata completamente nuova, in cui la pagina master personalizzata utilizza stili personalizzati e a cui fanno riferimento layout di pagina personalizzati.

Quando si esegue l'aggiornamento della raccolta siti a SharePoint 2013, questi tipi di personalizzazioni non funzioneranno così perché sono stati modificati gli stili CSS, i temi e le pagine master predefiniti. In alternativa, è necessario creare di nuovo la personalizzazione. Questa operazione richiede l'utilizzo di nuovi stili, temi o pagine master disponibili in SharePoint 2013, quindi di applicare la progettazione appena ricreata nella raccolta siti aggiornata.

Modifiche agli stili, temi e pagine master di SharePoint predefiniti sono state necessarie per creare un'interfaccia utente più fluida e più rapida e per rendere gli aggiornamenti successivi più prevedibili.

Per questo motivo, se la raccolta siti contiene personalizzazioni, è consigliabile, prima dell'aggiornamento, creare innanzitutto una raccolta siti di valutazione in cui è possibile verificare e ricreare le personalizzazioni in un ambiente SharePoint 2013. Per altre informazioni su una raccolta siti di valutazione, vedere Aggiornare una raccolta siti.

Nelle sezioni seguenti, vengono elencati i problemi che possono verificarsi quando si esegue l'aggiornamento a SharePoint 2013.

File CSS personalizzati

Il modo più comune per applicare personalizzazioni a un sito Prodotti SharePoint 2010 consiste nel creare un file CSS contenente stili che sostituiscono gli stili predefiniti di SharePoint.

Per rendere la nuova interfaccia utente più rapida e fluida, SharePoint 2013 ha introdotto modifiche fondamentali in cui viene applicato CSS:

Le dimensioni dei file CSS sono ridotte.
Annidamento dei selettori CSS è limitato.
Quando possibile, si consiglia di utilizzare l'ereditarietà CSS.
Le classi sono definite in un'unica posizione.
Le classi correlate sono raggruppate nel file CSS.
Gli stili inline e la dichiarazione !important non vengono usati perché non possono essere sottoposti a override.
Gli stili usano una struttura coerente e una convenzione di denominazione.

In SharePoint 2013, gli stili usano una struttura coerente e una convenzione di denominazione.

NAMING PART	MS-	<FUNZIONALITÀ>-	<NAME>
Spiegazione	Indica che si tratta di una classe Microsoft.	Il nome della caratteristica a cui è associato questo elemento o "core" se viene utilizzato come parte dell'interfaccia utente di base.	Un nome descrittivo dell'elemento, ad esempio titolo, collegamento e così via

In seguito alle modifiche al modo in cui SharePoint 2013 implementa CSS, quando si esegue l'aggiornamento, gli stili CSS personalizzati non saranno applicati al sito. Per risolvere questo problema, è necessario prima di tutto creare una raccolta siti di valutazione e quindi utilizzare tale sito come ambiente in cui è possibile identificare i nuovi stili SharePoint 2013 da sovrascrivere. Creare un file CSS per questi stili e quindi applicarlo al sito aggiornato.

Tema personalizzato

In Prodotti SharePoint 2010, è possibile utilizzare un programma Office come PowerPoint 2010 per creare un file THMX. È quindi possibile caricare il file del tema in Prodotti SharePoint 2010 e applicare il tema al sito.

In SharePoint 2013, il motore di applicazione dei temi è stato migliorato affinché l'applicazione dei temi sia più veloce e flessibile e affinché i temi possano essere aggiornati più facilmente andando avanti. Il modello di applicazione dei temi utilizza markup in stile commento in CSS, quindi sostituisce le parti dei parametri basati su CSS come tipo di carattere e combinazione colori selezionati dall'utente. I temi in SharePoint 2013 sono definiti da file XML:

SPColor.xml definisce la tavolozza dei colori, in cui slot ora hanno nomi semantici che rendono più chiaro quali elementi dell'interfaccia utente verranno interessati quando si modifica un valore di colore. Inoltre, i temi ora supportano l'impostazione di opacità.
SPFont.xml definisce la combinazione tipi di carattere e supporta più lingue, tipi di carattere web-safe e tipi di carattere Web.

Ma non è supportato l'aggiornamento di un file THMX da Prodotti SharePoint 2010 a SharePoint 2013. Se è stato applicato un tema personalizzato nel sito di Prodotti SharePoint 2010, quando si esegue l'aggiornamento a SharePoint 2013, i file tema verranno mantenuti in posizione. Tuttavia, il tema non è più applicato al sito e verrà ripristinato il tema predefinito.

Per ovviare a questo problema, è consigliabile creare innanzitutto una raccolta siti di valutazione e quindi utilizzare le nuove caratteristiche di applicazione dei temi in SharePoint 2013 per creare di nuovo un tema. Per ulteriori informazioni sui nuovi temi, vedere i seguenti articoli su MSDN:

Importante

[!IMPORTANTE] Andando avanti, se si desidera utilizzare la personalizzazione e si desidera che funzioni per gli aggiornamenti futuri, si consiglia di utilizzare temi per implementare la progettazione. I temi riceveranno supporto di aggiornamento in caso di futuri aggiornamenti. Se i temi non funzionano per lo specifico scenario o è necessario disporre di una personalizzazione più estesa, è consigliabile usare un sito di pubblicazione insieme a Gestione progettazione. Tenere tuttavia presente che se si investe nella creazione di pagine master e layout di pagina personalizzati, potrebbe essere necessario modificare o aggiornare i file di progettazione durante e dopo ogni aggiornamento di SharePoint.

Copiare e modificare una pagina master fornita con SharePoint 2013

In Prodotti SharePoint 2010, un modo comune per apportare personalizzazioni minori all'interfaccia utente consiste nel copiare e modificare una pagina master fornita con Prodotti SharePoint 2010. Ad esempio, è possibile modificare la pagina master per rimuovere o nascondere capacità agli utenti.

Quando si aggiorna un sito Prodotti SharePoint 2010 a SharePoint 2013, la pagina master viene reimpostata per usare la pagina master predefinita in SharePoint 2013. Di conseguenza, dopo l'aggiornamento, il sito visualizzerà la propria personalizzazione. La pagina master personalizzata creata in Prodotti SharePoint 2010 è ancora presente nel sito, ma la pagina master precedente non deve essere applicata al nuovo sito perché il nuovo sito non verrà visualizzato nel modo previsto.

Per supportare la nuova interfaccia utente in SharePoint 2013, sono state apportate modifiche alle pagine master predefinite. Per questo motivo, non è possibile applicare una pagina master creata in Prodotti SharePoint 2010 in un sito in SharePoint 2013.

Per ovviare a questo problema, è consigliabile creare innanzitutto una raccolta siti di valutazione e quindi ricreare la pagina master nel sito di SharePoint 2013. Dopo aver verificato che la nuova pagina master funziona come previsto, spostare la pagina master nella nuova raccolta siti e applicarla al sito. Se i siti sono siti di pubblicazione, è possibile utilizzare Gestione progettazione per esportare e quindi importare la pagina master all'interno di un pacchetto di progettazione. In caso contrario, è possibile spostare la pagina master come parte di una soluzione in modalità sandbox o caricando il file nella raccolta pagine master.

Importante

[!IMPORTANTE] SharePoint Foundation 2013 non supporta siti di pubblicazione. È necessario SharePoint 2013 per usare i siti di pubblicazione.

Pagine master personalizzate in un sito di pubblicazione

Se si vuole un sito completamente personalizzato, ad esempio un sito intranet di comunicazioni aziendali, usare un sito di pubblicazione con una pagina master interamente personalizzata e layout di pagina personalizzati collegati alla pagina master personalizzata.

Quando si aggiorna un sito Prodotti SharePoint 2010 a SharePoint 2013, la pagina master viene reimpostata per usare la pagina master predefinita in SharePoint 2013. Di conseguenza, dopo l'aggiornamento, il sito non visualizzerà la propria personalizzazione. La pagina master e i layout di pagina personalizzati creati in Prodotti SharePoint 2010 sono ancora presente nel sito, ma la pagina master precedente non deve essere applicata al nuovo sito perché il nuovo sito non verrà visualizzato nel modo previsto.

Per ovviare a questo problema, è consigliabile creare innanzitutto una raccolta siti di valutazione che è un sito di pubblicazione e quindi ricreare la pagina master nel sito di SharePoint 2013. Dopo aver verificato che la nuova pagina master funziona come previsto, procedere come segue:

Esportare la pagina master come parte di un pacchetto di progettazione.
Importare il pacchetto di progettazione nella nuova raccolta siti.
Applicare la nuova pagina master al sito.

Segnaposto di contenuto personalizzati in una pagina master personalizzata

Importante

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

Per determinare se si verifica il problema, è possibile creare innanzitutto una raccolta siti di valutazione che è anche un sito di pubblicazione e quindi impostare la pagina master fornita con SharePoint 2013. Se il sito viene ancora visualizzato, il problema non si verifica. Se il sito non viene visualizzato e si visualizza un "errore imprevisto" con un ID di correlazione, probabilmente il problema è presente.

Per risolvere il problema, procedere come segue:

Creare una raccolta siti di valutazione che è una raccolta siti di pubblicazione.
Creare una pagina master SharePoint 2013.
Aggiungere il segnaposto di contenuto personalizzato in una pagina master 2013.
Applicare la nuova pagina master al sito.
Creare un layout di pagina che non contiene il segnaposto di contenuto personalizzato.

Il layout di pagina sarà associato alla nuova pagina master applicata al sito.
Modificare tutte le pagine che usano il vecchio layout di pagina per usare il nuovo layout di pagina.

È possibile modificare manualmente ogni pagina singolarmente nel browser e utilizzare l'opzione sulla barra multifunzione oppure è possibile utilizzare il modello a oggetti sul lato client per SharePoint per aggiornare le pagine in modo programmatico.
Eliminare il vecchio layout di pagina contenente il segnaposto di contenuto personalizzato.