Risoluzione dei problemi relativi alle soluzioni SharePoint

Di seguito sono elencati i problemi o gli avvisi che potrebbero essere generati quando si esegue il debug di soluzioni SharePoint tramite il debugger di Visual Studio. Per ulteriori informazioni, vedere Debugging SharePoint Workflow Solutions.

Nel presente argomento sono contenute le seguenti sezioni.

• Restrizioni relative ai caratteri in nomi di progetti e di elementi del progetto
• Errori in caso di creazione di campi personalizzati
• Le nuove definizioni di sito non in lingua inglese non vengono visualizzate nella pagina di creazione del sito dopo la distribuzione
• Quando un progetto flusso di lavoro viene distribuito in un sistema pulito viene visualizzato un errore
• L'utente deve aggiornare la pagina dell'applicazione nel browser durante il debug per visualizzare l'immagine aggiornata
• Errore: Percorso del sito non valido
• L'evento Web di eliminazione del sito non si verifica nel progetto Ricevitore di eventi
• Dopo aver modificato il nome di un identificatore in un progetto Modello di integrazione applicativa dei dati viene visualizzato un errore di distribuzione
• Quando si tenta di visualizzare una web part visiva in SharePoint viene visualizzato un errore
• Quando viene eseguito un flusso di lavoro riutilizzabile importato contenente un campo del form di attività viene visualizzato un errore
• Quando viene eseguita un'istanza di elenco importata rinominata viene visualizzato un errore
• Sessione di debug di SharePoint terminata da IIS
• La ritrazione automatica lascia l'istanza di elenco orfana in SharePoint
• La soluzione SharePoint originale viene sostituita da una versione esportata
• Quando si avvia il debug viene visualizzato un errore
• Argomenti correlati

Restrizioni relative ai caratteri in nomi di progetti e di elementi del progetto

Nei nomi di progetti e di elementi del progetto possono essere inclusi solo caratteri che sono validi in un percorso di distribuzione in SharePoint 2010. Non è consentito l'uso di altri caratteri.

Messaggio di errore

Messaggio di errore "Caratteri non validi".

Risoluzione

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

• Caratteri ASCII alfanumerici

• Spazio

• punto (.)

• Virgola (,)

• Segno di sottolineatura (_)

• Trattino (-)

• barra rovesciata (\)

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

Errori in caso di creazione di campi personalizzati

I campi personalizzati in Visual Studio 2010 sono definiti in XML. Se un campo non è definito o non viene fatto riferimento ad esso tramite un formato specifico, si possono verificare errori.

Messaggio di errore

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. Ad esempio,

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

Un riferimento al campo in un tipo di contenuto deve essere definito utilizzando il formato dell'elemento vuoto (<FieldRef />), non tramite elementi iniziali o finali (<FieldRef></FieldRef>). Ad esempio:

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

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

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

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

Messaggio di errore

Nessuno.

Risoluzione

Questo problema si verifica a causa di un valore non corretto nella proprietà Percorso del file di configurazione della definizione del sito webtemp, ad esempio webtemp_SiteDefinitionProject1.xml. Nella proprietà Percorso del file webtemp, che si trova nel Percorso di distribuzione, modificare 1033 con l'ID delle impostazioni locali appropriato. Per utilizzare ad esempio le impostazioni locali giapponesi impostare il valore su 1041. Per ulteriori informazioni, vedere la pagina relativa agli ID delle impostazioni locali assegnati da Microsoft sul sito Web MSDN.

Quando un progetto flusso di lavoro viene distribuito in un sistema pulito viene visualizzato un errore

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

Messaggio di errore

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

Risoluzione

Questo errore si verifica a causa della mancanza di un elenco Cronologia flusso di lavoro. Poiché l'ambiente di sviluppo è un sistema pulito, non sono presenti flussi di lavoro distribuiti e l'elenco Cronologia flusso di lavoro non esiste ancora. Per risolvere questo problema, riaprire la procedura guidata del flusso di lavoro per creare l'elenco Cronologia flusso di lavoro.

