Ripristinare i percorsi federati (Office SharePoint Server)

Nota

Se non diversamente specificato, le informazioni di questo articolo si applicano a Microsoft Office SharePoint Server 2007 con l'Aggiornamento dell'infrastruttura per Microsoft Office Servers.

In Microsoft Office SharePoint Server 2007 la federazione consente agli utenti finali di eseguire una query che effettua una ricerca in più origini e combina i risultati in una singola pagina di risultati di ricerca. Le origini possono essere archivi contenuti aziendali, altri motori di ricerca o parti dell'indice di Microsoft Office SharePoint Server 2007. L'origine è definita da un percorso federato.

È possibile che i risultati di ricerca federati non vengano visualizzati correttamente oppure non vengano visualizzati affatto a causa di problemi di configurazione. In questo articolo vengono descritti alcuni degli scenari più comuni in cui può accadere che i percorsi federati non funzionino correttamente e vengono fornite informazioni per la risoluzione di tali problemi.

Nota

Se non si ha familiarità con i percorsi federati, leggere l'articolo Federazione dei risultati di ricerca da altri percorsi (Office SharePoint Server).

Correzione degli errori di configurazione

In Microsoft Office SharePoint Server 2007 la possibilità di eseguire controlli degli errori contestuali durante la creazione o l'importazione di un percorso federato è ridotta e si limita al tentativo di verificare le informazioni immesse nella pagina Aggiungi percorso federato o Modifica percorso federato. Omettendo ad esempio le informazioni necessarie o immettendo dati non validi nei campi della pagina Aggiungi percorso federato verrà visualizzato un messaggio di errore, nel qual caso il percorso non potrà essere salvato finché non verrà risolto il problema.

Nota

Il controllo degli errori nelle pagine di configurazione della federazione di Microsoft Office SharePoint Server 2007 non comporta la convalida degli URL dei feed, delle credenziali di protezione o del codice XSL personalizzato. È consigliabile verificare manualmente queste informazioni prima di immetterle nelle pagine di configurazione dei percorsi federati.

Verifica dei risultati di ricerca

Dopo aver creato un percorso federato, assicurarsi che sia configurato correttamente connettendolo alle web part Risultati federati e Risultati di ricerca principali e quindi inviando una query di prova.

Un percorso federato che restituisce risultati di ricerca può sembrare all'apparenza perfettamente funzionante. Se tuttavia il percorso è stato appena creato, importato o modificato, è consigliabile esaminare attentamente i risultati della ricerca prima di renderli disponibili per gli utenti.

Risoluzione dei problemi relativi a risultati di ricerca non corretti

Se i risultati di ricerca non sono corretti o sono incompleti, provare a eseguire una o più delle operazioni di risoluzione dei problemi seguenti:

Problema	Test di verifica	Ulteriori informazioni
I risultati federati sono diversi dai risultati di origine.	Verificare di aver specificato un modello di query valido.	Nella sezione Informazioni sul percorso della pagina Modifica percorso federato verificare la sintassi del modello specificato in Modello query. Se il modello non è valido, non passerà correttamente le query al percorso associato. Nota   Per i modelli di query viene applicata la distinzione tra maiuscole e minuscole.
"Altri collegamenti" non funziona o non consente di accedere alla destinazione prevista.	Verificare di aver specificato un modello di collegamento "Altri risultati" valido.	Nella sezione Informazioni sul percorso della pagina Modifica percorso federato verificare la sintassi del modello specificato in Modello collegamento "Altri risultati". Se il modello non è valido, non verranno visualizzati correttamente risultati di ricerca completi quando un utente fa clic sul collegamento Altri risultati.
I risultati di ricerca sono formattati in modo inadeguato o non includono i metadati di origine previsti (testo o immagini) oppure il rendering del percorso non viene eseguito correttamente in un editor compatibile con Windows SharePoint Services.	Verificare la validità di eventuale codice XSL, proprietà di formattazione o dati di esempio personalizzati immessi per la web part Risultati federati o la web part Risultati federati principali. Se non si è già provveduto, è possibile personalizzare le impostazioni predefinite del codice dei campi XSL e Proprietà in modo da restituire dati più appropriati per il percorso.	Nella sezione Informazioni di visualizzazione della pagina Modifica percorso federato verificare la validità di eventuale codice personalizzato immesso nei campi XSL, Proprietà o Dati di esempio. In Microsoft Office SharePoint Server 2007 il codice presente in questi campi non viene convalidato automaticamente ed è responsabilità dell'amministratore verificarne la validità. Se si sospetta un errore nel codice presente nel campo XSL o Proprietà, copiare il codice personalizzato immesso, selezionare la casella di controllo Usa formattazione predefinita per reimpostare il codice predefinito e quindi aggiungere di nuovo, con attenzione, il codice personalizzato per riprendere il testing. Come con qualsiasi codifica personalizzata, iniziare con una semplice modifica, salvarla e verificare il percorso. Aggiungere quindi in modo graduale codice più complesso nei campi di questa sezione e verificare nuovamente i risultati.
I risultati sono diversi o non vengono visualizzati correttamente cambiando browser o la risoluzione dello schermo.	Verificare i risultati in un altro Web browser e con risoluzioni dello schermo diverse.	È possibile che gli utenti finali dispongano di configurazioni del computer e del monitor diverse. Per verificare accuratamente la visualizzazione prevista dei risultati di ricerca federati, verificare il percorso in diversi Web browser e con risoluzioni dello schermo superiori e inferiori. Se si verificano problemi di rendering, è possibile risolverli apportando modifiche al codice XSL del percorso.
Altri problemi.	Controllare se i registri ULS del server contengono messaggi di errore registrati durante l'esecuzione della query del percorso federato.	I file di registro del Servizio di registrazione unificato (ULS, Unified Logging Service) in Windows SharePoint Services forniscono un audit trail di esecuzione che notifica eventuali condizioni di errore rilevate. Nella maggior parte dei casi la verifica dei registri ULS consente di individuare importanti indicazioni per la risoluzione dei problemi.

