Condividi tramite

Risolvere i problemi relativi alle soluzioni SharePoint

  • Articolo

Quando si esegue il debug di soluzioni SharePoint tramite il debugger di Visual Studio, possono verificarsi i problemi o gli avvisi seguenti. Per altre informazioni, vedere Debug di soluzioni flusso di lavoro di SharePoint 2007.

Restrizioni dei token nelle web part visive in modalità sandbox

Tramite le web part visive nelle soluzioni create mediante sandbox non è possibile elaborare i token standard, ad esempio $SPUrl, supportati dal runtime di SharePoint. Di conseguenza, l'URL non viene risolto e non è possibile visualizzare in anteprima il contenuto nella visualizzazione Progettazione nella finestra di progettazione di web part visive se vi si fa riferimento direttamente in un elemento dello script, come nell'esempio seguente:

<script src="<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>

Per risolvere questa limitazione e il token, farvi riferimento tramite valori letterali:

<asp:literal ID="Literal1" runat="server" Text="<script src='" />
<asp:literal ID="Literal2" runat="server" Text="<% $SPUrl:~site/SiteAssets/ListOperations.js %>" />
<asp:literal ID="Literal3" runat="server" Text="' type='text/javascript' ></script>" />

Restrizioni dei caratteri nei nomi dei progetti e degli elementi del progetto

Nei nomi di progetti e di elementi di progetto possono essere inclusi solo caratteri che sono validi in un percorso di distribuzione in SharePoint 2010. Non sono consentiti altri caratteri.

Error message

Messaggio di errore "Caratteri non validi".

Risoluzione

Per i nomi di progetti e di elementi di progetto di SharePoint, utilizzare solo i caratteri seguenti:

  • Caratteri ASCII alfanumerici

  • Space

  • Punto (.)

  • Virgola (,)

  • Carattere di sottolineatura (_)

  • Trattino (-)

  • Barra rovesciata (\)

    Quando viene creato un pacchetto di un progetto, tramite una regola di convalida viene verificato che nella proprietà del percorso di distribuzione per ogni file distribuito siano contenuti solo questi caratteri validi.

Errori durante la creazione di campi personalizzati

In Visual Studio i campi personalizzati sono definiti in XML. Si possono verificare errori se un campo non è definito o non vi viene fatto riferimento tramite un formato specifico.

Error message

Messaggio di errore "Caratteri non validi" in fase di creazione del pacchetto.

Risoluzione

L'ID per una definizione di campo deve essere un GUID racchiuso tra parentesi graffe, come illustrato nell'esempio seguente:

<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
    Type="Note"
    Name="PatientName"
    DisplayName="Patient Name"
    Group="A Custom Group">
</Field>.

Come illustrato nell'esempio seguente, è necessario definire un riferimento a un campo in un tipo di contenuto usando il formato di elemento vuoto (<FieldRef />), non usando gli elementi start/end (<FieldRef></FieldRef>):

<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
    Name="PatientName"
    DisplayName="Patient Name"
    Required="TRUE"/>

Se il codice XML di origine per il campo non è corretto, ad esempio un file XML non è valido o presenta altri problemi, si verificherà l'errore indicante che non è possibile analizzare il file.

Le nuove definizioni di sito non in inglese non vengono visualizzate nella pagina di creazione del sito dopo la distribuzione

Dopo aver creato e distribuito una definizione di sito usando una versione non in lingua inglese di Visual Studio (ovvero una versione con ID impostazioni locali diverso da 1033), la scheda Personalizzazioni di SharePoint non viene visualizzata nella casella Selezione modelli e il nuovo modello di sito non viene visualizzato nella pagina Nuovo sito di SharePoint.

Error message

Nessuno.

Risoluzione

Questo problema si verifica a causa di un valore non corretto nella proprietà Path per il file di configurazione della definizione del sito Webtemp, ad esempio webtemp_SiteDefinitionProject1.xml. Nella proprietà Path per il file webtemp, che si trova nel percorso di distribuzione, modificare 1033 con l'ID delle impostazioni locali appropriato. Ad esempio, per usare le impostazioni locali giapponesi, impostare il valore su 1041. Per altre informazioni, vedere ID delle impostazioni locali assegnati da Microsoft.

Si verifica un errore quando un progetto flusso di lavoro viene distribuito in un sistema pulito

