Risoluzione dei problemi relativi alla creazione di pacchetti e alla distribuzione di SharePoint

  • Articolo

In questo argomento vengono analizzati vari problemi che possono verificarsi durante la creazione di pacchetti e la distribuzione di soluzioni SharePoint.

Nel presente argomento sono contenute le seguenti sezioni.

  • Abilitazione del debug avanzato
  • Aggiunta dell'output del progetto al pacchetto della soluzione
  • Avvisi ed errori di convalida
  • Risoluzione dei conflitti di distribuzione
  • Differenze rispetto alla distribuzione tramite il tasto F5
  • Ritardo della visualizzazione della pagina di SharePoint durante la distribuzione di una Web part visiva
  • Distribuzione del progetto SharePoint non riuscita con generazione dell'errore "Impossibile estrarre il file cab nella soluzione"
  • Errore visualizzato durante la distribuzione di una web part visiva in un sito in un'applicazione Web diversa
  • Avviso visualizzato durante la distribuzione di controlli utente annidati
  • Argomenti correlati

Abilitazione del debug avanzato

Per effettuare una diagnosi dei problemi relativi a Visual Studio, SharePoint e ad altri livelli, è possibile utilizzare la chiave del Registro di sistema EnableDiagnostics per visualizzare la traccia dello stack. Per ulteriori informazioni, vedere Debug di soluzioni SharePoint.

Aggiunta dell'output del progetto al pacchetto della soluzione

