Si es necesario, puedes cambiar el conjunto de enlaces que aparecen en el menú de la izquierda del marco de Web Client. Lo ideal es evitar hacer cambios en el menú y, en su lugar, agregar enlaces a la página de inicio como se explica en Personalización del menú principal de Web Client.
Las siguientes secciones describen cómo funcionan los menús principales y ofrecen procedimientos para agregar nuevos enlaces.
- Cómo se definen los menús de Web Client
- Inicio de la declaración del menú principal
- Definición de los elementos del menú
- Destinos de los enlaces
- Agregar enlaces a la página de inicio de Web Client
Cómo se definen los menús de Web Client
Los menús de Web Client se definen mediante declaraciones de menú. Estas declaraciones se escriben en XML y se almacenan en archivos en el servidor de aplicaciones. Para cada elemento del menú, la declaración identifica la etiqueta que verá el usuario y el destino del enlace cuando seleccione ese elemento.
Las declaraciones de menú se utilizan tanto para el menú principal que se muestra en el marco, como para los menús desplegables que se usan en las páginas de Web Client. Normalmente, solo necesitas personalizar el menú principal.
La declaración XML del menú principal se define en el archivo menu.xml. Este archivo se instala en el directorio etc de la máquina del servidor de aplicaciones. La declaración del menú en sí se llama mainMenu.
En una instalación típica, el directorio etc es:
C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc.
Si deseas modificar este menú principal, primero debes copiar y pegar la declaración en un archivo aparte. El servidor de aplicaciones de InterAction instala un archivo XML de menú en blanco llamado localMenus.xml para este propósito. Utiliza esta versión para personalizar los menús.
El archivo localMenus.xml se instala en el directorio local de la máquina del servidor de aplicaciones.
En una instalación típica, el directorio local es:
C:\Program Files\LexisNexis\InterAction\AppServer\iahome\local.
Configurar el menú principal requiere editar archivos XML. Antes de usar los procedimientos de esta sección para cambiar el menú principal, deberías estar familiarizado con los conceptos básicos de XML. Debes comprender los siguientes términos y conceptos:
- Elementos y etiquetas
- La diferencia entre etiquetas de apertura y cierre
- Anidar una etiqueta dentro de otra etiqueta
- Atributos
- Asignar valores a los atributos
- Hacer que un documento XML sea bien formado
Si no estás familiarizado con estos conceptos, consulta Descripción general de la edición de archivos XML para obtener una visión general. Ten en cuenta que debes sentirte cómodo trabajando con XML para poder configurar el Web Client de InterAction.
Inicio de la declaración del menú principal
La declaración del menú para el menú principal de Web Client comienza con una etiqueta XML <menuItem> similar a la siguiente:
<menuItem id='mainMenu'>
La etiqueta <menuItem> inicia un nuevo elemento de menú; el atributo id le asigna un nombre. Todos los elementos dentro del menú se anidan entre la etiqueta de apertura <menuItem> y una etiqueta de cierre:
</menuItem>
Definición de los elementos del menú
Un elemento de menú se define con un bloque de XML como el siguiente:
Definición de un elemento de menú en XML
<menuItem>
<label>$(Contact Types)</label>
<methodName>contact-lists-home</methodName>
<url>
contact-lists-home?folderClass=1&searchDescription=$(Contact Types)
</url>
</menuItem>
Este bloque XML se puede interpretar de la siguiente manera:
- La etiqueta <menuItem> inicia el elemento. Normalmente, esto se anida dentro de otra etiqueta <menuItem> que inicia todo el menú.
- La etiqueta <label> proporciona el texto que se muestra para el elemento del menú. En el ejemplo anterior, se utiliza una variable para la etiqueta. La variable $(Contact Types) contiene el término para tipos de contacto en tu entorno.
- La etiqueta <methodName> es el nombre del método de página que define la página que deseas mostrar. Aunque esto se incluye en varias de las páginas predeterminadas, no es necesario si proporcionas la etiqueta <url>.
- La etiqueta <url> proporciona la URL completa de la página que se va a mostrar, incluidos los parámetros que deben pasarse a la página.
El menú principal consta de varios de estos bloques, todos anidados bajo la etiqueta <menuItem> que inicia todo el menú.
Destinos de los enlaces
Para cada elemento del menú que aparece como enlace, debes especificar un destino usando la etiqueta <url>. Al enlazar a otra página de Web Client, proporciona el nombre de la página y los parámetros que requiera en la URL.
Por ejemplo, observa la siguiente URL utilizada para el elemento de menú Alumni:
URL para el elemento de menú Alumni
<menuItem>
<label>$(Contact Types)</label>
<methodName>contact-lists-home</methodName>
<url>
contact-lists-home?folderClass=1&searchDescription=$(Contact Types)
</url>
</menuItem>
Esta URL se desglosa de la siguiente manera:
- contact-lists-home es el nombre de una página de Web Client que muestra una “lista de listas”. Esta página acepta varios parámetros que definen qué tipos de listas mostrar (tipos de contacto, listas de marketing o listas de trabajo).
-
Los elementos después del signo de interrogación (?) son los parámetros que se pasan a la página. Cada parámetro se separa con el siguiente símbolo:
&
Este es un carácter especial de XML que se convierte en un ampersand (&) cuando se muestra la página.