Guía de IBM Tealeaf CX UI Capture j2 Versión 3 Release 0 1 de agosto de 2013

IBM Tealeaf CX UI Capture j2




Nota Antes de utilizar esta información y el producto al que da soporte, lea la información incluida en “Avisos” en la página 81.

Esta edición se aplica a la versión 3, release 0, modificación 0 de IBM Tealeaf CX UI Capture j2 y a todos los releases y las modificaciones posteriores, hasta que se indique lo contrario en nuevas ediciones. © Copyright IBM Corporation 1999, 2013.

Contenido Guía de IBM Tealeaf CX UI Capture j2 . . v Capítulo 1. IBM Tealeaf CX UI Capture j2 1 Trabajar con casos de uso . . . . . . . . . . Validación de casos de uso con la captura lado del cliente . . . . . . . . . . . . . . . . Requisitos previos del sistema . . . . . . . . Navegadores soportados . . . . . . . . . . Cómo funciona la reproducción de CX UI Capture j2 Cómo CX UI Capture j2 captura interacciones . . Cómo reproduce CX UI Capture j2 interacciones capturadas . . . . . . . . . . . . . . Documentación relacionada . . . . . . . . .

1 2 2 3 3 4 6 7

Capítulo 2. Instalación e implementación de CX UI Capture j2. . . . . . . . . . 9 Instalar versión . . . . . . . . . . . . . 9 Soporte para Visor CX RealiTea . . . . . . . 9 Soporte para la captura de aplicación web móvil 10 Configuración de CX Passive Capture Application 10 Plan de instalación y despliegue . . . . . . . 10 Etapa 1: Entorno de desarrollo . . . . . . . 10 Etapa 2: Entorno de prueba . . . . . . . . 12 Etapa 3: Entorno de producción . . . . . . 15 Configuración de JavaScript . . . . . . . . . 16 Interacciones JavaScript de CX UI Capture j2 con páginas de aplicación web . . . . . . . . 16 Bloquear campos de datos confidenciales . . . 16 Instalación en páginas web . . . . . . . . . 17 ID de HTML exclusivos . . . . . . . . . 17 Cookies. . . . . . . . . . . . . . . 17 Instalación en el servidor web . . . . . . . . 17 Referencias al archivo JavaScript . . . . . . 17 Página de destino de IBM Tealeaf . . . . . . 18 Configuración del JavaScript de CX UI Capture j2 20 Configuración de IIS . . . . . . . . . . 20 Configuración de servidor web no IIS . . . . 21 Modificaciones de página web . . . . . . . . 21 Gestión de cambios para elementos del modelo de objeto de documento . . . . . . . . . . . 21 Actualizar CX UI Capture j2 . . . . . . . . . 22 Soporte para cabeceras de legado . . . . . . 22 Desinstalación de CX UI Capture j2 . . . . . . 23

Capítulo 3. Asistente de configuración de CX UI Capture j2 . . . . . . . . . 25 Navegadores soportados . . . . . . . . Controles del asistente de configuración . . . Tipos de creación . . . . . . . . . Paso 1: Configuración del servicio de navegador Paso 2: Configuración del servicio de cola . . Paso 3: Configuración del servicio de mensaje (configuración de máscaras de privacidad) . . Paso 4: Serializador . . . . . . . . . . © Copyright IBM Corp. 1999, 2013

. . . . .

. . . . .

25 25 25 26 27

. .

. 28 . 29

Paso 5: Módulos . . . . . . . Paso 6: Valores diversos . . . . Probador de expresiones regulares.

. . .

. . .

. . .

. . .

. . .

. 29 . 31 . 31

Capítulo 4. Directrices de uso de CX UI Capture j2 . . . . . . . . . . . . . 33 Ámbito de la aplicación . . . . . . . . . Tipos de aplicación soportadas . . . . . . Protocolos soportados . . . . . . . . . Antes de empezar el desarrollo . . . . . . . Acceso de IBM Tealeaf . . . . . . . . Contenido de terceros . . . . . . . . . Personal . . . . . . . . . . . . . Consideraciones de desarrollo . . . . . . . Ciclo de desarrollo . . . . . . . . . . Cuándo desplegar CX UI Capture j2 durante el desarrollo . . . . . . . . . . . . . Entornos de desarrollo y prueba . . . . . Gestión de rendimiento . . . . . . . . Contenido de la aplicación . . . . . . . . Identificadores exclusivos. . . . . . . . No utilice palabras clave del modelo de objetos de documento como nombre de campo de formulario . . . . . . . . . . . . . Objetos de aplicación . . . . . . . . . Datos privados . . . . . . . . . . . Frecuencia de publicaciones . . . . . . . Eventos de interfaz de usuario alterados temporalmente por CX UI Capture j2 . . . . Despliegue de CX UI Capture j2 . . . . . . Colocación de CX UI Capture j2 . . . . . JavaScript . . . . . . . . . . . . . Crear eventos personalizados . . . . . . Pasos siguientes . . . . . . . . . . . .

. . . . . . . . .

33 33 34 34 34 34 35 35 35

. . . . .

35 36 36 36 36

. . . .

37 37 38 39

. . . . . .

39 39 39 40 40 41

Capítulo 5. Referencia de CX UI Capture j2 . . . . . . . . . . . . . 43 Configuración del núcleo . . . . . . . Núcleo . . . . . . . . . . . . Configurar eventos de cliente por módulo Configuración de servicios . . . . . . Configuración del servicio de cola . . . Configuración del servicio de navegador Configuración del servicio de mensaje . Configuración d servicio serializador . . Configuración de módulos . . . . . . Rendimiento . . . . . . . . . . Configuración de localStorage . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

43 46 46 49 50 51 52 56 57 58 58

Capítulo 6. Referencia de API pública de CX UI Capture j2 . . . . . . . . . 61 TLT.init(object configObject) . . . . . . TLT.rebind(/*opcional*/ DOMElement root) TLT.flushAll(void) . . . . . . . . .

. . .

. . .

. 61 . 61 . 61

iii

TLT.setAutoFlush(AutoFlushFlag flag) . . . TLT.processDOMEvent(DOMEvent event) . . TLT.logCustomEvent(DOMString name, object customMsgObj) . . . . . . . . . . . TLT.logExceptionEvent(DOMString msg, /*opcional*/ DOMString url, /*opcional*/ línea larga) . . . . . . . . . . . . . . TLT.logScreenviewLoad(DOMString name, /*opcional*/ DOMString referrerName, /*opcional*/ DOMElement root) . . . . . TLT.logScreenviewUnload(nombre DOMString) TLT.getSessionData() . . . . . . . . .

. .

. 61 . 62

.

. 62

.

. 62

. . .

. 62 . 62 . 62

Capítulo 7. Preguntas más frecuentes de CX UI Capture j2 . . . . . . . . . 65 Cómo empezar . . . . . . . . . . . . . ¿Qué es CX UI Capture j2? . . . . . . . . ¿Qué versiones de UI Capture están disponibles? ¿Por qué necesito CX UI Capture j2? . . . . . ¿Cómo implemento CX UI Capture j2? . . . . ¿Cuál es el tamaño de CX UI Capture j2? . . . ¿Puedo empaquetar la biblioteca de CX UI Capture j2 con otros JavaScripts? . . . . . . ¿CX UI Capture j2 afectará al rendimiento o al comportamiento de mi sitio web? . . . . . . ¿Dónde puedo obtener la última versión de CX UI Capture j2? . . . . . . . . . . . . ¿Qué está capturando CX UI Capture j2? . . . ¿Dónde puedo encontrar más documentación? . Estoy teniendo problemas con la implementación de CX UI Capture j2. ¿Dónde puedo obtener soporte o ayuda? . . . . . . . . . . . Utilización de CX UI Capture j2 . . . . . . . ¿Cómo configuro lo que captura CX UI Capture j2? . . . . . . . . . . . . . . . . ¿Qué se captura de sesiones de web móvil? . . ¿Qué sucede si encuentro un error con CX UI Capture j2? . . . . . . . . . . . . . ¿Cómo puedo crear eventos de los datos de CX UI Capture j2? . . . . . . . . . . . . ¿Cómo busco datos de CX UI Capture j2? . . . ¿Cómo puedo capturar solo eventos mouseover en el menú? . . . . . . . . . . . . . .

iv

65 65 65 66 66 67 67 68 68 68 68

69 69 69 69 70 70 70

¿Cómo capturo eventos keyup? . . . . . . . ¿Cómo puedo informar sobre los mensajes de validación/error del lado del cliente? . . . . . ¿Cómo fuerzo el envío de eventos en cola? . . . Para la primera fase, la única métrica deseada es el tiempo de representación de página. ¿Hay valores de configuración que limitan los POST solo para ese evento? . . . . . . . . . . Utilizo DHTML en mi formulario de pago. ¿CX UI Capture j2 va a capturar los elementos DOM representado dinámicamente? . . . . . . . ¿Cómo obtengo los tiempos de representación de CX UI Capture j2? . . . . . . . . . . . ¿Es necesario que los ID se asignen a mis elementos DOM que me gustaría capturar? . . . ¿Puedo personalizar JavaScripts de CX UI Capture j2? . . . . . . . . . . . . . ¿Cómo obtengo mensajes de error de dominios cruzados en mi consola de depuración de navegadores relacionados con iFrames en mi sitio? . . . . . . . . . . . . . . . Actualización de la biblioteca . . . . . . . . ¿Cómo determino qué versión de la biblioteca estoy utilizando? . . . . . . . . . . . ¿Cómo determino qué versión del archivo TealeafTarget.jsp estoy utilizando? . . . . . ¿Cuándo actualizo? . . . . . . . . . . . ¿Cómo puedo saber si hay actualizaciones disponibles? . . . . . . . . . . . . .

70 70 71

71

72 72 72 72

73 73 73 73 73 74

Apéndice A. Comunicación de dominios cruzados . . . . . . . . . 75 Apéndice B. Comunidad viaTealeaf . . 77 Búsqueda en la ayuda en línea de Tealeaf . Otras áreas de ayuda . . . . . . . .

. .

. .

. 77 . 79

Avisos . . . . . . . . . . . . . . . 81 Marcas registradas . . . . . . . . . . . Consideraciones sobre la política de privacidad .

70

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

. 83 . 83

Guía de IBM Tealeaf CX UI Capture j2 Para el release 8.6 y posteriores, debe utilizar IBM Tealeaf CX UI Capture j2, la versión nueva del SDK de UI Capture. Para el release 8.5 y anteriores, el uso de CX UI Capture j2 no está soportado. Puede seguir utilizando la versión de legado de CX UI Capture for AJAX. Si desea más información, consulte la Guía de IBM Tealeaf CX UI Capture for AJAX. La Guía de IBM Tealeaf CX UI Capture j2 detalla cómo desplegar la última versión de IBM Tealeaf UI Capture para la aplicación web basada en JavaScript. IBM Tealeaf UI Capture permite la supervisión de los eventos de IU en el navegador del visitante que no genera una petición a la aplicación web y no se puede capturar a través de otros medios.

© Copyright IBM Corp. 1999, 2013

v

vi

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Capítulo 1. IBM Tealeaf CX UI Capture j2 La biblioteca de IBM Tealeaf CX UI Capture j2 permite la captura de contenido de página, eventos y otros datos que normalmente no se intercambian con el sitio web. Mediante el uso de IBM Tealeaf CX Passive Capture Application, puede capturar y reproducir el sitio web sin modificaciones en el propio sitio. Sin embargo, si el sitio utiliza JavaScript, o Ajax para añadir interactividad, estas interacciones permanecen locales en la página web. Es posible que las acciones realizadas que utilizan estas tecnologías no se transmitan al sitio web y, por lo tanto, CX Passive Capture Application no las captura. Al añadir JavaScript de CX UI Capture j2 a las páginas web dinámicas, puede capturar el estado de las páginas web y sus interacciones de JavaScript. También puede capturar otra información solo disponible en la página, como los tiempos de carga de página, la resolución de la visualización del usuario y otros atributos predefinidos. Puede añadir un conjunto de JavaScripts a páginas web relevantes y el contenido y las acciones relevantes se capturan e integran automáticamente con el resto de los datos de captura de IBM Tealeaf . El sistema CX UI Capture j2 obtiene datos del navegador y los transmite al servidor de captura de IBM Tealeaf . Esta información incluye pulsaciones de ratón, pulsaciones de tecla, eventos de cambio y otra información. La información se transmite al servidor mediante un POST HTTP asíncrono, una técnica Ajax, a una página web en el servidor que reconoce la solicitud. Puesto que la solicitud y la respuesta son capturadas por IBM Tealeaf , todos los datos están disponibles en IBM Tealeaf para informes o la reproducción posteriores.

Trabajar con casos de uso Existen tres uso básicos para IBM Tealeaf CX UI Capture j2. También puede desarrollar casos de uso específicos a sus necesidades. Estos casos de uso básico se listan en orden creciente de capacidad y complejidad: 1. Capturar información del entorno del navegador que normalmente no se transmite al servidor web. Este conjunto de datos incluye: v El tiempo de representación de página y las medidas de tiempo del rendimiento del lado del cliente, tal como se define en la especificación de tiempo de navegación W3C. Consulte http://www.w3.org/TR/navigationtiming/. v La resolución de pantalla del sistema o dispositivo del cliente. Cuanta más información de navegador se pueda capturar a través del agente de usuario, más información se extrae y evalúa a través de IBM Tealeaf cxImpact. Consulte "Gestión de agentes de usuario" en el Manual de administración de IBM Tealeaf cxImpact. 2. Capturar eventos predefinidos en la página. IBM Tealeaf puede capturar sus propios eventos, que se describen posteriormente.

© Copyright IBM Corp. 1999, 2013

1

3. Capturar interacciones de usuario (IU) con la página web. Estas capturas normalmente son el texto que se escribe en un campo de formulario, la interacción con controles como recuadros de selección, listas de selección o enlaces. Puede desarrollar sus propios casos de uso para IBM Tealeaf CX UI Capture j2. Específicamente, identifique actividades de usuario, condiciones de error y criterios de éxito para el uso de la aplicación. Un sólido conjunto de casos de uso puede ayudar con el proceso de implementación y en el rastreo de los resultados en IBM Tealeaf .

Validación de casos de uso con la captura lado del cliente IBM Tealeaf proporciona el programa de utilidad de la captura del lado del cliente, que permite la captura de sesiones web en el sistema local sin acceder a un despliegue de captura de IBM Tealeaf CX UI Capture j2. La captura del lado del cliente (CSC) es útil para capturar los casos de uso en la aplicación web. Con la CSC, las sesiones web se pueden capturar y guardar en el sistema local para una reproducción posterior en la aplicación autónoma IBM Tealeaf Visor CX RealiTea. Puede utilizar el CSC para visitar todas las áreas de aplicación y capturar flujos de trabajo específicos. Utilice este procedimiento para validar que IBM Tealeaf CX UI Capture j2 está capturando correctamente todos los elementos de requisito previo de la aplicación. Nota: Utilice sesiones capturadas por el CSC para verificar que se están capturando todos los eventos de interfaz de usuario. Si los eventos de IU no se están capturando, compruebe los problemas siguientes. v La aplicación anula estos eventos. Revise la aplicación para verificar que los eventos de IU no se están bloqueando o evitando de cualquier otro modo la "efervescencia" mediante el código de sitio. v La aplicación web está actualizando dinámicamente contenido en la página. La aplicación web debe llamar a la API de IBM Tealeaf para que UI Capture pueda adjuntar los escuchas de eventos apropiados. Consulte "Utilización de la captura del lado del cliente para Fiddler" en el Manual de captura del lado del cliente de IBM Tealeaf .

Requisitos previos del sistema Antes de desplegar IBM Tealeaf IBM Tealeaf CX, realice las modificaciones necesarias en la aplicación web. 1. Las sentencias para incluir el archivo JavaScript de IBM Tealeaf se deben añadir a las páginas web de interés. 2. Una página web de destino se debe añadir a los servidores web de origen para reconocer los POST que se reciben desde la biblioteca de IBM Tealeaf IBM Tealeaf CX en el navegador. 3. En función de la aplicación de la página web, a los elementos de interfaz de usuario accionables, como campos de formulario, botones y códigos , se les debe asignar ID HTML exclusivos para soportar la reproducción posterior a través de IBM Tealeaf . 4. Las peticiones Ajax desde los JavaScripts que se ejecutan en la página web deben tener al menos un elemento de datos exclusivos para que se puedan diferenciar varias peticiones.

2

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Navegadores soportados El JavaScript de IBM Tealeaf CX UI Capture j2 está soportado para el despliegue en un conjunto especificado de aplicaciones y versiones de navegador. Los navegadores web soportados son los siguientes. v IE 6.0 y posterior v Firefox 4.0 y posterior v Safari 4.0 y posterior v Opera 9.0 y posterior v Chrome 10.0 y posterior Para la reproducción, IBM Tealeaf Visor CX RealiTea utiliza una instancia incorporada de la versión de Internet Explorer que está instalada en el sistema local. Nota: La reproducción de las sesiones de IBM Tealeaf en Visor CX RealiTea, la aplicación autónoma para la reproducción de escritorio, requiere el soporte de Internet Explorer. Si Internet Explorer no está soportado por el departamento TI de la empresa, la reproducción básica se puede gestionar a través del navegador. Nota: La creación de eventos que supervisan los datos basados en JSON que se envían desde IBM Tealeaf CX UI Capture for AJAX o IBM Tealeaf CX UI Capture j2 no está soportada en IBM Tealeaf Visor CX RealiTea. Debe utilizar la reproducción basada en navegador para crear eventos a partir de estas versiones de CX UI Capture j2. Consulte "Eventos basados en pasos" en el Manual del gestor de eventos de IBM Tealeaf . Para obtener más información sobre estos requisitos previos, consulte Capítulo 2, “Instalación e implementación de CX UI Capture j2”, en la página 9. v Para ver una lista de navegadores y versiones que están soportados para su uso con el IBM Tealeaf Portal, consulte la "Lista de comprobación previa a la instalación de CX" en el Manual de instalación de IBM Tealeaf CX.

Cómo funciona la reproducción de CX UI Capture j2 De los tres casos de uso básicos para IBM Tealeaf CX UI Capture j2, la captura de interacciones de IU con la página web para una reproducción posterior es el más complejo. El diagrama siguiente muestra este caso de uso.

Capítulo 1. IBM Tealeaf CX UI Capture j2

3

Figura 1. Captura y reproducción de IU

Suponga que está intentando capturar un JavaScript, DHTML o una página web Ajax. Antes de la inclusión de la biblioteca de CX UI Capture j2, una visita a la página indica al servidor web que devuelva la página que contine el HTML/DHTML/JavaScript necesario para las funciones de la página. A medida que el usuario interacciona con la página, como entrando datos en el formulario, el código Ajax en la página procesa dichos datos como se ha diseñado. v La página web puede utilizar técnicas Ajax para publicar solicitudes para datos en el servidor web, que responde con los datos necesarios. De esta forma, la página se puede actualizar sin provocar que se cargue una página nueva. v Cuando el usuario marca un recuadro de selección, se desencadena otra interacción Ajax con el servidor web. v El usuario puede tomar una acción que provoca que la página actual se "descargue", probablemente para ser sustituida por otra página web. Todas estas Solicitud/Respuestas son capturadas por IBM Tealeaf CX Passive Capture Application. Durante la reproducción, a menudo, IBM Tealeaf puede inferir qué formularios se han llenado y puede vincular las respuestas Ajax con peticiones Ajax realizadas durante la reproducción. Sin embargo, sin la biblioteca de CX UI Capture j2, IBM Tealeaf no tiene ninguna visibilidad en las interacciones entre la aplicación de la página web y el visitante cuando la interacción no desencadenaba la transmisión de datos desde el servidor web.

Cómo CX UI Capture j2 captura interacciones Una vez que se añade la biblioteca de CX UI Capture j2 a la página web, el código de biblioteca puede detectare eventos de IU que se producen en distintos elementos en el modelo de objeto de documento (DOM) de la página. CX UI Capture j2 puede capturar eventos de todos los marcos o iframes que comparten el mismo dominio que la página padre. Por ejemplo, cuando el usuario entra texto en un campo, el código de la biblioteca ve cada evento de pulsación de tecla para el campo y el valor real de la tecla, como la letra A. La biblioteca almacena estos eventos en una estructura de datos JSON temporal para la transmisión de eventual de vuelva al servidor web. La biblioteca se puede configurar para enviar estos datos capturados hasta el servidor web de acuerdo con las condiciones siguientes:

