Agregar enlaces a la página de inicio de Web Client

Uno de los tipos de personalización más comunes para la página de inicio del Web Client es agregar enlaces adicionales a otras partes del sistema y a otros sitios. Por ejemplo, es posible que desee hacer lo siguiente:

• Agregar enlaces a otros formularios de búsqueda importantes y motores de búsqueda externos al conjunto de enlaces bajo “Buscar”.
• Agregar enlaces a algunas listas específicas de contactos importantes, como los principales clientes y prospectos.
• Agregar enlaces de “búsqueda rápida” a subconjuntos de las listas de contactos de la organización, como el personal de una oficina en particular.
• Agregar enlaces a más temas de ayuda o a procedimientos de procesos en su intranet.

Página de inicio personalizada con nuevos enlaces

[A] Enlace personalizado agregado al bloque Buscar... Este enlace abre el formulario de búsqueda de Clientes.

[B] Estos son nuevos bloques agregados a la página para ofrecer más enlaces personalizados.

La página de inicio predeterminada incluye varias listas estándar de enlaces (Buscar, Agregar nuevo, Centro de mensajes, etc.) y una lista adicional que se incluye si su organización tiene licencia para uno de los Módulos Relacionados.

Cada una de estas listas se coloca en la página usando el bloque formatSearchList.jsp, que puede mostrar un conjunto de enlaces definidos en una declaración de lista de búsqueda separada. Por lo tanto, la forma en que cambia los enlaces en la página depende exactamente de lo que desee modificar:

• Si solo desea agregar nuevos enlaces a una de las listas predeterminadas, edite la declaración de lista de búsqueda correspondiente.

  En la imagen anterior, así es como se agregó el nuevo elemento para Clientes a la lista “Buscar”.

• Si desea agregar un bloque completamente nuevo de enlaces, debe editar la declaración de la página para agregar una nueva instancia del bloque formatSearchList.jsp y luego agregar también una nueva declaración de lista de búsqueda para definir los enlaces.

  En el ejemplo anterior, el bloque Otros recursos es una instancia completamente nueva del bloque formatSearchList.jsp que se ha agregado a la página.

  Para obtener más información sobre cómo agregar nuevos bloques a la página de inicio, consulte Cambiar el diseño y los bloques en la página de inicio.

La siguiente tabla describe las declaraciones de listas de búsqueda predeterminadas que se usan en la página de inicio:

Sección de la página	Enlaces	Declaración de lista de búsqueda
Buscar...	Personas Empresas Actividades Asuntos, Oportunidades o Compromisos (si tiene licencia) Estos enlaces abren los formularios de búsqueda correspondientes en la página de búsqueda de contactos.	home-search
Agregar nuevo...	Contacto (abre el asistente para nuevo contacto) Actividad Recordatorio Asuntos, Oportunidades o Compromisos (si tiene licencia) No se recomienda modificar esta lista de búsqueda.	home-add
Centro de mensajes	Enlaces dinámicos según el estado de los contactos del usuario. No se recomienda modificar esta lista de búsqueda.	home-message
Módulos relacionados	Muestra un enlace a las búsquedas de calidad de datos para los Módulos Relacionados (InterAction Opportunities, InterAction Engagements y InterAction Matters). El enlace solo aparece si su organización tiene licencia para alguno de los módulos y usted ha iniciado sesión como usuario con permiso para usar las búsquedas.	home-related-modules
Ver...	Enlaces para ver recordatorios (si está habilitado). No se recomienda modificar esta lista de búsqueda.	home-view
Referencia rápida	Agregar un teléfono y dirección a un contacto Imprimir un informe para un contacto Usar el Mapa de relaciones Mantener mis contactos actualizados Personalizar mis ajustes de InterAction Más información sobre InterAction Estos enlaces abren temas en el sistema de ayuda del Web Client de InterAction.	home-how