È possibile aggiungere l'output del progetto a un pacchetto mediante Progettazione pacchetti. Quando tuttavia si aggiunge l'output del progetto, verificare che la piattaforma del progetto corrisponda alla piattaforma della soluzione SharePoint. È consigliabile utilizzare la piattaforma di destinazione Qualsiasi CPU per gli assembly che si desidera distribuire in un server SharePoint. Per ulteriori informazioni, vedere Finestra di dialogo Impostazioni del compilatore avanzate (Visual Basic) o Pagina Compilazione, Progettazione progetti (C#).

Avvisi ed errori di convalida

Gli strumenti di sviluppo di SharePoint in Visual Studio consentono di eseguire passaggi di convalida per verificare che il pacchetto della soluzione venga creato correttamente. È inoltre possibile creare passaggi di convalida personalizzati per le funzionalità e i pacchetti. Per ulteriori informazioni, vedere Procedura: creare regole personalizzate per la convalida di funzionalità e pacchetti per le soluzioni SharePoint.

Risoluzione dei conflitti di distribuzione

Quando si distribuisce una soluzione SharePoint, possono verificarsi conflitti se un elemento sul server ha lo stesso nome, URL o ID di un elemento presente nel pacchetto della soluzione. È possibile modificare la proprietà Risoluzione conflitti di distribuzione per risolvere, segnalare o ignorare i conflitti relativi a moduli, Web part, istanze di elenco e tipi di contenuto.

Nella tabella seguente sono elencate le impostazioni per la proprietà Risoluzione conflitti di distribuzione.

Valore

Descrizione

Automatic

I conflitti vengono rilevati e risolti automaticamente.

Prompt

I conflitti vengono rilevati e segnalati allo sviluppatore prima di essere risolti.

None

I conflitti non vengono rilevati.

Differenze rispetto alla distribuzione tramite il tasto F5

Quando si utilizza Visual Studio per distribuire il progetto SharePoint nel server SharePoint locale per il test e l'esecuzione del debug, in Visual Studio vengono eseguiti alcuni passaggi aggiuntivi.

  1. Reimpostazione di Internet Information Service (IIS) durante il passaggio di distribuzione.

  2. Associazione automatica dei flussi di lavoro.

  3. Impostazione dell'ordine di attivazione delle funzionalità in base alla gerarchia di Progettazione pacchetti.

È possibile aggiungere passaggi di distribuzione personalizzati per modificare ulteriormente il comportamento del tasto F5. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di un passaggio di distribuzione personalizzato per progetti SharePoint.

Ritardo della visualizzazione della pagina di SharePoint durante la distribuzione di una Web part visiva

La visualizzazione della pagina di SharePoint richiede molto tempo quando si distribuisce una Web part visiva nella cartella Bin di Windows Vista o di Windows Server 2008. Se si modificano i file di una directory di livello superiore di ASP.NET, ad esempio la directory Bin, viene ricompilata l'intera applicazione Web. Questo può determinare fino a 25 secondi di ritardo nel rendering della pagina di SharePoint.

Messaggio di errore

Nessuno.

Risoluzione

Per risolvere il problema, effettuare i passaggi seguenti:

  1. Installare l'hotfix QFE KB967535 come descritto nell'articolo del supporto tecnico Microsoft FIX: è disponibile un hotfix per correggere due problemi in ASP.NET in IIS 7.0 per Windows Vista e Windows Server 2008 (la pagina potrebbe essere in inglese).

  2. Aggiungere la riga di codice seguente al file Web.config:

    <compilation batch="false" optimizeCompilations="true">

Distribuzione del progetto SharePoint non riuscita con generazione dell'errore "Impossibile estrarre il file cab nella soluzione"

Se il nome di un qualsiasi elemento di progetto SharePoint contiene parentesi, la distribuzione della soluzione non riesce generando un errore.

Messaggio di errore

Si è verificato un errore nel passaggio di distribuzione 'Aggiungi Soluzione': Impossibile estrarre il file cab nella soluzione.

Risoluzione

Per risolvere il problema, rimuovere le parentesi nei nomi degli elementi di progetto SharePoint.

Errore visualizzato durante la distribuzione di una web part visiva in un sito in un'applicazione Web diversa

La prima volta che viene distribuita una Web part visiva a un sito su un'applicazione Web diversa da quella sulla quale è correntemente distribuita (modificando la proprietà SiteUrl della Web part visiva), si ottiene un errore.

Messaggio di errore

Si è verificato un errore nel passaggio di distribuzione 'Aggiungi Soluzione': Una funzionalità con ID [#] è già stata installata in questa farm. Utilizzare l'attributo force per installare nuovamente in modo esplicito la funzionalità.

Risoluzione

Questo errore si verifica a causa della modalità con cui le funzionalità della Web part visiva vengono ritratte in SharePoint. Per distribuire correttamente la Web part visiva, distribuire di nuovo la soluzione premendo F5.

Avviso visualizzato durante la distribuzione di controlli utente annidati

Questo avviso viene visualizzato quando si distribuisce una soluzione SharePoint in cui sono annidati controlli utente, quale una web part visiva contenente un controllo utente o un controllo utente contenente una web part visiva o un altro controllo utente. L'avviso viene generato se si aggiunge un controllo a una finestra di progettazione trascinandolo dalla casella degli strumenti o utilizzando l'istruzione @Register nella visualizzazione Origine.

Messaggio di errore

Avviso 1: L'elemento 'Control Name]' non è un elemento noto. Il problema potrebbe essere dovuto a un errore di compilazione del sito Web oppure il file web.config risulta mancante.

Risoluzione

Se il sistema del progetto Visual Studio non riconosce un controllo utente annidato, non può fornire IntelliSense e genera l'avviso. Il sistema del progetto non riconosce un controllo utente annidato se il progetto non viene compilato e la finestra di progettazione non viene chiusa né riaperta oppure se l'opzione di ritrazione automatica è abilitata, causando la ritrazione del controllo utente dall'hive SharePoint dopo il debug.

Per rimuovere questo avviso, compilare il progetto, quindi chiudere e riaprire la finestra di progettazione oppure disabilitare l'opzione di ritrazione automatica per il progetto. A tale scopo, deselezionare la casella di controllo Ritrazione automatica dopo il debug nella scheda SharePoint della finestra di dialogo delle proprietà del progetto.

Vedere anche

Altre risorse

Creazione del pacchetto e distribuzione delle soluzioni SharePoint