Une déclaration de liste de nuggets définit un ensemble de liens affichés par un seul nugget appelé le nugget nuggetLists. Chaque lien défini peut cibler une page différente du Web Client (définie séparément par une méthode de page) ou une page complètement externe à InterAction, comme un moteur de recherche Internet.
Les déclarations de listes de nuggets sont stockées dans des fichiers XML sur l'ordinateur sur lequel le serveur d'applications est installé.
Une déclaration de liste de nuggets est très flexible. Chaque lien défini peut être configuré pour faire l'une des actions suivantes lorsqu'un utilisateur le sélectionne :
- Afficher la page cible dans une zone de cadre (techniquement un iframe) sur la même page.
- Afficher la page cible dans la fenêtre de navigateur existante (c'est-à-dire remplacer le contenu actuel de la fenêtre par la page cible).
- Ouvrir une nouvelle fenêtre de navigateur complète pour la page cible.
- Afficher la page cible dans une fenêtre "popup" séparée.
Vous pouvez également créer des éléments uniquement textuels à utiliser comme en-têtes dans la liste de liens.
Une liste de nuggets qui affiche le contenu dans un Iframe
[A] Ce bloc entier est le nugget de la liste de nuggets.
[B] Ceci est la zone de liens. Elle affiche une série de liens.
[C] Ceci est la zone de contenu. Elle affiche le contenu qui correspond au lien sélectionné. En coulisses, le corps affiche en fait une autre page.
Lors de la définition et de l'utilisation des listes de nuggets, vous devez vous rappeler qu'il y a 3 parties impliquées :
- La déclaration de la liste de nuggets. Cela identifie la liste des liens. Pour chaque lien, elle identifie le nom qui doit être affiché, l'URL de la page cible et le type de lien (iframe, etc.). Dans la figure ci-dessous, la liste des liens définie par une liste de nuggets est montrée dans la section B.
-
La destination, ou cible, pour chaque lien. Comme mentionné précédemment, cela peut être une autre page du Web Client ou une page Web externe.
Lors de la liaison à une page du Web Client, vous définissez la page avec une méthode de page, comme pour toute autre page. Lors de l'utilisation d'une liste de nuggets qui affiche les pages dans un iframe, il est important de concevoir la page de manière à ce qu'elle s'adapte bien au cadre offert par l'iframe.
- Le nugget nuggetLists lui-même. Comme pour tout autre nugget, vous placez ce nugget sur une page lors de la définition de la page dans une méthode de page. Vous transmettez l'ID de la liste de nuggets qui définit l'ensemble de liens que vous souhaitez que la page affiche.
Comment fonctionne une liste de nuggets sur une page
[A] Ce nugget fait partie de la page Aperçu de la personne, qui est définie par la méthode de page relationship-overview-person. Notez que l'en-tête "Personnes, entreprises et organisations liées" ne fait pas partie du nugget - ce texte est défini comme partie d'une balise de section sur la déclaration de la page.
[B] La page relationship-overview-person affiche le nugget nuggetLists.jsp, configuré pour utiliser une liste de nuggets appelée rel-person-results. Cette liste de nuggets a été définie pour afficher ces liens.
[C] Une deuxième méthode de page définit cette page (who-knows-simple-results). Cette page est la cible du lien Mes collègues qui connaissent cette personne. La page affiche une grille contenant les relations.
Fichiers pour les déclarations de listes de nuggets sur le serveur d'applications
Les fichiers suivants pour les listes de nuggets sont installés avec le serveur d'applications InterAction. Ils sont installés dans le répertoire etc de la machine du serveur d'applications.
- nuggetLists.xml
- externalIntegrationNuggetLists.xml
- brewNuggetLists.xml
- actionableItemNuggetLists.xml
Dans une installation typique, le répertoire etc est normalement :
C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc.
En plus de ceux-ci, le serveur d'applications InterAction installe également un fichier XML de liste de nuggets vierge appelé localNuggetLists.xml. Vous pouvez utiliser cette version pour vos propres déclarations. Vous pouvez copier et coller les listes de nuggets prêtes à l'emploi dans ce fichier pour les utiliser comme point de départ. C'est également la meilleure façon de faire des modifications à une liste de nuggets prête à l'emploi - copiez-la dans localNuggetLists.xml et faites vos modifications. Cela préserve la version originale.
Le fichier localNuggetLists.xml est installé dans le répertoire local de la machine du serveur d'applications.
Dans une installation typique, le répertoire local est :
C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc\local.