Si nécessaire, vous pouvez modifier l'ensemble des liens qui apparaissent dans le menu de gauche du cadre du Web Client. Idéalement, vous devriez éviter de modifier le menu et plutôt ajouter des liens à la page d'accueil comme expliqué dans Personnalisation du menu principal du Web Client.
Les sections suivantes décrivent comment fonctionnent les menus principaux et fournissent des procédures pour ajouter de nouveaux liens.
- Comment les menus du Web Client sont définis
- Commencer la déclaration du menu principal
- Définir les éléments de menu
- Destinations des liens
- Ajouter des liens à la page d'accueil du Web Client
Comment les menus du Web Client sont définis
Les menus pour le Web Client sont définis avec des déclarations de menu. Les déclarations de menu sont écrites en XML et stockées dans des fichiers sur le serveur d'application. Pour chaque élément de menu, une déclaration de menu identifie le libellé que l'utilisateur voit et la destination du lien lorsqu'un utilisateur sélectionne l'élément.
Les déclarations de menu sont utilisées à la fois pour le menu principal affiché dans le cadre, et pour les menus déroulants utilisés sur les pages du Web Client. Vous n'avez normalement besoin de personnaliser que le menu principal.
La déclaration de menu XML pour le menu principal est définie dans le fichier menu.xml. Ce fichier est installé dans le répertoire etc de la machine du serveur d'application. La déclaration de menu elle-même est appelée mainMenu.
Dans une installation typique, le répertoire etc est :
C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc.
Si vous souhaitez modifier ce menu principal, vous devez d'abord copier et coller la déclaration dans un fichier séparé. Le serveur d'application InterAction installe un fichier XML de menu vierge appelé localMenus.xml à cet effet. Vous utilisez cette version pour personnaliser les menus.
Le fichier localMenus.xml est installé dans le répertoire local de la machine du serveur d'application.
Dans une installation typique, le répertoire local est :
C:\Program Files\LexisNexis\InterAction\AppServer\iahome\local.
Configurer le menu principal nécessite de modifier des fichiers XML. Avant d'utiliser les procédures de cette section pour changer le menu principal, vous devez être familier avec les bases de XML. Vous devez comprendre les termes et concepts suivants :
- Éléments et balises
- La différence entre les balises ouvrantes et fermantes
- Imbriquer une balise dans une autre balise
- Attributs
- Attribuer des valeurs aux attributs
- Rendre un document XML bien formé
Si vous n'êtes pas familier avec ces concepts, consultez Aperçu de l'édition des fichiers XML pour un aperçu. Notez que vous devez être à l'aise avec le travail sur XML pour configurer le Web Client InterAction.
Commencer la déclaration du menu principal
La déclaration de menu pour le menu principal du Web Client commence par une balise XML <menuItem> similaire à la suivante :
<menuItem id='mainMenu'>
La balise <menuItem> commence un nouvel élément de menu ; l'attribut id lui attribue un nom. Tous les éléments du menu sont imbriqués entre la balise ouvrante <menuItem> et une balise fermante :
</menuItem>
Définir les éléments de menu
Un élément de menu est défini avec un bloc XML comme le suivant :
Définir un élément de menu en XML
<menuItem>
<label>$(Contact Types)</label>
<methodName>contact-lists-home</methodName>
<url>
contact-lists-home?folderClass=1&searchDescription=$(Contact Types)
</url>
</menuItem>
Ce bloc XML peut être interprété comme suit :
- La balise <menuItem> commence l'élément. Elle est normalement imbriquée dans une autre balise <menuItem> qui commence l'ensemble du menu.
- La balise <label> fournit le texte affiché pour l'élément de menu. Dans l'exemple ci-dessus, une variable est utilisée pour le libellé. La variable $(Contact Types) contient le terme pour les types de contact dans votre environnement.
- La balise <methodName> est le nom de la méthode de la page qui définit la page que vous souhaitez afficher. Bien que cela soit inclus dans plusieurs des pages prêtes à l'emploi, ce n'est pas nécessaire si vous fournissez la balise <url>.
- La balise <url> fournit l'URL complète de la page à afficher, y compris tous les paramètres qui doivent être passés à la page.
Le menu principal se compose de plusieurs de ces blocs, tous imbriqués sous la balise <menuItem> qui commence l'ensemble du menu.
Destinations des liens
Pour chaque élément de menu qui apparaît comme un lien, vous spécifiez une destination de lien avec la balise <url>. Lors de la liaison vers une autre page du Web Client, vous fournissez le nom de la page et tous les paramètres requis dans l'URL.
Par exemple, notez l'URL suivante utilisée pour l'élément de menu Alumni :
URL pour l'élément de menu Alumni
<menuItem>
<label>$(Contact Types)</label>
<methodName>contact-lists-home</methodName>
<url>
contact-lists-home?folderClass=1&searchDescription=$(Contact Types)
</url>
</menuItem>
Cette URL se décompose comme suit :
- contact-lists-home est le nom d'une page du Web Client qui affiche une “liste de listes”. Cette page accepte plusieurs paramètres qui définissent quels types de listes afficher (types de contact, listes marketing ou listes de travail).
-
Les éléments après le point d'interrogation (?) sont les paramètres à passer à la page. Chaque paramètre est séparé par le symbole suivant :
&
C'est un caractère XML spécial qui est converti en esperluette (&) lorsque la page est affichée.