4

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

v A intervalos de tiempo predefinidos. v Cuando se capturó un número de eventos predefinido. v En el momento de descarga de página, normalmente se define como la condición mínima. Cada vez que el JavaScript de CX UI Capture j2 publica datos en el servidor web, la aplicación IBM Tealeaf en el servidor web reconoce el recibo de los datos. Esta respuesta también es capturada por el servidor IBM Tealeaf CX Passive Capture Application, de forma que el par de solicitud/respuesta se pueden registrar de forma precisa.

Figura 2. Transacciones Ajax y CX UI Capture j2

Este diagrama muestra las interacciones de la página web de ejemplo con el servidor web a lo largo del tiempo, incluyendo las transacciones Ajax de la página web y las páginas web añadidas por CX UI Capture j2. En este diagrama de secuencia, la aplicación de la página web ha realizado dos transacciones Ajax seguidas por dos transacciones Ajax de IBM Tealeaf . El tiempo aumenta de arriba a abajo. Nota: Para cada acción de usuario, la solución CX UI Capture j2 envía un solo mensaje. Si desea más información sobre las interacciones de página web, consulte Capítulo 2, “Instalación e implementación de CX UI Capture j2”, en la página 9.

Capítulo 1. IBM Tealeaf CX UI Capture j2

5

Cómo reproduce CX UI Capture j2 interacciones capturadas Para reproducir una página web, el software de reproducción de IBM Tealeaf imita las interacciones entre el navegador y el visitante y el navegador y el servidor web. Estas interacciones se muestran en el diagrama siguiente.

Figura 3. Escenario de reproducción

El software de reproducción IBM Tealeaf carga la página capturada. Cuando la página solicita el archivo JavaScript de CX UI Capture j2, el software de reproducción proporciona un conjunto de archivos diferente, que se han diseñado para la reproducción. El software de reproducción actualiza el estado de los distintos objetos de la página que se basa en las acciones del visitante. El usuario de IBM Tealeaf puede ver estas actualizaciones que se producen a la velocidad de la reproducción. Las actualizaciones pueden provocar que se ejecute el JavaScript en la página, que provoca que los POST de Ajax se envíen al servidor. Esta solicitud se atrapa y correlaciona con la petición y respuesta capturadas previamente. El último se envía al navegador, de forma que el JavaScript que se ejecuta en la página puede realizar las mismas acciones que se han producido en el momento de la captura. Para reproducir correctamente la correlación de la nueva petición Ajax con la capturada previamente, debe haber un identificador exclusivo para la publicación que sea coherente entre la instancia capturada y la instancia reproducida. Puede configurar reglas de correlación para que las variables de solicitud se puedan ignorar o utilizar para que coincidan con la solicitud capturada correctamente.

6

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Documentación relacionada Un número de guías y recursos está disponible para soportar la implementación de la solución IBM Tealeaf CX UI Capture j2. Tabla 1. Recursos de documentación de CX UI Capture j2 Documento

Descripción

Guía de integración de datos de infraestructura de cliente de IBM Tealeaf

Tras desplegar la infraestructura de cliente, puede ser necesaria más configuración. La referencia para configurar la captura de datos en IBM Tealeaf y para que los datos estén disponibles para crear eventos, que permite la búsqueda y los informes. Este documento ayuda a los administradores de IBM Tealeaf siempre que está implementando una infraestructura de cliente de IBM Tealeaf .

Guía de referencia de infraestructura de registro Android de IBM Tealeaf

Guía de instalación e implementación para IBM Tealeaf CX Mobile Android Logging Framework para aplicaciones nativas de móvil basadas en Android. El despliegue requiere la licencia de IBM Tealeaf CX Mobile.

Guía de referencia de infraestructura de registro iOS de IBM Tealeaf

Guía de instalación e implementación de IBM Tealeaf CX Mobile iOS Logging Framework para aplicaciones nativas de móvil basadas en iOS. El despliegue requiere la licencia de IBM Tealeaf CX Mobile.

IBM Tealeaf Guía de UI Capture for Ajax Guía para desplegar la versión de legado de UI Capture.

Capítulo 1. IBM Tealeaf CX UI Capture j2

7

8

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Capítulo 2. Instalación e implementación de CX UI Capture j2 Antes de instalar e implementar CX UI Capture j2, debe verificar el release de software utilizado por el sistema. Para el release 8.6 y posterior, debe utilizar CX UI Capture j2, que es la nueva versión del SDK de UI Capture. Para el release 8.5 y anteriores, el uso de CX UI Capture j2 no está soportado. Puede utilizar la versión anterior, CX UI Capture for AJAX. Para obtener más información, consulte la publicación IBM Tealeaf CX UI Capture for AJAX Guide. Antes de empezar la instalación e implementación, revise las directrices para su uso. Consulte Capítulo 4, “Directrices de uso de CX UI Capture j2”, en la página 33.

Instalar versión Antes de empezar a implementar CX UI Capture j2, verifique que tiene la última versión del software. Nota: Puede obtener información adicional relativa a la descarga del software de Tealeaf consultando Descargas de Tealeaf CX. Esta sección contiene detalles sobre cómo implementar la biblioteca de IBM Tealeaf CX UI Capture j2. Nota: En función de la complejidad de su aplicación web, la implementación de una biblioteca de IBM Tealeaf CX UI Capture j2 puede requerir servicios de asesoría de IBM®. Si desea más información, póngase en contacto con IBM Professional Services.

Soporte para Visor CX RealiTea IBM Tealeaf Visor CX RealiTea es una aplicación de escritorio autónoma que se puede utilizar para reproducir las sesiones capturadas por IBM Tealeaf , incluyendo eventos de IU de cliente. Para reproducir sesiones que incluyen eventos de IU, debe instalar Visor CX RealiTea en el escritorio local. Nota: La reproducción de sesiones capturadas por CX UI Capture j2 no está soportada por completo en Visor CX RealiTea. v Los mensajes JSON que contienen eventos de IU no están soportados por completo en Visor CX RealiTea. v Para la reproducción de mensajes JSON, utilice la reproducción basada en navegador. Consulte "Reproducción basada en navegador de CX" en el Manual de usuario de IBM Tealeaf cxImpact. Nota: CX UI Capture j2 es compatible con el release 8.6 y posterior. No es compatible con releases anteriores.

© Copyright IBM Corp. 1999, 2013

9

Soporte para la captura de aplicación web móvil Para capturar datos de aplicaciones web móvil, es necesaria una licencia para IBM Tealeaf CX Mobile. Consulte "Versiones de infraestructura de cliente" en la Guía de integración de datos de infraestructura de cliente de IBM Tealeaf .

Configuración de CX Passive Capture Application De forma predeterminada, IBM Tealeaf CX Passive Capture Application captura un número de los tipos mime publicados por las aplicaciones avanzadas de Internet. En función del tipo de aplicación que está desplegando, puede habilitar la captura de más tipos. IBM Tealeaf CX UI Capture j2 requiere el CX Passive Capture Application para que se configure para habilitar la captura de contenido JSON en la solicitud. También debe configurar CX Passive Capture Application para capturar el tráfico POST deseado. CX Passive Capture Application se puede configurar para incluir o excluir extensiones de archivo específicos, tipos mime y tipos POST. Nota: Asegúrese de verificar que la instalación de CX Passive Capture Application se ha configurado para capturar tipos mime JSON. Consulte "Consola web PCA - Pestaña Interconexión" en el Manual de CX Passive Capture Application CX Passive Capture Application. Si se deben JavaScript dinámico u hojas de estilo CSS, IBM Tealeaf CX Passive Capture Application se debe configurar para capturar este contenido. Evite capturar versiones dinámicas de contenido que normalmente es estático. Como alternativa, puede capturar este contenido en un archivo estático. Consulte "Gestión de archivos estáticos" en el Manual de administración de IBM Tealeaf cxImpact. v Para descripciones de los tipos de captura para habilitar para distintos tipos de aplicaciones RIA, consulte "Instalación" en el Manual de IBM Tealeaf CX Passive Capture Application. v Si desea más información sobre cómo habilitar un tipo de captura en la consola web de CX Passive Capture Application, consulte "Consola web PCA - Pestaña Interconexión" en el Manual de IBM Tealeaf CX Passive Capture Application.

Plan de instalación y despliegue CX UI Capture j2 se puede desplegar rápidamente en entornos locales para el desarrollo y las pruebas. Al resolver todos los problemas que se pueden supervisar fuera del entorno de IBM Tealeaf , la biblioteca se puede transportar a un entorno de IBM Tealeaf para realizar más pruebas y ajustes.

Etapa 1: Entorno de desarrollo En el entorno de desarrollo, los objetivos del despliegue de CX UI Capture j2 son integrar los archivos necesarios en la infraestructura web y establecer la conectividad básica entre el servidor web, el cliente y CX Passive Capture Application para la captura.

10

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Archivo para añadir páginas web El archivo JavaScript de CX UI Capture j2 se debe incluir en cada página web de la aplicación que desea supervisar.

colocación de servidor En el servidor web, coloque el archivo JavaScript de CX UI Capture j2 con los otros archivos estáticos servidos por el sitio.

Incluir ubicación Cada página servida que requiere un rastreo de eventos de cliente debe tener incluidos códigos para cargar el archivo JavaScript de CX UI Capture j2. En cada página, el archivo JavaScript se debe incluir del modo siguiente.

Si coloca el archivo JavaScript de IBM Tealeaf CX UI Capture j2 en cualquier lugar distinto al directorio raíz en el servidor web, debe ajustar el parámetro src= en la referencia para que apunte a la ubicación correcta. Nota: No es necesario que coloque el JavaScript de CX UI Capture j2 en la parte superior de la página. Consulte Capítulo 1, “IBM Tealeaf CX UI Capture j2”, en la página 1.

Instalación de CX UI Capture j2 Para instalar y desplegar CX UI Capture j2, complete los pasos siguientes. 1. Si no todavía no lo ha hecho, configure el JavaScript. Consulte Configuración. 2. Despliegue la página de destino de IBM Tealeaf en la ubicación donde la biblioteca se ha configurado para realizar POST. Consulte “Página de destino de IBM Tealeaf ” en la página 18. 3. Coloque el JavaScript necesario en la ubicación del servidor web apropiada. Consulte “colocación de servidor”. 4. Modifique las páginas servidas para que haga referencia al JavaScript. Consulte “Incluir ubicación ”. 5. Cuando se hace referencia al JavaScript en las páginas servidas y puede publicar en la página de destino, CX UI Capture j2 está en funcionamiento.

Verificar Etapa 1 Para verificar que CX UI Capture j2 está funcionando correctamente en el entorno de despliegue, complete las pruebas siguientes.

No hay errores de JavaScript en la página A través del navegador web, visite una muestra de las páginas servidas. Verifique que el JavaScript incluido no genera errores de JavaScript.

Verificar que los eventos de cliente se están publicando Desplegar una herramienta de supervisión de navegador como Fiddler, HTTPWatch o Firebug para verificar que los eventos de cliente se están publicando en la página de destino.

Capítulo 2. Instalación e implementación de CX UI Capture j2

11