Estas declaraciones de listas de búsqueda se almacenan en el archivo de configuración searchLists.xml, que se instala en el directorio etc de la máquina del Application Server.

Antes de editar una de estas declaraciones, debe copiarla al archivo localSearchLists.xml en el directorio local de la máquina del Application Server. En una instalación típica, el directorio local es C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc\local.

Una lista completa de etiquetas XML que se pueden usar en una declaración de lista de búsqueda está disponible en Referencia XML de declaración de lista de búsqueda. Las siguientes secciones destacan cómo se usan las etiquetas en las declaraciones de listas de búsqueda predeterminadas de la página de inicio:

• Etiquetas que inician una lista de búsqueda
• Definir elementos de la lista de búsqueda (encabezados y enlaces) para la página de inicio
• URLs de ejemplo para enlaces en la página de inicio
• Enlazar a temas de ayuda del Web Client
• Hacer una copia de la lista de búsqueda predeterminada para editar

Etiquetas que inician una lista de búsqueda

Todas las declaraciones de listas de búsqueda en un archivo de configuración XML deben estar anidadas dentro de la etiqueta searchListDeclarations Tag. Después de esta etiqueta, cada lista de búsqueda comienza con la etiqueta searchList Tag. Al proporcionar un valor para el atributo id, se nombra la lista para que pueda ser referenciada desde otras declaraciones. Esto inicia esencialmente una nueva lista. Después de la primera etiqueta searchList Tag, las etiquetas siguientes definen encabezados y enlaces. Consulte Etiqueta searchList.

Por ejemplo, en el siguiente ejemplo de código, la primera instancia de la etiqueta searchList Tag tiene el atributo id configurado como home-search. Por lo tanto, inicia una nueva lista de búsqueda con este ID. Las instancias siguientes de la etiqueta searchList Tag no establecen el atributo ID, por lo que definen nuevos elementos en la lista. El método de página para la página de inicio (home en el archivo pages.xml) hace referencia al ID home-search al colocar el bloque formatSearchList.jsp en la página.

Iniciar una lista de búsqueda y definir elementos — Ejemplos XML

<!-- Esta línea inicia la declaración de la lista de búsqueda home-search. Esto define el conjunto de enlaces que aparecen bajo el encabezado "Buscar..." en la página de inicio. El atributo id proporciona el nombre para la lista de búsqueda que puede usarse para referenciar la lista desde otras declaraciones.-->

<searchList id="home-search" template="searchList.xsl">

<searchList>

...<!-- aquí aparecen las etiquetas para el primer elemento de la lista -->

</searchList>

... <!-- aquí aparecerían más elementos de la lista de búsqueda antes de la etiqueta de cierre que termina toda la lista home-search. -->

</searchList>

Definir elementos de la lista de búsqueda (encabezados y enlaces) para la página de inicio

Usted define los elementos de la lista de búsqueda con la etiqueta searchList Tag. Consulte Etiqueta searchList para más detalles.

La etiqueta searchList Tag identifica lo siguiente:

• El texto que se mostrará en la página. Esto se establece con la etiqueta label Tag.
• La URL de destino para el enlace. Esto se establece con la etiqueta url Tag.

Por ejemplo, el siguiente código para la declaración home-search crea el enlace al formulario de búsqueda de Personas:

Definir elementos de la lista de búsqueda

<!-- Esta línea crea un enlace al formulario de búsqueda de Personas. Normalmente esto aparece anidado dentro de la etiqueta searchList Tag que inicia la declaración de la lista de búsqueda. -->

<searchList>

<!-- La etiqueta label Tag identifica el texto que aparece para el enlace -->

<label>Personas</label>

<!-- La etiqueta url Tag identifica la página de destino para el enlace. -->

<url>$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&amp;

usePersistence=false&amp;proxyAccount=$(proxyAccount)</url>

</searchList> <!-- esto termina este elemento de la lista de búsqueda. -->

