Affichage des informations ACL lors du débogage

Pourquoi et quand exécuter cette tâche

En principe, les résultats de recherche s'affichent au format HTML, mais peuvent également l'être au format XML brut non rendu en ajoutant le paramètre CGI v:xml=1 à l'URL de votre requête. Comme indiqué dans la documentation Watson Explorer Engine, un administrateur peut ajouter ce paramètre à une requête adressée à une application afin de pouvoir examiner le code XML réel renvoyé par une requête.

Si vous développez une application, il s'avère très utile de pouvoir afficher des résultats de recherche bruts pour vérifier que toutes les informations que vous recherchez sont réellement renvoyées par vos requêtes. Cela est particulièrement utile si vous développez et déboguez des applications de recherche qui utilisent l'authentification pour déterminer quels utilisateurs doivent être en mesure de consulter certains résultats.

Après avoir procédé à une recherche et ajouté &v:xml=1 à la fin de l'URL, appuyez sur return pour afficher la version XML des résultats de la recherche. Utilisez les capacités de recherche de votre navigateur pour accéder aux noeuds document, qui sont les éléments contenant réellement les résultats. Le noeud cache associé à chaque élément de document (voir la Figure 1 contient un attribut acl qui présente une liste des ACL de cet élément de document. Vous devrez probablement faire défiler la fenêtre de votre navigateur pour accéder à l'attribut acl.

Figure 1. Affichage des détails ACL dans les résultats de recherche XML

Pour les besoins des tests et de la vérification, vous pouvez également activer une option d'affichage des informations ACL détaillées dans l'index d'une source distante (un partage de fichiers SMB, par exemple) que vous explorez. Cette option permet au moteur de recherche de sortir des informations ACL tant au niveau du document que du contenu. Pour des raisons de performances, cela ne doit avoir lieu qu'au moment du développement et des tests, et jamais dans un système de production.

Des informations ACL plus détaillées peuvent être données à partir de l'onglet Configuration de votre collection de recherches :

Procédure

Cliquez sur cet onglet, sélectionnez le sous-onglet Searching, puis cliquez sur edit pour éditer les options d'indexation.
Faites défiler vers le bas jusqu'à la section Debugging, puis attribuez la valeur true à l'option Output ACLs.
Revenez en haut de la page et cliquez sur OK pour enregistrer vos modifications.
Redémarrez le service d'indexation en cliquant sur le lien restart dans la case jaune en haut de la page.
Entrez un exemple de requête ("test", par exemple) dans la zone de texte de requête sous l'intitulé Test with project dans la barre de menu de gauche de l'outil d'administration Watson Explorer Engine, puis cliquez sur Search.

Résultats

Lorsque les résultats de la recherche s'affichent, placer le curseur dans la barre d'adresse/d'URL, ajoutez &v:xml=1 à la fin de l'URL qui a renvoyé ces résultats, et appuyez sur return. Votre navigateur affiche le XML non formaté qui a été renvoyé par l'application de recherche, avant de le convertir en HTML et de rendre la page. Cet écran doit contenir le code XML ressemblant à celui de la Figure 2.

Figure 2. Affichage de détails ACL dans les résultats de recherche XML

Pour réellement voir les informations ACL par projet, vous pouvez utiliser les capacités de recherche internes de votre navigateur pour rechercher la chaîne default-content-acl. Chaque élément de document contient un attribut default-content-acl qui définit les ACL associées à ce résultat de recherche dans les données que vous avez explorées pour créer la collection de recherches. Comme le suggère le nom, il s'agit de la valeur par défaut de tous les éléments de contenu, sauf si votre application de recherche met en oeuvre une logique d'identification d'éléments de contenu spécifiques et modifie leurs informations ACL.

Important : Comme indiqué plus haut dans cette section, vous devez désactiver l'option Output ACLs à l'issue de la vérification de l'extraction réussie de toutes les ACL.

Pour désactiver cette option, retournez au sous-onglet Searching de la collection de recherches, cliquez sur edit, puis attribuez la valeur false à l'option Output ACLs. Ensuite, vous devez cliquez sur OK pour enregistrer vos paramètres modifiés, puis redémarrer votre service d'indexation pour ne plus renvoyer ces informations.

Pour poursuivre avec ce tutoriel, cliquez sur Création d'un projet.