Nota: Los POST normales de CX UI Capture j2 son asíncronos, con una excepción. Las peticiones Ajax síncronas se utilizan durante la descarga de la página. En la corriente de tráfico de POST, busque las cabeceras de petición que contienen X-Tealeaf y un mensaje JSON como: {"messageVersion":"2.1.0.0","serialNumber":1,"sessions":...

El número de versión varía de release a release. Nota: Si se están enviando datos de UI Capture a IBM Tealeaf , mediante el IBM Tealeaf Portal puede buscar la página de destino de IBM Tealeaf para ver si se está recuperando alguna sesión. En los entornos de prueba y producción, utilice la prueba de búsqueda del Portal.

Etapa 2: Entorno de prueba En el entorno de prueba, los objetivos son desplegar CX UI Capture j2 para verificar un correcto funcionamiento y la supervisión integral de los eventos de interfaz de usuario, de forma que puede buscar, reproducir e informar sobre sucesos de interfaz de usuario de cliente.

Requisitos para el entorno de prueba El entorno de prueba debe cumplir determinados requisitos para completar las pruebas integrales. v IBM Tealeaf CX Passive Capture Application CX Passive Capture Application se debe implementar, habilitar y funcionar correctamente. CX Passive Capture Application se debe configurar para capturar los tipos de contenido apropiados. Consulte "Versiones de infraestructura de cliente" en la Guía de integración de datos de infraestructura de cliente de IBM Tealeaf . Si desea más información sobre la configuración, consulte "Consola web PCA Pestaña interconexión" en el Manual de IBM Tealeaf CX Passive Capture Application. v Reproducción basada en navegador Para verificar la reproducción de eventos de IU, utilice la reproducción basada en navegador para verificar que los eventos de IU aparecen en el panel de navegación. Consulte “Reproducción de una sesión capturada en BBR” en la página 13. v Búsqueda Debe poder buscar y recuperar campos de IU de cliente específicos en la solicitud. A continuación se proporcionan detalles. Verifique las capacidades de búsqueda básica de antemano en ambos, Portal y Visor CX RealiTea. v Informes Los eventos de IU de cliente pueden aparecer en informes que están configurados a través del Creador de informes de IBM Tealeaf . Consulte "Creador de informes Tealeaf" en la Guía de informes de IBM Tealeaf .

Instalación en el entorno de prueba Para instalar y desplegar en el entorno de prueba, siga los mismos pasos que se utilizan en el entorno de desarrollo, modificando el JavaScript según sea necesario para trabajar en el entorno de prueba. v Consulte “Instalación de CX UI Capture j2” en la página 11.

12

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Verificar Etapa 2 Para validar el despliegue de CX UI Capture j2 en el entorno de prueba, complete las pruebas siguientes. Generar una sesión con eventos de IU incluidos: Mediante el navegador web, visite la aplicación web supervisada por el entorno de prueba de IBM Tealeaf . Requisitos v No utilice la captura del lado del cliente para esta prueba. Utilice IBM Tealeaf para capturar y procesar los datos. v Visite una serie de páginas que contienen eventos de IU. Desencadene todos los eventos de IU de prueba de forma que se incluyan en la sesión capturada. v Genere la sesión para que tenga una forma de identificación exclusiva para localizar la sesión mediante la búsqueda. – A medida que se genera la sesión, puede utilizar Fiddler o una herramienta similar para revisar los datos de solicitud para localizar el identificador de sesión de IBM Tealeaf . – También puede hacer trucos de navegación como insertar una serie exclusiva en un campo de formulario y, después, enviarlo. v Asegúrese de cerrar la sesión para se pueda indexar para la búsqueda. Reproducción de una sesión capturada en BBR: Tras capturar una sesión, reprodúzcala a través de la reproducción basada en navegador para confirmar que los eventos de IU de cliente están presentes. De acuerdo con la revisión de la reproducción, puede ajustar los valores de configuración y desarrollar reglas de reproducción, después de lo cual puede reproducir la sesión. Repita este proceso hasta que pueda asegurar una reproducción de buena calidad de la sesión capturada. Nota: La reproducción de sesiones capturadas en Visor CX RealiTea no está soportada por completo para CX UI Capture j2, en función de la aplicación. A partir del release 8.6 o posterior, utilice la reproducción basada en navegador para la reproducción. 1. Localice la sesión a través de la búsqueda. Consulte "Búsqueda de datos de sesión" en el Manual de usuarios de IBM Tealeaf cxImpact. 2. Reproduzca la sesión en la reproducción basada en navegador. 3. Cambie a la vista de solicitud. 4. Pase a través de las páginas de la sesión. 5. En la parte superior del panel de visualización, se muestra el enlace siguiente. Pulse aquí para ver los atributos de paso.

6. Este enlace indica que los datos JSON se han capturado como parte de la sesión, lo que significa que CX UI Capture j2 los está enviando correctamente. v Puede pulsar el enlace para revisar los datos JSON en un formato legible. v Desde esta área, puede crear eventos y atributos de paso de IBM Tealeaf de los datos. Consulte “Crear eventos de IBM Tealeaf para datos de IU de cliente” en la página 14.

Capítulo 2. Instalación e implementación de CX UI Capture j2

13

v Cuando se crean eventos de IBM Tealeaf a partir de los datos JSON, estos eventos se marcan en sesiones posteriores capturadas por IBM Tealeaf . A continuación, puede buscarlos utilizando la interfaz del Portal. Consulte "Búsqueda de datos de sesión" en el Manual de usuario de IBM Tealeaf cxImpact. 7. Para garantizar una buena experiencia de reproducción, puede crear reglas de reproducción o modificar las existentes para gestionar correctamente la reproducción de sesiones capturadas por IBM Tealeaf CX UI Capture j2. Consulte “Retocar reglas de reproducción”. 8. Una vez creados los eventos de IBM Tealeaf , puede crear informes en el Creador de informes de IBM Tealeaf con estos eventos para empezar a rastrear eventos del lado del cliente. Consulte “Verifique los informes de IBM Tealeaf ” en la página 15. Crear eventos de IBM Tealeaf para datos de IU de cliente: Tras implementar CX UI Capture j2, puede probar la disponibilidad de datos para fines de eventos a través de la reproducción basada en navegador. La reproducción basada en navegador permite la creación de atributos y eventos desde los pasos JSON que se envían desde las infraestructuras de cliente de IBM Tealeaf . Mediante este mecanismo simple, puede crear rápidamente los atributos y eventos de paso necesarios para capturar tráfico desde la interfaz de cliente, tal como ha sido enviado por CX UI Capture j2. Consulte "Eventos basados en pasos" en el Manual del gestor de eventos de IBM Tealeaf . Nota: Si está actualizando desde una versión de UI Capture de 2012.06.01.1 o anterior, los campos de solicitud siguientes no se llenan mediante esta versión de UI Capture: v TLT_CUI_URL v TLT_CUI_APPLICATION_NAME Las plantillas de eventos, indexación o búsqueda configuradas basándose en la presencia de estos campos de solicitud no funcionan para CX UI Capture j2. v Si desea más información sobre eventos, consulte "Pestaña Eventos de TEM" en el Manual del gestor de eventos de IBM Tealeaf . v si desea más información sobre la indexación, consulte "Configuración de la indexación de CX" en el Manual de configuración de IBM Tealeaf CX. v Si desea más información sobre cómo configurar plantillas de búsqueda, consulte "Configuración de plantillas de búsqueda" en el Manual de administración de IBM Tealeaf cxImpact. Retocar reglas de reproducción: A menudo, los eventos de IU de cliente requieren reglas de reproducción para gestionar su correcta visualización. Una regla de reproducción es una acción que se aplica a los datos de sesión antes de la reproducción para mejorar la experiencia de reproducción. Nota: Las reglas de reproducción se guardan en un perfil de usuario. Cuando CX UI Capture j2 se despliega en un entorno de producción, haga que este perfil esté

14

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

disponible para todos los usuarios de Visor CX RealiTea y los usuarios de la reproducción basada en navegador. Consulte “Perfil de despliegue ”. Las reglas de reproducción se pueden aplicar a través de la reproducción basada en navegador. Consulte "Reglas de reproducción BBR" en el Manual de usuario de IBM Tealeaf cxImpact. Repetir las pruebas: Repita las pruebas de esta sección hasta que consiga una reproducción correcta. Para repetir el proceso, consulte “Reproducción de una sesión capturada en BBR” en la página 13. Verifique los informes de IBM Tealeaf : Puede revisar los informes siguientes para verificar que los eventos de IU de cliente se están publicando en IBM Tealeaf y enviando a las bases de datos de informes. Tras crear un evento de IBM Tealeaf con los eventos basados en pasos en la reproducción basada en navegador, espere al menos 1 hora para recopilar datos de informe. A continuación, puede crear un informe sencillo en el Creador de informes de IBM Tealeaf que contiene el evento y que está restringido a la fecha actual como periodo de foco. Si hay datos presentes, las funciones de informes están funcionando para datos de CX UI Capture j2. Consulte "Creador de informes Tealeaf" en la Guía de informes de IBM Tealeaf .

Etapa 3: Entorno de producción Tras completar todas las pruebas en el entorno de prueba, puede desplegar la solución CX UI Capture j2 en el entorno de producción.

Perfil de despliegue Si desarrolla reglas de perfil o modifica los valores de Visor CX RealiTea en el entorno de prueba, haga que los cambios estén disponibles para todos los usuarios de Visor CX RealiTea y de reproducción basada en navegador que pueden acceder al entorno de producción. v Si desea más información sobre cómo compartir el perfil de Visor CX RealiTea, consulte "Visor RealiTea - Opciones de perfil" en el Manual de usuario de IBM Tealeaf Visor CX RealiTea. v Para la reproducción basada en navegador, los valores del perfil de reproducción se configuran para grupos de usuarios individuales para IBM Tealeaf cxImpact o usuarios de IBM Tealeaf cxReveal. – Si desea más información, consulte el perfil de la reproducción de navegador en "Administración de usuarios de CX" en el Manual de administración de IBM Tealeaf cxImpact. – Si desea más información, consulte el perfil de reproducción de navegador en "Administración de usuarios de cxReveal" en el Manual de administración de IBM Tealeaf cxReveal.

Capítulo 2. Instalación e implementación de CX UI Capture j2

15

Instalar en Producción Para instalar y desplegar en el entorno de producción, siga los mismos pasos que se utilizan en el entorno de despliegue, modificando el JavaScript según sea necesario en la producción. v Consulte “Instalación de CX UI Capture j2” en la página 11.

Verificar la Etapa 3 Repita todas las pruebas que ha completado en el desarrollo y la prueba en el entorno de producción. v “Verificar Etapa 1” en la página 11 v “Verificar Etapa 2” en la página 13

Configuración de JavaScript Interacciones JavaScript de CX UI Capture j2 con páginas de aplicación web El JavaScript de IBM Tealeaf CX UI Capture j2 puede supervisar eventos de interfaz de usuario adjuntando escuchas de suceso de teclado y ratón a elementos HTML en las páginas de la aplicación web.

Alteración temporal de la API existente En algunos casos, IBM Tealeaf altera la API del navegador existente. Actualmente, este comportamiento de alteración se produce para el evento siguiente.

window.onerror IBM Tealeaf altera el manejador de eventos window.onerror predeterminado para rastrear las condiciones de error del lado del cliente que no generan una transacción con el servidor web. La biblioteca de IBM Tealeaf CX UI Capture j2 realiza esta alteración solo si no hay ningún escucha actual para window.onerror.

Bloquear campos de datos confidenciales Si es necesario, se puede bloquear la información confidencial que envían los visitantes en formularios del lado del cliente en los datos JSON que se envían a IBM Tealeaf . Por ejemplo, si un visitante entra un número de la seguridad social en un campo de formulario, puede configurar reglas de bloqueo de campo para bloquear el número de la seguridad social entrado (como XXX-XX-XXXX). La sección siguiente describe cómo funciona la privacidad en IBM Tealeaf CX UI Capture j2. Implemente la configuración de la privacidad como parte de su instalación inicial. Si desea más información, póngase en contacto con IBM Professional Services. Consulte "Privacidad de datos en UI Capture" en la Guía de IBM Tealeaf CX UI Capture for AJAX.

16

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Instalación en páginas web Al planificar la instalación de la biblioteca de CX UI Capture j2, tenga en cuenta que utiliza recursos del sistema para procesar en el sitio web y los sistemas de captura IBM Tealeaf . Instale la biblioteca solo en las páginas que desea capturar y reproducir. La instalación de la biblioteca de CX UI Capture j2 puede provocar los efectos siguientes. v Los tiempos de carga de página pueden aumentar ligeramente durante la primera descarga. IBM Tealeaf proporciona estrategias para minimizar el efecto en tiempos de carga, incluyendo el almacenamiento en memoria caché del JavaScript después de la descarga inicial. v La página web publica más datos en elk servidor, pero no se procesan. v IBM Tealeaf debe procesar y almacenar los datos adicionales. IBM Tealeaf CX UI Capture j2 se ha diseñado para minimizar estas cargas.

ID de HTML exclusivos Para capturar los eventos de cliente para un objeto de modelo de objeto de documento, cada objeto o control disponible con el cual puede interactuar el visitante debe tener un ID HTML exclusivo. Sin ID exclusivos, IBM Tealeaf no puede reproducir correctamente los eventos de IU en la página. Si no ha instrumentalizado la aplicación para dar soporte a ID exclusivos o nombres únicos en el modelo de objeto de documento, IBM Tealeaf CX UI Capture j2 genera automáticamente vías de acceso al nodo que soportan el requisito de la exclusividad. IBM Tealeaf también soporte la creación de listas negras de ID, que fuerza el uso de valores de atributo Xpath o de nombre como identificadores. Consulte Capítulo 5, “Referencia de CX UI Capture j2”, en la página 43.

Cookies La sesión web debe utilizar cookies para la sesionización. Las cookies permiten a los eventos de cliente enviar mensajes sin tener que comprender el mecanismo de sesionización. Para obtener los mejores resultados en la captura de eventos de IU de cliente, despliegue el inyector de cookies de IBM Tealeaf en el entorno de servidor web. El inyector de cookies de IBM Tealeaf proporciona ID de sesión exclusivos con respecto a los datos de sesión capturados de IBM Tealeaf . Consulte "Instalación y configuración del inyector de cookies de Tealeaf" en el Manual del inyector de cookies de IBM Tealeaf .

Instalación en el servidor web La biblioteca de IBM Tealeaf CX UI Capture j2 consta de un único archivo JavaScript. Coloque este archivo JavaScript con los otros archivos estáticos servidos por su sitio.

Referencias al archivo JavaScript Para rastrear actividad en una página web, añada una referencia al archivo JavaScript necesario de CX UI Capture j2. Capítulo 2. Instalación e implementación de CX UI Capture j2

17

Cada página servida que requiere rastreo de eventos de cliente debe tener incluidos códigos para cargar el JavaScript de IBM Tealeaf CX UI Capture j2:

Si coloca el JavaScript de CX UI Capture j2 en cualquier lugar que no sea el directorio raíz del servidor web, ajuste el parámetro src= en la referencia para que señale la ubicación correcta. Consulte "Visión general de UI Capture j2".

Página de destino de IBM Tealeaf La página de destino de IBM Tealeaf es un URL en el que está configurado el JavaScript de CX UI Capture j2 para enviar peticiones POST para su captura por el sistema IBM Tealeaf . Coloque esta página dinámica con los otros archivos de página dinámico para la aplicación web. Esta página web de destino dinámico se debe publicar o crear para recibir la información publicada por el JavaScript, como TealeafTarget.php, TealeafTarget.jsp, TealeafTarget.asp o similar. Nota: La página de destino solo existe para reconocer la publicación. No se guarda ningún dato. El servidor web devuelve una respuesta válida mínima como, por ejemplo, el mensaje siguiente. 895 bytes recibidos en 0,1 ms

Coloque la página de destino dinámica con las otros archivos de página dinámica. Para simplificar, puede colocar estos archivos en el directorio raíz. El administrador del sitio web puede proporcionarle las políticas y los procedimientos para la instalación. Se proporcionan destinos de ejemplo para entornos ASPX, JSP y PHP con la distribución de CX UI Capture j2. v Modifique la página de destino para su entorno de destino específico. v Utilice estos destinos de ejemplo como base para crear páginas de destino idóneas para otros entornos.

Verificación de la página de destino Todas las páginas de destino de IBM Tealeaf proporcionadas se determinan de forma que los datos que reciben se pueden capturar, procesar e integrar en la reproducción mediante IBM Tealeaf . Nota: El nombre de archivo de la página de destino de IBM Tealeaf debe incluir TealeafTarget para una fácil identificación. No cambie este nombre de archivo después de configurar IBM Tealeaf CX UI Capture j2. Complete los pasos siguientes para verificar que no hay impedimentos a la captura y el proceso de la página de destino de IBM Tealeaf en el sistema. 1. En la consola web de IBM Tealeaf CX Passive Capture Application, configure las extensiones de archivo para descartar de la captura. Verifique que la extensión de archivo utilizada para la página de destino de IBM Tealeaf no se

18

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

descarta de la captura. Consulte "Consola web de PCA - Pestaña Interconexión" en el Manual de IBM Tealeaf CX Passive Capture Application. 2. En IBM Tealeaf Visor CX RealiTea, algunas extensiones de archivo se tratan como páginas interpretadas, que significa que las páginas se interpretan en el servidor web antes de que se entreguen a Visor CX RealiTea. Verifique que la extensión para el nombre de archivo de la página de destino de IBM Tealeaf no aparece en la lista de posibles páginas interpretadas en Visor CX RealiTea. Consulte "Visor RealiTea - Pestañas Opciones avanzadas" en el Manual de usuario de IBM Tealeaf Visor CX RealiTea.

Instalación de la página de destino La página de destino se debe añadir a la infraestructura web en una ubicación a la que se puede acceder desde el navegador web del visitante. Para simplificar, puede colocar estos archivos en el directorio raíz o en un directorio JavaScript central. El administrador del sitio web puede proporcionarle las políticas y los procedimientos para la instalación. En las páginas de la aplicación web, las referencias a la página de destino deben estar relacionadas con la vía de acceso raíz del sitio. Para www.example.com, para hacer referencia a una página de destino de IBM Tealeaf en www.example.com/ scripts/TealeafTarget.aspx, configure el IBM Tealeaf CX UI Capture j2 en /scripts/TealeafTarget.aspx. La / inicial la convierte en una vía de acceso relativa a la raíz del sitio.

Directrices para el despliegue Consulte estas directrices al desplegar la página de destino de IBM Tealeaf . Normalmente, la página de destino de IBM Tealeaf se despliega de forma independiente de la propia aplicación central en términos lógicos y físicos. Revise estas directrices con el personal de la infraestructura. v Evite desplegar la página de destino de IBM Tealeaf detrás de características de seguridad empresarial, como SiteMinder. v Si es posible, despliegue la página de destino de IBM Tealeaf en una instancia de servidor de aplicaciones separada desde la aplicación web. Aunque se trata de un despliegue ligero, puede competir por los recursos con la aplicación web. Si es posible, realice el despliegue en una instancia de servidor de aplicaciones dedicada. v Pruebe la página de destino de IBM Tealeaf de forma exhaustiva en un entorno de prueba antes de su despliegue para producción.

Referencias a la página de destino En las páginas de la aplicación web, las referencias a la página de destino de IBM Tealeaf deben estar relacionadas con la vía de acceso raíz del sitio. Para www.example.com, para hacer referencia a una página de destino de IBM Tealeaf en www.example.com/scripts/TealeafTarget.aspx, configure la biblioteca de CX UI Capture j2 para realizar POST en /scripts/TealeafTarget.aspx. La "/" inicial hace que sea una vía de acceso relativa de raíz del sitio. En el JavaScript de CX UI Capture j2, el URL de la página de destino se configura como parte de la implementación inicial.

Capítulo 2. Instalación e implementación de CX UI Capture j2

19

Pruebas de unidad de la página de destino Para probar que la página de destino está funcionando correctamente, puede ejecutar las pruebas siguientes. v GET: Especifique el URL de la página de destino en el navegador. Si recibe una página en blanco o un error distinto a 404, la página está manejando correctamente la petición. v POST: Puede utilizar Fiddler u otra herramienta de supervisión de tráfico para generar una publicación en la página. Verifique que la acción POST ha generado un mensaje de código de estado 200.

Configuración del JavaScript de CX UI Capture j2 Para configurar el archivo JavaScript para IBM Tealeaf CX UI Capture j2, defina valores para la compresión y la memoria caché.

Compresión Para un rendimiento óptimo, comprima el JavaScript de IBM Tealeaf en el servidor web. v Configure el servidor web para realizar la codificación de la compresión de los datos de respuesta antes de que se vuelvan a enviar al navegador, que los descomprime para su uso en el cliente. v Aplique la codificación de compresión en el contenido de texto estático, incluyendo el archivo JavaScript de IBM Tealeaf . Nota: Puesto que este comportamiento se negocia entre el servidor y el cliente, un servidor web compatible con HTTP 1.1 no debe utilizar ninguna codificación de compresión a menos que el cliente haya indicado su soporte mediante una cabecera de petición (Accept-Encoding). Esta forma de compresión reduce más los tamaños del archivo del JavaScript de IBM Tealeaf minimizado aproximadamente un 75 % antes de la entrega al cliente.

Almacenamiento en memoria cache del navegador Para la configuración de la memoria caché del navegador, siga estas directrices. v Defina los valores TTL para las cabeceras Expires o Cache-Control para el JavaScript de IBM Tealeaf en el mismo valor que el resto de los scripts almacenados en el servidor web. v Aproveche la función GET condicional de HTTP 1.1 configurando el servidor web para definir las cabeceras ETag o Last-Modified apropiadas. Cuando esta característica está habilitada, cualquier cambio en los recursos JavaScript se propaga automáticamente en la memoria caché del visitante. Si desea más información, consulte estos recursos del sector. v http://developer.yahoo.com/performance/rules.html v http://code.google.com/speed/page-speed/docs/rules_intro.html

Configuración de IIS En Windows Server 2003, coloque los archivos de IBM Tealeaf CX UI Capture j2 en un directorio con el otro archivo JavaScript para cumplir con el valor "acceso de origen de script" en la configuración.

20

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Si desea más información sobre cómo configurar IIS, consulte http:// support.microsoft.com/default.aspx?scid=kb;en-us;313075.

Configuración de servidor web no IIS Para un servidor no IIS, se debe crear una página web dinámica para aceptar el POST del JavaScript de IBM Tealeaf CX UI Capture j2. El contenido de la página web varía en función de la tecnología desplegada. El contenido de las peticiones POST devueltas del JavaScript de UI Capture es irrelevante. Para minimizar el ancho de banda, minimice el contenido de retorno.

Modificaciones de página web Cada página servida que requiere un rastreo del evento del cliente debe tener incluido un código para cargar el archivo JavaScript de IBM Tealeaf CX UI Capture j2. Consulte “Incluir ubicación ” en la página 11.

Gestión de cambios para elementos del modelo de objeto de documento En determinadas instancias, cuando la aplicación web cambia el modelo del objeto de documento, el código de la página debe notificar a IBM Tealeaf la ubicación donde se realizaron los cambios. Para actualizaciones basadas en Ajax, DHTML o JavaScript que añaden o editan elementos del modelo de objeto de documento, la página en la que se realizan los cambios debe llamar a la siguiente API de IBM Tealeaf para registrar el cambio del nodo, TLT.rebind. Nota: Esta llamada se debe realizar cuando se añaden nodos nuevos para los cuales capturar la interacción del usuario es básico. Los cambios que eliminan nodos se pueden procesar durante la limpieza normal cuando se descarga la página. Código de ejemplo: Ejemplo de volver a vincular ... /* Se llamará a AJAXUpdate una vez que XMLHttpRequest devuelva * una respuesta correcta. */ function AJAXUpdate(responseMarkup){ var targetDiv = document.getElementById("target_div"); if (!targetDiv || !responseMarkup) { return; } targetDiv.innerHtml = responseMarkup; if (TLT && TLT.rebind) { // Notificar a Tealeaf la actualización de DOM. TLT.rebind(targetDiv); } }

Capítulo 2. Instalación e implementación de CX UI Capture j2

21

... ... Marcador donde se colocará la marcación de la respuesta AJAX. ...

Actualizar CX UI Capture j2 Si desea información sobre cómo actualizar a la última versión de IBM Tealeaf CX UI Capture j2, póngase en contacto con IBM Professional Services. Si desea más información sobre cómo actualizar la versión de legado de CX UI Capture j2, consulte "Instalación e implementación de UI Capture for Ajax" en la Guía de IBM Tealeaf CX UI Capture for AJAX.

Soporte para cabeceras de legado Para los clientes que están actualizando desde IBM Tealeaf CX UI Capture for AJAX a IBM Tealeaf CX UI Capture j2, se conserva el soporta para algunas de las cabeceras de legado enviadas desde CX UI Capture for AJAX. Cabecera Descripción X-TeaLeafType Tipo de conjunto de eventos del lado del cliente. El valor predeterminado es GUI. X-TeaLeaf-Page-Url URL completo de la página padre. X-TeaLeaf-Page-Render Tiempo en milisegundos para la página para representar. X-TeaLeaf-Page-Objects Número de objetos (códigos de página) en la página. X-TeaLeaf-Page-Img-Fail Número de imágenes incorrectas en la página. X-TeaLeaf-Page-Cui-Exceptions Número de excepciones en la página. X-TeaLeaf-Page-Dwell Tiempo de permanencia en la página. X-TeaLeaf-Page-Last-Field ID del último campo de formulario visitado en la página. X-TeaLeaf-Visit-Order Orden de visita de los campos del formulario en la página.

22

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Nota: Otras cabeceras que se envían a través de IBM Tealeaf CX UI Capture for AJAX no están soportadas. si desea más información sobre estas cabeceras, consulte "Mensaje de evento de cliente de ejemplo de UI Capture for Ajax" en la Guía de IBM Tealeaf CX UI Capture for AJAX.

Desinstalación de CX UI Capture j2 Para desinstalar CX UI Capture j2, aplique los cambios siguientes en el entorno de desarrollo. 1. Guarde una copia del JavaScript de CX UI Capture j2 desplegado actualmente. Si ha minimizado el JavaScript, guarde una versión del JavaScript de origen. 2. Elimine las referencias en los archivos CX UI Capture j2 desde las páginade la aplicación web. 3. Elimine los archivos CX UI Capture j2 del área donde están instalados en el servidor web. 4. Elimine la página de destino de IBM Tealeaf . 5. Transmita los cambios en el servidor. 6. Verifique que no se generan errores de navegador en los navegadores del visitante cuando visite su propia aplicación web. 7. Verifique que los eventos de IBM Tealeaf CX UI Capture j2 dejan de ser capturados y procesados por IBM Tealeaf . 8. Inhabilite los objetos de evento IBM Tealeaf que hacen referencia a los eventos de IU de referencia capturados por el IBM Tealeaf CX UI Capture j2. Si los cambios se aplican correctamente en el entorno de despliegue, puede aplicarlos en los entornos de prueba y producción en sucesión.

Capítulo 2. Instalación e implementación de CX UI Capture j2

23

24

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Capítulo 3. Asistente de configuración de CX UI Capture j2 Con el asistente de configuración, puede completar las tareas de configuración necesarias para modificar la solución IBM Tealeaf CX UI Capture j2 para trabajar con la aplicación web. A través de su interfaz basada en pasos, configure IBM Tealeaf CX UI Capture j2, después de lo cual los cambios de configuración se pueden aplicar al JavaScript en el entorno. El asistente de configuración está disponible en el paquete de instalación en el directorio Wizard. En el asistente, puede acceder a documentación específica de contexto a través del icono Ayuda (

) junto a opciones disponibles.

Nota: Para el release 8.6 y posteriores, debe utilizar CX UI Capture j2, la versión nueva del SDK de UI Capture. Para el release 8.5 y anteriores, el uso de CX UI Capture j2 no está soportado. Puede utilizar la versión de legado, CX UI Capture for AJAX. Para obtener más información, consulte la publicación IBM Tealeaf CX UI Capture for AJAX Guide.

Navegadores soportados El asistente de configuración de IBM Tealeaf CX UI Capture j2 está soportado en Chrome y Firefox 10 y posterior. Internet Explorer no está soportado.

Controles del asistente de configuración Al utilizar el asistente de configuración de CX UI Capture j2, complete distintas acciones con estos controles de interfaz de usuario. Para continuar con la siguiente pantalla en el asistente, pulse Siguiente. Para volver a la pantalla anterior, pulse Anterior. Para completar la configuración, pulse Finalizar. Para restablecer la configuración a los valores predeterminados proporcionados por Tealeaf, pulse Restablecer a valores predeterminados. v Para definir y probar expresiones regulares para su uso en la configuración, pulse Probador de expresiones regulares. Consulte “Probador de expresiones regulares” en la página 31. v Si desea más información sobre valores de configuración individuales, pulse el v v v v

icono de Ayuda (

) junto al valor.

Tipos de creación De forma predeterminada, el asistente de configuración genera el JavaScript de IBM Tealeaf CX UI Capture j2 para su uso en un entorno de producción. En función del estado actual de desarrollo, puede seleccionar un tipo de creación diferente en el asistente de configuración. © Copyright IBM Corp. 1999, 2013

25

Las versiones de producción del JavaScript se han minimizado, lo que significa: v Los comentarios y otro texto no funcional se eliminan. v Los nombres de variable se reducen a los archivos más pequeños posibles. v Se reduce la carga útil general de JavaScript para facilitar los requisitos de ancho de banda. v El código ya no se lee fácilmente. Las descripciones de los otros tipos de creación son las siguientes. Tipo de creación Descripción Creación de producción (minimizado) El valor predeterminado. Creación de producción (sin minimizar) Se aplican todas las opciones de creación de producción. Sin embargo, el JavaScript no se ha minimizado, lo que permite la revisión del código desplegado. Creación de desarrollo (sin minimizar) El código de depuración adicional está habilitado. Nota: Esta opción es básicamente para desarrolladores o para usuarios avanzados de la biblioteca que desean depurar el código. No despliegue este tipo de creación en la producción. Nota: Si sigue desarrollando y probando la solución IBM Tealeaf CX UI Capture j2, seleccione la opción de creación Creación de producción (sin minimizar).

Paso 1: Configuración del servicio de navegador En este paso, configure el servicio del navegador, que se utiliza para supervisar objetos en el navegador.

Elija jQuery o W3C. En función de lo que selecciona, tiene distintas opciones en la sección Opciones avanzadas. Si selecciona jQuery, las Opciones avanzadas están disponibles.

26

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

v Añada una vía de acceso al objeto jQuery. v Ponga en la lista negra los ID de elemento que no son exclusivos o que se generan dinámicamente. Los ID de elemento que coinciden con alguna de las entradas de la lista negra se sustituyen con valores de atributo personalizados o XPATH. v Añada uno o más nombres de atributo que se pueden utilizar para identificar de forma exclusiva un elemento cuando su ID HTML no está disponible o está en la lista negra. Si selecciona W3C, están disponibles las Opciones avanzadas siguientes. v Añada el URL Sizzle. Sizzle es necesario para una funcionamiento correcto de la biblioteca en navegadores IE de legado cuando se utiliza el servicio W3C. v Incluya la vía de acceso al objeto Sizzle. v Ponga en la lista negra los ID de elemento que no son exclusivos o que se generan dinámicamente. Los ID de elemento que coinciden con alguna de las entradas de la lista negra se sustituyen con valores de atributo personalizado o XPATH. v Añada uno o más nombres de atributo que se pueden utilizar para identificar de forma exclusiva un elemento cuando su ID HTML no está disponible o está en la lista negra.

Pulse

en el asistente de configuración si desea más detalles sobre cada valor.

Hay disponibles más detalles en la sección Referencia. Consulte Capítulo 5, “Referencia de CX UI Capture j2”, en la página 43.

Paso 2: Configuración del servicio de cola En este paso, se configura la cola de mensajes que se utiliza para almacenar mensajes JSON localmente antes de que se envíen a la página de destino de IBM Tealeaf para la captura y el proceso. Solo puede configurar una cola. Esta cola se debe llamar DEFAULT. Actualice el campo Punto final con el URL de la página de destino. Actualice el campo Tamaño con el límite al número de mensajes para permitir en la cola antes de que se envíe. De forma predeterminada, los mensajes se colocan en cola localmente en el navegador del visitante. Cuando la cola alcanza un número definido de mensajes, los datos que se incluyen se serializan y envían a la página de destino de IBM Tealeaf , que permite a IBM Tealeaf captura y procesar los mensajes.

Capítulo 3. Asistente de configuración de CX UI Capture j2

27

Pulse

en el asistente de configuración si desea más detalles sobre cada valor.

Hay disponibles más detalles en la sección Referencia. Consulte Capítulo 5, “Referencia de CX UI Capture j2”, en la página 43.

Paso 3: Configuración del servicio de mensaje (configuración de máscaras de privacidad) En este paso, puede configurar valores de privacidad para que los datos sensibles detectados en el cliente se bloqueen o enmascaren antes del envío a IBM Tealeaf para la captura. La configuración de la privacidad a través de IBM Tealeaf CX UI Capture j2 garantiza que los datos sensibles nunca tocan IBM Tealeaf . v Puede especificar varios destinos IDs e IDTypes para cada máscara de privacidad. v Las máscaras de privacidad vacías que añade en el asistente no se añaden al archivo de configuración. v IBM Tealeaf proporciona varios métodos para aplicar la privacidad en toda la solución IBM Tealeaf . Consulte "Gestión de la privacidad de datos en Tealeaf CX" en el Manual de instalación de IBM Tealeaf CX.

28

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Pulse

en el asistente de configuración si desea más detalles sobre cada valor.

Los campos de contraseña se pueden enmascarar si utiliza defaultconfiguration.js y define los campos input type=password fields. Si utiliza el asistente de configuración, los campos de contraseña se deben enmascarar de forma explicita añadiendo lo siguiente a la configuración de privacidad. El asistente de configuración actual no soporta añadir selectores CSS para que esta edición en la configuración se deba realizar a mano. { targets: [ // Selector CSS: Todos los campos de entrada de contraseña "input[type=password]" ], "maskType": 3 }

Hay disponibles más detalles en la sección Referencia. Consulte Capítulo 5, “Referencia de CX UI Capture j2”, en la página 43.

Paso 4: Serializador En este paso, puede elegir utilizar un analizador/serializador incorporador, si no hay ninguno disponible. Añada analizadores que contienen funciones para CX UI Capture j2 para utilizar (por ejemplo, JSON.parse). El primer analizador es el más importante. Si CX UI Capture j2 no encuentra el primer analizador, CX UI Capture j2 lo vuelve a intentar, etc. Añada serializadores que contienen funciones para CX UI Capture j2 para utilizar (por ejemplo, JSON.stringify). El primer serializador es el más importante. Si CX UI Capture j2 no encuentra el primer serializador, CX UI Capture j2 lo vuelve a intentar, etc.

Pulse

en el asistente de configuración si desea más detalles sobre cada valor.

Hay disponibles más detalles en la sección Referencia. Consulte Capítulo 5, “Referencia de CX UI Capture j2”, en la página 43.

Paso 5: Módulos En este paso, seleccione los módulos para habilitar en la solución IBM Tealeaf CX UI Capture j2 y defina opciones avanzadas para cada módulo. Capítulo 3. Asistente de configuración de CX UI Capture j2

29

También puede añadir un delegado de evento de rendimiento personalizado o un delegado de evento de reproducción personalizado. Los eventos del módulo de rendimiento cumplen con el estándar W3C sobre tiempo de navegación. El módulo de rendimiento analiza el objeto de rendimiento tiempo de navegación W3C e incluye esta información como el mensaje de rendimiento en la secuencia de datos JSON enviada de vuelta al servidor de captura Tealeaf.

Pulse

en el asistente de configuración si desea más detalles sobre cada valor.

Hay disponibles más detalles en la sección Referencia. Consulte Capítulo 5, “Referencia de CX UI Capture j2”, en la página 43. Si desea más información, visite http://www.w3c.org.

30

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Paso 6: Valores diversos En este paso, puede añadir Marcos de lista negra que se excluyen de la recopilación de datos. También puede definir opciones de uso compartido de datos de sesión.

Pulse

en el asistente de configuración si desea más detalles sobre cada valor.

Hay disponibles más detalles en la sección Referencia. Consulte Capítulo 5, “Referencia de CX UI Capture j2”, en la página 43.

Probador de expresiones regulares En el probador de expresiones regulares, puede especificar expresiones regulares y probarlas con los datos que proporcione.

Figura 4. Probador de expresiones regulares

1. RegEx: Inserte la expresión regular para probar aquí. v De forma predeterminada, las búsquedas en los datos de Prueba de ejemplo son sensibles a las mayúsculas. Puede configurar la prueba para realizar búsquedas No sensibles a mayúsculas y minúsculas. Capítulo 3. Asistente de configuración de CX UI Capture j2

31

v De forma predeterminada, la expresión regular se utiliza en la primera aparición de la serie. v Para utilizar la expresión regular en todas las apariciones en la serie, seleccione Global. Esta opción no suele ser necesaria. 2. Ejemplo de prueba: Inserte los datos de ejemplo para aplicar en la prueba aquí. Utilice datos específicos a la aplicación web, como una solicitud de ejemplo. 3. Coincide: Si se encuentra una coincidencia para la expresión regular en los datos de la prueba de ejemplo, este valor es true. 4. RegEx (preparado): Si la expresión regular se evalúa como true o false, el valor que puede utilizar para insertar la expresión regular en cualquier recuadro de texto del asistente de configuración se muestra aquí. Copie y pegue el texto según sea necesario. v Se insertan referencias a los distintivos globales o insensibles a mayúsculas y minúsculas. Por ejemplo, el distintivo insensible a las mayúsculas y minúsculas se añade a la expresión de la forma siguiente: "flags": "i". v Si desea más información sobre los distintivos de expresión regular, consulte https://developer.mozilla.org/en- US/docs/JavaScript/Reference/ Global_Objects/RegExp. 5. Pulse Probar. 6. Para cerrar el probador de expresiones regulares, pulse

32

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

.

Capítulo 4. Directrices de uso de CX UI Capture j2 Este capítulo proporciona directrices para una implementación y un uso correctos de IBM Tealeaf CX UI Capture j2. Nota: Para el release 8.6 y posteriores, debe utilizar CX UI Capture j2, la versión nueva del SDK de UI Capture. Para el release 8.5 y anteriores, el uso de CX UI Capture j2 no está soportado. Puede utilizar la versión de legado, CX UI Capture for AJAX. Para obtener más información, consulte la publicación IBM Tealeaf CX UI Capture for AJAX Guide. En paralelo con el proceso para desarrollar la aplicación web, planifique desplegar IBM Tealeaf CX UI Capture j2 tan pronto como sea posible en el proceso de desarrollo para los motivos siguientes. v Un despliegue temprano limita el potencial de los problemas que se descubren en un entorno de producción. v Un despliegue temprano proporciona una oportunidad para supervisar problemas de aplicación y ayudar a depurar la aplicación. Estas directrices se aplican a todos los despliegues de IBM Tealeaf CX UI Capture j2. Se pueden aplicar opciones diferentes a tipos distintos tipos de aplicación.

Ámbito de la aplicación IBM Tealeaf CX UI Capture j2 soporta navegadores, tipos de aplicación y protocolos específicos. Para ver una lista de los navegadores soportados, consulte el Navegadores soportados.

Tipos de aplicación soportadas En general, las funciones RIA (aplicación avanzada de Internet) deben estar limitadas solo a las áreas de la aplicación web que lo necesitan. RIA requiere técnicas de supervisión más sofisticadas y puede aumentar el volumen del tráfico que debe procesar IBM Tealeaf . IBM Tealeaf soporta los tipos de aplicación avanzada de Internet siguientes: v Ajax Nota: IBM Tealeaf sigue soportando clientes existentes que han desplegado aplicaciones Flash o Flex. IBM Tealeaf no soporta clientes nuevos que utilizan estas tecnologías. Nota: Actualmente, IBM Tealeaf no soporta UI Capture y la reproducción de aplicaciones Flex o Flash en la misma página. Esta limitación no incluye aplicaciones de contenido multimedia que no requieren la captura o reproducción de la interfaz de usuario de IBM Tealeaf . Si la aplicación requiere varias RIA Flex o Flash en la misma página, cada una se debe capturar para la reproducción, póngase en contacto con IBM Professional Services. © Copyright IBM Corp. 1999, 2013

33

Nota: IBM Tealeaf soporta aplicaciones que utilizan formatos de datos basados en texto para comunicarse con el servidor. Si la aplicación utiliza formatos de datos binarios como, por ejemplo, AMF, póngase en contacto con IBM Professional Services.

Protocolos soportados IBM Tealeaf soporta HTTP y HTTPS para la comunicación de petición y respuesta entre cliente y servidor. Verifique que todas las comunicaciones de envío y recepción de Ajax se gestionan mediante HTTP o HTTPS. El protocolo de los eventos de cliente es el mismo que la petición que ha enviado la página al navegador. Si los eventos de cliente se deben enviar mediante HTTPS, verifique que la página de origen se entrega mediante HTTPS. Los valores del campo de formulario capturados se transmiten en el mismo protocolo en el cual la página de formulario se transmite al servidor. Si la página de formulario se transmite mediante HTTPS, los valores del campo de formulario también se cifran. Nota: Actualmente, IBM Tealeaf no soporta ningún otro protocolo, como la modalidad continua HTTP, la distribución HTTP o protocolos no HTTP, como RTMP. Verifique que la aplicación no utiliza protocolos no HTTP/HTTPS.

Antes de empezar el desarrollo Antes de empezar las iniciativas de desarrollo de IBM Tealeaf CX UI Capture j2, verifique que la información siguiente está disponible o que se ha capturado.

Acceso de IBM Tealeaf Si es posible, despliegue la aplicación web en un servidor al que pueden acceder los desarroladores de IBM Tealeaf . Para depurar eficazmente los problemas, los desarrolladores de IBM Tealeaf deben tener acceso a la aplicación.

Contenido de terceros Las directrices siguientes se aplican al contenido de terceros.

Dominios de terceros IBM Tealeaf no puede capturar contenido gestionado por dominios de terceros. En un despliegue típico, la mayoría de este contenido no es integral para el rendimiento de la aplicación, y se puede volver a solicitar durante la reproducción sin que ello afecte a la reproducción de la aplicación en general. Si es necesaria la captura de versiones dinámicas de este contenido, póngase en contacto con IBM Professional Services.

Plug-ins de terceros Además del reproductor Flash, actualmente IBM Tealeaf no soporta la reproducción de plug-ins de terceros en aplicaciones avanzadas de Internet como, por ejemplo, Silverlight o applets Java™.

34

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Personal El personal de los roles siguientes deben estar disponibles para IBM Tealeaf para el despliegue de CX UI Capture j2. Rol

Descripción

Arquitecto de aplicaciones Durante el despliegue, IBM Tealeaf puede realizar solicitudes al arquitecto de aplicaciones web para identificar ubicaciones en la aplicación para llamadas a la API de IBM Tealeaf . Esta persona también es útil para responder preguntas técnicas. Analista empresarial Desde la perspectiva empresarial, es importante saber qué áreas de la aplicación requieren supervisión y en qué grado. Este conocimiento se traduce directamente en qué elementos de IU, eventos, pulsaciones y otros aspectos de la aplicación debe capturar IBM Tealeaf . Durante el desarrollo, este persona podría ser capaz de identificar casos de uso calificados para IBM Tealeaf CX UI Capture j2.

Recursos externos Si el desarrollo de aplicaciones está externalizado a un tercero, proporcione acceso a este equipo. IBM Tealeaf puede trabajar con cualquier restricción para contactar con equipos de desarrollo externos.

Consideraciones de desarrollo Durante el proceso de desarrollo, tenga en cuenta las consideraciones siguientes.

Ciclo de desarrollo IBM Tealeaf asume que se están produciendo las etapas de producción básica siguientes. v Desarrollo v Pruebas v Producción Si desea más información sobre los objetivos de desarrollo durante cada una de las etapas, consulte Capítulo 2, “Instalación e implementación de CX UI Capture j2”, en la página 9.

Cuándo desplegar CX UI Capture j2 durante el desarrollo IBM Tealeaf recomienda desplegar IBM Tealeaf CX UI Capture j2 tan pronto como sea posible en el proceso de desarrollo. Además de reducir el número de problemas en un entorno de producción, CX UI Capture j2 puede ser útil para depurar problemas con el propio proceso de desarrollo de aplicaciones. La aplicación web y CX UI Capture j2 pueden trabajar mano a mano para ofrecer un mejor resultado en general. Por ejemplo, los cambios en la aplicación del lado del cliente como, por ejemplo, cambios en los identificadores de elemento, adiciones o modificaciones de los widgets de IU, o con CX UI Capture j2 en un entorno de despliegue facilita una resolución más rápida y una mejor experiencia de reproducción, una vez desplegar la aplicación en el entorno de producción. Capítulo 4. Directrices de uso de CX UI Capture j2

35

También puede utilizar la configuración de reglas de privacidad de IBM Tealeaf CX UI Capture j2 para identificar y proteger datos de cliente sensibles antes de su despliegue en el sitio activo. Al incluir IBM Tealeaf como parte del esfuerzo de desarrollo principal para la aplicación web, CX UI Capture j2 se puede intergrar en la gestión de cambios y en los procesos de mantenimiento planificados para su empresa.

Entornos de desarrollo y prueba Siempre que sea posible, configure todos los entornos de desarrollo o prueba para duplicar el entorno de producción. Aplique los mismos valores y permisos del servidor web que los que se han configurado en el servidor de producción al entorno de desarrollo o entornos de prueba. Nota: Nunca despliegue IBM Tealeaf CX UI Capture j2 directamente en un entorno de producción.

Gestión de rendimiento Integre IBM Tealeaf CX UI Capture j2 en la suite de prueba de la gestión de rendimiento para su empresa. La medida del rendimiento de IBM Tealeaf CX UI Capture j2 JavaScript puede ayudar a configurar el tamaño y la frecuencia de las publicaciones de la UI Capture. A través de IBM Tealeaf , puede supervisar los aspectos de rendimiento de la aplicación web desplegada. Consulte "Rendimiento de UI Capture" en la Guía de IBM Tealeaf CX UI Capture for AJAX.

Contenido de la aplicación Al desarrollar la aplicación web, tenga en cuenta las consideraciones siguientes.

Identificadores exclusivos Todos los elementos de interfaz de usuario de la aplicación web deben tener identificadores exclusivos. Cuando sea posible, implemente la aplicación con identificadores exclusivos para cada elemento de IU. Si los identificadores exclusivos no están disponibles, IBM Tealeaf se basa en identificadores XPath. Sin embargo, esta solución podría no ser precisa al 100 % y el uso de XPaths puede aumentar el tamaño de cada mensaje de CX UI Capture j2 y el coste total del almacenamiento de los datos. Nota: IBM Tealeaf CX UI Capture j2 no comprueba automáticamente la exclusividad de los identificadores. Los identificadores no exclusivos se deben colocar manualmente en la lista negra mediante la configuración.

GUID transmitidos dinámicamente Si la aplicación genera GUID dinámicos del lado del cliente que se transmiten a través de la red, la reproducción de sesiones capturas se puede ver afectada. Las indicaciones de fecha y hora y los cambios en el comportamiento de la aplicación debido al agente del usuario, el entorno local del visitante y otros factores dinámicos pueden tener efectos en la reproducción.

36

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

En función de las variaciones, la reproducción eficaz podría requerir a los IBM Professional Services que desarrollen reglas complejas para utilizar con los datos POST generados automáticamente, volver a correlacionar hosts de servidor, etc. Nota: Siempre que sea posible, evite los identificadores generados dinámicamente del lado del cliente. Aunque IBM Tealeaf puede rastrera los identificadores dinámicos, gestionarlos añade otra capa de complejidad en la configuración.

No utilice palabras clave del modelo de objetos de documento como nombre de campo de formulario Este requisito se ilustra mejor con un ejemplo. A continuación aparece una especificación de un formulario HTML que contiene tres campos de entrada, el nombre del cual utiliza las palabras clave de HTML y de objeto de modelo de documento action, type y tagName.

Cuando CX UI Capture j2 intenta informar de las propiedades estándar (como type, action o tagName) del nodo de formulario en el cual se ha producido un evento de usuario, el valor normalmente es una serie definida o un valor sin definir o nulo. En este caso, el destino es un elemento de formulario, cuyos nombres de campo de entrada se exportan mediante el navegador como propiedades del objeto de formulario. Como resultado, las propiedades action, type y tagName del formulario hacen referencia al campo de entrada respectivo, que es un objeto. Cualquier JavaScript que intenta acceder a una de estas propiedades nativas recupera en su lugar el objeto del campo de entrada. Nota: No utilice ninguna palabra clave reservada de modelo de objeto de documento como el nombre de un campo de formulario.

Objetos de aplicación Las secciones siguientes describen aspectos de la aplicación que está desarrollando y cómo pueden afectar a IBM Tealeaf CX UI Capture j2. En general, no cancele los eventos JavaScript en la aplicación. Permita que todos los eventos de elementos hijo se desencadenen de forma masiva en el elemento raíz del documento.

Ajax v Siempre que sea posible, no utilice códigos ancla como el valor al que se deben cambiar las vistas controladas por Ajax, los modales o las ventanas flotantes. v En las llamadas Ajax, no haga que los parámetros de solicitud o los datos de respuesta sean difíciles de revisar y analizar. Cree un cuerpo de solicitud que muestra claramente lo que se está solicitando en el documento raíz. Se aplica lo mismo a la respuesta. v Para las llamadas Ajax que dan como resultado actualizaciones en la página en forma de elementos de entrada de usuario nuevo como, por ejemplo, listas desplegables o recuadros de texto, IBM Tealeaf debe ser notificado para que las

Capítulo 4. Directrices de uso de CX UI Capture j2

37

interacciones de usuario con estos elementos recién insertados se pueden capturar. La biblioteca de CX UI Capture j2 proporciona una API sencilla para este propósito.

Controles personalizados de interfaz de usuario Nota: La captura y respuesta de controles personalizados de interfaz de usuario podrían requerir una solución personalizada. Si desea más información, póngase en contacto con IBM Professional Services.

Eventos Keyup Nota: La versión JSON de CX UI Capture for AJAX no captura eventos keyup del cliente. En su lugar, supervise los eventos de cambio para los mismos objetos.

Cabeceras del control de memoria caché HTTP En función de la configuración del navegador del visitante, CX UI Capture j2 JavaScript se podría almacenar en la memoria caché local para un periodo prolongado. Si despliega una versión actualizada de CX UI Capture j2, los navegadores de los visitantes podrían seguir extrayendo el JavaScript de CX UI Capture j2 de la memoria caché local, lo que puede provocar problemas significativos si se necesitaban cambios de configuración para UI Capture para que funcione con la aplicación. Para gestionar este posible problema, utilice cabeceras de control de memoria caché HTTP para el servidor web y la configuración del uso de la solicitudes HTTP condicionales a través de la cabecera HTTP estándar Last-Modified. Cualquier actualización en los archivos CX UI Capture j2 en el servidor se propaga automáticamente mediante el mecanismo de almacenamiento en memoria caché HTTP. Nota: El almacenamiento en memoria caché de HTTP requiere más configuración y puede generar problemas si no se ha configurado correctamente. Consulte con el personal de TI antes de habilitar estos cambios. Nota: Si no puede realizar cambios en la configuración en el servidor web, puede gestionar actualizaciones colocando una indicación de fecha en el nombre del archivo de los archivos de IBM Tealeaf CX UI Capture j2 como, por ejemplo, tealeaf_110310.js. Sin embargo, estos cambios de nombre de archivo se deben coordinar con el equipo de desarrollo web y no siempre desencadenan el comportamiento correcto del almacenamiento en memoria caché. Referencias: v http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html#sec13 v http://httpd.apache.org/docs/2.1/caching.html

Datos privados IBM Tealeaf proporciona muchas opciones para gestionar la privacidad de datos en todas las funciones de captura, reproducción e informes. Los datos se pueden bloquear o enmascarar a través de CX UI Capture j2, en el punto de la captura en CX Passive Capture Application, o utilizando el agente de sesión de privacidad en la interconexión en el servidor de procesos.

38

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Identifique los datos que requieren la privacidad con anterioridad en el proceso de desarrollo y pruebe la configuración de privacidad en los entornos de desarrollo y prueba. Siempre que sea posible, busque minimizar el volumen de datos que requieren gestión de privacidad. Nota: Cuando los datos de CX UI Capture j2 están bloqueados o enmascarados utilizando la privacidad de IBM Tealeaf , la reproducción se puede interrumpir si la aplicación web no se ha diseñado para aceptar el contenido alterado. v Si desea más información sobre cómo IBM Tealeaf protege datos, consulte "Gestión de privacidad de datos en Tealeaf CX" en el Manual de instalación de IBM Tealeaf CX. v Si desea más información sobra privacidad de datos en UI Capture, consulte "Privacidad de datos en UI Capture" en la Guía de IBM Tealeaf CX UI Capture for AJAX.

Frecuencia de publicaciones IBM Tealeaf permite la configuración del tamaño y la frecuencia de POST en la página de destino de IBM Tealeaf . v Durante el desarrollo, puede enviar POST pequeños y frecuentes de forma que pueda supervisar actividades en un nivel granular. v En un entorno de producción, minimice el número de POST, cada uno de los cuales tiene una sobrecarga de datos. Nota: De forma ideal, el desencadenante para enviar cada POST en un entorno de producción es el tamaño máximo de la publicación. El tamaño y la frecuencia de estas publicaciones se pueden configurar mediante parámetro para controlar: v El número máximo permitido de eventos en el almacenamiento intermedio. Si se excede este máximo, se publican los eventos en cola. v Un valor de temporizador para desechar periódicamente la cola del evento, independientemente del tamaño del almacenamiento intermedio

Eventos de interfaz de usuario alterados temporalmente por CX UI Capture j2 En algunas implementaciones, IBM Tealeaf se puede configurar para alterar temporalmente eventos de interfaz de usuario específicos. Verifique que no hay ningún conflicto entre las alteraciones de IBM Tealeaf y los eventos su aplicación utiliza o supervisa. Consulte Capítulo 2, “Instalación e implementación de CX UI Capture j2”, en la página 9.

Despliegue de CX UI Capture j2 Colocación de CX UI Capture j2 Para obtener los mejores resultados, coloque el archivo de configuración de CX UI Capture j2 al principio de la página en la sección de cabecera HTML. La colocación en otras secciones de la página también está soportada.

Capítulo 4. Directrices de uso de CX UI Capture j2

39

Consulte Capítulo 2, “Instalación e implementación de CX UI Capture j2”, en la página 9.

JavaScript Las directrices siguientes se aplican al uso de JavaScript.

Modificaciones Evite cambiar cualquier valor de configuración de IBM Tealeaf , a menos que esté seguro de los motivos y sus efectos. Algunas opciones pueden tener efectos significativos en el rendimiento.

Comentarios Supervise los cambios en los archivos JavaScript añadiendo comentarios detallados. De forma periódica, IBM Tealeaf proporciona actualizaciones a los archivos JavaScript e integrar estos cambios con los cambios de su empresa es más fácil con unos comentarios completos.

Funciones especiales Verifique que las funciones especiales de nivel de página no se sobrescriben. Estas funciones incluyen onload, onunload y onreadystatechange. Si es necesario sobrescribir, páselo siempre en la llamada. Por ejemplo: if( typeof document.onreadystatechange == "function" ) { document.originalReadyStateChange = document.onreadystatechange; } else { document.originalReadyStateChange = null; } document.onreadystatechange = function() { // Realizar mi trabajo aquí // Llamar al ReadyStateChange original if(document.originalReadyStateChange) { document.originalReadyStateChange(); } };

Crear eventos personalizados De forma predeterminada, IBM Tealeaf CX UI Capture j2 supervisa las interacciones de usuario con la aplicación capturando los eventos del modelo de objeto de documento estándar. IBM Tealeaf CX UI Capture j2 también se puede utilizar para supervisar aspectos específicos de la aplicación como, por ejemplo, métricas de rendimiento del lado del cliente, los mensajes de validación de entrada del lado cliente y cualquier otro dato relevante a la aplicación. Para capturar estos aspectos y otra actividad del lado del cliente, el desarrollador de aplicaciones puede utilizar una API IBM Tealeaf sencilla para notificar a la biblioteca los datos que se deben incluir en el POST de IBM Tealeaf . Los eventos personalizados se implementan mejor en una ubicación centralizada donde la aplicación procesa su validación de entrada o métricas de rendimiento, por ejemplo.

40

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Nota: La creación de eventos personalizados para insertar datos en envíos a IBM Tealeaf aumenta el volumen de datos almacenados para cada sesión. Cree eventos personalizados solo para datos vitales para la empresa. El envío de grandes volúmenes de datos de IU aumenta el tráfico de red y los requisitos de almacenamiento en IBM Tealeaf y podría afectar al rendimiento de la aplicación. Consulte Capítulo 6, “Referencia de API pública de CX UI Capture j2”, en la página 61.

Pasos siguientes Si desea información adicional sobre prácticas específicas para aplicar al desarrollo de la aplicación web y la implementación de IBM Tealeaf CX UI Capture j2, póngase en contacto con IBM Professional Services.

Capítulo 4. Directrices de uso de CX UI Capture j2

41

42

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Capítulo 5. Referencia de CX UI Capture j2 La configuración de la biblioteca de IBM Tealeaf CX UI Capture j2 es un contenedor de objetos JSON anónimo. La configuración de la biblioteca incluye distintas secciones. v Objeto de configuración principal: Contiene información de configuración sobre eventos del modelo de objeto de documento que escucha la biblioteca. Consulte “Configuración del núcleo”. v Objeto de configuración de servicios: Contiene información de configuración sobre los servicios individuales que amplían el núcleo y proporciona las funciones necesarias que necesita la biblioteca. Consulte “Configuración de servicios” en la página 49. v Objeto de configuración de módulos: Contiene información de configuración sobre los módulos que están habilitados en la biblioteca. Consulte “Configuración de módulos” en la página 57. También puede configurar claves para capturar datos de localStorage. Nota: Para el release 8.6 y posteriores, debe utilizar CX UI Capture j2, la versión nueva del SDK de UI Capture. Para el release 8.5 y anteriores, el uso de CX UI Capture j2 no está soportado. Puede utilizar la versión de legado, CX UI Capture for AJAX. Para obtener más información, consulte la publicación IBM Tealeaf CX UI Capture for AJAX Guide.

Configuración del núcleo El objeto de configuración del núcleo contiene información básica sobre los eventos DOM a los que escucha la biblioteca de IBM Tealeaf CX UI Capture j2. TLT.init({ /** * Configuración base para el núcleo. * Especifica qué módulos deben escuchar a qué eventos y el * moduleBase para cargar dinámicamente módulos adicionales * @type {Object} */ core: { /** * La entrada ieExcludedLinks especifica un conjunto de enlaces que no * deben desencadenar el evento beforeunload, que destruye la biblioteca de * UI Capture. Esto soluciona un problema conocido con Internet * Explorer */ ieExcludedLinks: ["a.ignore"], /** * Esta es la sección de configuración del módulo que contiene * opciones relevantes al núcleo. * Contiene los eventos a los que intentan escuchar los módulos. * NOTA: No utilice esta sección para la configuración específica del módulo, * a la que debe acceder dentro de los módulos. * @type {Object} */ modules: { performance: { enabled: true, © Copyright IBM Corp. 1999, 2013

43

events: [ { name: "load", target: window }, { name: "unload", target: window } ] }, replay: { enabled: true, events: [ /* Sucesos de ciclo de vida - no opcional */ { name: "load", target: window }, { name: "unload", target: window }, /* Eventos de interacción de usuario - no opcional */ { name: "change", target: changeTarget, recurseFrames: true }, { name: "click", recurseFrames: true }, /* Tiempo de permanencia y estado anterior */ { name: "focus", target: "input, select, textarea, [contenteditable]", recurseFrames: true }, { name: "blur", target: "input, select, textarea, [contenteditable]", recurseFrames: true }, /* Cambio de hash - opcional */ { name: "hashchange", target: window }, /* Eventos ClientState - no opcional */ { name: "resize", target: window }, { name: "scroll", target: window }, /* Eventos DOM móviles - opcional */ { name: "orientationchange", target: window },

44

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

{ name: "touchend" } ] } } }, }, /* Los valores siguientes están relacionados con la API pública TLT.getSessionData() */ /** * Defina el distintivo sessionDataEnabled en true solo si está correcto para exponer * datos de sesión de sesión a scripts de terceros. */ sessionDataEnabled: false, /** * El objeto sessionData especifica el nombre de parámetro de consulta O el nombre * de cookie del que obtener el valor de ID de sesión. Un despliegue real solo * especificaría uno de los métodos para obtener el ID de sesión. Si se especifican * ambos, el sessionQueryName tiene prioridad sobre sessionCookieName. Si no se * especifica ninguno, se buscará un valor predeterminado interno de * “TLTSID” en las cookies. */ sessionData: { /** * Especifique sessionQueryName solo si el ID de sesión se deriva de un * parámetro de consulta. */ sessionQueryName: "sessionID", /* Opcionalmente, especifique el delimitador de serie de consulta. /*El predeterminado es & */ sessionQueryDelim: ";", /* La cookie que se está utilizando para la sesionización en Tealeaf. */ sessionCookieName: "jsessionid", /** * O especifique si se debe realizar un hash en el valor * para derivar el ID de sesión. */ sessionValueNeedsHashing: true } /** * La matriz framesBlacklist especifica los selectores CSS que corresponden a * elementos de marco/iframe a los que no se debe acceder. */ framesBlacklist: [ ".tlBlock" ] }, /* Final de la configuración del núcleo */ // Configuración de servicios ... // Configuración específica del módulo ... });

Capítulo 5. Referencia de CX UI Capture j2

45

Núcleo En Núcleo, puede definir las propiedades para garantizar la captura de eventos de IU. Nota: No modifique estos valores a menos que se lo indique IBM Tealeaf . Si desea más información, póngase en contacto con IBM Professional Services.

Enlaces de IE En Internet Explorer, pulsar el enlace href=javascript puede desencadenar el evento beforeunload. Si este enlace no desencadena un cambio de navegación, la biblioteca de CX UI Capture j2 se destruye de forma prematura y no se capturan los eventos de IU posteriores en la página. Para solucionar este problema, puede especificar una serie de elementos HTML que, cuando se pulsan, no desencandan el evento beforeunload. En el campo ieExcludedLinks, puede especificar estos elementos HTML como una matriz de selectores CSS. En el ejemplo siguiente, se especifican dos anclas que se van a ignorar. ieExcludedLinks: ["a.ignore1", "a.ignore2"],

Configurar eventos de cliente por módulo La subsección de módulos de la configuración del núcleo especifica los eventos a los que escucha cada módulo. Nota: No cambie los valores predeterminados. Una configuración de ejemplo para un evento de interfaz de usuario individual es la configuración siguiente. { name: "load", target: window },

Donde: v name identifica el nombre W3C del evento de interfaz de usuario. v target identifica el objeto de cliente que es el destino del evento. – El destino puede ser un elemento del modelo de objeto de documento como un documento o una ventana. – El destino también puede ser una serie que contiene selectores CSS separados por comas para que se utilicen como los destinos. – Si el destino no se especifica, toma como valor predeterminado el elemento de documento. Nota: Para inhabilitar un evento, realice un comentario o elimine la entrada. Algunos eventos no son opcionales y deben permanecer habilitados para una operación correcta de la biblioteca. Para algunos eventos de interfaz de usuario, la configuración podría tener el formato siguiente:

46

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

{ name: "click", recurseFrames: true },

v Si recurseFrames está definido en true, la evaluación se aplica a todos los marcos y submarcos en la página que se originan a partir del mismo dominio que la página.

Rendimiento El módulo de rendimiento analiza el objeto de rendimiento de tiempo de navegación W3C e incluye esta información como el mensaje de rendimiento en la secuencia de datos JSON que se vuelve a enviar al servidor de captura IBM Tealeaf . Nota: Para una correcta operación, no modifique esta configuración. Si el módulo de rendimiento no es necesario, elimine esta sección de la configuración del núcleo.

Reproducción El módulo de reproducción proporciona los datos subyacentes en formato de mensajes JSON que habilitan características como, por ejemplo: v Reproducción de aplicaciones avanzadas de Internet (RIA): Reproducción basada en navegador y Visor CX RealiTea. v Funciones de usabilidad de IBM Tealeaf cxOverstat; mapas de calor, análisis de formularios y mapas de atención. Consulte "Manual de usuario de cxOverstat" en el Manual de usuario de IBM Tealeaf cxOverstat. v Eventos basados en pasos. Consulte "Eventos basados en pasos" en el Manual del gestor de eventos de IBM Tealeaf . Los eventos siguientes se rastrean para la reproducción en el cliente. Las mayoría de estos eventos son necesarios para la reproducción. Nota: El soporte para todos estos eventos de reproducción se proporciona solo en la reproducción basada en navegador. Consulte "Reproducción basada en navegador de CX" en el Manual de usuario de IBM Tealeaf cxImpact. Un subconjunto de eventos de reproducción podrían funcionar en Visor CX RealiTea. Consulte "Visor RealiTea - Vista de reproducción" en el Manual de usuario de IBM Tealeaf Visor CX RealiTea. Propiedad Descripción "load" Evento de carga de página. Nota: Este evento es obligatorio. "unload" Evento de descarga de página. Nota: Este evento es obligatorio. "change" Evento de cambio de control. Capítulo 5. Referencia de CX UI Capture j2

47

Nota: Este evento es obligatorio. De forma predeterminada, se configura para rastrear todos los elementos HTML que soportan el evento de cambio. v De forma opcional, puede definir recurseFrames en true para explorar todos los marcos y submarcos para estos eventos. "click" Eventos de pulsación en la página. Nota: Este evento es obligatorio. v De forma opcional, puede definir recurseFrames en true para explorar todos los marcos y submarcos para estos eventos. "focus" Eventos de foco en el control. Nota: Este evento es obligatorio. v De forma opcional, puede definir recurseFrames en true para explorar todos los marcos y submarcos para estos eventos. "blur" Los eventos de difusión en el control. Nota: Este evento es obligatorio. v De forma opcional, puede definir recurseFrames en true para explorar todos los marcos y submarcos para estos eventos. "hashchange" Cuando está habilitado, esta opción genera eventos de vista de pantalla cuando se identifica un cambio de hash en el URL de la página. v Se define una screenview como un cambio en el estado de la página general. Por ejemplo, si una página tiene varias pestañas, cada pestaña se puede definir como una vista de pantalla separada para la página. v Cuando esta opción está habilitada, se inserta un evento de vista de pantalla en los datos de sesión, y los eventos de IU capturados por UI Capture se pueden organizar por debajo de la vista de pantalla en la que se han producido. v Consulte Referencia de esquema de objeto JSON Tealeaf. v Si la aplicación web no utiliza vistas de pantalla, inhabilite esta opción. "resize" Eventos de redimensionamiento en el cliente. Consulte Referencia de esquema de objeto JSON Tealeaf. "scroll" Eventos de desplazamiento en el cliente. Consulte Referencia de esquema de objeto JSON Tealeaf. Nota: En función de la aplicación, las ventanas de rastreo que se desplazan pueden generan un número significativo de eventos. Nota: La reproducción de eventos de desplazamiento está soportada para las sesiones móviles solo en la reproducción basada en navegador. Consulte Búsqueda y reproducción para web móvil. "orientationchange" Eventos de cambio de orientación para dispositivos móviles. Consulte Referencia de esquema de objeto JSON Tealeaf.

48

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Nota: Estos eventos solo se reproducen si tiene una licencia de IBM Tealeaf CX Mobile. Si desea más información, póngase en contacto con el representante de IBM Tealeaf . "touchend" Eventos de táctiles finales para dispositivos móviles. Consulte Referencia de esquema de objeto JSON Tealeaf. Nota: Estos eventos solo se reproducen si tiene una licencia de IBM Tealeaf CX Mobile. Si desea más información, póngase en contacto con el representante de IBM Tealeaf .

Configuración de servicios El objeto de configuración de servicios contiene opciones utilizadas por los servicios individuales que forman parte de la biblioteca de IBM Tealeaf CX UI Capture j2. Nota: Al integrar la biblioteca con una aplicación nueva, normalmente se modifica solo unos pocos de estos elementos de configuración. /** * La configuración del servicio para opciones utilizadas dentro de los servicios. * @type {Objeto} * @required */ services: { /** * La configuración de la cola es una matriz de colas. * Debe especificar al menos una cola predeterminada. * @type {Array} */ queue: [ /** * Una configuración de la cola predeterminada. */ { /** * El ID de la cola para la cola predeterminada es "DEFAULT". * Para otras colas, podría ser cualquier serie para identificar * la cola. * @type {Serie} */ qid: "DEFAULT", /** * El punto final en el servidor donde los mensajes se * envían. Este valor debe corresponder a un identificador de * página de destino de Tealeaf. * @type {Serie} */ endpoint: "TealeafTarget.php", /** * Para maxEvents, podría especificar el número de eventos en cola * después del cual la cola se debe vaciar y enviarlos todos * al servidor. * @type {Número} * @default 25 */ maxEvents: 25, /** * El intervalo al cual se debe vaciar la cola * automáticamente. * (en milisegundos) * Si esta opción no está presente o está definida en 0, Capítulo 5. Referencia de CX UI Capture j2

49

* el temporizador se inhabilita. * @type {Número} * @optional * @default 0 */ timerInterval: 0 /** * Distintivo que indica si se debe usar un POST de dominio cruzado. * Si está habilitado, crossDomainFrameSelector debe especificar * el elemento de iframe o marco en la página que se ha * configurado para realizar peticiones POST. * @type {Booleano} * @optional * @default false */ crossDomainEnabled: false, /** * Selector CSS que se resuelve en un único elemento de marco o iframe * en la página que se ha configurado para realizar peticiones * POST. * @type {string} * @optional */ crossDomainFrameSelector: "#uicXdomain" } ],

Configuración del servicio de cola A través de la configuración del servicio de cola, puede añadir colas de evento adicionales para el proceso y configurar propiedades de cola de evento que se basan en el volumen del tráfico. Nota: Añadir una cola adicional es una opción avanzada y no es necesario en la mayoría de despliegues. Propiedad Descripción qid

Identifica el nombre de las colas de evento disponibles. Nota: De forma predeterminada, una cola se define como DEFAULT. No elimine esta cola o cambie su nombre.

endpoint Identifica el destino al que se envían mensajes. Este valor corresponde a un identificador de página de destino de IBM Tealeaf . Se proporcionan destinos de ejemplo para entornos ASPX, JSP y PHP con la distribución de UI Capture. Si desea más información sobre páginas de destino, consulte "Instalación e implementación de UI Capture for Ajax" en la Guía de IBM Tealeaf CX UI Capture for AJAX. maxEvents El número máximo de eventos en una cola. Si este número de eventos se excede, la cola se vacía automáticamente, y todos los eventos en cola se envían al destino para su captura por parte de IBM Tealeaf . Nota: Ajuste el número máximo de eventos a un valor razonable, normalmente entre 20 y 50. El valor máximo permitido es 100. timerInterval El intervalo en milisegundos al que se vacían colas de evento automáticamente.

50

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Si esta opción no está presente o está definida en 0, el temporizador se inhabilita. Nota: Mantenga este valor inhabilitado, a menos que sea necesario un vaciado más inmediato de datos, como cuando los usuarios de IBM Tealeaf están examinando de forma oculta la sesión de un visitante.

Configuración del servicio de navegador A través de la configuración del servicio de navegador, puede especificar objetos y elementos de navegador que tienen ID HTML dinámicos o duplicados. browser: { /** * sizzleURL es un URL al archivo sizzle.js que contiene la biblioteca * Sizzle. Se utiliza en algunos navegadores más antiguos para obtener * elementos a través de un selector CSS. * * En dicho casos, el w3c browserService cargará de forma condicional * este archivo. * * Este valor solo es válido cuando el sabor del * servicio de navegador w3c está seleccionado. * * @type {String} * @optional (solo es necesario para w3c browserService y si jQuery o * Sizzle no está definido en la ventana) */ sizzleURL: "/scripts/legacyIESupport/sizzle.js", /** * sizzleObject es la ubicación del objeto Sizzle en la página. Si * este valor no está especificado, se asume que el objeto Sizzle * estará en el ámbito global, es decir, window.Sizzle * * Este valor solo es válido cuando el sabor W3C del * servicio de navegador está seleccionado. * * @type {String} * @optional (solo es necesario para W3C browserService y si jQuery * no está definido) */ sizzleObject: "My.location.Sizzle", /** * jQueryObject es la ubicación del objeto jQuery en la página. Si * este valor no está especificado, se asume que el objeto jQuery * estará en el ámbito global, es decir, window.jQuery * * @type {String} * @optional (solo es necesario si jQuery no está definido en la ventana) */ jQueryObject: "My.location.jQuery", /** * Para especificar elementos cuyos ID HTML no se pueden usar como ID * o en la generación de xPath. Podría ser objeto de serie con una o dos * propiedades, "regex" (obligatorio) y "flags", que se especifican como * series. La expresión regular que se evalúa respecto al ID del nodo. * @type {Array} * @optional */ blacklist: [ "duplicateid", {regex: "/password|pass|pin|tan/", flags: "gi"} ], /** * Si la aplicación usa atributos personalizados como una , * sustitución de ID puede especificar aquí el nombre del atributo. * @type {Array} Capítulo 5. Referencia de CX UI Capture j2

51

* @optional */ customid: [ "mycustomid" ] }, El motor Sizzle JS es necesario para una operación correcta del sabor W3C de la biblioteca en navegadores de legado (por ej., IE 7) que no tienen soporte nativo para las consultas basadas en el selector CSS. Sizzle se incluye en jQuery de forma predeterminada de forma que si la aplicación tiene una versión más reciente de jQuery, la inclusión separada de Sizzle podría no ser necesaria. La biblioteca tiene varias formas para especificar la ubicación del motor Sizzle. En orden de preferencia estas son: sizzleURL – Si se especifica, esto se utilizará y los posteriores mecanismos para localizar Sizzle se ignorarán. sizzleObject – Si se especifica, esto se utilizará en lugar de window.Sizzle window.Sizzle jQueryObject – Si se especifica, esto se utilizará en lugar de window.jQuery window.jQuery

Propiedad Descripción sizzleURL Puede utilizar este elemento de configuración para especificar el URL al archivo sizzle.js que contiene la biblioteca de Sizzle. Esta biblioteca es utilizada por IBM Tealeaf CX UI Capture j2 para evaluar selectores CSS en navegadores más antiguos. Nota: Este elemento de configuración es necesario solo para el servicio de navegador W3C y si JQuery o Sizzle no está definido en el objeto de la ventana de la aplicación web. v La biblioteca Sizzle es necesaria para algunos navegadores más antiguos para adquirir elementos de documento que utilizan un selector CSS. Si el navegador del cliente es una de las versiones afectadas, el servicio del navegador W3C puede cargar automáticamente este archivo desde el servidor web. v La lista de objetos se puede especificar como valores separados con comas, que pueden ser series fijas o expresiones regulares. Estos valores se evalúan respecto al ID del nodo. lista negra De forma opcional, puede especificar un conjunto de elementos de documento cuyos ID HTML no se garantiza que sean estáticos o exclusivos. Estos ID HTML de estos objetos de la lista negra no se utilizan para identificar los elementos y mecanismos alternativos, como un customid (si está configurado) o un xpath. customid Si la aplicación web utiliza un atributo personalizado que se puede utilizar para identificar de forma exclusiva los elementos, puede especificar aquí el nombre del atributo.

Configuración del servicio de mensaje Utilice la configuración del servicio de mensaje para definir opciones, como las reglas de privacidad aplicadas a los mensajes JSON enviados al servidor IBM Tealeaf para la captura.

52

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

message: { /** * Defina reglas de privacidad para modificar valores notificados en los * mensajes enviados al servidor. * @type {Array} * @optional */ privacy: [ /** * Una regla de privacidad de ejemplo. */ { /** * Especifique los destinos a los que se deben aplicar esta regla. * @type {Array} */ targets: [ { id: "htmlid", idType: -1 }, { id: "myid=custom", idType: -3 } ], /** * El maskType define cómo se debe transformar el * valor. * maskType 1: El valor se defien en una serie vacía * maskType 2: El valor se sustituye con la serie * fija "XXXXX". * maskType 3: El valor se sustituye por una máscara donde: * cada carácter minúsculo se sustituye con "x", * cada carácter mayúsculo con "X", * cada número con "9" * cada símbolo con "@" * por e., "HelloWorld123" se convierte en "XxxxxXxxxx999" * maskType 4: El valor se sustituye por el valor return * de * una función personalizada que se debe especificar como * maskFunction. * @type {Número} */ maskType: 3 }, { targets: [ { id: "[[\"HTML\",0],[\"BODY\",0],[\"SELECT\",0]]", idType: -2 } ], maskType: 4, /** * Una función de máscara personalizada que sustituye el valor * notificado por su valor de retorno ("enmascarado", en este * ejemplo) * @param {Serie} el valor para sustituir. * @retorno {Serie} podría devolver cualquier serie. */ maskFunction: function (value) { devuelve "enmascarado"; }

Capítulo 5. Referencia de CX UI Capture j2

53

} ] } },

Configuración de privacidad para CX UI Capture j2 IBM Tealeaf CX UI Capture j2 permite el bloqueo y el enmascaramiento de información confidencial dentro del navegador del cliente, antes de que los datos se envíen a IBM Tealeaf para la captura, mientras que permite que los datos se envíen a servidores web para un proceso normal. Los datos confidenciales que se han limpiado a través de CX UI Capture j2 nunca llegan a IBM Tealeaf , lo que garantiza que las interacciones del cliente son seguras en CX UI Capture j2. v CX UI Capture j2 permite el bloqueo de los datos de entrada de usuario por ID de elemento, nombre o xpath. v Las máscaras se pueden expresar como series explícitas, sustituciones para tipos de caracteres o funciones personalizadas. v Si desea más información sobre cómo se gestiona la privacidad de datos en todo el sistema IBM Tealeaf , consulte "Gestión de la privacidad de datos en Tealeaf CX" en el Manual de instalación de IBM Tealeaf CX. Nota: Si tiene preguntas sobre la implementación de la privacidad de datos en CX UI Capture j2, póngase en contacto con IBM Professional Services. Para especificar una regla de privacidad, debe definir: v El tipo de identificador. v Los destinos a los que se aplica la regla. v El tipo de máscaras para aplicar a los destinos.

Especificación de una regla de privacidad En la configuración, se especifica una sola regla de privacidad en el objeto privacy utilizando la plantilla de configuración siguiente. { targets: [ { id: "htmlid", idType: -1 } ], maskType: 3 }

Especificación de destinos Para especificar un destino, debe especificar las propiedades siguientes. Nota: Puede especificar varios destinos id o idType para cada regla de máscaras. Propiedad Descripción id

54

El identificador para el elemento de destino. Este valor se especifica de acuerdo con el valor idType. En el archivo de configuración, puede utilizar una expresión regular para

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

especificar identificadores coincidentes. Por ejemplo, la configuración de destino siguiente coincide con todos los identificadores HTML que acaban en _pii: message: { privacy: [ { targets: [ { id: { regex: ".+_pii$" }, idType: -1 }, ], "maskType": 3 } ] }

idType El tipo de identificador. Los tipos siguientes están soportados: Nota: Los valores para idType se registran como números negativos. v -1 - ID HTML v -2 - Identificador xpath v -3 - Nombre HTML u otro identificador de atributo de elemento Selector CSS En el archivo de configuración, también puede especificar valores de selector CSS para que coincidan con elementos CSS para máscaras de privacidad. En el ejemplo siguiente, la regla de privacidad designada se aplica a todos los campos de entrada de contraseña: message: { privacy: [ { targets: [ "input[type=password]" ], "maskType": 3 } ] }

Especificación del tipo de máscara IBM Tealeaf CX UI Capture j2 soporta los tipos de máscaras siguientes (valores maskType): Tabla 2. Configuración de la privacidad para UI Capture j2 Valor

Descripción

Ejemplo

Ejemplo de enmascarado

1

El valor se bloquea y se sustituye por una serie vacía.

"HelloWorld123"

""

2

El valor se enmascara con "HelloWorld123" una serie fija de X

XXXXX

Capítulo 5. Referencia de CX UI Capture j2

55

Tabla 2. Configuración de la privacidad para UI Capture j2 (continuación) Valor

Descripción

Ejemplo

Ejemplo de enmascarado

3

El valor se enmascara de acuerdo con los parámetros siguientes:

"HelloWorld123"

"XxxxxXxxxx999"

v una letra en minúscula se sustituye con x. v una letra en mayúscula se sustituye con X. v un número se sustituye con 9. v un valor no alfanumérico se sustituye con @. 4

Función personalizada "HelloWorld123 Nota: Se debe definir una función de máscara como maskFunction.

Depende de la función definida

Configuración d servicio serializador A través de la configuración del servicio serializador, puede especificar qué función de analizador y serializador JSON utilizar. La biblioteca utiliza JSON como su formato de mensaje. Todos los navegadores modernos tienen un soporte incorporado para serializar y analizar JSON. Sin embargo, los navegadores de legado (por ejemplo, Internet Explorer 6 y 7) no tienen este soporte incorporado. Para dichos navegadores, es necesaria una biblioteca de un tercero que proporciona las funciones de serialización y análisis JSON. De forma predeterminada, la biblioteca de CX UI Capture j2 se basa en las funciones JSON incorporadas del navegador donde están disponibles, y toma de forma predeterminada una implementación interna simplificada en otros casos. Si la aplicación o el entorno de TI obliga el uso del analizador o serializador JSON específico, puede especificarlo utilizando esta configuración. Nota: La serialización y el análisis JSON son básicos para la capacidad de la biblioteca para funcionar y producir una salida correcta. A través de pruebas de navegadores cruzados, las pruebas son necesarias si se realiza algún cambio en esta configuración. serializer: { json: { /** * Si este código está habilitado, la implementación interna * simplificada del serializador y analizador JSON * se utilizará si no está disponible ningunos de los * analizadores e identificadores especificados. * * Si este código está inhabilitado, la biblioteca se concluirá * si el serializador y analizador JSON especificado no * están disponibles. */ defaultToBuiltin: true, /** * Esta matriz especifica una secuencia ordenada de * analizadores JSON que se deben utilizar para analizar * un objeto JSON serializado.

56

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

* * El analizador debe soportar la interfaz siguiente: * var jsObject = parse(jsonString); */ parsers: [ "JSON.parse" ], /** * Esta matriz especifica una secuencia ordenada de * serializadores que se deben utilizar para serializar * un objeto JavaScript. * * El serializador debe soportar la interfaz siguiente: * var jsonString = stringify(jsObject); */ stringifiers: [ "JSON.stringify" ] } }

Configuración de módulos El objeto de configuración de módulos contiene opciones que son utilizadas por módulos individuales que están habilitados en la biblioteca de IBM Tealeaf CX UI Capture j2. Estas opciones se corresponden a las opciones disponibles de la especificación de tiempo de navegación W3C. Consulte http://www.w3.org/TR/navigation-timing/#sec-navigation-timinginterface modules: { performance: { /** * El valor calculateRenderTime solo se aplica a navegadores * que no soportan la API de tiempo de navegación W3C. * * Si está habilitado, la biblioteca calculará e informará del tiempo * de representación como una diferencia entre la * indicación de fecha de carga de biblioteca * y la indicación de fecha de carga de la página. * * Para garantizar un cálculo preciso, la biblioteca se inicializa * tan pronto como sea posible en el ciclo de carga de página. Debido a * estas limitaciones, el tiempo de representación calculado de esta * forma siempre será menos preciso que el notificado por el * navegador. */ calculateRenderTime: true, filter: { navigationStart: true, unloadEventStart: true, unloadEventEnd: true, redirectStart: true, redirectEnd: true, fetchStart: true, domainLookupStart: true, domainLookupEnd: true, connectStart: true, connectEnd: true, secureConnectionStart: true, requestStart: true, responseStart: true, responseEnd: true, domLoading: true, domInteractive: true, domContentLoadedEventStart: true, domContentLoadedEventEnd: true, domComplete: true, Capítulo 5. Referencia de CX UI Capture j2

57

loadEventStart: true, loadEventEnd: true } } } });

Rendimiento En la sección de rendimiento, configure los eventos de la interfaz de cliente que se rastrean para las métricas de rendimiento.

Filtro Utilizando los filtros disponibles en la sección de rendimiento, configure los eventos relacionados con el rendimiento para que los supervise CX UI Capture j2. La lista de métricas proporcionadas que puede filtrar está predefinida mediante la especificación de tiempo de navegación W3C. Si desea más información, visite http://www.w3c.org. De forma predeterminada, los datos de rendimiento no se capturan, ya que puede tener un impacto significativo en el ancho de banda. Como resultado, la configuración predeterminada filtra todos los datos de rendimiento (métrica de rendimiento: true). Nota: Cuando está habilitado un filtro individual, los datos de rendimiento que están relacionados con dicha propiedad no son capturados por CX UI Capture j2. Para habilitar el rastreo de cualquier propiedad de rendimiento, defina su valor en false.

Configuración de localStorage Muchos navegadores soportan localStorage, que es más rápido y genera un cantidad de datos más grande almacenados localmente en el navegador del usuario. Para capturar datos, utilice el SDK de CX UI Capture j2 con la captura localStorage para definir las claves que se deben capturar. Los datos se almacenan en pares de clave-valor y una página web puede acceder solo a los datos almacenados por sí misma. El objeto localStorage almacena los datos sin fecha de caducidad. Los datos no se suprimen cuando se cierra el navegador, y están disponibles el día, semana o año siguiente. El localStorage de IBM Tealeaf CX UI Capture j2 solo captura datos de la lista blanca. Nota: localStorage no está disponible en el SDK general de CX UI Capture j2. Para la captura localStorage, necesita un SDK de CX UI Capture j2 con la captura localStorage. Para configurar localStorage, defina una clave que se va a capturar. Esta clave se añade a la configuración de CX UI Capture j2. No se captura nada si no se definen claves.

58

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

CX UI Capture j2 solo captura claves si utiliza la getItem() API (por ejemplo, localStorage.getItem("xyz")). Si utiliza la notación por puntos, no se captura nada (por ejemplo, localStorage.xyz). Ejemplo: modules: { performance: { filter: { } }, replay: { storageKeys: ["x", "y"] } }

IBM Tealeaf CX UI Capture j2 solo captura las claves que define y sus valores. CX UI Capture j2 captura los elementos localStorage cuando se accede a ellos (por ejemplo, en la llamada getItem()). CX UI Capture j2 produce un evento de tipo 8. Después envía el mensaje JSON de nuevo al servidor tal como está. A continuación aparece un ejemplo de captura de tipo 8. Para este ejemplo, la configuración de localStorage se establece solo en la captura de la clave usrname. count: 9 fromWeb: true offset: 10585 screenviewOffset: 10585 type: 8 webStorage:{ key: "usrname" value: "ssingh" }

Capítulo 5. Referencia de CX UI Capture j2

59

60

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Capítulo 6. Referencia de API pública de CX UI Capture j2 La biblioteca de IBM Tealeaf CX UI Capture j2 soporta las interfaces públicas que se listan aquí.

TLT.init(object configObject) Esta API inicializa la biblioteca de IBM Tealeaf CX UI Capture j2 con el objeto de configuración especificado. La ejecución init se produce después de la carga del modelo de objeto de documento. v Para despliegue estáticos, la llamada a init se puede incluir como parte del recurso JavaScript estático. v Para despliegue dinámicos, la llamada a init se puede realizar desde la aplicación de cliente.

TLT.rebind(/*opcional*/ DOMElement root) Volver a vincular provoca que la biblioteca de IBM Tealeaf CX UI Capture j2 vuelva a procesar sus escuchas de eventos. La aplicación puede utilizar esta API para notificar a la biblioteca de IBM Tealeaf CX UI Capture j2 después de que la aplicación haya realizado una actualización dinámica que ha añadido elementos de entrada de un usuario nuevo al modelo de objeto de documento. La aplicación puede especificar un elemento raíz opcional desde el cual se produce el reproceso. Si no se especifica, el reproceso se produce desde el elemento del documento. En un modelo de objeto de documento grande y complejo, especificar el subconjunto exacto que se ha actualizado con los elementos de entrada del usuario nuevo mejora la eficacia.

TLT.flushAll(void) Esta API provoca que los datos del almacenamiento intermedio recopilados por la biblioteca de IBM Tealeaf CX UI Capture j2 se desechen en su URL del punto final configurado. Normalmente, la acción de desechar se utiliza en combinación con la llamada de la API setAutoFlush para obtener un control preciso sobre el comportamiento del uso de la red en aplicaciones móviles muy ajustadas.

TLT.setAutoFlush(AutoFlushFlag flag) Esta API se utiliza para habilitar o inhabilitar el comportamiento del vaciado automático de la biblioteca. El vaciado automático está habilitado de forma predeterminada y se controla mediante la longitud de cola configurable. enum AutoFlushFlag { TLT.setAutoFlush.ENABLE TLT.setAutoFlush.DISABLE }

Nota: Cuando el vaciado automático está inhabilitado, es responsabilidad de la aplicación asegurarse de que los datos que almacena de forma intermedia la biblioteca se desechan a intervalos apropiados iniciando la API flushAll(). © Copyright IBM Corp. 1999, 2013

61

TLT.processDOMEvent(DOMEvent event) Esta API se utiliza para informar de forma explícita a la biblioteca de IBM Tealeaf CX UI Capture j2 sobre cualquier evento del modelo de objeto de documento que la aplicación está bloqueando activamente de la efervescencia. También se aplica a acciones similares que impiden a la biblioteca de CX UI Capture j2 procesar automáticamente el evento.

TLT.logCustomEvent(DOMString name, object customMsgObj) La aplicación puede utilizar esta API para registrar un mensaje personalizado en la corriente de mensajes de la biblioteca de CX UI Capture j2. El parámetro customMsgObj en esta función especifica el objeto que se va a serializar y pasar como un mensaje personalizado. El mensaje personalizado se puede procesar en los eventos e informes de fondo y basados en pasos. v Consulte "Eventos basados en pasos" en el Manual del gestor de eventos de IBM Tealeaf . v Consulte "Creador de informes Tealeaf" en la Guía de informes de IBM Tealeaf .

TLT.logExceptionEvent(DOMString msg, /*opcional*/ DOMString url, /*opcional*/ línea larga) La aplicación puede utilizar esta API para registrar un mensaje de error o de excepción en la corriente de mensajes de la biblioteca de IBM Tealeaf CX UI Capture j2. Especificar el URL y el número de línea del mensaje de error es opcional.

TLT.logScreenviewLoad(DOMString name, /*opcional*/ DOMString referrerName, /*opcional*/ DOMElement root) La aplicación puede utilizar esta API para registrar un mensaje de carga de vista de pantalla en la corriente de mensajes de la biblioteca de IBM Tealeaf CX UI Capture j2. Especificar el nombre de la vista de pantalla a la que se hace referencia y el elemento raíz para esta vista es opcional.

TLT.logScreenviewUnload(nombre DOMString) La aplicación puede utilizar esta API para registrar un mensaje de descarga de vista de pantalla en la secuencia de mensajes de la biblioteca de IBM Tealeaf CX UI Capture j2.

TLT.getSessionData() Esta API devuelve un objeto de datos de sesión de IBM Tealeaf . La información del ID de sesión de IBM Tealeaf se incluye en estos datos.

62

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Un distintivo opcional indica si el ID de sesión se debe derivar mediante un hash del valor de sesión en el objeto. Un ejemplo de un valor devuelto es el siguiente. { tltSCN: "PHPSESSID", tltSCV: "joese2pun5nus50p45j38hrak5", tltSCVNeedsHashing: true

// Opcional

}

Para habilitar esta API, la biblioteca debe estar configurada con los valores de configuración apropiados. Estos valores informan a la biblioteca de dónde se deriva la información del ID de sesión. Si la API no está habilitada en la configuración o los datos especificados no se pueden leer, se devuelve null.

Capítulo 6. Referencia de API pública de CX UI Capture j2

63

64

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Capítulo 7. Preguntas más frecuentes de CX UI Capture j2 Esta sección incluye las preguntas más frecuentes sobre cómo adquirir, implementar y utilizar la biblioteca de IBM Tealeaf CX UI Capture j2 que proporciona CX UI Capture j2. Nota: Excepto cuando se indica, las preguntas y respuestas de esta sección se aplican solo a IBM Tealeaf CX UI Capture j2. v A partir del release 8.6, IBM Tealeaf CX UI Capture j2 es la versión necesaria de UI Capture. v Si desea más información sobre la versión de legado, consulte "Preguntas más frecuentes de UI Capture for Ajax" en la Guía de IBM Tealeaf CX UI Capture for AJAX.

Cómo empezar ¿Qué es CX UI Capture j2? CX UI Capture j2 es una biblioteca JavaScript, una aplicación del lado del servidor de ejemplo y una documentación. Utilice CX UI Capture j2 para capturar las interacciones del visitante con la página web (pulsaciones de ratón, entrada de teclado, desplazamiento e interacciones táctiles, etc.), el entorno del navegador (dimensiones de ventana, etc.) e información de rendimiento (por ejemplo, tiempos de representación). CX UI Capture j2 recopila esta información y crea un mensaje que se publica posteriormente en una página de destino en el servidor de aplicaciones. La página de destino no realiza ningún proceso y devuelve un estado HTTP 200. La publicación se puede producir en la descarga, después de un intervalo de tiempo predefinido o después de que la cola de mensajes llegue a un tamaño predefinido. Puesto que el producto IBM Tealeaf principal captura todas las interacciones de solicitud y respuesta entre el navegador y el servidor, los datos publicados de CX UI Capture j2 se pueden utilizar para reproducir y notificar la interacción de usuario que se produce en la página.

¿Qué versiones de UI Capture están disponibles? UI Capture está disponible en dos versiones. A partir del release 8.6, IBM Tealeaf ha introducido IBM Tealeaf CX UI Capture j2. CX UI Capture j2 envía datos en un esquema JSON actualizado. IBM Tealeaf CX UI Capture j2 es necesario para IBM Tealeaf cxOverstat. IBM Tealeaf CX UI Capture for AJAX es la otra versión disponible. CX UI Capture for AJAX captura eventos de interfaz de cliente y los envía en formato XML o formato JSON (Release 8.5 y posterior). Consulte la Guía de IBM Tealeaf CX UI Capture for AJAX.

© Copyright IBM Corp. 1999, 2013

65

¿Por qué necesito CX UI Capture j2? CX UI Capture j2 captura interacciones de usuario con una aplicación. Algunos datos de experiencia de usuario solo existen en el navegador y nunca se vuelven a transmitir al servidor. Estos datos incluyen tiempos de representación, orden de entrada de campo de formulario, abandono de formulario, etc. La reproducción de aplicaciones web Ajax requiere la inclusión del JavaScript de CX UI Capture j2 para capturar los eventos de IU generados como resultado de la interacción de usuario con la aplicación. Estos eventos de IU capturados se utilizan para estimular la aplicación durante la reproducción para que coincidan las peticiones/respuestas Ajax.

¿Cómo implemento CX UI Capture j2? Los pasos siguientes describen el proceso básico para implementar IBM Tealeaf CX UI Capture j2. 1. Determine qué páginas se deben instrumentalizar. Normalmente, estas páginas incluyen funciones basadas en JavaScript de interés. Para obtener información adicional, póngase en contacto con http://support.tealeaf.com. 2. Obtenga la biblioteca de la distribución del software. Puede obtener información adicional relativa a la descarga del software de Tealeaf consultando Descargas de Tealeaf CX. v Para ver información de la última versión, consulte las Notas del release publicadas en https://community.tealeaf.com/display/public. v Puede acceder a la Ayuda en línea de IBM Tealeaf a través del menú Ayuda en el IBM Tealeaf Portal. Si sabe el inicio de sesión de la empresa, utilice el URL anterior. 3. Revise la documentación en línea en https://community.tealeaf.com/display/ public o el PDF publicado con la biblioteca. La documentación en línea es la más actualizada. 4. Determine las opciones de captura que son necesarias para su aplicación web. Estas opciones pueden variar para distintas páginas en el sitio web. 5. De acuerdo con las opciones que seleccione, modifique los archivos de configuración de JavaScript que se proporcionan en la biblioteca. Nota: IBM Tealeaf CX UI Capture j2 incluye un programa de utilidad de GUI para ayudar a la configuración de la solución CX UI Capture j2. Este asistente de configuración realiza realiza la validación de datos y configura el JavaScript de IBM Tealeaf en función de sus selecciones. Consulte Capítulo 3, “Asistente de configuración de CX UI Capture j2”, en la página 25. 6. Modifique la página JavaServer (.jsp) proporcionada por IBM Tealeaf para cumplir los requisitos. O bien, puede elegir duplicarla en un idioma de servidor diferente, como ASP o PHP. Esta página acepta las publicaciones desde el JavaScript de IBM Tealeaf que se ejecuta en el navegador y devuelve un código de éxito. No evalúa ni manipula los datos recibidos, que se envían a y son procesados por el sistema IBM Tealeaf . 7. Modifique las páginas que llaman a la biblioteca de CX UI Capture j2 para incluir el JavaScript de IBM Tealeaf . 8. En un entorno de prueba o en una página que no es de producción en el sitio de producción, publique la página de destino de IBM Tealeaf , el JavaScript configurado de IBM Tealeaf y las páginas modificadas.

66

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Nota: Este entorno se debe capturar por IBM Tealeaf como una instancia de entorno de prueba separada o la instancia de producción que se ha configurado para mantener el tráfico de prueba separado del tráfico de producción. 9. Pruebe las páginas web para asegurarse de que la adición del JavaScript de IBM Tealeaf interactúa correctamente con la página. 10. Pruebe el tráfico capturado en la instancia de IBM Tealeaf para verificar que el tráfico de IU se ha capturado. En algunos casos, modifique las reglas de reproducción para reproducir correctamente estas sesiones. Si tiene algún problema, revise la documentación o póngase en contacto con http://support.tealeaf.com. 11. Tras verificar que todos los elementos de IU instrumentalizados han sido capturados y procesados correctamente por IBM Tealeaf , publique los cambios en el entorno de producción con la publicación normal y los procesos de control de cambios.

¿Cuál es el tamaño de CX UI Capture j2? Cuando el JavaScript de CX UI Capture j2 se convierte a una versión de producción que se ha minimizado y comprimido, tiene aproximadamente 22 K.

¿Puedo empaquetar la biblioteca de CX UI Capture j2 con otros JavaScripts? No. No combine la biblioteca de CX UI Capture j2 con otros JavaScripts. IBM Tealeaf reconoce que algunos clientes empaquetan sus recursos JavaScript en un único archivo para simplificar el despliegue de contenido estático. Sin embargo, debido a los riesgos y costes siguientes que están asociados al paquete de JavaScripts, IBM Tealeaf no soporte los paquetes.

Riesgos v La biblioteca de IBM Tealeaf es mutuamente independiente de cualquier otro código que se ejecuta en el contexto de la aplicación web. Mantenga esta separación como política general. v El navegador trata cada código de inclusión de JavaScript como una única unidad de ejecución. Cuando empaquete JavaScripts, se crea una dependencia entre bibliotecas independientes. Un error en uno de los scripts empaquetados puede evitar que se ejecuten otras bibliotecas. En el peor escenario, un error en un script periférico como IBM Tealeaf puede generar una interrupción de la aplicación. v Si el paquete es inevitable, el cliente es responsable de realizar la mitigación de riesgos a través de unas pruebas exhaustivas del paquete empaquetado para verificar que no se están introduciendo problemas.

Otros costes de paquetes v La biblioteca empaquetada se debe probar en relación con la aplicación, así como cualquier prueba necesaria para bibliotecas individuales. Los JavaScripts de IBM Tealeaf pueden requerir actualizaciones de configuración y varias iteraciones para verificar. v Los cambios de script individuales o actualizaciones de biblioteca requieren un paquete completamente nuevo para ser versionado, probado y desplegado.

Capítulo 7. Preguntas más frecuentes de CX UI Capture j2

67

Problemas potenciales Depurar problemas en un script empaquetado es más complicado. Las bibliotecas individuales no se pueden habilitar o inhabilitar fácilmente utilizando herramientas de proxy como Fiddler. Nota: Si separar el JavaScript de IBM Tealeaf de los scripts empaquetados no es una opción, en la mayoría de las situaciones, el JavaScript de IBM Tealeaf debe ser el último componente del paquete. Consulte con IBM Professional Services para garantizar una gestión eficaz del desarrollo y el despliegue del paquete.

¿CX UI Capture j2 afectará al rendimiento o al comportamiento de mi sitio web? La biblioteca se ha diseñado para minimizar la carga en el servidor web y la página web que se ejecuta en el navegador. Como parte de los pasos de implementación anteriores, el JavaScript descargado se minimiza y el navegador lo almacena en la memoria caché. Las optimizaciones del servidor web pueden mejorar más el rendimiento mediante la compresión del lado del servidor y los valores de la memoria caché. Consulte Capítulo 2, “Instalación e implementación de CX UI Capture j2”, en la página 9. La aplicación del servidor que acepta las publicaciones es muy sencilla y no hace nada con los datos. Las publicaciones de la biblioteca añaden un hit o dos adicionales a cada página que captura IBM Tealeaf . El tamaño del hit es pequeño, normalmente aumenta los requisitos de almacenamiento de IBM Tealeaf en menos del 10%. Por diseño, el sistema IBM Tealeaf no mezcla estos hits con los hits de página normal en los informes de recuentos de páginas. Con la biblioteca, es posible que la solución IBM Tealeaf se tenga que configurar con nuevas reglas reproducción para obtener fidelidad de reproducción.

¿Dónde puedo obtener la última versión de CX UI Capture j2? Para obtener la última versión del código JavaScript de CX UI Capture j2, póngase en contacto con http://support.tealeaf.com.

¿Qué está capturando CX UI Capture j2? En función de cómo configura la biblioteca, CX UI Capture j2 puede capturar tiempos de representación, dimensiones del navegador, eventos de interfaz de usuario (pulsación, entrada de texto, información de desplazamiento, etc.), etc. Consulte Capítulo 1, “IBM Tealeaf CX UI Capture j2”, en la página 1.

¿Dónde puedo encontrar más documentación? Un número de guías y recursos está disponible para soportar la implementación de la solución IBM Tealeaf CX UI Capture j2.

68

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Tabla 3. Recursos de documentación de CX UI Capture j2 Documento

Descripción

Guía de integración de datos de infraestructura de cliente de IBM Tealeaf

Tras desplegar la infraestructura de cliente, puede ser necesaria más configuración. La referencia para configurar la captura de datos en IBM Tealeaf y para que los datos estén disponibles para crear eventos, que permite la búsqueda y los informes. Este documento ayuda a los administradores de IBM Tealeaf siempre que está implementando una infraestructura de cliente de IBM Tealeaf .

Guía de referencia de infraestructura de registro Android de IBM Tealeaf

Guía de instalación e implementación para IBM Tealeaf CX Mobile Android Logging Framework para aplicaciones nativas de móvil basadas en Android. El despliegue requiere la licencia de IBM Tealeaf CX Mobile.

Guía de referencia de infraestructura de registro iOS de IBM Tealeaf

Guía de instalación e implementación de IBM Tealeaf CX Mobile iOS Logging Framework para aplicaciones nativas de móvil basadas en iOS. El despliegue requiere la licencia de IBM Tealeaf CX Mobile.

IBM Tealeaf Guía de UI Capture for Ajax Guía para desplegar la versión de legado de UI Capture.

Estoy teniendo problemas con la implementación de CX UI Capture j2. ¿Dónde puedo obtener soporte o ayuda? Para ponerse en contacto con el servicio de soporte al cliente, visite el portal de soporte de IBM o conéctese a través de su cuenta de Salesforce.

Utilización de CX UI Capture j2 ¿Cómo configuro lo que captura CX UI Capture j2? Actualmente, la solución IBM Tealeaf CX UI Capture j2 no soporta los niveles de captura dinámicos o configurables. CX UI Capture j2 supervisa un conjunto predefinido de propiedades y eventos de interfaz de usuario, enviando mensajes para aquellos que se detectan y capturan. Consulte "Propiedades JSON de Tealeaf" en la Guía de integración de datos de infraestructura de cliente de IBM Tealeaf . Puede configurar CX UI Capture j2 para capturar eventos personalizados específicos para su aplicación web. Consulte "Referencia de API pública de UI Capture j2".

¿Qué se captura de sesiones de web móvil? Las sesiones de web móvul se capturan utilizando el mismo esquema JSON que se utiliza para las sesiones de escritorio, con algunas excepciones. Consulte "Referencia de esquema de objeto JSON de Tealeaf" en la Guía de integración de datos de infraestructura de cliente de IBM Tealeaf .

Capítulo 7. Preguntas más frecuentes de CX UI Capture j2

69

¿Qué sucede si encuentro un error con CX UI Capture j2? Si encuentra un error, acceda al IBM Support Portal para notificarlo. Esté preparado para proporcionar la información siguiente: v Versión de CX UI Capture j2 (se encuentra en tealeaf.js or tealeaf.min.js como @version 2.0.0.664) v Número de compilación de IBM Tealeaf (en la parte inferior de cada página de Portal) v Versión de Visor CX RealiTea (si se utiliza) v Una sesión de IBM Tealeaf que no contiene ninguna información confidencial

¿Cómo puedo crear eventos de los datos de CX UI Capture j2? IBM Tealeaf CX UI Capture j2 envía datos en formato JSON. Puede crear eventos y atributos de paso a partir de estos estos a través de la interfaz de reproducción basada en navegador, utilizando eventos basados en pasos. Estos objetos de evento se pueden modificar en el gestor de eventos, según sea necesario. v Consulte "Propiedades JSON de Tealeaf" en la Guía de integración de datos de infraestructura de cliente de IBM Tealeaf . v Consulte "Eventos basados en pasos" en el Manual del gestor de eventos de IBM Tealeaf . v Consulte "Gestor de eventos de Tealeaf" en el Manual del gestor de eventos de IBM Tealeaf .

¿Cómo busco datos de CX UI Capture j2? Los datos basados en JSON se indexan y están disponibles para su búsqueda. Además, puede buscar datos de CX UI Capture j2 si ha creado eventos y atributos para rastrear y capturar los datos. v Consulte "Búsqueda de datos de sesión" en el Manual de usuario de IBM Tealeaf cxImpact. v Consulte "Eventos basados en pasos" en el Manual del gestor de eventos de IBM Tealeaf .

¿Cómo puedo capturar solo eventos mouseover en el menú? IBM Tealeaf CX UI Capture j2 no soporta la captura de eventos mouseover.

¿Cómo capturo eventos keyup? La versión JSON de IBM Tealeaf CX UI Capture for AJAX no captura eventos keyup del cliente. En su lugar, supervise los eventos de cambio para los mismos objetos.

¿Cómo puedo informar sobre los mensajes de validación/error del lado del cliente? IBM Tealeaf captura datos que se intercambian entre el navegador y el servidor web. Para capturar datos que no intercambian entre el navegador y el servidor web, como la validación del lado del cliente, cree eventos personalizados. Como tal, cualquier condición de validación o error que se detecte en el servidor y se comunique al cliente se registra en la sesión de IBM Tealeaf .

70

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

La validación del lado del cliente normalmente se realiza mediante el JavaScript que se ejecuta en el navegador del usuario. Esta validación no genera un intercambio de datos entre el navegador y el servidor web. Aunque los mensajes de validación del lado del cliente se pueden ver durante la reproducción de la sesión mediante la reproducción de los eventos de entrada del mismo usuario que conducen a errores de validación, no se pueden detectar mediante los eventos de IBM Tealeaf que funcionan en el tráfico de red. Una solución es hacer que la validación del lado del cliente desencadene parte del tráfico de red. Utilizando una API proporcionada con CX UI Capture j2, puede crear un evento de IU personalizado en el navegador mediante el mismo código que detecta y desencadena el mensaje de validación. En el ejemplo siguiente, una función de validación del lado de cliente realiza comprobaciones para verificar que un campo de entrada no está vacío. function Validation_Check(user_input_element) { if (!user_input_element.value) { // La entrada está vacía, la validación ha fallado return FAILURE; } return SUCCESS; }

Para capturar este desencadenante de validación en una sesión de IBM Tealeaf , debe crear un evento personalizado utilizando el método TLT.logCustomEvent(). La salida generada se puede capturar desde el formato JSON.

¿Cómo fuerzo el envío de eventos en cola? De forma predeterminada, IBM Tealeaf coloca en cola los eventos de IU capturados para la transmisión que se basa en umbrales predefinidos. En algunos casos, es necesario forzar el envío de un conjunto de eventos en cola al servidor web para su captura por IBM Tealeaf . Por ejemplo, si un elemento de IU como el botón Enviar desencadena el evento onbeforeunload, la ejecución de dicho código puede vaciar la cola de eventos antes de que la cadena de eventos onclick se haya enviado correctamente a los eventos en cola. En dicho caso, el evento onclick que llega después de la finalización del manejador de eventos del sitio se pierde. Para manejar estas situaciones, la biblioteca permite el vaciado forzado de la cola de eventos durante la fase de descarga. Para iniciar manualmente esta API en su código, llame a TLT.flushAll()

Para la primera fase, la única métrica deseada es el tiempo de representación de página. ¿Hay valores de configuración que limitan los POST solo para ese evento? Puede configurar el asistente de configuración de captura de IU para que solo se envíen datos de rendimiento. En el asistente de configuración de captura de IU, habilite solo el módulo de rendimiento. Inhabilite el módulo de reproducción. Esta configuración fuerza a IBM Tealeaf CX UI Capture j2 a enviar solo datos de rendimiento, que incluyen la métrica del tiempo de representación de página. Capítulo 7. Preguntas más frecuentes de CX UI Capture j2

71

Consulte "Asistente de configuración de UI Capture j2".

Utilizo DHTML en mi formulario de pago. ¿CX UI Capture j2 va a capturar los elementos DOM representado dinámicamente? DHTML se gestiona mediante la llamada a TLT.rebind() para adjuntar elementos de entrada creados dinámicamente.

¿Cómo obtengo los tiempos de representación de CX UI Capture j2? Puede configurar el asistente de configuración de captura de IU para que solo se envíen datos de rendimiento. En el asistente de configuración de captura de IU, habilite solo el módulo de rendimiento. Inhabilite el módulo de reproducción. Esta configuración obliga a IBM Tealeaf CX UI Capture j2 a enviar solo datos de rendimiento. Para todos los navegadores modernos que implementan la especificación de tiempo de navegación W3C, los tiempos de representación se notifican mediante el módulo de rendimiento. Consulte "Asistente de configuración de UI Capture j2".

¿Es necesario que los ID se asignen a mis elementos DOM que me gustaría capturar? Si es posible, asigne ID exclusivos a los elementos HTML que se deben rastrear. Hacerlo no es una opción, asigne ID exclusivos al elemento HTML ancestro más cercano. En la ausencia de un ID, IBM Tealeaf CX UI Capture j2 crea un XPath como como una vía de acceso de modelo de objeto de documento (DOM), que finaliza en el ancestro más cercando con un ID de HTML válido.

¿Puedo personalizar JavaScripts de CX UI Capture j2? No. IBM Tealeaf UI Capture proporciona bibliotecas configurables para capturar eventos de interfaz de usuario para visitantes a su aplicación AJAX, incluyendo mucha opciones de configuración para adaptar los eventos que se van a capturar y los métodos mediante los cuales se capturan. Estas opciones se indican en la documentación del producto y en los scripts de CX UI Capture j2. Nota: Las modificaciones que no son cambios de configuración en el código JavaScript de IBM Tealeaf CX UI Capture j2 que no se implementan mediante IBM Tealeaf de acuerdo con un compromiso de IBM Professional Services anulan la garantía con respecto al software, y dicho código modificado no está soportado según el programa de mantenimiento y soporte de IBM Tealeaf . Si desea más información, póngase en contacto con IBM Professional Services.

72

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

¿Cómo obtengo mensajes de error de dominios cruzados en mi consola de depuración de navegadores relacionados con iFrames en mi sitio? Cuando la solución CX UI Capture j2 se inicializa en cualquier página de su aplicación web, intenta adjuntar los elementos del marco en la página. Sin embargo, si estos elementos de marco no están en el mismo dominio que la aplicación web, la mayoría de los navegadores registra esta acción como un acceso de dominio cruzado e impide la ejecución del script de CX UI Capture j2. No hay ningún medio de anticipar el navegador que rechaza el acceso debido a esta restricción de seguridad. CX UI Capture j2 sigue funcionando normalmente. Sin embargo, las acciones que se ejecutan en el iFrame no se pueden supervisar. Algunos navegadores registran un mensaje de error en la consola. A efectos de funciones de CX UI Capture j2 que se describen arriba, este mensaje se puede ignorar y no afecta negativamente ni a CX UI Capture j2 ni a su aplicación.

Actualización de la biblioteca ¿Cómo determino qué versión de la biblioteca estoy utilizando? Para IBM Tealeaf CX UI Capture j2, la información de versión de la biblioteca se proporciona en la cabecera X-Tealeaf. Consulte "Visión general de UI Capture j2".

¿Cómo determino qué versión del archivo TealeafTarget.jsp estoy utilizando? A través del navegador, vaya hasta el archivo TealeafTarget.jsp en el sitio web utilizando el parámetro de consulta version. El URL siguiente es un ejemplo. http://mydomain.com/mySite/TealeafTarget.jsp?version

Nota: Si este URL no devuelve la información de la versión, no tiene la versión más reciente.

¿Cuándo actualizo? Siempre que sea posible, utilice la última versión de IBM Tealeaf CX UI Capture j2. Si está experimentando problemas de captura de IU, debe actualizar a la última versión de IBM Tealeaf CX UI Capture j2 porque contiene las mejoras más recientes. Puede integrar la actualización de CX UI Capture j2 en los procesos existentes de mantenimiento y despliegue para la aplicación. Nota: Antes de actualizar, revise las Notas del release de IBM Tealeaf CX UI Capture j2 para evaluar su idoneidad para su aplicación web.

Capítulo 7. Preguntas más frecuentes de CX UI Capture j2

73

¿Cómo puedo saber si hay actualizaciones disponibles? 1. Adquiera el número de versión para su instalación actual de IBM Tealeaf CX UI Capture j2. Consulte “¿Cómo determino qué versión de la biblioteca estoy utilizando?” en la página 73. 2. Compare el número anterior con la última versión disponible. Puede obtener información adicional relativa a la descarga del software de Tealeaf consultando Descargas de Tealeaf CX. La información de la versión también se publica en la Notas del release general en la ayuda en línea de IBM Tealeaf .

74

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Apéndice A. Comunicación de dominios cruzados En el funcionamiento normal, CX UI Capture j2 realiza POST en los datos capturados en el URL configurado utilizando el protocolo (por ejemplo, http o https), el dominio (www.website.com) y el puerto de la página padre. Este es el método preferido de despliegue. En algunos casos, podría ser necesario enviar la solicitud POST de CX UI Capture j2 a un servidor diferente que la página padre. Por ejemplo, el sitio se puede haber desplegado con un servidor dedicado para alojar la página de destino que tiene su propio subdominio (tealeaf.website.com). Esto se puede visualizar del modo siguiente:

Para realizar este tipo de POST, el sitio web debe estar configurado del modo siguiente: 1. Despliegue lo siguiente en el servidor de dominios cruzados. v Página de destino de IBM Tealeaf . v JavaScript de Tealeaf de dominios cruzados desde el paquete CX UI Capture j2. v Un origen html mínimo para incluir el JS y definir el dominio de documento para habilitar la comunicación de dominios cruzados. A continuación, se proporciona un ejemplo del html (xdomainFrame.html). // Asegurarse de que el dominio de documento está definido // en el subdominio. document.domain = "website.com"; © Copyright IBM Corp. 1999, 2013

75



2. Añada un elemento iframe a las páginas y defina el dominio de documento en el subdominio para habilitar la comunicación de dominios cruzados. Marque el elemento iframe con un estilo CSS de visualización: ninguno, para que no afecte a la salida representada de la página. // Asegurarse de que el dominio de documento está definido en el subdominio. document.domain = "website.com";

3. Configure la biblioteca principal de UI Capture para definir el valor crossDomainEnabled en true y especifique el crossDomainFrameSelector para que corresponda al iframe oculto añadido en el paso 2.

76

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Apéndice B. Comunidad viaTealeaf La ayuda en línea de Tealeaf es un componente de la comunidad de viaTealeaf. viaTealeaf contiene documentación de producto, foros de Tealeaf, el portal de autoservicio, la base de conocimiento de Tealeaf y más. v https://community.tealeaf.com v https://community.tealeaf.com/display/public Si ya se ha adquirido una cuenta individual de viaTealeaf, las siguientes áreas también estarán disponibles. Nota: Cualquier usuario autorizado de Tealeaf puede adquirir una cuenta gratuita de la comunidad de viaTealeaf. Para registrarse, https://community.tealeaf.com/ signup.action. v https://forums.tealeaf.com v http://support.tealeaf.com

Acceso del portal Cada licenciatario con un acuerdo de soporte válido tiene derecho a una cuenta de ayuda en línea de Tealeaf, que proporciona acceso a la documentación del producto de Tealeaf. Esta cuenta está pensada para uso de grupo a través del portal de Tealeaf instalado. Consulte "Instalación de las credenciales de la ayuda en línea de Tealeaf" en el Manual de administración de IBM Tealeaf cxImpact.

Acceso individual Los usuarios individuales de Tealeaf pueden adquirir una cuenta de comunidad de viaTealeaf, que proporciona acceso a la ayuda en línea de Tealeaf, así como a los foros de Tealeaf, al portal de autoservicio de soporte y más. Consulte https://community.tealeaf.com.

Permisos Los usuarios individuales con una cuenta de usuario válida de viaTealeaf pueden configurar el acceso a los diversos componentes de la comunidad de viaTealeaf, incluida la documentación del producto de releases individuales. Nota: Si su empresa ha adquirido licencias de nuevos productos o ha actualizado a una versión nueva de Tealeaf, revise y modifique sus permisos de acceso. Consulte https://community.tealeaf.com/display/public/ Configuring+Permissions+in+viaTealeaf.

Búsqueda en la ayuda en línea de Tealeaf Puede encontrarse rápidamente la información que se necesita utilizando el potente motor de búsqueda de la ayuda en línea de Tealeaf. © Copyright IBM Corp. 1999, 2013

77

Búsqueda en la ayuda en línea de Tealeaf desde Portal Desde el portal de Tealeaf puede buscarse directamente en la ayuda en línea de Tealeaf. Nota: Para habilitar la búsqueda de documentación a través de Portal, deberán insertarse las credenciales de la ayuda en línea de Tealeaf. Consulte "Instalación de las credenciales de la ayuda en línea de Tealeaf" en el Manual de administración de IBM Tealeaf cxImpact.

Especifique un término de búsqueda en el recuadro de texto de la esquina superior derecha y pulse Buscar ayuda en línea . Los resultados se mostrarán en una ventana de navegador nueva.

Búsqueda desde dentro de la ayuda en línea de Tealeaf Para buscar en la documentación de un producto, especifique un término de búsqueda en el recuadro de texto de la parte superior de la pantalla. A continuación, pulse en Buscar. En la página resultados Búsqueda del sitio, puede revisar las coincidencias de búsqueda del release de la documentación seleccionada. Para buscar un área distinta a la que se tenga acceso, seleccione en la lista desplegable de ubicaciones. En la barra de navegación izquierda: v Búsqueda en espacio: los resultados pueden centrarse solo en la documentación de producto relevante a su versión de Tealeaf empleando el panel de búsqueda superior, que habilita la búsqueda del espacio actual. v Búsqueda jerárquica: el panel de búsqueda inferior puede utilizarse para buscar desde la página actual hacia abajo en la jerarquía de páginas. Los manuales de documentación de producto se organizan en una jerarquía de páginas, de modo que este método es de utilidad cuando se desea buscar en el contenido de un determinado manual. Puede obtener información adicional relativa a cómo buscar en víaTealeaf consultando https://community.tealeaf.com/display/public/ Help+Searching+viaTealeaf.

Cómo empezar Puede obtener información adicional relativa a cómo empezar con la ayuda en línea consultando https://community.tealeaf.com/display/public/ Getting+Started+with+Online+Help.

78

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Otras áreas de ayuda Mediante el portal, puede acceder a distintas formas de ayuda:

v La Ayuda en línea abre https://community.tealeaf.com/display/public, que contiene la documentación más reciente y otros recursos útiles. v Tealeaf.com le lleva a http://www.tealeaf.com, donde se puede obtener más información sobre la empresa Tealeaf y sus productos. v En Póngase en contacto con nosotros se indica el número de teléfono y direcciones de las oficinas de Tealeaf. v En el Póngase en contacto con el administrador de Tealeaf se proporciona el nombre y la información de contacto del administrador de Tealeaf. Nota: La información de contacto del administrador de Tealeaf se puede configurar a través del portal de Tealeaf. Consulte "Configuración de CX" en la publicación IBM Tealeaf cxImpact Administration Manual. v En Acerca del portal de Tealeaf CX aparecen las versiones que actualmente hay instaladas del software de Tealeaf, las propiedades de l sistema y los resultados de las pruebas de rendimiento del portal. Consulte el apartado "Informe de información de la aplicación del portal" en la publicación IBM Tealeaf cxImpact Administration Manual. v En el menú Anuncios se muestran los anuncios actuales del sistema, los cuales también se muestran cuando se inicia sesión.

Apéndice B. Comunidad viaTealeaf

79

80

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Avisos Esta información se ha escrito para productos y servicios ofrecidos en Estados Unidos. Es posible que IBM no ofrezca en otros países los productos, servicios o características que se describen en este documento. Consulte al representante local de IBM para obtener información sobre los productos y servicios disponibles actualmente en su localidad. Las referencias a programas, productos o servicios de IBM no pretenden establecer ni implicar que sólo puedan utilizarse dichos productos, programas o servicios de IBM. En su lugar, se puede utilizar cualquier producto, programa o servicio funcionalmente equivalente que no infrinja ninguno de los derechos de propiedad intelectual de IBM. Sin embargo, es responsabilidad del usuario evaluar y comprobar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM. IBM puede tener patentes o solicitudes de patentes pendientes que cubran la materia descrita en esta información. La entrega de este documento no le otorga ninguna licencia sobre estas patentes. Puede enviar consultas sobre licencias, por escrito, a: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 EE. UU. En el caso de consultas sobre licencias relativas a información de doble byte (DBCS), póngase en contacto con el Departamento de propiedad intelectual de IBM de su país o envíe sus consultas, por escrito, a: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japón El párrafo siguiente no se aplica al Reino Unido ni a ningún otro país en que dichas disposiciones entren en contradicción con la legislación local: INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN "TAL CUAL" SIN GARANTÍA DE NINGÚN TIPO, NI EXPLÍCITA NI IMPLÍCITA, INCLUYENDO, PERO NO LIMITÁNDOSE, A LAS GARANTÍAS IMPLÍCITAS DE NO VULNERABILIDAD, COMERCIALIZACIÓN O ADECUACIÓN A UN PROPÓSITO DETERMINADO. Algunos países no permiten la renuncia a garantías explícitas o implícitas en determinadas transacciones, por lo que puede que esta declaración no sea aplicable en su caso. Esta información puede contener imprecisiones técnicas o errores tipográficos. Periódicamente se realizan cambios en la información aquí contenida; dichos cambios se incorporarán en nuevas ediciones de la publicación. IBM puede realizar mejoras y/o cambios en el/los producto(s) y/o programa(s) descritos en esta publicación en cualquier momento sin aviso.

© Copyright IBM Corp. 1999, 2013

81

Cualquier referencia en esta información a sitios Web que no sean de IBM se proporciona únicamente a efectos de comodidad y no sirve, en modo alguno, de recomendación de dichos sitios Web. Los materiales de dichos sitios Web no forman parte de los materiales de este producto IBM y el usuario utilizará dichos sitios Web por su cuenta y riesgo. IBM puede utilizar o distribuir la información que proporcione el usuario de la manera que IBM crea más conveniente sin incurrir en ninguna obligación con el usuario. Los licenciatarios de este programa que deseen obtener información sobre él para poder: (i) intercambiar información entre programas creados de forma independiente y otros programas (incluidos este) y (ii) y utilizar, de forma mutua, la información que se ha intercambiado, deberán ponerse en contacto con: IBM Bay Area Lab 1001 E Hillsdale Boulevard Foster City, California 94404 EE. UU. Dicha información puede estar disponible, sujeta a los términos y condiciones apropiados, incluyendo el pago de una tarifa en algunos casos. El programa bajo licencia descrito en este documento y todo el material bajo licencia disponible para el mismo lo proporciona IBM de acuerdo con los términos del Acuerdo de Cliente de IBM, el Acuerdo Internacional de Programa bajo Licencia de IBM o cualquier otro acuerdo equivalente entre las partes. Los datos de rendimiento contenidos en esta documentación se han determinado en un entorno controlado. Por lo tanto, los resultados obtenidos en otros entornos operativos podrían variar de forma significativa. Es posible que algunas medidas se hayan realizado en sistemas en nivel de desarrollo, y no existen garantías de que estas medidas sean las mismas en los sistemas de disponibilidad general. Además, algunas mediciones se pueden haber estimado mediante extrapolación. Los resultados reales podrían variar. Los usuarios de este documento deberán verificar los datos aplicables para su entorno específico. La información relativa a los productos que no son de IBM se ha obtenido de los proveedores de dichos productos, sus anuncios publicados u otras fuentes públicas. IBM no ha probado estos productos y no puede confirmar la precisión del rendimiento, la compatibilidad o cualquier otra afirmación relacionada con productos que no sean de IBM. Las preguntas relativas a las prestaciones de los productos que no son de IBM deberán dirigirse a los proveedores de dichos productos. Todas las declaraciones sobre futuras tendencias o intenciones de IBM están sujetas a modificación o retirada sin previo aviso y representan únicamente metas y objetivos. Esta información contiene ejemplos de datos e informes utilizados en operaciones de negocio diarias. Para ilustrarlos de la manera más completa posible, los ejemplos incluyen los nombres de personas, empresas, marcas y productos. Todos estos nombres son ficticios y cualquier similitud con nombres y direcciones de empresas reales es pura coincidencia. LICENCIA DE COPYRIGHT:

82

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2

Esta información contiene programas de aplicación de muestra escritos en código fuente, los cuales muestran técnicas de programación para diversas plataformas operativas. Puede copiar, modificar y distribuir estos programas de muestra de cualquier forma sin pagar ninguna cuota a IBM, con fines de desarrollo, uso, marketing o distribución de programas de aplicación que se ajusten a la interfaz de programación de aplicaciones de la plataforma operativa para la que se han escrito los programas de muestra. Estos programas no se han probado exhaustivamente bajo todas las condiciones. IBM, por tanto, no puede garantizar ni dar por supuesta la fiabilidad, la capacidad de servicio ni la funcionalidad de estos programas. Los programas de ejemplo se proporcionan "TAL CUAL", sin ningún tipo de garantía. IBM no se responsabiliza de los daños que puedan derivarse del uso de los programas de ejemplo.

Marcas registradas IBM, el logotipo de IBM e ibm.com son marcas registradas o marcas comerciales de International Business Machines Corp., registradas en muchas jurisdicciones en todo el mundo. Otros nombres de productos y servicios pueden ser marcas registradas de IBM u otras empresas. Hay disponible una lista actual de marcas registradas de IBM en la Web en “Información de marca registrada y copyright en ”www.ibm.com/legal/copytrade.shtml.

Consideraciones sobre la política de privacidad Los productos de IBM Software, incluidas las soluciones de software como servicio, ("Software Offerings") pueden utilizar cookies u otras tecnologías para recopilar información de uso del producto, para ayudar a mejorar la experiencia del usuario final, para adaptar las interacciones con el usuario final o para otros fines. Una cookie es un elemento de datos que un sitio web puede enviar al navegador, que a continuación se puede almacenar en el sistema como una etiqueta que identifica el sistema. En muchos casos, estas cookies no recopilan información personal. Si está utilizando una Oferta de Software que recopila información personal a través de cookies o de una tecnología similar, a continuación le informamos sobre los pormenores. Dependiendo de las configuraciones desplegadas, esta Oferta de software puede utilizar cookies de sesión y persistentes que recopilan el nombre de cada usuario, y otra información personal para fines de gestión de sesiones, utilización de usuario mejorada u otros fines funcionales o de seguimiento de uso. Estas cookies pueden inhabilitarse, pero si se inhabilitan también se eliminará la funcionalidad que habilitan. Existen diversas jurisdicciones que regulan la recopilación de información personal a través de tecnologías como las de cookies o similares. Si las configuraciones desplegadas para esta Oferta de software le proporcionan como cliente la capacidad de recopilar información personal de los usuarios finales mediante cookies y otras tecnologías, deberá buscar asesoramiento legal sobre la legislación aplicable para la recopilación de dicha información, incluidos los requisitos para proporcionar el aviso y consentimiento donde corresponda. IBM requiere que los Clientes (1) proporcionen un enlace claro y visible a los términos de uso del sitio web del Cliente (por ej., política de privacidad) que incluya un enlace a la recopilación de datos y las prácticas de uso de IBM y del Cliente, (2) notifiquen que IBM coloca, en nombre del cliente, cookies y balizas web/gifs claras en el sistema del visitante, junto con una explicación de la finalidad de dicha tecnología, y (3) en la medida requerida por ley, obtengan el Avisos

83

consentimiento de los visitantes del sitio web antes de la colocación de cookies y balizas web/gifs por parte del Cliente o IBM en nombre del Cliente, en dispositivos del visitante del sitio web Para obtener más información sobre el uso de diversas tecnologías, incluidas las cookies, para estos fines, consulte la sección Declaración de privacidad en línea de IBMen: http://www.ibm.com/privacy/details/us/en titulada "Cookies, Web Beacons and Other Technologies."

84

IBM Tealeaf CX UI Capture j2: Guía de IBM Tealeaf CX UI Capture j2




Impreso en España