Tanto las etiquetas como los destinos de los enlaces pueden incluir variables del Application Server. Cuando el Web Client muestra el texto, estas variables se reemplazan por sus valores reales. Dado que la página de inicio no tiene ningún contexto específico de contacto, realmente solo puede usar las variables relacionadas con el entorno, como userName.

Puede usar variables tanto en el nombre de la etiqueta como en el destino de la URL. Para más detalles sobre el uso de variables, consulte Uso de variables para información de InterAction.

Configurar la URL del enlace

El destino de un enlace especificado con la etiqueta url Tag puede ser la dirección de otra página del Web Client o cualquier otra página web a la que se pueda acceder mediante una solicitud HTTP estándar.

Al enlazar a una página del Web Client, puede usar la variable PAGE_SERVER en lugar de ingresar el nombre completo de su Application Server. También puede pasar parámetros a la página. Por ejemplo, la siguiente URL llama a la página advanced-searches y pasa tres parámetros:

defaultItemId=item5001

usePersistence=false

proxyAccount=$(proxyAccount)

URL del enlace

$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&amp;usePersistence=false&amp;proxyAccount=$(proxyAccount)

Los parámetros hacen que la página de búsqueda de contactos vaya a la búsqueda de Personas. Para más detalles sobre cómo determinar la URL de una página del Web Client, consulte URLs de páginas del Web Client. También consulte URLs de ejemplo para enlaces en la página de inicio.

URLs de ejemplo para enlaces en la página de inicio

La mayoría de los enlaces que agregue a la página de inicio entran en una de cinco categorías.

Sitios que no son de InterAction

Puede enlazar a cualquier sitio de Internet o intranet interna. Consulte el sitio al que desea enlazar para conocer el formato de la URL.

Formularios de búsqueda del Web Client

Use el mismo formato que se proporciona para los enlaces predeterminados en el bloque Buscar, pero reemplace el ID con el ID del formulario que desea abrir:

$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&amp;

usePersistence=false&amp;proxyAccount=$(proxyAccount)

Por ejemplo, cambie item5001 por item10013 para que el enlace abra el formulario de búsqueda de Principales clientes. Puede ver el ID de un formulario de búsqueda en el Windows Client en el cuadro de diálogo Administrar formularios de búsqueda del Web Client. Tenga en cuenta que un enlace solo puede abrir formularios de búsqueda que aparecen en la navegación superior.

Listas por tipo de contacto

Cada tipo de contacto en tu entorno está disponible desde la página de Lista de Tipos de Contacto. Sin embargo, puede ser útil poner accesos directos a listas especialmente importantes directamente en la página de inicio. La siguiente URL muestra una lista de contactos asignados al tipo de contacto con el ID 10 (el tipo de contacto Top Clients que viene por defecto).

$(PAGE_SERVER)/InterAction/contact-search-results?isProfile=true&amp;

searchDescription=Top Clients&amp;profileId=10005&amp;contactTypeId=10

Ten en cuenta que la parte profileId=8 identifica un perfil (el perfil de Cliente) que se usará para el panel de resumen. Puedes obtener el ID de un perfil en el Windows Client en el cuadro de diálogo Administrar Perfiles de Web Client.

Listas de Marketing

Enlazar a páginas de listas de marketing es similar a enlazar a tipos de contacto. La siguiente URL muestra una lista de contactos en la lista Holiday Card. Ten en cuenta que necesitas proporcionar el ID de la carpeta.

$(PAGE_SERVER)/mailing-list-membership?searchDescription=Holiday+Card&amp;

folderId=2/-10017&amp;proxyAccount=

Subconjuntos de Listas

Los formularios de búsqueda permiten a los usuarios encontrar un subconjunto de contactos dentro de una lista, como solo clientes que cumplen ciertos criterios. Algunas de estas listas de subconjuntos pueden ser lo suficientemente importantes como para incluirlas como un enlace en la página de inicio. Esto ahorra a los usuarios tener que ingresar los criterios para encontrar los contactos. Por ejemplo, podrías querer un enlace que muestre la lista de empleados en una oficina en particular.

