Réparer les emplacements fédérés (Office SharePoint Server)

Mise à jour : 2008-07-31

NoteRemarque :

Sauf indication contraire, les informations contenues dans cet article s’appliquent à Office SharePoint Server 2007 avec la Mise à jour d’infrastructure pour les produits serveur de Microsoft Office.

Dans Microsoft Office SharePoint Server 2007, la fédération permet aux utilisateurs finaux d’émettre une requête qui effectue une recherche dans plusieurs sources et regroupe les résultats dans une page de résultats de recherche unique. Ces sources peuvent être des référentiels de contenu d’entreprise, d’autres moteurs de recherche ou des parties de votre index Office SharePoint Server 2007. La source est définie par un emplacement fédéré.

Les problèmes de configuration peuvent parfois se traduire par le non-affichage ou l’affichage incorrect des résultats de recherche fédérés. Cet article décrit certains des scénarios courants dans lesquels les emplacements fédérés peuvent cesser de fonctionner correctement et fournit des informations de dépannage vous permettant de résoudre ces problèmes.

NoteRemarque :

Si vous n’êtes pas familiarisé avec les emplacements fédérés, lisez l’article Fédération des résultats de recherche à partir d'autres emplacements (Office SharePoint Server).

Corriger les erreurs de configuration

Lorsque vous créez ou importez un emplacement fédéré, Office SharePoint Server 2007 offre une vérification d’erreur contextuelle limitée qui se traduit par la vérification des informations que vous entrez dans les pages Ajouter un emplacement fédéré ou Modifier l'emplacement fédéré. Par exemple, l’omission d’informations requises ou la saisie de données non valides dans les champs de la page Ajouter un emplacement fédéré entraîne l’affichage d’un message d’erreur et l’emplacement ne pourra être enregistré qu’une fois le problème résolu.

NoteRemarque :

La vérification des erreurs dans les pages de configuration de fédération Office SharePoint Server 2007 ne fournit pas de mécanisme pour la validation des URL de flux, des informations d’identification de sécurité ou du code XSL personnalisé. Vous devez manuellement vérifier ces informations avant de les entrer dans les pages de configuration des emplacements fédérés.

Tester les résultats de la recherche

Une fois que vous avez créé un emplacement fédéré, assurez-vous qu’il est correctement configuré en le connectant aux composants WebPart pour les résultats de recherche fédérés ou pour les résultats fédérés de niveau supérieur, puis en soumettant une requête de test.

À première vue, un emplacement fédéré qui renvoie des résultats de recherche peut sembler fonctionner correctement. Toutefois, si l’emplacement a été récemment créé, importé ou modifié, vous devez soigneusement consulter les résultats de la recherche avant de le mettre à la disposition des utilisateurs.

Résoudre les résultats de recherche incorrects

Si les résultats de la recherche semblent incorrects ou incomplets, essayez une ou plusieurs des procédures de dépannage suivantes :

Problème Test de vérification Informations complémentaires

Les résultats fédérés sont différents des résultats sources.

Vérifiez que vous avez spécifié un modèle de requête valide.

Dans la page Modifier l’emplacement fédéré, dans la section Informations concernant votre emplacement, vérifiez la syntaxe du modèle de requête que vous avez spécifié.

Si le modèle n’est pas valide, il ne passera pas correctement les requêtes à son emplacement associé.

Remarque   Les modèles de requête respectent la casse.

L’option « Autres liens » ne fonctionne pas ou ne permet pas d’atteindre la destination attendue.

Vérifiez que vous avez spécifié un modèle de lien « Autres résultats » valide.

Dans la page Modifier l'emplacement fédéré, dans la section Informations concernant votre emplacement, vérifiez la syntaxe du modèle de lien « Autres résultats » que vous avez spécifié.

Si le modèle n’est pas valide, les résultats complets de la recherche ne s’affichent pas correctement lorsqu’un utilisateur clique sur le lien Autres résultats.

Les résultats de la recherche semblent incorrectement mis en forme, n’incorporent pas les métadonnées sources attendues (texte ou images) ou l’emplacement n’est pas correctement restitué dans un éditeur compatible avec Windows SharePoint Services.

Vérifiez la validité du code XSL personnalisé, des propriétés de mise en forme ou des données exemple que vous avez entrés pour le composant WebPart pour les résultats fédérés ou pour les résultats fédérés de niveau supérieur.

Si vous ne l’avez déjà fait, vous pouvez personnaliser les paramètres par défaut XSL et Properties afin d’obtenir des données plus appropriées pour l’emplacement.

Dans la page Modifier l'emplacement fédéré, dans la section Informations d'affichage, vérifiez la validité du code personnalisé entré dans les champs XSL, Propriétés ou Exemple de données. Office SharePoint Server 2007 ne valide pas automatiquement le code dans ces champs ; il incombe à l’administrateur de vérifier que le code entré est valide.

Si vous suspectez une erreur dans le code XSL ou Propriétés, copiez le code personnalisé que vous avez entré, activez la case à cocher Utiliser la mise en forme par défaut pour réinitialiser le code par défaut, puis rajoutez avec soin le code personnalisé pour reprendre le test.

Comme avec tout codage personnalisé, commencez par une modification simple, enregistrez-la, puis testez l’emplacement. Ensuite, ajoutez progressivement du code plus complexe aux champs dans cette section et testez les résultats à nouveau.

Les résultats semblent modifiés ou ne s’affichent pas correctement dans différents navigateurs ou par rapport à la résolution de l’écran.

Vérifiez les résultats dans un autre navigateur Web et à une résolution d’écran différente.

Les utilisateurs finaux peuvent utiliser des configurations d’ordinateur et de moniteur différentes des vôtres. Pour vérifier minutieusement l’affichage attendu des résultats de recherche fédérés, testez l’emplacement dans différents navigateurs Web et à une résolution d’écran supérieure et inférieure.