Questo problema si verifica se si distribuisce un progetto di flusso di lavoro in Visual Studio in un sistema pulito. Un sistema pulito è un computer con una nuova installazione di Visual Studio e SharePoint, ma senza progetti di flusso di lavoro distribuiti.

Error message

Impossibile trovare l'elenco di SharePoint: Cronologia flussi di lavoro.

Risoluzione

Questo errore si verifica a causa di un elenco cronologia flussi di lavoro mancante. Poiché l'ambiente di sviluppo è un sistema pulito, non vengono distribuiti flussi di lavoro e l'elenco Cronologia flussi di lavoro non esiste ancora. Per risolvere questo problema, riaprire la procedura guidata del flusso di lavoro, che determina la creazione dell'elenco Cronologia flussi di lavoro.

Per immettere nuovamente la procedura guidata del flusso di lavoro

  1. In Esplora soluzioni scegliere il nodo del flusso di lavoro.

  2. Nella finestra Proprietà scegliere il pulsante con i puntini di sospensione (...) in qualsiasi proprietà con un pulsante con i puntini di sospensione.

L'utente deve aggiornare la pagina dell'applicazione nel browser durante il debug per visualizzare l'immagine aggiornata

Se si esegue il debug di una soluzione SharePoint contenente una pagina dell'applicazione con un controllo che visualizza un'immagine, ad esempio un controllo Immagine HTML, è necessario aggiornare la pagina nel browser per visualizzare le modifiche apportate all'immagine.

Errore: il percorso del sito non è valido

Questo problema può verificarsi se SharePoint Server non è installato. Può verificarsi anche se non si dispone dell'accesso amministratore al sito Web di SharePoint specificato nella Personalizzazione guidata SharePoint.

Error message

  • Il percorso del sito di SharePoint non è valido.

Risoluzione

L'evento Web di eliminazione del sito non si verifica nel progetto ricevitore di eventi

Quando si crea un progetto ricevitore di eventi e si selezionano determinati eventi Web, ad esempio "un sito viene eliminato", l'evento non si verifica mai.

Error message

Nessuno.

Risoluzione

Questo problema si verifica perché l'ambito della funzionalità deve essere "Sito" per gestire gli eventi a livello di sito, ma l'ambito di funzionalità predefinito per i progetti ricevitore di eventi è "Web". Gli eventi Web interessati sono:

  • Un sito viene eliminato (WebDeleting)

  • Un sito è stato eliminato (WebDeleted)

  • Un sito viene spostato (WebMoving)

  • Un sito è stato spostato (WebMoved)

    Per risolvere il problema, modificare l'ambito della funzionalità del ricevitore di eventi, come indicato di seguito.

Per modificare l'ambito della funzionalità del ricevitore di eventi

  1. In Esplora soluzioni aprire il file con estensione feature del ricevitore di eventi in Progettazione funzionalità facendo doppio clic sul file o aprendone il menu di scelta rapida e quindi scegliendo Apri.

  2. Scegliere la freccia accanto a Ambito e quindi scegliere Sito nell'elenco visualizzato.

L'errore di distribuzione viene visualizzato dopo la modifica del nome di un identificatore in un progetto di modello di integrazione applicativa dei dati

Questo problema si verifica se si modifica il nome dell'identificatore di un'entità in un modello di business data Connessione ivity (BDC) e quindi si tenta di distribuire la soluzione.

Messaggi di errore

  • <il nome> del modello presenta i seguenti errori di attivazione del tipo di contenuto esterno ...

  • L'oggetto IMetadataObject con nome '<nome> modello' ha un valore in Campo 'name' duplicato ...

Risoluzione

Per risolvere questo problema, eliminare il modello manualmente e quindi distribuirla di nuovo. È possibile eliminare il modello usando uno degli strumenti seguenti:

  • SharePoint 2010 Central Amministrazione istration. Per altre informazioni, vedere BDC Model Management nel sito Web Microsoft TechNet.

  • Windows PowerShell. È possibile eliminare il modello digitando questo comando al prompt dei comandi: Remove-SPBusinessDataCatalogModel. Per altre informazioni, vedere Cmdlet generali (SharePoint Server 2010) nel sito Web Microsoft TechNet.

Errore di distribuzione durante il tentativo di riciclo del pool di applicazioni IIS in SharePoint Server