Per accedere di nuovo alla procedura guidata del flusso di lavoro

1. Selezionare il nodo del flusso di lavoro in Esplora soluzioni.

2. Nella finestra Proprietà fare clic sul pulsante con i puntini di sospensione (…) accanto a una proprietà.

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 che contiene una pagina di 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: Percorso del sito non valido

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

Messaggio di errore

• Il percorso del sito SharePoint non è valido.

Risoluzione

• Installare SharePoint Server 2010.

• Assicurarsi di disporre dell'accesso come amministratore al sito Web SharePoint. Per ulteriori informazioni, vedere l'articolo di Office Online Concedere l'accesso al sito del portale (la pagina potrebbe essere in inglese).

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 come ad esempio "è in corso l'eliminazione di un sito", l'evento non si verifica mai.

Messaggio di errore

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 predefinito della funzionalità per i progetti di tipo ricevitore di eventi è "Web". Gli eventi Web interessati sono:

• È in corso l'eliminazione di un sito (WebDeleting)

• È stato eliminato un sito (WebDeleted)

• È in corso lo spostamento di un sito (WebMoving)

• È stato spostato un sito (WebMoved)

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

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

1. Aprire la funzionalità del ricevitore di eventi in Progettazione funzionalità. A tale scopo, fare doppio clic sul file its .feature in Esplora soluzioni.

2. Fare clic sulla freccia a discesa accanto a Ambito.

3. Selezionare Sito nell'elenco a discesa.

Dopo aver modificato il nome di un identificatore in un progetto Modello di integrazione applicativa dei dati viene visualizzato un errore di distribuzione

Questo problema si verifica quando si modifica il nome dell'identificatore di un'entità in un modello di integrazione applicativa dei dati (BDC, Business Data Connectivity) e si tenta di distribuire la soluzione.

Messaggi di errore

• <nome modello> ha i seguenti errori di attivazione per il tipo di contenuto esterno ...

• IMetadataObject con nome '<nome modello>' ha un valore duplicato nel campo 'nome' ...

Risoluzione

Per risolvere questo problema, eliminare manualmente il modello, quindi distribuire nuovamente la soluzione. È possibile eliminare il modello tramite uno degli strumenti riportati di seguito:

• Amministrazione centrale SharePoint 2010. Per ulteriori informazioni, vedere Gestire i modelli BDC sul sito Web Microsoft TechNet.

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

Quando si tenta di visualizzare una web part visiva in SharePoint viene visualizzato un errore

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 server nell'applicazione '/'.

Risoluzione

Per risolvere il problema

1. In Esplora soluzioni selezionare il file del controllo utente. L'estensione di questo file è ascx.

2. Scegliere Finestra Proprietà dal menu Visualizza.

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

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

Quando viene eseguito un flusso di lavoro riutilizzabile importato contenente un campo del form di attività viene visualizzato un errore

Questo problema si verifica se si importa un flusso di lavoro contenente un form di attività che dispone di un campo e il nuovo flusso di lavoro viene eseguito nello stesso sistema dal quale è stato importato.

Messaggio di errore

Si è verificato un errore nella fase 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 di campo che si verificano perché il progetto Importa flusso di lavoro riutilizzabile in Visual Studio non consente la modifica di ID di campo del form di attività. Se si distribuisce un flusso di lavoro importato nello stesso server in cui è contenuto il flusso di lavoro originale, si verificano conflitti di ID di campo.

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

Quando viene eseguita un'istanza di elenco importata rinominata viene visualizzato un errore

Questo problema si verifica se si rinomina un'istanza di elenco importata che viene eseguita in Visual Studio.

Messaggio di errore

Errore di compilazione: Si è verificato un errore nella fase di distribuzione 'Attiva funzionalità': Il file Template\Features\[import project feature name]\Files\Lists\[old list name]\Schema.xml non esiste.

Risoluzione