La forma más sencilla de determinar este tipo de URL es realizar la búsqueda en el Web Client, luego copiar la URL resultante del navegador y modificarla según sea necesario. Para un ejemplo, consulta Acceso directo para determinar la URL de una página de Web Client.

Temas de Ayuda de Web Client

Si hay temas de ayuda de Web Client que serían útiles para los profesionales de tu organización, puedes agregar enlaces a ellos en la página de inicio. Para más detalles sobre cómo determinar la URL de un tema, consulta Enlazar a Temas de Ayuda de Web Client.

Enlazar a Temas de Ayuda de Web Client

El Web Client ofrece un sistema de ayuda en línea para responder preguntas y tareas comunes. La página de inicio incluye una serie de enlaces a temas específicos dentro del sistema de ayuda.

Puedes agregar enlaces a temas adicionales. Especifica la siguiente URL para la etiqueta url Tag (todo en una sola línea):

Enlazar a Temas de Ayuda de Web Client

javascript:var remoteWin = IA_openWindow('$(HELP_URL)/TopicFilename.htm', '', 'height=550, width=700, location=no, menubar=no, resizable=yes, scrollbars=yes, status=no, titlebar=no, toolbar=no');

Reemplaza TopicFilename.htm con el nombre real del archivo del tema al que quieres enlazar. El resto del código en la URL se usa para mostrar el tema en una ventana emergente. Asegúrate de ingresar la URL exactamente como se muestra; lo más fácil es copiar la URL de uno de los enlaces de temas de ayuda existentes.

Utiliza los siguientes pasos para determinar el nombre de archivo de un tema de ayuda:

1. Abre la ayuda y navega hasta el tema al que quieres enlazar. Puedes usar el enlace de Ayuda en el marco de la página de Web Client para abrir la ayuda.

2. Cuando el tema que deseas aparezca en el panel derecho de la ventana de ayuda, haz clic derecho en el tema y selecciona Propiedades.

   

3. Anota la Dirección (URL) que aparece en el cuadro de diálogo de propiedades. Verás algo como lo siguiente:

   http://bailey/IA_HELP/ad1015791.htm

4. El nombre de archivo del tema es la parte *.html. En el ejemplo anterior, el nombre de archivo de este tema es ad1015791.htm. Ten en cuenta que puede haber un signo de número (#) u otro texto adicional después del nombre de archivo; puedes ignorar esto.

Haz una copia de la lista de búsqueda predeterminada para editarla

Ten en cuenta que solo necesitas seguir este procedimiento una vez, antes de hacer cualquier cambio en una lista de búsqueda en particular.

1. En tu máquina del InterAction Application Server, localiza el directorio etc. En una instalación típica, normalmente es el siguiente:

   C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc

2. Abre el archivo searchLists.xml en un editor XML.

3. Busca las líneas que inician la declaración de la lista de búsqueda que deseas editar. Para ver una lista de las listas de búsqueda disponibles, consulta Declaraciones de Búsqueda de la Página de Inicio. El nombre de la lista de búsqueda aparecerá así:

   <searchList id="home-search" template="searchList.xsl">

4. Copia todo el bloque de código XML de la lista de búsqueda. La declaración termina con la etiqueta <\searchList>. Ten en cuenta que la declaración incluye varias etiquetas <searchList> anidadas, así que asegúrate de copiar toda la declaración.
5. Abre el archivo localSearchLists.xml y pega la declaración del menú en algún punto después de la etiqueta de apertura searchListDeclarations Tag.
6. Actualiza esta versión copiada de la declaración de la lista de búsqueda con tus cambios.

"Este artículo de ayuda fue traducido usando IA y puede contener inexactitudes. Si tienes dudas sobre alguna información, consulta la versión original en inglés."