Questo problema si verifica se la funzionalità di compatibilità WMI di IIS 6 e .NET Framework 3.5 non sono installate nel computer SharePoint Server.

Messaggi di errore

  • Errore durante il passaggio di distribuzione 'Riciclo pool di applicazioni IIS': spazio dei nomi non valido
  • Errore durante il passaggio di distribuzione 'Riciclo pool di applicazioni IIS': un'attività è stata annullata.

Risoluzione

Per risolvere questo problema, nel computer SharePoint Server verificare se la funzionalità di Windows Compatibilità WMI di IIS 6 è installata,

  • Windows PowerShell. È possibile verificare se la funzionalità è installata eseguendo questo comando di PowerShell: get-windowsfeature -name Web-WMI. Se non viene visualizzato come installato, è possibile installarlo eseguendo il comando di PowerShell seguente: install-windowsfeature -name Web-WMI. Se vengono ancora visualizzati errori durante il riciclo del pool di applicazioni, assicurarsi che .NET Framework 3.5 sia installato anche nel computer eseguendo get-windowsfeature -name NET-Framework-Core e install-windowsfeature -name NET-Framework-Core in caso contrario.

Viene visualizzato un errore quando si tenta di visualizzare una web part visiva in SharePoint

Questo problema si verifica quando la proprietà Path del controllo utente non inizia con la stringa "CONTROLTEMPLATES\".

Messaggi di errore

  • Il file '/_CONTROLTEMPLATES/nome progetto nome></web part nome>></ controllo utente.ascx' non esiste.<

  • Errore del server nell'applicazione '/'.

Risoluzione

Per risolvere il problema

  1. In Esplora soluzioni scegliere il file di controllo utente, la cui estensione del nome file è ascx.

  2. Sulla barra dei menu scegliere Visualizza>finestra Proprietà.

  3. Nella finestra Proprietà espandere il nodo Percorso di distribuzione.

  4. Assicurarsi che il valore della proprietà Path inizi con la stringa "CONTROLTEMPLATES\".

Viene visualizzato un errore quando viene eseguito un flusso di lavoro riutilizzabile importato che contiene un campo modulo attività

Questo problema si verifica se si importa un flusso di lavoro contenente un modulo attività con un campo e quindi si esegue il nuovo flusso di lavoro nello stesso sistema da cui è stato importato.

Error message

Errore durante il passaggio di distribuzione 'Attiva funzionalità': il campo con ID [Guid] definito nella funzionalità [Guid] è stato trovato nella raccolta siti corrente o in un sito secondario.

Risoluzione

Questo errore è il risultato di conflitti di ID campo che si verificano perché il progetto Importa flusso di lavoro riutilizzabile in Visual Studio non modifica gli ID campo modulo attività. Se si distribuisce un flusso di lavoro importato nello stesso server che contiene il flusso di lavoro originale, si verificano conflitti di ID campo.

Per risolvere questo problema, usare la funzionalità Trova e sostituisci per modificare il valore dell'attributo ID campo in tutti i file del flusso di lavoro importati.

L'errore viene visualizzato quando viene eseguita un'istanza di elenco importata rinominata

Questo problema si verifica se si rinomina un'istanza di elenco importata e quindi la si esegue in Visual Studio.

Error message

Errore di compilazione: si è verificato un errore nel passaggio di distribuzione 'Activate Features': The file Template\Features\[import projectfeaturename]\Files\Lists\[oldlist name]\Schema.xml does not exist.

Risoluzione

Quando si importa un'istanza di elenco, viene aggiunto un attributo denominato CustomSchema al file Elements.xml dell'istanza dell'elenco. Elements.xml include il percorso di uno schema.xml personalizzato per l'istanza di elenco. Quando si rinomina l'istanza dell'elenco in Visual Studio, il percorso di distribuzione per lo schema.xml personalizzato cambia, ma il valore del percorso dell'attributo CustomSchema non viene aggiornato. Di conseguenza, l'istanza dell'elenco non riesce a trovare il file schema.xml nel percorso precedente specificato dall'attributo CustomSchema quando la funzionalità viene attivata.

Per risolvere questo problema, aggiornare il percorso di distribuzione del file schema.xml nell'attributo CustomSchema.

Sessione di debug di SharePoint terminata da IIS

Questo problema si verifica se si imposta un punto di interruzione in una soluzione SharePoint di Visual Studio, scegliere il tasto F5 per eseguirlo e quindi rimanere in un punto di interruzione più lungo di 90 secondi.