Risoluzione dei problemi relativi a risultati di ricerca mancanti

Se il percorso non restituisce alcun risultato di ricerca, provare a eseguire una o più delle operazioni di risoluzione dei problemi seguenti:

Problema	Test di verifica	Ulteriori informazioni
Non vengono visualizzati risultati o viene visualizzato un messaggio di errore che comunica che il percorso non è stato trovato.	Verificare il corretto funzionamento di feed host o origine.	Un problema temporaneo nell'origine host può impedire a volte a un percorso federato di recuperare e visualizzare i risultati di ricerca dall'origine. Provare ad accedere o a connettersi manualmente all'origine host per verificare che funzioni correttamente al di fuori del sistema di federazione. Assicurarsi inoltre che il modello di query sia specificato correttamente.
Non vengono visualizzati risultati o viene visualizzato un messaggio di errore che comunica che il percorso non è stato trovato.	Verificare che Microsoft Office SharePoint Server 2007 sia configurato correttamente per l'utilizzo di un server proxy per la ricerca.	Gli amministratori dei servizi di ricerca possono specificare le impostazioni del server proxy per la ricerca per indicizzazione nel contenuto e l'esecuzione di query su origini federate in computer di altre reti, ad esempio Internet. In molti casi è necessario utilizzare un server proxy per ignorare restrizioni di protezione Intranet. Se nei log ULS del server sono contenuti errori HTTP, ad esempio errori di tipo 404 di segnalazione di elementi non trovati, e la rete aziendale utilizza un server proxy per la connessione a Internet, assicurarsi che le impostazioni proxy della federazione siano configurate correttamente. Per ulteriori informazioni, vedere Configurare le impostazioni del server proxy per le origini federate (Office SharePoint Server).
Non vengono visualizzati risultati o viene visualizzato un messaggio di errore di autenticazione non valida.	Verificare che i percorsi che richiedono l'autenticazione passino correttamente le credenziali necessarie.	Se uno o più percorsi federati richiedono l'autenticazione dell'utente, verificare di aver specificato le credenziali necessarie nella sezione Specifica credenziali della pagina Modifica percorso federato. Se per Tipo di posizione nella pagina Modifica percorso federato è specificato Indice di ricerca su questo server, in Microsoft Office SharePoint Server 2007 verrà utilizzata l'autenticazione predefinita. Se invece per Tipo di posizione è specificato OpenSearch 1.0/1.1, nella sezione Specifica credenziali saranno disponibili opzioni avanzate, inclusi diversi protocolli di autenticazione basata sull'utente. Se si utilizza un protocollo di autenticazione basata sull'utente, verificare di aver attivato Kerberos o di raccogliere le credenziali utente tramite la propria web part.
Non vengono visualizzati risultati o viene segnalato un errore di visualizzazione.	Verificare la validità di eventuale codice XSL, proprietà di formattazione o dati di esempio personalizzati immessi per la web part Risultati federati o la web part Risultati federati principali.	Nella sezione Informazioni di visualizzazione della pagina Modifica percorso federato verificare la validità di eventuale codice personalizzato immesso nei campi XSL, Proprietà o Dati di esempio. In Microsoft Office SharePoint Server 2007 il codice presente in questi campi non viene convalidato automaticamente ed è responsabilità dell'amministratore verificarne la validità. Se si sospetta un errore nel codice presente nel campo XSL o Proprietà, copiare il codice personalizzato immesso, selezionare la casella di controllo Usa formattazione predefinita per reimpostare il codice predefinito e quindi aggiungere di nuovo, con attenzione, il codice personalizzato per riprendere il testing. Come con qualsiasi codifica personalizzata, iniziare con una semplice modifica, salvarla e verificare i risultati. Aggiungere quindi in modo graduale codice più complesso nei campi di questa sezione e verificare nuovamente i risultati.
Non vengono visualizzati risultati.	Verificare che il tipo di trigger selezionato corrisponda alla query relativa al percorso.	Le ricerche in un percorso federato vengono eseguite solo se la query di un utente corrisponde al trigger del percorso. Nella sezione Informazioni generali della pagina Modifica percorso federato verificare che sia selezionato il tipo appropriato per Trigger. Se la selezione corrente è impostata su Prefisso o Modello, provare a impostarla su Sempre e controllare se vengono visualizzati risultati di ricerca.
Altri problemi.	Controllare se i registri ULS del server contengono messaggi di errore registrati durante l'esecuzione della query del percorso federato.	I file di registro del Servizio di registrazione unificato (ULS, Unified Logging Service) in Windows SharePoint Services 3.0 forniscono un audit trail di esecuzione che notifica eventuali condizioni di errore rilevate. Nella maggior parte dei casi la verifica dei registri ULS consente di individuare importanti indicazioni per la risoluzione dei problemi.