Quando si importa un'istanza di elenco, un attributo denominato CustomSchema viene aggiunto al file Elements.xml dell'istanza di elenco. Nel file Elements.xml è incluso il percorso di un file schema.xml personalizzato per l'istanza di elenco. Quando si rinomina l'istanza di elenco in Visual Studio, il percorso di distribuzione per il file schema.xml personalizzato viene modificato, ma il valore del percorso dell'attributo CustomSchema non viene aggiornato. Di conseguenza, è impossibile trovare nell'istanza di elenco 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. Premere F5 per eseguirla, quindi restare in corrispondenza del punto di interruzione per più di 90 secondi.

Messaggio di errore

Il processo del server Web in fase di debug è stato interrotto da Internet Information Services (IIS). Il problema può essere risolto configurando le impostazioni ping del pool di applicazioni. Per ulteriori informazioni, consultare la Guida.

Risoluzione

Per impostazione predefinita, il pool di applicazioni di IIS attende 90 secondi per la risposta da parte di un'applicazione prima di chiuderla. Questo processo è noto come "esecuzione di ping" dell'applicazione. Per risolvere il problema, è possibile aumentare il tempo di attesa o disabilitare completamente il ping dell'applicazione.

Per accedere alle impostazioni del pool di applicazioni di IIS

1. Aprire Gestione IIS.

2. Nel riquadro Connessioni espandere il nodo del server SharePoint e fare clic su Pool di applicazioni.

3. Nella pagina Pool di applicazioni selezionare il pool di applicazioni di SharePoint (in genere "SharePoint - 80"), quindi, nel riquadro Azioni, fare clic su Impostazioni avanzate.

4. Per aumentare il tempo di attesa prima del timeout di IIS, impostare Tempo massimo di risposta ping (secondi) su un valore superiore ai 90 secondi.

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

La ritrazione automatica lascia l'istanza di elenco orfana in SharePoint

Questo problema si verifica se si effettuano i passaggi riportati di seguito.

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

2. Esecuzione della soluzione premendo F5.

3. Arresto del debug o chiusura del sito di SharePoint.

4. Riapertura del sito di SharePoint e apertura dell'istanza di elenco.

Messaggio di errore

Errore server nell'applicazione '/'.

Risoluzione

Questo errore si verifica perché dopo la chiusura di una sessione di debug di una soluzione SharePoint, la soluzione viene ritirata dalla funzionalità di ritrazione automatica. La ritrazione consente di eliminare la definizione di elenco da SharePoint ma non di eliminare l'istanza dell'elenco. La definizione di elenco sottostante è richiesta dall'istanza di elenco.

Per risolvere questo problema, scegliere Distribuisci dal menu Compila per distribuire la soluzione. Non utilizzare F5 per eseguire il relativo debug. Quindi, eliminare l'istanza di elenco in SharePoint.

La soluzione SharePoint originale viene sostituita da una versione esportata

Se si esporta una soluzione SharePoint, si importa la soluzione in Visual Studio, quindi si distribuisce di nuovo la soluzione nello stesso sito dal quale è stata esportata, la soluzione SharePoint originale viene sostituita. Questo problema non si verifica se si distribuisce la soluzione in un server che non dispone della soluzione originale in esso attivata.

Messaggio di errore

Nessuno.

Risoluzione

Per evitare di sovrascrivere una soluzione sul sito dal quale è stata esportata, modificare i GUID di SolutionID e gli ID della funzionalità di tutte le funzionalità importate nel progetto Visual Studio.

Quando si avvia il debug viene visualizzato un errore

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.

Messaggio di errore

Impossibile caricare il file di configurazione Web.config. Verificare che nel file non siano presenti elementi XML in formato non corretto, quindi riprovare. Si è verificato il seguente errore: La chiave specificata non era 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 alternativo, fare clic su Gestione applicazioni nell'utilità Amministrazione centrale di SharePoint 2010, quindi fare clic sul collegamento Configura mapping di accesso alternativo sotto Applicazioni Web. Per ulteriori informazioni, vedere Creare aree per le applicazioni Web.

Vedere anche

Concetti

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

Altre risorse

Compilazione e debug delle soluzioni SharePoint

Debugging in Visual Studio