Error message

Il processo del server Web di cui è in corso il debug è stato terminato da Internet Information Services (IIS). Il problema può essere risolto configurando le impostazioni ping del pool di applicazioni in IIS. Per altri dettagli, vedere la Guida.

Risoluzione

Per impostazione predefinita, il pool di applicazioni IIS attende 90 secondi prima che un'applicazione risponda prima di chiudere l'applicazione. Questo processo è noto come "pinging" dell'applicazione. Per risolvere questo problema, è possibile aumentare il tempo di attesa o disabilitare completamente il ping dell'applicazione.

Per accedere alle impostazioni del pool di app IIS

  1. Apri Gestione IIS.

  2. Nel riquadro Connessione espandere il nodo del server SharePoint e quindi scegliere il nodo Pool di applicazioni.

  3. Nella pagina Pool di applicazioni scegliere il pool di applicazioni di SharePoint (in genere "SharePoint - 80") e quindi nel riquadro Azioni scegliere il collegamento Avanzate Impostazioni.

  4. Per aumentare il tempo di attesa prima del timeout di IIS, modificare il valore di Ping Maximum Response Time (seconds) in un valore maggiore di 90 secondi.

  5. Per disabilitare il ping iis, impostare Ping abilitato su False.

Il ritiro automatico lascia l'istanza dell'elenco orfana in SharePoint

Questo problema si verifica se si esecludono i passaggi seguenti.

  1. Creare una definizione di elenco con un'istanza di elenco in Visual Studio.

  2. Scegliere il tasto F5 per eseguire la soluzione.

  3. Arrestare il debug o chiudere il sito di SharePoint.

  4. Riaprire il sito di SharePoint e aprire l'istanza dell'elenco.

Error message

Errore del server nell'applicazione '/'.

Risoluzione

Ciò si verifica perché dopo aver chiuso una sessione di debug di una soluzione SharePoint, la funzionalità di ritiro automatico ritira la soluzione. Il ritiro elimina la definizione dell'elenco da SharePoint, ma non elimina l'istanza dell'elenco. La definizione dell'elenco sottostante è richiesta dall'istanza dell'elenco.

Per risolvere questo problema, distribuire la soluzione tramite, nella barra dei menu scegliere Distribuisci compilazione>. (Non eseguire il debug della soluzione scegliendo Tasto F5 . Eliminare quindi l'istanza dell'elenco in SharePoint.

La soluzione SharePoint originale viene sostituita da una versione esportata

Se si esporta una soluzione SharePoint, importare la soluzione in Visual Studio e quindi distribuire nuovamente la soluzione nello stesso sito da cui è stata esportata, la soluzione SharePoint originale viene sostituita. Questo problema non si verifica se si distribuisce la soluzione in un server in cui non è attivata la soluzione originale.

Error message

Nessuno.

Risoluzione

Per evitare di sovrascrivere una soluzione nel sito da cui è stata esportata, modificare i GUID dell'ID soluzione e gli ID funzionalità di tutte le funzionalità importate nel progetto di Visual Studio.

Viene visualizzato un errore all'avvio del debug

Quando si avvia il debug di una soluzione SharePoint in Visual Studio, viene visualizzato un errore indicante che è impossibile caricare il file di configurazione Web.config in Visual Studio perché la chiave specificata non è presente nel dizionario.

Error message

Impossibile caricare il file di configurazione Web.config. Controllare la presenza di elementi XML in formato non valido e riprovare. Si è verificato l'errore seguente: la chiave specificata non è presente nel dizionario.

Risoluzione

Per risolvere questo problema, verificare che il valore della proprietà URL sito del progetto SharePoint in Visual Studio corrisponda all'URL assegnato all'area predefinita per i mapping di accesso alternativo dell'applicazione Web. L'utilizzo di un'altra area, ad esempio Intranet, per l'URL non risolverà l'errore. L'URL del sito del progetto e l'URL nell'area predefinita devono corrispondere. Per accedere ai mapping di accesso alternativi, aprire l'utilità di Amministrazione istration centrale di SharePoint 2010, scegliere il collegamento Gestione applicazioni e quindi, in Applicazioni Web, scegliere il collegamento Configura mapping di accesso alternativo. Per altre informazioni, vedere Creare zone per le applicazioni Web.

Contenuto correlato