En cas de problème de rendu, vous pouvez probablement le résoudre en apportant des modifications au code XSL de l’emplacement.

Autres problèmes.

Consultez les journaux ULS du serveur pour déterminer si des messages d’erreur ont été enregistrés au moment de l’exécution de la requête des emplacements fédérés.

Les fichiers journaux ULS (Unified Logging Service) disponibles dans Windows SharePoint Services fournissent un journal d’audit en continu qui vous avertit de toute condition d’erreur détectée. Dans la plupart des cas, la vérification des journaux ULS peut mettre en évidence des indices importants pour la résolution des problèmes.

Résoudre les résultats de recherche manquants

Si l’emplacement ne semble pas retourner de résultat de recherche, essayez une ou plusieurs des procédures de dépannage suivantes :

Problème Test de vérification Informations complémentaires

Aucun résultat n’est affiché, ou un message d’erreur Emplacement introuvable s’affiche.

Vérifiez que le flux source ou hôte fonctionne correctement.

Un problème temporaire au niveau de la source hôte peut parfois empêcher un emplacement fédéré d’extraire et d’afficher des résultats de recherche à partir de cette source.

Essayez d’accéder ou de vous connecter manuellement à la source hôte afin de vérifier qu’elle fonctionne correctement en dehors du système de fédération.

Assurez-vous également que le modèle de requête est correctement spécifié.

Aucun résultat n’est affiché, ou un message d’erreur Emplacement introuvable s’affiche.

Vérifiez que Office SharePoint Server 2007 est configuré de manière à pouvoir utiliser un serveur proxy pour la recherche.

Les administrateurs des services de recherche peuvent spécifier des paramètres du serveur proxy pour l’analyse de contenu et l’interrogation de sources fédérées sur des ordinateurs appartenant à d’autres réseaux, tels qu’Internet. Dans de nombreux cas, il est nécessaire d’utiliser un serveur proxy pour contourner toute restriction de sécurité intranet.

Si les journaux ULS de votre serveur contiennent des erreurs HTTP (telles que les erreurs « HTTP 404 Non trouvé ») et que votre réseau d’entreprise utilise un serveur proxy pour se connecter à Internet, vérifiez que les paramètres proxy de fédération sont correctement configurés.

Pour plus d’informations, voir Configurer les paramètres proxy pour les sources fédérées (Office SharePoint Server).

Aucun résultat n’est affiché ou un message d’erreur Authentification non valide apparaît.

Vérifiez que les emplacements exigeant une authentification passent correctement les informations d’identification nécessaires.

Si un ou plusieurs de vos emplacements fédérés requièrent l’authentification des utilisateurs, vérifiez que vous avez spécifié les informations d’identification nécessaires dans la section Spécifier les informations d'identification de la page Modifier l'emplacement fédéré.

Si, dans la page Modifier l'emplacement fédéré, l’option Type d'emplacement est définie sur Rechercher un index sur ce serveur, Office SharePoint Server 2007 utilise l’authentification par défaut. Toutefois, si l’option Type d'emplacement est définie sur OpenSearch 1.0/1.1, la section Spécifier les informations d'identification propose des options avancées, notamment plusieurs protocoles d’authentification basée sur l’utilisateur. Si vous utilisez un protocole d’authentification basée sur l’utilisateur, assurez-vous que l’authentification Kerberos est activée ou que vous rassemblez les informations d’identification de l’utilisateur par le biais de votre propre composant WebPart.

Aucun résultat n’est affiché ou une erreur de visualisation apparaît.

Vérifiez la validité du code XSL personnalisé, des propriétés de mise en forme ou des données exemple que vous avez entrés pour le composant WebPart pour les résultats fédérés ou pour les résultats fédérés de niveau supérieur.

Dans la page Modifier l'emplacement fédéré, dans la section Informations d'affichage, vérifiez la validité du code personnalisé entré dans les champs XSL, Propriétés ou Exemple de données. Office SharePoint Server 2007 ne valide pas automatiquement le code dans ces champs ; il incombe à l’administrateur de vérifier que le code entré est valide.

Si vous suspectez une erreur dans le code XSL ou Propriétés, copiez le code personnalisé que vous avez entré, activez la case à cocher Utiliser la mise en forme par défaut pour réinitialiser le code par défaut, puis rajoutez avec soin le code personnalisé pour reprendre le test.

Comme avec tout codage personnalisé, commencez par une modification simple, enregistrez-la, puis testez les résultats. Ensuite, ajoutez progressivement du code plus complexe aux champs dans cette section et testez les résultats à nouveau.

Aucun résultat n’est affiché.

Vérifiez que le type de déclencheur que vous avez sélectionné correspond à la requête pour votre emplacement.

Un emplacement fédéré n’est exploré que lorsque la requête d’un utilisateur correspond au déclencheur associé à cet emplacement.

Dans la page Modifier l'emplacement fédéré, dans la section Informations générales, vérifiez que le type Déclencheur approprié est sélectionné. Si la valeur actuellement sélectionnée est Préfixe ou Modèle, essayez de la remplacer par Toujours, puis déterminez si des résultats de recherche s’affichent.

Autres problèmes.

Consultez les journaux ULS du serveur pour déterminer si des messages d’erreur ont été enregistrés au moment de l’exécution de la requête des emplacements fédérés.

Les fichiers journaux ULS (Unified Logging Service) disponibles dans Windows SharePoint Services 3.0 fournissent un journal d’audit en continu qui vous avertit de toute condition d’erreur détectée. Dans la plupart des cas, la vérification des journaux ULS peut mettre en évidence des indices importants pour la résolution des problèmes.