IBM Tealeaf CX UI Capture j2 Version juin Guide d'ibm Tealeaf CX UI Capture j2

Transcription

1 IBM Tealeaf CX UI Capture j2 Version juin 2014 Guide d'ibm Tealeaf CX UI Capture j2

2 Important Aant d'utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à la section «Remarques», à la page 85. Remarque Certaines illustrations de ce manuel ne sont pas disponibles en français à la date d'édition. LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE CONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE. Ce document est mis à jour périodiquement. Chaque nouelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d'être modifiées aant que les produits décrits ne deiennent eux-mêmes disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou serices non annoncés dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncés. Pour plus de détails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-ous aux documents d'annonce disponibles dans otre pays, ou adressez-ous à otre partenaire commercial. Vous pouez également consulter les sereurs Internet suiants : (sereur IBM en France) (sereur IBM au Canada) (sereur IBM aux Etats-Unis) Compagnie IBM France Direction Qualité 17, aenue de l'europe Bois-Colombes Cedex Cette édition s'applique à la ersion d'ibm Tealeaf CX UI Capture j2 et à toutes les ersions et modifications ultérieures, sauf stipulation contraire figurant dans les nouelles éditions. Copyright IBM Corporation 1999, 2014.

3 Table des matières Ais aux lecteurs canadiens Guide d'ibm Tealeaf CX UI Capture j2 ii Chapitre 1. IBM Tealeaf CX UI Capture j2 1 Gestion des cas d'utilisation Validation des cas d'utilisation à l'aide de l'utilitaire Client-Side Capture Configuration système prérequise Naigateurs pris en charge Description du fonctionnement d'cx UI Capture j2 pour la relecture Comment CX UI Capture j2 capture les interactions Comment CX UI Capture j2 relit les interactions capturées Documentation connexe Chapitre 2. Installation et implémentation de CX UI Capture j2.. 9 Installation de la ersion Prise en charge de CX RealiTea Viewer Prise en charge de la capture d'applications Web mobiles Configuration de CX Passie Capture Application 10 Plan d'installation et de déploiement Etape 1 : Enironnement de déeloppement.. 10 Etape 2 : Enironnement de test Etape 3 : Enironnement de production Configuration du code JaaScript Interactions de CX UI Capture j2 JaaScript aec les pages d'application Web Blocage des zones de données sensibles Installation sur des pages Web ID HTML uniques Cookies Installation sur le sereur Web Références au fichier JaaScript Page cible IBM Tealeaf Configuration du fichier CX UI Capture j2 JaaScript Configuration du serice IIS Configuration d'un sereur Web non-iis Modifications de pages Web Gestion des modifications des éléments DOM Mise à nieau de CX UI Capture j Prise en charge des en-têtes existants Désinstallation de CX UI Capture j Chapitre 3. Assistant de configuration de CX UI Capture j Naigateurs pris en charge Commandes de l'assistant de configuration Types de ersion Etape 1 : Configuration du serice du naigateur. 27 Etape 2 : Configuration du serice de file d'attente 28 Etape 3 : Configuration du serice de message (configuration du masquage de la confidentialité). 29 Etape 4 : Sérialiseur Etape 5 : Modules Etape 6 : Paramètres diers Testeur RegEx Chapitre 4. Instructions d'utilisation de CX UI Capture j Portée de l'application Types d'application pris en charge Protocoles pris en charge Aant de commencer le déeloppement Accès à IBM Tealeaf Contenus tiers Personnel Eléments à prendre en compte lors du déeloppement Cycle de déeloppement Quand déployer CX UI Capture j2 au cours du déploiement Enironnements de déeloppement et de test.. 38 Gestion des performances Contenu de l'application Identificateurs uniques Les mots clés DOM ne sont pas autorisés dans les noms de zone de formulaire Objets application Données priées Fréquence des publications Eénements de l'interface utilisateur remplacés par CX UI Capture j Déploiement de CX UI Capture j Positionnement de CX UI Capture j JaaScript Création d'éénements personnalisés Etapes suiantes Chapitre 5. Référence de CX UI Capture j Configuration de base Core Configuration des éénements client par module 48 Configuration des serices Configuration du serice de mise en file d'attente 52 Configuration du serice de naigateur Configuration du serice de message Configuration du serice du sérialiseur Configuration des modules Performance Configuration de la fonction localstorage Copyright IBM Corp. 1999, 2014 iii

4 Chapitre 6. Référence des API publiques de CX UI Capture j TLT.init(object configobject) TLT.rebind(/*optional*/ DOMElement root) TLT.flushAll(oid) TLT.setAutoFlush(indicateur AutoFlushFlag) TLT.processDOMEent(éénement DOMEent).. 64 TLT.logCustomEent(DOMString name, object custommsgobj) TLT.logExceptionEent(DOMString msg, /*optional*/ DOMString url, /*optional*/ long line) 65 TLT.logScreeniewLoad(DOMString name, /*optional*/ DOMString referrername, /*optional*/ DOMElement root) TLT.logScreeniewUnload(DOMString name) TLT.getSessionData() TLT.registerBridgeCallbacks TLT.logScreenCapture Chapitre 7. Foire aux questions sur CX UI Capture j Mise en route Définition de CX UI Capture j Quelles sont les ersions d'ui Capture disponibles? Pourquoi ai-je besoin de l'application CX UI Capture j2? Procédure d'implémentation de CX UI Capture j2 70 Quelle est la taille de CX UI Capture j2? Est-ce que je peux regrouper la bibliothèque CX UI Capture j2 aec d'autres ressources JaaScript? Est-ce que CX UI Capture j2 a impacter les performances ou le comportement de mon site Web? Où obtenir la dernière ersion de CX UI Capture j2? Quels sont les éléments capturés par CX UI Capture j2? Je rencontre des problèmes lors de l'implémentation de CX UI Capture j2. Comment obtenir de l'aide ou une assistance technique?. 72 Utilisation de CX UI Capture j Comment configurer ce qui est capturé par CX UI Capture j2? Quels sont les éléments capturés à partir des sessions Web mobiles? Que dois-je faire si je rencontre un bogue dans CX UI Capture j2? Comment créer des éénements à partir des données CX UI Capture j2? Comment rechercher des données CX UI Capture j2? Comment faire pour capturer uniquement des éénements mouseoer sur le menu? Comment faire pour capturer des éénements keyup? Comment produire des rapports sur les messages d'erreur/de alidation côté client? Quelle est la procédure à suire pour forcer l'enoi des éénements mis en file d'attente?.. 74 Pour la première phase, la mesure du temps de rendu de page est la seule dont j'ai besoin. Y-a-t-il des paramètres de configuration qui limitent les requêtes POST à ce seul éénement? 75 J'utilise DHTML sur mon formulaire d'emprunt. Est-ce que CX UI Capture j2 a capturer les éléments DOM affichés de manière dynamique?. 75 Quelle est la procédure à suire pour obtenir les temps de rendu de CX UI Capture j2? Faut-il absolument que des ID soient affectés aux éléments DOM que je souhaite capturer? Puis-je personnaliser les codes JaaScript de CX UI Capture j2? Pourquoi des messages d'erreur interdomaine associés aux iframes sur mon site s'affichent-ils dans la console de débogage de mes naigateurs? Mise à nieau de la bibliothèque Comment déterminer la ersion de la bibliothèque utilisée? Comment déterminer la ersion du fichier TealeafTarget.jsp utilisée? Quand procéder à une mise à nieau? Comment faire pour rechercher les mises à jour disponibles? Chapitre 8. Documentation et aide d'ibm Tealeaf Annexe A. Communication entre domaines Annexe B. Différences entre les ersions jquery et W3c de CX UI Capture j Remarques Marques Remarques sur les règles de confidentialité i IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

5 Ais aux lecteurs canadiens Le présent document a été traduit en France. Voici les principales différences et particularités dont ous deez tenir compte. Illustrations Les illustrations sont fournies à titre d'exemple. Certaines peuent contenir des données propres à la France. Terminologie La terminologie des titres IBM peut différer d'un pays à l'autre. Reportez-ous au tableau ci-dessous, au besoin. IBM France ingénieur commercial agence commerciale ingénieur technico-commercial inspecteur IBM Canada représentant succursale informaticien technicien du matériel Claiers Les lettres sont disposées différemment : le claier français est de type AZERTY, et le claier français-canadien de type QWERTY. OS/2 et Windows - Paramètres canadiens Au Canada, on utilise : les pages de codes 850 (multilingue) et 863 (français-canadien), le code pays 002, le code claier CF. Nomenclature Les touches présentées dans le tableau d'équialence suiant sont libellées différemment selon qu'il s'agit du claier de la France, du claier du Canada ou du claier des États-Unis. Reportez-ous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de otre claier. Copyright IBM Corp. 1999, 2014

6 Breets Il est possible qu'ibm détienne des breets ou qu'elle ait déposé des demandes de breets portant sur certains sujets abordés dans ce document. Le fait qu'ibm ous fournisse le présent document ne signifie pas qu'elle ous accorde un permis d'utilisation de ces breets. Vous pouez enoyer, par écrit, os demandes de renseignements relaties aux permis d'utilisation au directeur général des relations commerciales d'ibm, 3600 Steeles Aenue East, Markham, Ontario, L3R 9Z7. Assistance téléphonique Si ous aez besoin d'assistance ou si ous oulez commander du matériel, des logiciels et des publications IBM, contactez IBM direct au i IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

7 Guide d'ibm Tealeaf CX UI Capture j2 Pour la ersion 8.6 et ultérieures, ous deez utiliser IBM Tealeaf CX UI Capture j2. Le guide d'ibm Tealeaf CX UI Capture j2 décrit en détail la façon de déployer la toute dernière ersion d'ibm Tealeaf UI Capture pour otre application Web basée sur JaaScript. IBM Tealeaf UI Capture permet de sureiller les éénements de l'interface utilisateur, par le biais du naigateur du isiteur, qui ne se traduisent pas par une demande à l'application Web et ne peuent pas être capturés selon d'autres méthodes. Copyright IBM Corp. 1999, 2014 ii

8 iii IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

9 Chapitre 1. IBM Tealeaf CX UI Capture j2 Gestion des cas d'utilisation La bibliothèque IBM Tealeaf CX UI Capture j2 actie la capture du contenu, des éénements et d'autres données de page qui ne sont en principe pas échangés aec le site Web. Si ous utilisez la IBM Tealeaf CX Passie Capture Application, Vous pouez capturer et relire otre site Web sans aoir à modifier le site lui-même. Toutefois, si otre site utilise JaaScript pour ajouter de l'interactiité, ces interactions restent en local sur la page Web. Il se peut que les actions effectuées à l'aide de ces technologies ne soient pas transmises au site Web et, par conséquent, ne soient pas capturées par la CX Passie Capture Application. Si ous ajoutez CX UI Capture j2 JaaScript aux pages Web dynamiques, ous pouez capturer l'état des pages Web et ses interactions JaaScript. Vous pouez également capturer d'autres informations qui sont uniquement disponibles dans la page, telles que les temps de chargement des pages, la résolution de l'affichage pour les utilisateurs ainsi que d'autres attributs prédéfinis. Si ous ajoutez un ensemble de fichiers JaaScript aux pages Web adéquates, le contenu et les actions appropriés sont automatiquement capturés et intégrés au reste de os données de capture IBM Tealeaf. Le système CX UI Capture j2 reçoit les données du naigateur et les transmet au sereur de capture IBM Tealeaf. Ces informations sont entre autres des clics de souris, des frappes de touche et des éénements de modification. Elles sont transmises au sereur par le biais d'une requête POST HTTP asynchrone dans une page Web sur le sereur qui accuse réception de la demande. Comme la demande et la réponse sont capturées par IBM Tealeaf, toutes les données sont mises à la disposition de IBM Tealeaf en ue d'une future génération de rapports ou relecture. On distingue trois utilisations de base d'ibm Tealeaf CX UI Capture j2, mais ous pouez également déelopper des cas d'utilisation propres à os besoins. La complexité et les fonctions des cas d'utilisation de base qui ous sont présentées ont crescendo : 1. Capture des informations de l'enironnement de naigateur, qui ne sont généralement pas transmises au sereur Web. Ces données incluent notamment : Les mesures du temps de rendu des pages et de performance côté client associées, conformément à la spécification Temps de naigation de W3C. Voir La résolution d'écran de l'ordinateur ou de l'unité client. Daantage de données de naigateur peuent être capturées ia les informations d'agent utilisateur qui sont extraites et éaluées par le biais d'ibm Tealeaf cximpact. Voir "Gestion des agents d'utilisateur" dans le document IBM Tealeaf cximpact Administration Manual. 2. Capture des éénements prédéfinis sur la page. IBM Tealeaf peut capturer os propres éénements (oir plus loin la description). Copyright IBM Corp. 1999,

10 3. Capture des interactions d'utilisateur (UI) aec la page Web. Ces captures correspondent généralement au texte qui est saisi dans une zone de formulaire et à l'interaction aec des contrôles tels que des cases à cocher, des listes de sélection ou des liens. Vous pouez déelopper os propres cas d'utilisation pour IBM Tealeaf CX UI Capture j2. En particulier, ous pouez identifier les actiités d'utilisateur, les cas d'erreur et les critères de succès concernant l'utilisation de l'application. Un ensemble robuste de cas d'utilisation peut ous être d'une aide précieuse lors du processus d'implémentation et du suii des résultats dans IBM Tealeaf. Validation des cas d'utilisation à l'aide de l'utilitaire Client-Side Capture IBM Tealeaf fournit l'utilitaire CSS (Client-Side Capture), qui actie la capture de sessions Web sur l'ordinateur local sans accéder à un déploiement des captures d'ibm Tealeaf CX UI Capture j2. Cet utilitaire est utile pour capturer des cas d'utilisation dans l'application Web. Aec CSC, ous pouez capturer et enregistrer des sessions Web sur otre ordinateur local pour une relecture ultérieure dans l'application autonome IBM Tealeaf CX RealiTea Viewer. CSC ous permet de isiter toutes les zones de l'application et de capturer des flux de traaux spécifiques. Utilisez cette procédure pour érifier qu'ibm Tealeaf CX UI Capture j2 capture correctement tous les éléments requis de l'application. Remarque : Utilisez les sessions capturées par CSC pour érifier que tous les éénements d'interface utilisateur sont en cours de capture. Si ce n'est pas le cas, érifiez les points suiants. L'application Web écrase ces éénements. Contrôlez l'application pour érifier que des éénements d'interface utilisateur ne sont pas bloqués ou que leur propagation n'est pas empêchée par le code du site. L'application Web met dynamiquement à jour le contenu de la page. L'API d'ibm Tealeaf doit être appelée par l'application Web pour que UI Capture puisse se connecter aux programmes d'écoute d'éénement appropriés. Voir "Utilisation de Client-Side Capture for Fiddler" dans le document IBM Tealeaf Client-Side Capture Manual. Configuration système prérequise Aant de déployer IBM Tealeaf CX UI Capture j2, ous deez apporter certaines modifications à otre application Web. 1. Ajouter à ces pages Web d'intérêt des instructions pour inclure le fichier JaaScript IBM Tealeaf. 2. Ajouter aux sereurs Web d'origine une page Web cible afin d'accuser réception des demandes POST reçues de la bibliothèque IBM Tealeaf CX UI Capture j2 sur le naigateur. 3. En fonction de otre application de page Web, les éléments d'interface utilisateur pouant donner lieu à une action, tels que les zones de formulaire, les boutons et les balises <di>, doient être associés à des ID HTML uniques afin d'assurer la prise en charge de la relecture ia IBM Tealeaf. 2 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

11 Naigateurs pris en charge 4. Toutes les demandes Ajax proenant de fichiers JaaScript exécutés sur la page Web doient comporter au moins un élément de données unique pour permettre de distinguer plusieurs demandes. IBM Tealeaf CX UI Capture j2 JaaScript est pris en charge pour le déploiement ers un ensemble indiqué d'applications et de ersions de naigateur. Les naigateurs Web pris en charge sont les suiants. Internet Explorer 6.0 et ultérieures Firefox 4.0 et ultérieures Safari 4.0 et ultérieures Opera 9.0 et ultérieures Chrome 10.0 et ultérieures Pour la relecture, IBM Tealeaf CX RealiTea Viewer utilise une instance intégrée de la ersion d'internet Explorer qui est installée sur l'ordinateur local. Remarque : La relecture de sessions IBM Tealeaf dans CX RealiTea Viewer, l'application autonome dédiée à la relecture de bureau, nécessite la prise en charge d'internet Explorer. Si Internet Explorer n'est pas pris en charge par le serice informatique de otre entreprise, le naigateur peut prendre en charge la relecture de base. Remarque : La création des éénements qui sureillent les données JSON soumises à partir d'ibm Tealeaf CX UI Capture j2 n'est pas prise en charge dans IBM Tealeaf CX RealiTea Viewer. Pour créer des éénements à partir de ces ersions de CX UI Capture j2, ous deez utiliser la fonction de relecture sur naigateur. Voir "Eénements basés sur des étapes" dans le document IBM Tealeaf Eent Manager Manual. Pour plus d'informations sur ces prérequis, oir Chapitre 2, «Installation et implémentation de CX UI Capture j2», à la page 9. Pour obtenir la liste naigateurs et des ersions pris en charge pour une utilisation aec le portail IBM Tealeaf, oir "Liste de contrôle préinstallation CX" dans le document IBM Tealeaf CX Installation Manual. Description du fonctionnement d'cx UI Capture j2 pour la relecture Des trois cas d'utilisation de base d'ibm Tealeaf CX UI Capture j2, la capture des interactions de l'interface utilisateur aec la page Web en ue d'une relecture ultérieure est la plus complexe. Le diagramme suiant présente ce cas d'utilisation. Chapitre 1. IBM Tealeaf CX UI Capture j2 3

12 Figure 1. Capture et relecture de l'interface utilisateur Supposons que ous tentez de capturer une page Web JaaScript, DHTML ou Ajax. Aant l'intégration de la bibliothèque CX UI Capture j2, une isite de la page force le sereur Web à renoyer la page qui contient le code HTML/DHTML/ JaaScript nécessaire pour les fonctions de la page. Si l'utilisateur a des interactions dans la page, comme la saisie de données sur le formulaire, le code Ajax sur la page traite ces données comme préu. La page Web peut utiliser des techniques Ajax pour publier des demandes de données sur le sereur Web, qui répond aec les données nécessaires. La page peut donc être mise à jour sans entraîner le chargement d'une nouelle page. Lorsque l'utilisateur marque une case, une autre interaction Ajax aec le sereur Web est déclenchée. L'utilisateur peut lancer une action qui entraîne le déchargement de la page en cours, raisemblablement pour la remplacer par une autre page Web. Toutes ces demandes/réponses sont capturées par IBM Tealeaf CX Passie Capture Application. Lors de la relecture, IBM Tealeaf peut souent déduire quels formulaires sont remplis et associer les réponses Ajax aux demandes Ajax effectuées au cours de ce processus. Toutefois, sans la bibliothèque CX UI Capture j2, IBM Tealeaf n'a aucune isibilité sur les interactions entre l'application de page Web et le isiteur lorsque l'interaction n'a pas déclenché la transmission des données à partir du sereur Web. Comment CX UI Capture j2 capture les interactions Lorsque la bibliothèque CX UI Capture j2 est ajoutée à la page Web, le code de bibliothèque peut détecter les éénements d'interface utilisateur qui se produisent sur les diers éléments du modèle DOM (Document Object Model) de la page. CX UI Capture j2 est capable de capturer les éénements proenant de tous les cadres ou iframes qui partagent le même domaine que la page parent. Ainsi, lorsque l'utilisateur saisit du texte dans une zone, le code de bibliothèque détecte chaque éénement d'appui de touche dans la zone et la aleur de la touche actuelle, comme la lettre A. La bibliothèque stocke ces éénements dans une structure de données JSON temporaire en ue d'une éentuelle retransmission au 4 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

13 sereur Web. La bibliothèque peut ensuite être configurée pour enoyer ces données capturées au sereur Web, moyennant les conditions suiantes : A des interalles de temps prédéfinis. Lors de la capture d'un nombre d'éénements prédéfini. Lors du déchargement de la page (en général, la condition minimale). Chaque fois que le logiciel CX UI Capture j2 JaaScript publie des données sur le sereur Web, l'application IBM Tealeaf installée sur le sereur Web accuse réception de ces données. Cette réponse est également capturée par le sereur IBM Tealeaf CX Passie Capture Application, ce qui permet à la paire demande-réponse d'être enregistrée aec précision. Figure 2. Transactions Ajax et CX UI Capture j2 Ce diagramme affiche les interactions de l'exemple de page Web aec le sereur Web dans le temps, y compris les transactions Ajax de page Web et les pages Web ajoutées par CX UI Capture j2. Dans ce diagramme de séquence, l'application de page Web a effectué deux transactions Ajax suiies de deux transactions Ajax IBM Tealeaf. Le temps augmente du haut ers le bas. Remarque : Pour chaque action utilisateur, la solution CX UI Capture j2 soumet un message unique. Pour plus d'informations sur les interactions de page Web, oir Chapitre 2, «Installation et implémentation de CX UI Capture j2», à la page 9. Chapitre 1. IBM Tealeaf CX UI Capture j2 5

14 Comment CX UI Capture j2 relit les interactions capturées Pour relire une page Web, le logiciel de relecture d'ibm Tealeaf simule les interactions entre le naigateur et le isiteur et entre le naigateur et le sereur Web. Ces interactions sont présentées dans le diagramme ci-après. Figure 3. Scénario de relecture Le logiciel de relecture d'ibm Tealeaf charge la page capturée. Lorsque la page demande le fichier CX UI Capture j2 JaaScript, le logiciel de relecture fournit un autre ensemble de fichiers conçu pour la relecture. Ensuite, le logiciel de relecture met directement à jour l'état des diers objets sur la page en fonction des actions du isiteur. L'utilisateur d'ibm Tealeaf peut oir les mises à jour qui se produisent à la itesse de la relecture. Les mises à jour peuent prooquer l'exécution du fichier JaaScript sur la page, ce qui génère l'enoi des requêtes POST Ajax au sereur. Cette demande est interceptée et mappée à la demande et à la réponse précédemment capturées. La réponse est quant à elle enoyée au naigateur. Ainsi, le fichier JaaScript exécuté sur la page peut effectuer les mêmes actions qui se sont produites lors de la capture. Pour que la relecture mappe correctement la nouelle demande Ajax à la demande précédemment capturée, il faut la présence d'un identificateur unique pour la publication qui soit compatible entre l'instance capturée et l'instance relue. Vous pouez configurer des règles de mappage afin que les ariables de la demande puissent être ignorées ou utilisées pour correspondre à la demande capturée correctement. 6 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

15 Documentation connexe Un grand nombre de guides et de ressources sont disponibles afin de ous aider à prendre en charge l'implémentation de la solution IBM Tealeaf CX UI Capture j2. Tableau 1. Documentation de CX UI Capture j2 Document Description IBM Tealeaf Client Framework Data Integration Guide Guide d'ibm Tealeaf CX Mobile Android Logging Framework Lorsque ous aez déployé otre enironnement de client, des étapes de configuration supplémentaires peuent s'aérer nécessaires. Ce document de référence décrit la configuration de la capture des données dans IBM Tealeaf et le processus de mise à disposition des données pour la création d'éénements, permettant ainsi la recherche et la génération de rapports. Il est destiné aux administrateurs de IBM Tealeaf qui implémentent un enironnement de capture côté client IBM Tealeaf. Guide d'installation et d'implémentation d'ibm Tealeaf CX Mobile Android Logging Framework pour applications naties mobiles basées sur Android. Guide d'ibm Tealeaf CX Mobile ios Logging Framework Le déploiement nécessite la licence pour IBM Tealeaf CX Mobile. Guide d'installation et d'implémentation d'ibm Tealeaf CX Mobile ios Logging Framework pour applications naties mobiles basées sur ios. Le déploiement nécessite la licence pour IBM Tealeaf CX Mobile. Chapitre 1. IBM Tealeaf CX UI Capture j2 7

16 8 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

17 Chapitre 2. Installation et implémentation de CX UI Capture j2 Installation de la ersion Pour installer et implémenter CX UI Capture j2, Vous deez d'abord érifier la ersion des logiciels utilisés par le système. Aant de commencer l'installation et l'implémentation, reportez-ous aux instructions d'utilisation. Voir Chapitre 4, «Instructions d'utilisation de CX UI Capture j2», à la page 35. Aant de commencer l'implémentation de CX UI Capture j2, Vérifiez que ous disposez de la dernière ersion du logiciel. Vous pouez accéder au module d'installation ia IBM Passport Adantage Online. Cette section contient des informations sur l'implémentation de la bibliothèque IBM Tealeaf CX UI Capture j2. Remarque : Selon la complexité de otre application Web, l'implémentation de la bibliothèque IBM Tealeaf CX UI Capture j2 peut nécessiter la consultation des serices de conseil d'ibm. Pour plus d'informations, contactez les serices professionnels d'ibm. Prise en charge de CX RealiTea Viewer IBM Tealeaf CX RealiTea Viewer est une application de bureau autonome qui permet de relire des sessions capturées par IBM Tealeaf, notamment des éénements de l'interface utilisateur client. Pour relire des sessions qui incluent des éénements de l'interface utilisateur, ous deez installer CX RealiTea Viewer sur otre bureau local. Remarque : La relecture des sessions qui sont capturées par CX UI Capture j2 n'est pas prise en charge en totalité dans CX RealiTea Viewer. Les messages JSON contenant les éénements de l'interface utilisateur ne sont pas intégralement pris en charge dans CX RealiTea Viewer. Pour effectuer la relecture des messages JSON, utilisez la fonction de relecture sur naigateur. Voir "Relecture sur naigateur CX" dans le document IBM Tealeaf cximpact User Manual. Remarque : CX UI Capture j2 est compatible aec la ersion 8.6 et ultérieures, mais ne l'est pas aec les ersions antérieures. Prise en charge de la capture d'applications Web mobiles Pour pouoir capturer des données issues d'applications Web mobiles, une licence pour IBM Tealeaf CX Mobile est obligatoire. Voir "Versions de structure client" dans le document IBM Tealeaf Client Framework Data Integration Guide. Copyright IBM Corp. 1999,

18 Configuration de CX Passie Capture Application Par défaut, IBM Tealeaf CX Passie Capture Application capture de nombreux types MIME enoyés par les applications Internet enrichies. Selon le type d'application que ous déployez, ous pouez actier la capture d'autres types. IBM Tealeaf CX UI Capture j2 requiert que CX Passie Capture Application soit configuré pour actier la capture du contenu JSON dans la demande. Vous deez également configurer CX Passie Capture Application pour la capture du trafic de requêtes POST. CX Passie Capture Application peut être configuré pour inclure ou exclure des extensions de fichier, des types MIME et des types POST spécifiques. Remarque : Vérifiez que otre installation CX Passie Capture Application a été configurée pour capturer les types MIME JSON. Voir "Console Web de la PCA - Onglet Pipeline" dans le document CX Passie Capture Application CX Passie Capture Application Manual. Si des feuilles de style JaaScript ou CSS dynamiques doient être capturées, IBM Tealeaf CX Passie Capture Application doit être configuré pour capturer ce contenu. Eitez de capturer des ersions dynamiques de contenu généralement statique. Vous pouez aussi capturer ce contenu statique dans une archie statique. Voir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact Administration. Pour obtenir des descriptions des types de capture à actier pour diers types d'applications RIA, oir "Installation" dans le document IBM Tealeaf CX Passie Capture Application Manual. Pour plus d'informations sur la manière d'actier un type de capture dans la console Web CX Passie Capture Application, oir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf CX Passie Capture Application Manual. Plan d'installation et de déploiement CX UI Capture j2 peut être déployé rapidement dans des enironnements locaux à des fins de déeloppement et de test. Une fois que ous aez résolu tous les problèmes pouant être analysés en dehors de l'enironnement IBM Tealeaf, la bibliothèque peut être transférée ers un enironnement IBM Tealeaf pour plus de tests et de personnalisations. Etape 1 : Enironnement de déeloppement Dans l'enironnement de déeloppement, les objectifs du déploiement d'cx UI Capture j2 sont d'intégrer les fichiers requis dans l'infrastructure Web et d'établir une connectiité de base entre le sereur Web, le client et CX Passie Capture Application pour la capture. Fichier à ajouter à des pages Web Le fichier JaaScript CX UI Capture j2 doit être inclus dans chaque page Web de l'application que ous souhaitez sureiller. 10 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

19 Positionnement sur le sereur Sur otre sereur Web, placez le fichier JaaScript CX UI Capture j2 aec les autres fichiers statiques traités par otre site. Inclure l'emplacement Chaque page traitée nécessitant le suii d'éénement client doit comporter des balises <script> pour pouoir charger le fichier JaaScript CX UI Capture j2. Dans chaque page, le fichier JaaScript doit être inclus comme suit. <script src="/tealeaf.js" type="text/jaascript"></script> Si ous placez le fichier JaaScript IBM Tealeaf CX UI Capture j2 ailleurs que dans le répertoire racine sur otre sereur Web, ous deez ajuster le paramètre src= dans la référence pour le faire pointer ers l'emplacement approprié. Remarque : Vous n'êtes pas tenu de placer le fichier JaaScript CX UI Capture j2 en haut de la page. Voir Chapitre 1, «IBM Tealeaf CX UI Capture j2», à la page 1. Installation de CX UI Capture j2 Pour installer et déployer CX UI Capture j2, suiez la procédure ci-dessous. 1. Si ous ne l'aez pas déjà fait, configurez JaaScript. 2. Déployez la page cible IBM Tealeaf à l'emplacement où la bibliothèque est configurée afin de lui enoyer les fichiers. Voir «Page cible IBM Tealeaf», à la page Placez les fichiers JaaScript requis à l'emplacement du sereur Web approprié. Voir «Positionnement sur le sereur». 4. Modifiez les pages series pour faire référence aux fichiers JaaScript. Voir «Inclure l'emplacement». 5. Lorsque les fichiers JaaScript sont référencés dans les pages series et prêts à l'enoi dans la page cible, cela signifie que CX UI Capture j2 est opérationnel. Vérification de l'étape 1 Pour érifier que CX UI Capture j2 fonctionne correctement dans otre enironnement de déeloppement, ous pouez effectuer les tests suiants. Pas d'erreurs JaaScript sur la page A l'aide de otre naigateur Web, affichez un échantillon des pages series. Vérifiez que le code JaaScript inclus ne génère pas d'erreurs Jaascript. Vérification que les éénements client sont en cours de publication Déployez un outil de sureillance de naigateur, tel que Fiddler, HTTPWatch ou Firebug, pour érifier que les éénements client sont en cours de publication sur la page cible. Remarque : Les publications normales issues de CX UI Capture j2 sont asynchrones à une seule exception. Chapitre 2. Installation et implémentation de CX UI Capture j2 11

20 Dans le flux de trafic POST, recherchez les en-têtes de demande contenant X-Tealeaf et un message JSON tel que celui-ci : {"messageversion":" ","serialnumber":1,"sessions":... Le numéro de ersion change d'une édition à l'autre. Remarque : Si les données du programme UI Capture sont transférées ers IBM Tealeaf, ous pouez, par le biais du portail IBM Tealeaf, rechercher la page cible IBM Tealeaf pour érifier si des sessions sont extraites. Dans les enironnements de test et de production, utilisez le test de recherche dans le portail. Etape 2 : Enironnement de test Dans l'enironnement de test, les objectifs sont de déployer CX UI Capture j2 pour érifier l'opération correcte et sureiller de bout-en-bout les éénements de l'interface utilisateur, de sorte que ous puissiez rechercher, relire des éénements de l'interface utilisateur du client et générer des rapports les concernant. Configuration de l'enironnement de test La réalisation de tests de bout en bout requiert une configuration spécifique de otre enironnement de test. IBM Tealeaf CX Passie Capture Application CX Passie Capture Application doit être implémentée, actiée et opérationnelle. CX Passie Capture Application doit être configurée pour capturer les types de contenu appropriés. Voir "Versions de structure client" dans le document IBM Tealeaf Client Framework Data Integration Guide. Pour plus d'informations sur la configuration, oir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf CX Passie Capture Application Manual. Relecture sur naigateur Pour érifier la relecture des éénements de l'interface utilisateur, utilisez la fonction de relecture sur naigateur pour ous assurer que les éénements de l'interface utilisateur s'affichent dans le panneau de naigation. Voir «Relecture d'une session capturée dans BBR», à la page 13. Rechercher Vous deez être en mesure de rechercher et d'extraire des champs spécifiques de l'interface utilisateur client dans la demande. Des informations détaillées sont fournies ci-dessous. Vérifiez à l'aance la fonction de recherche de base dans le Portail et dans CX RealiTea Viewer. Génération de rapports Des éénements de l'interface utilisateur client peuent apparaître dans des rapports qui sont configurés par le biais du générateur de rapport d'ibm Tealeaf. Voir "Générateur de rapport Tealeaf" dans le document IBM Tealeaf cximpact Reporting Guide. Installation dans l'enironnement de test Pour procéder à l'installation et au déploiement dans l'enironnement de test, suiez la même procédure que celle utilisée dans l'enironnement de déeloppement, en modifiant si nécessaire les fichiers JaaScript pour qu'ils fonctionnent dans l'enironnement de test. Voir «Installation de CX UI Capture j2», à la page IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

21 Vérification de l'étape 2 Pour alider otre déploiement CX UI Capture j2 dans l'enironnement de test, effectuez les tests suiants. Génération d'une session comprenant des éénements d'interface utilisateur : A l'aide de otre naigateur Web, accédez à l'application Web qui est contrôlée par l'enironnement de test IBM Tealeaf. Conditions préalables N'utilisez pas de capture côté client pour effectuer ce test. Pour capturer et traiter les données, utilisez IBM Tealeaf. Accédez à une série de pages contenant des éénements d'interface utilisateur. Déclenchez tous les éénements d'interface utilisateur de test de façon à ce qu'ils soient inclus dans otre session capturée. Générez la session afin de disposer d'un moyen identifiable de manière unique pour rechercher la session ia la recherche. Au fur et à mesure que la session est générée, ous pouez utiliser l'outil Fiddler ou un outil similaire pour contrôler les données de la demande afin de localiser l'identificateur de la session IBM Tealeaf. Vous pouez également appliquer des astuces de naigation telles que l'insertion d'une chaîne unique dans un champ Formulaire et l'enoi de celle-ci. N'oubliez pas de fermer otre session afin qu'elle soit indexée pour la recherche. Relecture d'une session capturée dans BBR : Une fois que ous aez capturé une session, ous pouez la relire ia BBR (relecture basée sur naigateur) pour confirmer que les éénements d'interface utilisateur client sont présents. A partir du contrôle de la relecture, ous pouez ajuster les paramètres de configuration et déelopper des règles de relecture, après quoi ous pouez relire la session. Répétez ce processus jusqu'à ce que ous obteniez une relecture de bonne qualité de la session capturée. Remarque : La relecture des sessions capturées dans CX RealiTea Viewer n'est pas totalement prise en charge pour CX UI Capture j2, en fonction de otre application. A partir de la ersion 8.6 ou ultérieure, ous utilisez la fonction BBR pour la relecture. 1. Localisez la session à l'aide de la fonction de recherche. Voir "Recherche des données de session" dans le document IBM Tealeaf cximpact User Manual. 2. Relisez la session en mode BBR. 3. Passez à la ue de la demande. 4. Faites défiler les pages de la session. 5. En haut du panneau d'affichage, le lien suiant s'affiche. Cliquez ici pour afficher les attributs de l étape. 6. Ce lien indique que les données JSON ont été capturées dans le cadre de la session, ce qui signifie que CX UI Capture j2 les a soumises correctement. Vous pouez cliquer sur le lien pour consulter les données JSON dans un format lisible. Chapitre 2. Installation et implémentation de CX UI Capture j2 13

22 Dans cette zone, ous pouez créer les éénements IBM Tealeaf et les attributs d'étape des données. Voir «Création d'éénements IBM Tealeaf pour les données de l'interface utilisateur client». Lorsque les éénements IBM Tealeaf sont créés à partir des données JSON, ils sont marqués dans les sessions suiantes qui sont capturées par IBM Tealeaf. Vous pouez ensuite les rechercher à l'aide de l'interface du portail. Voir "Recherche des données de session" dans le document IBM Tealeaf cximpact User Manual. 7. Pour optimiser la relecture, ous pouez créer des règles de relecture ou modifier os règles existantes afin de gérer correctement la relecture des sessions qui sont capturées par IBM Tealeaf CX UI Capture j2. Voir «Modification des règles de relecture». 8. Une fois que les éénements IBM Tealeaf sont créés, ous pouez créer des rapports dans IBM Tealeaf Report Builder aec ces éénements pour commencer à effectuer le suii des éénements côté client. Voir «Vérification de la génération de rapports du portail IBM Tealeaf», à la page 15. Création d'éénements IBM Tealeaf pour les données de l'interface utilisateur client : Après l'implémentation de CX UI Capture j2, ous pouez tester la disponibilité des données pour la création d'éénements à l'aide de la relecture sur naigateur. La relecture sur naigateur permet la création d'attributs et d'éénements à partir des étapes JSON qui sont soumises depuis les infrastructures client IBM Tealeaf. Grâce à ce mécanisme simple, ous pouez créer rapidement les attributs et les éénements d'étape qui sont nécessaires pour capturer le trafic de l'interface client, tel que soumis par CX UI Capture j2. Voir "Eénements basés sur des étapes" dans le document IBM Tealeaf Eent Manager Manual. Remarque : Si ous effectuez une mise à nieau à partir d'une ersion ou antérieure d'ui Capture, les zones de demande suiantes ne sont pas remplies par cette ersion d'ui Capture : TLT_CUI_URL TLT_CUI_APPLICATION_NAME Tous les modèles d'éénement, d'indexation ou de recherche configuré, basé sur la présence de ces zones de demande, ne fonctionnent pas pour CX UI Capture j2. Pour plus d'informations sur les éénements, oir "Onglet Eénements TEM" dans le document IBM Tealeaf Eent Manager Manual. Pour plus d'informations sur l'indexation, oir "Configuration de l'indexation CX" dans le document IBM Tealeaf CX Configuration Manual. Pour plus d'informations sur la configuration des modèles de recherche, oir "Configuration des modèles de recherche" dans le document IBM Tealeaf cximpact Administration Manual. Modification des règles de relecture : L'affichage correct des éénements de l'interface utilisateur client passe souent par la définition de règles de relecture. Une règle de relecture est une action qui est appliquée aux données de session aant la relecture dans le but d'améliorer l'expérience de relecture. 14 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

23 Remarque : Les règles de relecture sont stockées dans un profil utilisateur. Lorsque CX UI Capture j2 est déployé dans un enironnement de production, ce profil est mis à la disposition de tous les utilisateurs de CX RealiTea Viewer et de la fonction de relecture sur naigateur. Voir «Déploiement du profil». Les règles de relecture peuent être appliquées par le biais de la fonction de relecture sur naigateur. Voir "Règles de relecture sur naigateur" dans le document IBM Tealeaf cximpact User Manual. Répétition des tests : Répétez les tests indiqués dans cette section jusqu'à ce que ous obteniez une relecture satisfaisante. Pour répéter le processus, oir «Relecture d'une session capturée dans BBR», à la page 13. Vérification de la génération de rapports du portail IBM Tealeaf : Vous pouez consulter les rapports suiants pour érifier que des éénements de l'interface utilisateur client ont bien été enoyés à IBM Tealeaf et soumis aux bases de données de génération de rapports. Après aoir créé un éénement IBM Tealeaf à l'aide de la fonction Eénements basés sur des étapes de BBR, attendez au moins 1 heure que les données de rapport soient collectées. Dans le générateur de rapport IBM Tealeaf, ous pouez ensuite créer un rapport simple contenant otre éénement et ciblé sur la date actuelle. Si des données sont présentes, les fonctions de génération de rapports sont acties pour les données CX UI Capture j2. Voir "Générateur de rapport Tealeaf" dans le document IBM Tealeaf cximpact Reporting Guide. Etape 3 : Enironnement de production Lorsque ous aez terminé tous les tests dans otre enironnement de test, ous pouez déployer la solution CX UI Capture j2 dans otre enironnement de production. Déploiement du profil Si ous déeloppez des règles de profil ou modifiez des paramètres CX RealiTea Viewer dans otre enironnement de test, mettez ces modifications à la disposition de tous les utilisateurs CX RealiTea Viewer et BBR pouant accéder à l'enironnement de production. Pour plus d'informations sur le partage de otre profil CX RealiTea Viewer, oir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf CX RealiTea Viewer User Manual. Dans le cas de la fonction BBR (relecture sur naigateur), les paramètres du profil de relecture sont configurés pour chaque groupe d'utilisateurs pour les utilisateurs IBM Tealeaf cximpact ou IBM Tealeaf cxreeal. Pour plus d'informations, oir Profil de relecture du naigateur dans la section "Administration des utilisateurs CX" du document IBM Tealeaf cximpact Administration Manual. Chapitre 2. Installation et implémentation de CX UI Capture j2 15

24 Pour plus d'informations, oir Profil de relecture du naigateur dans la section "Administration des utilisateurs cxreeal" du document IBM Tealeaf cxreeal Administration Manual. Installation dans l'enironnement de production Pour procéder à l'installation et au déploiement dans l'enironnement de production, suiez la même procédure que celle utilisée dans l'enironnement de déeloppement, en modifiant si nécessaire le fichier JaaScript pour qu'il fonctionne dans un enironnement de production. Voir «Installation de CX UI Capture j2», à la page 11. Vérification de l'étape 3 Répétez tous les tests que ous aez effectués dans l'enironnement de déeloppement et de test dans l'enironnement de production. «Vérification de l'étape 1», à la page 11 «Vérification de l'étape 2», à la page 13 Configuration du code JaaScript Interactions de CX UI Capture j2 JaaScript aec les pages d'application Web IBM Tealeaf CX UI Capture j2 JaaScript est capable de sureiller les éénements de l'interface utilisateur en connectant les programmes d'écoute des éénements de claier et de souris aux éléments HTML des pages de otre application Web. Remplacement de l'api existante Dans certains cas, IBM Tealeaf remplace l'api de naigateur existante. A l'heure actuelle, ce comportement se produit pour l'éénement suiant. window.onerror IBM Tealeaf remplace le gestionnaire de l'éénement Window.onerror par défaut pour effectuer le suii des conditions d'erreur côté client qui ne génèrent pas une transaction aec le sereur Web. La bibliothèque IBM Tealeaf CX UI Capture j2 n'effectue ce remplacement que s'il n'y a aucun programme d'écoute en cours de window.onerror. Blocage des zones de données sensibles Si nécessaire, les informations sensibles enoyées par les isiteurs dans des formulaires côté client peuent être bloquées dans les données JSON qui sont soumises à IBM Tealeaf. Par exemple, si un isiteur saisit un numéro de sécurité sociale dans un champ de formulaire, ous pouez configurer des règles de blocage de champ afin de bloquer le numéro de sécurité sociale saisi (par exemple, Xxx-XX-XXXX). La section suiante décrit le fonctionnement de la confidentialité dans IBM Tealeaf CX UI Capture j2. L'implémentation de otre configuration de confidentialité s'effectue dans le cadre de l'installation initiale. Pour plus d'informations, contactez les serices professionnels d'ibm. 16 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

25 Installation sur des pages Web Si ous enisagez d'installer la bibliothèque CX UI Capture j2, sachez qu'elle sollicite beaucoup des ressources système pour s'exécuter sur le site Web et les systèmes de capture IBM Tealeaf. Installez-la uniquement sur les pages que ous souhaitez capturer et relire. L'installation de la bibliothèque CX UI Capture j2 peut aoir les effets suiants : Les temps de chargement des pages peuent augmenter légèrement au cours du premier téléchargement. IBM Tealeaf propose des stratégies permettant de réduire l'effet sur les temps de chargement, notamment la mise en mémoire cache de JaaScript après le téléchargement initial. Des données supplémentaires sont transmises par la page Web au sereur, mais elles ne sont pas traitées. IBM Tealeaf doit traiter et stocker ces données supplémentaires. IBM Tealeaf CX UI Capture j2 est conçu pour réduire ces charges. ID HTML uniques Pour pouoir capturer les éénements client pour un objet DOM (Document Object Model), chaque objet ou contrôle disponible aec lequel le isiteur peut interagir doit posséder un ID HTML unique. Sans lui, IBM Tealeaf ne peut pas relire correctement les éénements de l'interface utilisateur dans la page. Si ous n'aez pas configuré otre application de manière à prendre en charge les ID uniques ou les noms uniques dans le modèle d'objet de document, IBM Tealeaf CX UI Capture j2 génère automatiquement des chemins ers le noeud qui acceptent le critère d'unicité. IBM Tealeaf prend également en charge la création de listes noires d'id, qui force l'utilisation des aleurs d'attribut de nom ou de chemin XPath en tant qu'identificateurs. Voir Chapitre 5, «Référence de CX UI Capture j2», à la page 45. Cookies La session Web doit utiliser des cookies pour la mise en sessions. Les cookies permettent aux éénements client d'enoyer des messages sans aoir à comprendre le mécanisme de mise en sessions. Pour optimiser les résultats de la capture des éénements d'interface utilisateur client, déployez l'injecteur de cookies IBM Tealeaf dans otre enironnement de sereur Web. L'injecteur de cookies IBM Tealeaf fournit des ID de session uniques concernant les données de session IBM Tealeaf capturées. Voir "Installation et configuration de l'injecteur de cookies Tealeaf" dans le document IBM Tealeaf CX Cookie Injector Manual. Installation sur le sereur Web La bibliothèque IBM Tealeaf CX UI Capture j2 est constituée d'un fichier JaaScript unique. Vous deez placer ce fichier JaaScript aec les autres fichiers statiques seris par otre site. Références au fichier JaaScript Pour effectuer le suii des actiités sur une page Web, ous deez ajouter une référence au fichier JaaScript CX UI Capture j2 requis. Chapitre 2. Installation et implémentation de CX UI Capture j2 17

26 Chaque page traitée nécessitant le suii d'éénement client doit contenir les balises <script> pour charger le fichier JaaScript IBM Tealeaf CX UI Capture j2 : <script src="/tealeaf.js" type="text/jaascript"></script> Si ous placez le fichier JaaScript CX UI Capture j2 ailleurs que dans le répertoire racine sur otre sereur Web, modifiez le paramètre src= dans la référence pour qu'il pointe sur l'emplacement correct. Voir "Présentation d'ui Capture j2". Page cible IBM Tealeaf La page cible IBM Tealeaf est une adresse URL à laquelle CX UI Capture j2 JaaScript doit enoyer les demandes POST pour qu'elles soient capturées par le système IBM Tealeaf. Vous pouez placer cette page dynamique aec les autres fichiers de page dynamique de otre application Web. Cette page Web cible dynamique doit être enoyée ou créée pour receoir les informations transmises par JaaScript, par exemple, Tealeaftarget.php, Tealeaftarget.jsp, Tealeaftarget.asp ou similaire. Remarque : La page cible n'existe que pour accuser réception de l'enoi. Aucune donnée n'est enregistrée. Le sereur Web renoie une réponse alide minimale, telle que le message suiant. <html><head></head><body>receied 895 bytes in 0.1 ms</body></html> Placez la page cible dynamique aec les autres fichiers de page dynamique. Pour simplifier les opérations, ous pouez placer ces fichiers dans le répertoire principal. Votre administrateur de site Web peut ous communiquer les règles et les procédures relaties à otre installation. Des exemples de cible pour les enironnements ASPX, JSP et PHP sont fournis aec la distribution d'cx UI Capture j2. Modifiez la page cible pour otre enironnement cible spécifique. Utilisez ces exemples de cible comme base de création des pages cible adaptées pour d'autres enironnements. Vérification de la page cible Toutes les pages cible IBM Tealeaf fournies sont nommées de telle sorte que les données qu'elles reçoient puissent être capturées, traitées et intégrées dans la relecture par IBM Tealeaf. Remarque : Le nom de fichier de la page cible IBM Tealeaf doit inclure TealeafTarget afin de faciliter l'identification. Ne modifiez pas ce nom de fichier après aoir configuré IBM Tealeaf CX UI Capture j2. Effectuez les étapes suiantes pour érifier qu'il n'y a pas d'obstacle à la capture et au traitement de la page cible IBM Tealeaf dans otre système. 1. Dans la console Web d'ibm Tealeaf CX Passie Capture Application, ous pouez configurer les extensions de fichier à éliminer de la capture. Vérifiez que l'extension de fichier utilisée pour otre page cible IBM Tealeaf n'est pas éliminée de la capture. Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf CX Passie Capture Application Manual. 18 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

27 2. Dans IBM Tealeaf CX RealiTea Viewer, certaines extensions de fichier sont traitées comme des pages interprétées, ce qui signifie que les pages sont interprétées sur le sereur Web aant d'être distribuées à CX RealiTea Viewer. Vérifiez que l'extension du nom de fichier de la page cible IBM Tealeaf n'apparaît pas dans la liste des pages possibles interprétées dans CX RealiTea Viewer. Voir "RealiTea Viewer - Onglets Options aancées" dans le document IBM Tealeaf CX RealiTea Viewer User Manual. Installation de la page cible Vous deez ajouter la page cible à otre infrastructure Web, dans un emplacement accessible à partir du naigateur Web du isiteur. Pour simplifier les opérations, ous pouez placer ces fichiers dans le répertoire racine ou dans un répertoire central JaaScript. Votre administrateur de site Web peut ous communiquer les règles et les procédures relaties à otre installation. Dans les pages de otre application Web, les références à la page cible doient être relaties au chemin d'accès de la racine du site. Dans le cas de l'exemple pour faire référence à une page cible IBM Tealeaf à l'adresse ous deez configurer IBM Tealeaf CX UI Capture j2 sur /scripts/tealeaftarget.aspx. La barre oblique / initiale en fait un chemin d'accès relatif à la racine du site. Instructions de déploiement Utilisez ces instructions lorsque ous déployez la page cible d'ibm Tealeaf. En général, la page cible d'ibm Tealeaf est déployée indépendamment de l'application de base elle-même en termes logiques et physiques. Passez en reue ces instructions aec l'équipe chargée de l'infrastructure. Eitez de déployer la page cible d'ibm Tealeaf derrière les fonctions de sécurité de l'entreprise, telles que SiteMinder. Dans la mesure du possible, déployez la page cible d'ibm Tealeaf sur une instance du sereur d'application distincte à partir de l'application Web. Bien qu'il s'agisse d'un déploiement léger, ce processus peut entrer en compétition aec l'application Web lors de l'acquisition des ressources. Par conséquent, effectuez si possible le déploiement sur une instance de sereur d'application dédiée. Effectuez des tests approfondis de la page cible d'ibm Tealeaf dans un enironnement de test aant tout déploiement en production. Références à la page cible Dans les pages de otre application Web, les références à la page cible IBM Tealeaf doient être relaties au chemin d'accès de la racine du site. Dans le cas de pour faire référence à une page cible IBM Tealeaf à l'adresse ous deez configurer la bibliothèque CX UI Capture j2 pour la publication ers /scripts/ TealeafTarget.aspx. Les caractères "/" initiaux en font un chemin d'accès relatif à la racine du site. Dans le fichier JaaScript CX UI Capture j2, l'url de la page cible est configurée dans le cadre de l'implémentation initiale. Chapitre 2. Installation et implémentation de CX UI Capture j2 19

28 Tests d'unité de la page cible Pour érifier que la page cible fonctionne correctement, ous pouez exécuter les tests ci-dessous. GET : Entrez l'adresse URL de la page cible dans otre naigateur. Si une page blanche ou une erreur qui n'est pas l'erreur 404 s'affiche, la page traite correctement otre demande. POST : Utilisez l'outil Fiddler ou un autre outil de sureillance du trafic pour générer une publication sur la page. Vérifiez que l'action POST a prooqué l'affichage d'un message de code d'état 200. Configuration du fichier CX UI Capture j2 JaaScript Pour configurer le fichier JaaScript pour IBM Tealeaf CX UI Capture j2, ous deez définir des paramètres de compression et de mise en cache. Compression Pour obtenir des performances optimales, compressez le fichier IBM Tealeaf JaaScript sur otre sereur Web. Configurez le sereur Web pour effectuer le codage de la compression des données de réponse aant qu'elles soient renoyées au naigateur, qui les décompresse pour une utilisation sur le client. Appliquez le codage de la compression au contenu du texte statique, notamment au fichier IBM Tealeaf JaaScript. Remarque : Comme ce comportement est négocié entre le sereur et le client, un sereur Web compatible aec HTTP 1.1 ne doit utiliser aucun codage de compression, sauf si le client a précisé que le codage était pris en charge dans un en-tête de demande (Accept-Encoding). Ce type de compression réduit la taille du fichier IBM Tealeaf JaaScript d'eniron 75 % aant la distribution au client. Mise en cache du naigateur Pour effectuer la configuration de la mise en cache du naigateur, suiez les instructions ci-dessous. Affectez aux aleurs TTL des en-têtes Expires ou Cache-Control du fichier IBM Tealeaf JaaScript la même aleur que les autres scripts qui sont stockés sur le sereur Web. Tirez parti de la fonction GET conditionnelle de HTTP 1.1 en configurant otre sereur Web de sorte à définir les en-têtes ETag ou Last-Modified appropriés. Lorsque cette fonction est actiée, toutes les modifications apportées aux ressources JaaScript sont automatiquement propagées à la mémoire cache du isiteur. Pour plus d'informations, reportez-ous à ces ressources industrielles IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

29 Configuration du serice IIS Sous Windows Serer 2003, placez les fichiers IBM Tealeaf CX UI Capture j2 dans un répertoire aec les autres fichiers JaaScript afin d'être en conformité aec le paramètre "Script source access" de la configuration. Pour plus d'informations sur la configuration d'iis, oir support.microsoft.com/default.aspx?scid=kb;en-us; Configuration d'un sereur Web non-iis Dans le cas d'un sereur non-iis, une page Web dynamique doit être créée pour accepter la demande POST d'ibm Tealeaf CX UI Capture j2 JaaScript. Le contenu de la page Web arie en fonction de la technologie déployée. Modifications de pages Web Le contenu des demandes POST d'ui Capture JaaScript renoyées est inapproprié. Pour réduire la bande passante, diminuez le contenu du retour. Chaque page traitée nécessitant le suii des éénements client doit contenir une balise <script> afin de charger le fichier IBM Tealeaf CX UI Capture j2 JaaScript. Voir «Inclure l'emplacement», à la page 11. Gestion des modifications des éléments DOM Dans certains cas, lorsque otre application Web modifie le modèle d'objet de document, otre code de page doit signaler à IBM Tealeaf l'emplacement où les modifications ont été effectuées. Dans le cas des mises à jour de type Ajax, DHTML ou JaaScript qui se traduisent par l'ajout ou l'édition d'éléments DOM, la page dans laquelle les modifications sont effectuées doit appeler l'api IBM Tealeaf suiante, TLT.rebind, pour enregistrer la modification du noeud. Remarque : Cet appel doit être effectué lors de l'ajout de noueaux noeuds pour lesquels la capture de l'interaction d'utilisateur est essentielle. Les suppressions de noeud peuent être traitées au cours des opérations de nettoyage normales, lorsque la page est déchargée. Exemple de code : <html> <head> <title>rebind example</title> <script type="text/jaascript">... /* AJAXUpdate will be called after the XMLHttpRequest returns * a successful response. */ function AJAXUpdate(responseMarkup){ ar targetdi = document.getelementbyid("target_di"); if (!targetdi!responsemarkup) { return; targetdi.innerhtml = responsemarkup; if (TLT && TLT.rebind) { // Notify Tealeaf of the DOM update. Chapitre 2. Installation et implémentation de CX UI Capture j2 21

30 TLT.rebind(targetDi);... </script> </head> <body> <di id="target_di">placeholder where the AJAX response markup will be placed. </di> </body> </html> Mise à nieau de CX UI Capture j2 Pour plus d'informations sur la mise à nieau ers la dernière ersion d'ibm Tealeaf CX UI Capture j2, contactez les serices professionnels d'ibm. Prise en charge des en-têtes existants Lorsque des clients effectuent une mise à nieau d'ibm Tealeaf CX UI Capture for AJAX ers IBM Tealeaf CX UI Capture j2, la prise en charge de certains des en-têtes existants soumis à partir de CX UI Capture for AJAX est conserée. En-tête Description X-TeaLeafType Type d'ensemble d'éénements côté client. La aleur par défaut est GUI. X-TeaLeaf-Page-Url URL complète de la page parente. X-TeaLeaf-Page-Render Délai d'affichage de la page, en millisecondes. X-TeaLeaf-Page-Objects Nombre d'objets (balises d'objet) sur la page. X-TeaLeaf-Page-Img-Fail Nombre d'images incorrectes sur la page. X-TeaLeaf-Page-Cui-Exceptions Nombre d'exceptions sur la page. X-TeaLeaf-Page-Dwell Temps de passage sur la page. X-TeaLeaf-Page-Last-Field ID du dernier champ de formulaire isité sur la page. X-TeaLeaf-Visit-Order Ordre de isite des champs de formulaire sur la page. Remarque : Les autres en-têtes qui sont soumis ia IBM Tealeaf CX UI Capture for AJAX ne sont pas pris en charge. Pour plus d'informations sur ces en-têtes, oir "Exemple de message d'éénement client UI Capture for AJAX" dans le document IBM Tealeaf CX UI Capture for AJAX Guide. 22 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

31 Désinstallation de CX UI Capture j2 Pour désinstaller CX UI Capture j2, appliquez les modifications suiantes dans otre enironnement de déeloppement. 1. Enregistrez une copie de CX UI Capture j2 JaaScript qui est actuellement déployé. Si ous aez réduit JaaScript, enregistrez une ersion de JaaScript source. 2. Supprimez les références <include> aux fichiers CX UI Capture j2 à partir des pages de otre application Web. 3. Supprimez les fichiers CX UI Capture j2 de la zone dans laquelle ils sont installés sur otre sereur web. 4. Supprimez la page cible IBM Tealeaf. 5. Enoyez les modifications au sereur. 6. Vérifiez qu'aucune erreur de naigateur n'est générée dans les naigateurs des isiteurs lorsque ous accédez à otre propre application Web. 7. Vérifiez que les éénements IBM Tealeaf CX UI Capture j2 ne sont plus capturés et traités par IBM Tealeaf. 8. Désactiez tous les objets d'éénement IBM Tealeaf faisant référence à des éénements de l'interface utilisateur capturés par IBM Tealeaf CX UI Capture j2. Si les modifications sont correctement appliquées dans l'enironnement de déeloppement, ous pourrez ensuite les appliquer dans les enironnements de production et de test. Chapitre 2. Installation et implémentation de CX UI Capture j2 23

32 24 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

33 Chapitre 3. Assistant de configuration de CX UI Capture j2 L'assistant de configuration ous permet d'exécuter les tâches de configuration nécessaires pour modifier otre solution IBM Tealeaf CX UI Capture j2 afin qu'elle fonctionne aec otre application Web. Grâce à son interface basée sur des étapes, ous pouez configurer IBM Tealeaf CX UI Capture j2. Les changements de configuration seront alors appliqués au JaaScript dans otre enironnent. Utilisez l'assistant de configuration uniquement pour effectuer une configuration de base de CX UI Capture j2. L'assistant de configuration est uniquement conçu comme un point de départ et ne fournit pas d'options de configuration détaillée pour optimiser l'installation. Pour les implémentations complètes, contactez les serices pour professionnels d'ibm ou sollicitez un déeloppeur Web compétent. L'assistant de configuration est disponible dans le module d'installation qui se troue dans le répertoire de l'assistant. Dans l'assistant, ous pouez accéder à la documentation spécifique au contexte en cliquant sur l'icône Aide ( ) qui se troue en regard des options disponibles. Naigateurs pris en charge Remarque : Pour la ersion 8.6 et ultérieures, ous deez utiliser CX UI Capture j2, la nouelle ersion du SDK d'ui Capture. L'assistant de configuration IBM Tealeaf CX UI Capture j2 est pris en charge dans Chrome et Firefox 10 et ersions ultérieures. Internet Explorer n'est pas pris en charge. Commandes de l'assistant de configuration Dans l'assistant de configuration de CX UI Capture j2, les différentes actions sont effectuées à l'aide des commandes de l'interface utilisateur. Pour passer à l'écran suiant de l'assistant, cliquez sur Suiant. Pour reenir à l'écran précédent, cliquez sur Précédent. Pour terminer la configuration, cliquez sur Terminer. Pour rétablir les aleurs de configuration fournies par Tealeaf, cliquez sur Rétablir les aleurs par défaut. Pour définir et tester des expressions régulières à utiliser dans otre configuration, cliquez sur Testeur RegEx. Voir «Testeur RegEx», à la page 33. Pour plus d'informations sur chaque paramètre de configuration, cliquez sur l'icône Aide ( ) située en regard du paramètre. Copyright IBM Corp. 1999,

34 Types de ersion Par défaut, l'assistant de configuration génère le code JaaScript d'ibm Tealeaf CX UI Capture j2 pour une utilisation dans un enironnement de production. Selon l'état de otre déeloppement, ous pouez sélectionner un autre type de ersion dans l'assistant de configuration. Les ersions de production du code JaaScript sont réduites, ce qui signifie ceci : Les commentaires et autres éléments textuels non fonctionnels sont supprimés. Les noms de ariable sont réduits aux fichiers les plus petits possibles. Le contenu JaaScript global est réduit pour simplifier les besoins de bande passante. Le code n'est plus lisible facilement. Les autres types de ersion sont décrits ci-dessous. Type de build Description Production build (minified) Paramètre par défaut. Production build (non-minified) Toutes les options de ersion de production sont appliquées. Toutefois, comme le code JaaScript n'est pas réduit, ous pouez réiser le code déployé. Deelopment build (non-minified) Du code de débogage supplémentaire est actié. Remarque : Cette option est principalement destinée aux déeloppeurs et aux utilisateurs cheronnés de la bibliothèque qui souhaitent déboguer le code. Ne déployez pas ce type de ersion en production. Remarque : Si ous déeloppez et testez otre solution IBM Tealeaf CX UI Capture j2, sélectionnez l'option Production build (non-minified). 26 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

35 Etape 1 : Configuration du serice du naigateur Au cours de cette étape, ous allez configurer le serice du naigateur qui permet de sureiller des objets du naigateur. Vous pouez choisir jquery ou W3C. Selon otre sélection, différentes options s'affichent sous la section Options aancées. Si ous choisissez jquery, les Options aancées suiantes sont disponibles. Objet jquery : Ajoutez un chemin d'accès à l'objet jquery. Eléments sur liste noire : Mettez sur liste noire tous les ID d'élément qui ne sont ni uniques ni générés dynamiquement. Les ID d'élément qui correspondent à l'une des entrées sur liste noire sont remplacés par des aleurs d'attribut personnalisées ou des expressions XPATH. ID d'attribut personnalisé : Ajoutez un ou plusieurs noms d'attribut utilisables pour identifier de manière unique un élément lorsque son ID HTML n'est pas disponible ou sur liste noire. Liens exclus par Internet Explorer : Cette configuration est définie sous la forme d'un tableau de sélecteurs CSS. Par exemple, la configuration sera sous la forme ieexcludedlinks: [ a.ignore ], pour ignorer la commande beforeunload déclenchée par le lien < a href = jaascript:process(); class= ignore >Click< /a>. Si ous choisissez W3C, les Options aancées suiantes sont disponibles. Remarque : Lorsque ous utilisez W3C, si otre site Web contient des cadres imbriqués, les actions exécutées dans ce type de cadre aec un naigateur Internet Explorer ne sont ni signalées ni capturées actuellement. URL Sizzle : Ajoutez l'adresse URL de Sizzle. Sizzle est requis pour que la bibliothèque fonctionne correctement dans les naigateurs Internet Explorer aec le serice W3C. Objet Sizzle : Ajoutez le chemin d'accès à l'objet Sizzle. Eléments sur liste noire : Mettez sur liste noire tous les ID d'élément qui ne sont ni uniques ni générés dynamiquement. Les ID d'élément correspondant à l'une des entrées sur liste noire sont remplacés par des aleurs d'attribut personnalisées ou des expressions XPATH. Chapitre 3. Assistant de configuration de CX UI Capture j2 27

36 ID d'attribut personnalisé : Ajoutez un ou plusieurs noms d'attribut utilisables pour identifier de manière unique un élément lorsque son ID HTML n'est pas disponible ou sur liste noire. Liens exclus par Internet Explorer : Cette configuration est définie sous la forme d'un tableau de sélecteurs CSS. Par exemple, la configuration sera sous la forme ieexcludedlinks: [ a.ignore ], pour ignorer la commande beforeunload déclenchée par le lien < a href = jaascript:process(); class= ignore >Click< /a>. Pour l'option Liens exclus par Internet Explorer, la aleur Sélecteur CSS génère une exception dans les naigateurs Chrome et Webkit si un caractère non alide (par exemple, $) est spécifié sans le caractère d'échappement \. Exemple : { //Name Value Blocking "targets": ["input[name=login\\$password]"], "masktype" : 2 //Replace with XXX s Pour plus d'informations sur chaque paramètre, cliquez sur de configuration. dans l'assistant Des informations supplémentaires sont disponibles dans la section de référence. Voir Chapitre 5, «Référence de CX UI Capture j2», à la page 45. Etape 2 : Configuration du serice de file d'attente Au cours de cette étape, ous allez configurer la file d'attente de messages utilisée pour stocker les messages JSON localement aant que ceux-ci soient soumis à la page cible d'ibm Tealeaf pour la capture et le traitement. Vous ne pouez configurer qu'une seule file d'attente, impératiement nommée DEFAULT. Mettez à jour le champ Noeud final en indiquant l'url de la page cible. Mettez à jour le champ Taille en respectant la limite sur le nombre de messages autorisés dans la file d'attente aant l'enoi de cette dernière. Par défaut, les messages sont mis en file d'attente localement dans le naigateur du isiteur. Lorsque la file d'attente atteint un certain nombre de messages, les données qu'elle contient sont sérialisées et soumises à la page cible d'ibm Tealeaf, ce qui permet à IBM Tealeaf de capturer et de traiter les messages. Pour permettre l'exploration fictie, ous pouez définir l'interalle du temporisateur de manière à ider régulièrement la file d'attente quel que soit le nombre de messages. Dans la plupart des cas, il est préférable de conserer cette option désactiée. Vous pouez sélectionner Autoriser les requêtes POST interdomaine et Autoriser les requêtes XHR asynchrones au déchargement de la page pour actier ces options. Remarque : L'autorisation des requêtes asynchrones au déchargement de la page peut se traduire par des données incomplètes ou manquantes. 28 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

37 Cliquez sur paramètre. dans l'assistant de configuration pour plus de détails sur chaque Des informations supplémentaires sont disponibles dans la section de référence. Voir Chapitre 5, «Référence de CX UI Capture j2», à la page 45. Etape 3 : Configuration du serice de message (configuration du masquage de la confidentialité) Au cours de cette étape, ous allez configurer les paramètres de confidentialité de sorte que les données sensibles détectées sur le client soient bloquées ou masquées aant d'être soumises à IBM Tealeaf pour la capture. La configuration de la confidentialité ia IBM Tealeaf CX UI Capture j2 permet de s'assurer que les données sensibles ne touchent jamais IBM Tealeaf. IBM Tealeaf fournit plusieurs méthodes permettant d'appliquer la confidentialité dans l'ensemble de la solution IBM Tealeaf. Voir "Gestion de la confidentialité des données dans Tealeaf CX" dans le document IBM Tealeaf CX Installation Manual. Dans l'assistant de configuration, ous pouez configurer plusieurs masques de confidentialité. Chaque configuration de masque de confidentialité comprend au moins une cible, ce qui inclut les paramètres ID, Types d ID et Sélecteur CSS. Chaque configuration de masque de confidentialité comprend également un Type de masque. Pour supprimer une cible dans une configuration de masque de confidentialité, cliquez sur Supprimer la cible. Pour supprimer une configuration de masque de confidentialité complète, cliquez sur Supprimer la configuration de confidentialité. Les masques de confidentialité ides que ous ajoutez dans l'assistant ne sont pas ajoutés dans le fichier de configuration. La aleur que ous entrez pour Sélecteur CSS génère une exception dans les naigateurs Chrome et Webkit si un caractère non alide (par exemple, $) est spécifié sans le caractère d'échappement \. Exemple : Chapitre 3. Assistant de configuration de CX UI Capture j2 29

38 { //Name Value Blocking "targets": ["input[name=login\\$password]"], "masktype" : 2 //Replace with XXX s Vous aez la possibilité de masquer les zones de mot de passe si ous utilisez le fichier defaultconfiguration.js et définissez la ligne input type=password fields. Si ous utilisez l'assistant de configuration, ous pouez masquer les zones de mot de passe en ajoutant explicitement les éléments suiants dans la configuration de la confidentialité. { targets: [ // CSS Selector: All password input fields "input[type=password]" ], "masktype": 3 Des informations supplémentaires sont disponibles dans la section de référence. Voir Chapitre 5, «Référence de CX UI Capture j2», à la page 45. Pour plus d'informations sur chaque paramètre, cliquez sur de configuration. dans l'assistant Etape 4 : Sérialiseur Au cours de cette étape, ous pouez choisir d'utiliser un programme d'analyse syntaxique/sérialiseur intégré s'il n'y en a pas de disponible. Ajoutez des analyseurs syntaxiques qui contiennent des fonctions utilisables par CX UI Capture j2 (par exemple, JSON.parse). Le premier programme d'analyse syntaxique est le plus important. Si CX UI Capture j2 ne le troue pas, CX UI Capture j2 essaie à noueau, et ainsi de suite. Ajoutez des sérialiseurs qui contiennent des fonctions utilisables par CX UI Capture j2 (par exemple, JSON.stringify). Le premier sérialiseur est le plus important. Si CX UI Capture j2 ne le troue pas, CX UI Capture j2 essaie à noueau, et ainsi de suite. 30 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

39 Pour plus d'informations sur chaque paramètre, cliquez sur de configuration. dans l'assistant Etape 5 : Modules Des informations supplémentaires sont disponibles dans la section de référence. Voir Chapitre 5, «Référence de CX UI Capture j2», à la page 45. Au cours de cette étape, ous allez sélectionner les modules à actier dans otre solution IBM Tealeaf CX UI Capture j2, puis définir des options aancées pour chacun d'entre eux. Vous pouez également ajouter des éénements de relecture personnalisés. Lorsque ous ajoutez un éénement de relecture personnalisé, la aleur Sélecteur CSS génère une exception dans les naigateurs Chrome et Webkit si un caractère non alide (par exemple, $) est spécifié sans le caractère d'échappement \. Exemple : { //Name Value Blocking "targets": ["input[name=login\\$password]"], "masktype" : 2 //Replace with XXX s Les éénements du module de performance sont conformes à la norme W3C eu égard au temps de naigation. Le module de performance W3C analyse l'objet de performance Temps de naigation de W3C et intègre ces informations en tant que message de performance dans le flux de données JSON renoyé au sereur de capture Tealeaf. Chapitre 3. Assistant de configuration de CX UI Capture j2 31

40 Pour plus d'informations sur chaque paramètre, cliquez sur de configuration. dans l'assistant Des informations supplémentaires sont disponibles dans la section de référence. Voir Chapitre 5, «Référence de CX UI Capture j2», à la page 45. Pour plus d'informations, consultez le site 32 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

41 Etape 6 : Paramètres diers Lors de cette étape, ous pouez ajouter des cadres sur liste noire qui sont exclus de la collecte de données. Vous pouez également définir des options de partage des données de session. Pour l'option de sélection des cadres à bannir, la aleur Sélecteur CSS génère une exception dans les naigateurs Chrome et Webkit si un caractère non alide (par exemple, $) est spécifié sans le caractère d'échappement \. Exemple : { //Name Value Blocking "targets": ["input[name=login\\$password]"], "masktype" : 2 //Replace with XXX s Pour plus d'informations sur chaque paramètre, cliquez sur de configuration. dans l'assistant Testeur RegEx Des informations supplémentaires sont disponibles dans la section de référence. Voir Chapitre 5, «Référence de CX UI Capture j2», à la page 45. Dans le testeur RegEx, ous pouez spécifier des expressions régulières et les tester par rapport aux données que ous fournissez. Chapitre 3. Assistant de configuration de CX UI Capture j2 33

42 Figure 4. Testeur RegEx 1. RegEx : insérez ici l'expression régulière à tester. Par défaut, les recherches effectuées dans les données Echantillon de test sont sensibles à la casse. Vous pouez configurer le test afin d'effectuer des recherches insensibles à la casse. Par défaut, l'expression régulière est comparée à la première occurrence de la chaîne. Pour comparer l'expression régulière à toutes les occurrences de la chaîne, sélectionnez Global. Cette option n'est généralement pas requise. 2. Echantillon de test : insérez ici os données d'échantillon à appliquer dans le test. Utilisez des données propres à otre application Web, par exemple, un exemple de demande. 3. Correspondances : si une correspondance est trouée pour l'expression régulière dans les données échantillon de test, cette aleur est true. 4. RegEx (prêt) : que l'expression régulière éalue à true ou à false, la aleur utilisable pour insérer l'expression régulière dans une zone de texte quelconque de l'assistant de configuration s'affiche ici. Copiez-la et collez-la en fonction des besoins. Des références aux indicateurs globaux ou insensibles à la casse sont insérées. Par exemple, l'indicateur insensible à la casse est ajouté à l'expression de la manière suiante : "flags": "i". Pour plus d'informations sur les indicateurs d'expression régulière, oir US/docs/JaaScript/Reference/ Global_Objects/RegExp. 5. Cliquez sur Tester. 6. Pour fermer le testeur RegEx, cliquez sur. 34 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

43 Chapitre 4. Instructions d'utilisation de CX UI Capture j2 Portée de l'application Ce chapitre contient des instructions sur la mise en oeure et l'utilisation d'ibm Tealeaf CX UI Capture j2. Parallèlement à otre processus de déeloppement de l'application Web, essayez de déployer IBM Tealeaf CX UI Capture j2 le plus tôt possible dans le processus de déeloppement, pour les raisons suiantes. Le déploiement précoce limite les problèmes détectés dans un enironnement de production. Le déploiement précoce est un moyen pour sureiller les problèmes applicatifs et aide à déboguer l'application. Ces instructions s'appliquent à tous les déploiements d'ibm Tealeaf CX UI Capture j2. Des options différentes peuent s'appliquer pour d'autres types d'application Web. IBM Tealeaf CX UI Capture j2 prend en charge des naigateurs, des types d'application et des protocoles spécifiques. Pour obtenir la liste des naigateurs pris en charge, oir Naigateurs pris en charge. Types d'application pris en charge En règle générale, la fonctionnalité RIA (Rich Internet Application) doit être limitée aux zones de otre application Web qui en ont besoin. RIA requiert des techniques de sureillance plus sophistiquées et peut augmenter le olume du trafic que IBM Tealeaf doit traiter. IBM Tealeaf prend en charge les types de fonctions RIA suiants : Ajax Remarque : IBM Tealeaf continue de prendre en charge les clients qui ont déployé des applications Flash ou Flex. IBM Tealeaf ne prend pas en charge les noueaux clients qui utilisent ces technologies. Remarque : Actuellement, IBM Tealeaf ne prend pas en charge la capture de l'interface utilisateur et la relecture de plusieurs applications Flex ou Flash sur la même page. Cette limitation n'inclut pas les applications de contenu multimédia qui ne requièrent pas la capture ou la relecture de l'interface utilisateur IBM Tealeaf. Si otre application requiert plusieurs fonctions RIA Flex ou Flash sur la même page, dont chacune doit être capturée pour la relecture, contactez les serices professionnels d'ibm. Remarque : IBM Tealeaf prend en charge les applications qui utilisent des formats de données à base de texte pour communiquer aec le sereur. Si otre application utilise des formats de données binaires tels que AMF, contactez les serices professionnels d'ibm. Copyright IBM Corp. 1999,

44 Protocoles pris en charge IBM Tealeaf prend en charge HTTP et HTTPS pour gérer les communications d'enoi et de réception entre le client et le sereur. Vérifiez que toutes les communications d'enoi et de réception Ajax sont gérées par HTTP ou HTTPS. Le protocole des éénements client est le même que celui de la demande qui a enoyé la page au naigateur. Si les éénements client doient être enoyés par HTTPS, érifiez que la page source est distribuée par HTTPS. Les aleurs des zones de formulaire capturées sont transmises dans le même protocole que celui dans lequel la page de formulaire est transmise au sereur. Si otre page de formulaire est transmise par HTTPS, les aleurs des zones de formulaire sont également chiffrées. Remarque : A l'heure actuelle, IBM Tealeaf ne prend pas en charge d'autres protocoles tels que la diffusion en continu HTTP, les opérations push HTTP, ou les protocoles non-http tels que RTMP. Vérifiez que otre application n'utilise pas de protocoles non-http/https. Aant de commencer le déeloppement Aant de commencer os initiaties de déeloppement IBM Tealeaf CX UI Capture j2, érifiez que les informations suiantes sont disponibles ou ont été capturées. Accès à IBM Tealeaf Si possible, déployez l'application Web sur un sereur qui est accessible aux déeloppeurs IBM Tealeaf. Pour déboguer les problèmes de manière efficace, les déeloppeurs IBM Tealeaf doient aoir accès à l'application. Contenus tiers Les instructions suiantes s'appliquent aux contenus tiers. Domaines tiers IBM Tealeaf ne peut pas capturer des contenus gérés par des domaines tiers. Dans un déploiement standard, la plupart de ces contenus ne font pas partie intégrante des performances de l'application et ils peuent être redemandés au moment de la relecture sans aoir de répercussions sur la relecture de l'application globale. Si la capture des ersions dynamiques de ces contenus est requise, contactez les serices professionnels d'ibm. Plugins tiers A part Flash Player, IBM Tealeaf ne prend actuellement pas en charge la relecture des plugins tiers dans des applications Internet enrichies, comme les applets Silerlight ou Jaa. Personnel Les employés doient détenir les rôles suiants sur IBM Tealeaf pour pouoir effectuer le déploiement de CX UI Capture j2. Rôle Description 36 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

45 Architecte de l'application Lors du déploiement, IBM Tealeaf peut être amené à contacter l'architecte de l'application Web pour identifier les emplacements dans l'application d'où appeler l'api IBM Tealeaf. Cette personne est également utile pour répondre aux questions techniques. Analyste métier Dans la perspectie business, il est important de saoir quelles zones de l'application nécessitent une sureillance et à quel nieau. Grâce à ces connaissances, ous pouez déterminer quels éléments d'interface utilisateur, éénements, clics et autres aspects de l'application doient être capturés par IBM Tealeaf. Au cours de déeloppement, cette personne peut être autorisée à identifier des cas d'utilisation spécialisés pour IBM Tealeaf CX UI Capture j2. Ressources externes Si le déeloppement d'application est confié à un tiers, fournissez-lui des droits d'accès. IBM Tealeaf est en mesure de gérer toutes les contraintes pour les équipes de déeloppement externes. Eléments à prendre en compte lors du déeloppement Pendant le processus de déeloppement, gardez à l'esprit les éléments suiants. Cycle de déeloppement IBM Tealeaf suppose que les étapes de production de base suiantes sont en place. Déeloppement Test Production Pour plus d'informations sur les objectifs de déeloppement au cours de chacune des étapes, oir Chapitre 2, «Installation et implémentation de CX UI Capture j2», à la page 9. Quand déployer CX UI Capture j2 au cours du déploiement IBM Tealeaf recommande de déployer IBM Tealeaf CX UI Capture j2 le plus tôt possible dans le processus de déeloppement. En plus de diminuer le nombre de problèmes dans un enironnement de production, CX UI Capture j2 peut être utile pour déboguer les problèmes liés au processus de déeloppement d'application lui-même. Votre application Web et CX UI Capture j2 peuent fonctionner ensemble pour fournir un résultat global optimal. Par exemple, les modifications apportées à l'application côté client, telles que les modifications des identificateurs d'éléments, les ajouts et les modifications des widgets de l'interface utilisateur, peuent aoir un impact sur la capture et la relecture des sessions de l'interface utilisateur côté client. Identifier ces modifications aec IBM Tealeaf CX UI Capture j2 dans un enironnement de déeloppement permet une résolution plus rapide des problèmes et améliore la qualité de la relecture lorsque l'application est ensuite déployée dans l'enironnement de production. Chapitre 4. Instructions d'utilisation de CX UI Capture j2 37

46 Vous pouez également utiliser la configuration des règles de confidentialité d'ibm Tealeaf CX UI Capture j2 pour identifier et protéger les données client sensibles aant de réaliser le déploiement sur le site actif. En incluant IBM Tealeaf dans l'effort de déeloppement principal de otre application Web, CX UI Capture j2 peut être intégré aux processus de maintenance planifiée et de gestion des modifications pour otre entreprise. Enironnements de déeloppement et de test Dans la mesure du possible, configurez tous les enironnements de déeloppement et de test à l'image de l'enironnement de production. Appliquez les paramètres et autorisations de sereur Web qui sont configurés sur le sereur de production aux enironnements de déeloppement ou de test. Remarque : Ne déployez jamais IBM Tealeaf CX UI Capture j2 directement dans un enironnement de production. Gestion des performances Intégrez IBM Tealeaf CX UI Capture j2 dans la suite de tests de gestion des performances pour otre entreprise. Contenu de l'application La mesure des performances d'ibm Tealeaf CX UI Capture j2 JaaScript peut ous aider à configurer la taille et la fréquence des enois d'ui Capture. Lorsque ous déeloppez otre application Web, gardez à l'esprit les points suiants. Identificateurs uniques Tous les éléments d'interface utilisateur de l'application Web doient aoir des identificateurs uniques. Lorsque cela est possible, implémentez l'application aec des identificateurs uniques pour chaque élément d'interface utilisateur. Si des identifiants uniques ne sont pas disponibles, IBM Tealeaf s'appuie sur des identificateurs XPath. Cette solution n'est toutefois pas fiable à 100 %. Par ailleurs, l'utilisation des XPaths peut augmenter la taille de chaque message CX UI Capture j2 et le coût total du stockage des données. Remarque : IBM Tealeaf CX UI Capture j2 ne érifie pas automatiquement l'unicité des identificateurs. Les identificateurs non uniques doient être mis sur liste noire manuellement par le biais de la configuration. GUID transmis dynamiquement Si l'application génère des GUID dynamiques côté client qui sont transmis sur le réseau, la relecture des sessions capturées peut être affectée. Les horodatages et les modifications de comportement de l'application dus à l'agent utilisateur, à l'enironnement local du isiteur et à d'autres facteurs dynamiques peuent aoir des effets sur la relecture. 38 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

47 Selon les ariations, ous derez peut-être faire appel aux serices professionnels d'ibm pour établir des règles complexes afin de faire correspondre des données POST générées dynamiquement, de remapper des hôtes sereur, par exemple, et garantir ainsi une relecture optimale. Remarque : Chaque fois que c'est possible, éitez les identificateurs générés dynamiquement côté client. Si les identificateurs dynamiques peuent être contrôlés par IBM Tealeaf, leur gestion s'effectue par le biais de la configuration à un nieau éleé de complexité. Les mots clés DOM ne sont pas autorisés dans les noms de zone de formulaire Cette exigence est mieux illustrée par l'exemple. Voici une spécification d'un formulaire HTML contenant trois zones d'entrée, dont les noms utilisent du code HTML et les mots clés DOM action, type et tagname. <form id="my_form" method="get" action="submit.php"> <input type="text" name="action" alue="hotel" /> <input type="text" name="type" /> <input type="text" name="tagname" /> </form> Lorsque CX UI Capture j2 tente de déclarer les propriétés standard (par exemple, type, action ou tagname) du noeud de formulaire sur lequel un éénement utilisateur s'est produit, la aleur est généralement une chaîne définie ou bien une aleur non définie ou NULL. Dans ce cas, la cible est un élément form, dont les noms de zone d'entrée sont exportés par le naigateur en tant que propriétés de l'objet de formulaire. Les propriétés action, type et tagname du formulaire font alors référence à la zone d'entrée correspondante, qui est un objet. Tous les fichiers JaaScript tentant d'accéder à l'une de ces propriétés naties extraient à la place l'objet de zone d'entrée. Remarque : N'utilisez aucun mot clé DOM réseré dans le nom d'une zone de formulaire. Objets application Les sections suiantes décrient des aspects de l'application que ous déeloppez et la manière dont ils peuent affecter IBM Tealeaf CX UI Capture j2. En général, n'annulez pas les éénements JaaScript dans otre application. Autorisez la propagation de tous les éénements des éléments enfants jusqu'à l'élément racine du document. Ajax Lorsque cela est possible, n'utilisez pas les balises d'ancrage comme aleur sur laquelle modifier des ues, des fenêtres modales ou des fenêtres olantes gérées par Ajax. Dans les appels Ajax, éitez d'utiliser des paramètres de demande ou de réponse difficiles à réiser et à analyser. Créez un corps de demande qui affiche clairement les éléments de la demande et leur emplacement dans le document racine. La même règle s'applique à la réponse. Pour les appels Ajax qui se traduisent par des mises à jour de la page sous forme de noueaux éléments d'entrée utilisateur, tels que des listes déroulantes Chapitre 4. Instructions d'utilisation de CX UI Capture j2 39

48 ou des zones de texte, IBM Tealeaf doit être notifié de façon à pouoir capturer ces noueaux éléments insérés. La bibliothèque CX UI Capture j2 fournit une API simple à cet effet. Contrôles d'interface utilisateur personnalisés Remarque : Il est possible que la capture et la relecture des contrôles d'interface utilisateur personnalisés nécessitent une solution spécifique. Pour plus d'informations, contactez les serices professionnels d'ibm. En-têtes de contrôle du cache HTTP En fonction des paramètres de naigateur de os isiteurs, CX UI Capture j2 JaaScript peut être stocké dans le cache local pendant une longue période. Si ous déployez une ersion mise à jour de CX UI Capture j2, les naigateurs de os isiteurs peuent toujours récupérer CX UI Capture j2 JaaScript à partir du cache local, ce qui peut entraîner des problèmes importants dans l'éentualité où des modifications de configuration seraient nécessaires pour qu'ui Capture fonctionne aec otre application. Pour gérer ce problème potentiel, utilisez les en-têtes de contrôle du cache HTTP pour otre sereur Web et la configuration de l'utilisation des demandes HTTP conditionnelles ia l'en-tête HTTP Last-Modified standard. Toutes les mises à jour des fichiers CX UI Capture j2 sur le sereur sont automatiquement propagées par le biais du mécanisme de mise en cache HTTP. Remarque : La mise en cache HTTP nécessite des étapes de configuration supplémentaires qui, si elles ne sont pas réalisées correctement, peuent générer des problèmes. Demandez l'ais de os informaticiens aant d'actier ces modifications. Remarque : Si ous ne pouez pas effectuer des modifications de configuration pour otre sereur Web, ous pouez en reanche gérer les mises à jour en insérant un horodatage dans le nom des fichiers IBM Tealeaf CX UI Capture j2, par exemple, tealeaf_ js. Ces modifications de nom de fichier doient toutefois être effectuées de concert aec l'équipe de déeloppement et ne génèrent pas toujours le comportement de mise en cache escompté. Références : Données priées IBM Tealeaf fournit de nombreuses options de gestion de la confidentialité des données par le biais des fonctions de capture, de relecture et de génération de rapports. Les données peuent être bloquées ou masquées grâce à CX UI Capture j2, soit au point de capture dans CX Passie Capture Application, soit ia l'agent de session de confidentialité dans le pipeline sur le sereur de traitement. Identifiez les données qui nécessitent la gestion de la confidentialité tôt dans le processus de déeloppement, puis testez la configuration de la confidentialité dans les enironnements de déeloppement et de test. Lorsque cela est possible, essayez de réduire le olume des données qui requièrent la gestion de confidentialité. 40 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

49 Remarque : Une fois que les données CX UI Capture j2 ont été bloquées ou masquées à l'aide de la fonction de confidentialité IBM Tealeaf, la relecture peut s'interrompre si l'application Web n'a pas été conçue pour accepter le contenu modifié. Pour plus d'informations sur la manière dont IBM Tealeaf sécurise les données, oir "Gestion de la confidentialité des données dans Tealeaf CX" dans le document IBM Tealeaf CX Installation Manual. Fréquence des publications IBM Tealeaf actie la configuration de la taille et de la fréquence des publications ers la page cible IBM Tealeaf. Au cours du déeloppement, ous pouez enoyer les publications fréquentes et de petite taille de façon à pouoir sureiller les actiités à un nieau granulaire. Dans un enironnement de production, réduisez le nombre des publications caractérisées par une surcharge des données. Remarque : Idéalement, le déclencheur de l'enoi de chaque publication dans un enironnement de production est la taille maximum de la publication. La taille et la fréquence de ces publications peuent être configurées par le biais des paramètres pour contrôler : Le nombre maximum autorisé d'éénements dans la mémoire tampon. Si ce nombre maximum est dépassé, les éénements mis en file d'attente sont publiés. Une aleur de temporisateur pour le idage périodique de la file d'attente d'éénement, quelle que soit la taille de la mémoire tampon. Eénements de l'interface utilisateur remplacés par CX UI Capture j2 Dans certaines implémentations, IBM Tealeaf peut être configuré pour remplacer des éénements de l'interface utilisateur spécifiques. Vérifiez qu'il n'y a pas de conflit entre les remplacements IBM Tealeaf et les éénements qui sont utilisés ou sureillés par otre application. Voir Chapitre 2, «Installation et implémentation de CX UI Capture j2», à la page 9. Déploiement de CX UI Capture j2 Positionnement de CX UI Capture j2 Pour obtenir des résultats optimaux, placez le fichier de configuration CX UI Capture j2 au début de la page dans la section d'en-tête HTML. Le positionnement dans d'autres sections de la page est également pris en charge. Voir Chapitre 2, «Installation et implémentation de CX UI Capture j2», à la page 9. JaaScript Les instructions suiantes s'appliquent à l'utilisation de JaaScript. Chapitre 4. Instructions d'utilisation de CX UI Capture j2 41

50 Modifications Eitez de modifier les paramètres de configuration de IBM Tealeaf, sauf si ous connaissez parfaitement les raisons de la modification et ses effets. Certaines options peuent aoir des conséquences significaties sur les performances. Commentaires Sureillez les modifications apportées aux fichiers JaaScript en ajoutant des commentaires détaillés. IBM Tealeaf fournit régulièrement des mises à jour des fichiers JaaScript ; l'intégration de ces mises à jour aec les modifications relaties à otre entreprise est plus facile aec la mise en commentaire. Fonctions spéciales Vérifiez que les fonctions spéciales au nieau de la page ne sont pas écrasées. Ces fonctions incluent onload, onunload et onreadystatechange. Si l'écrasement est requis, relaie toujours l'appel. Par exemple: if( typeof document.onreadystatechange == "function" ) { document.originalreadystatechange = document.onreadystatechange; else { document.originalreadystatechange = null; document.onreadystatechange = function() { // Do my work here ; // Call the original ReadyStateChange if(document.originalreadystatechange) { document.originalreadystatechange(); Création d'éénements personnalisés Par défaut, IBM Tealeaf CX UI Capture j2 sureille les interactions d'utilisateur aec l'application en capturant les éénements DOM (Document Object Model) standard. IBM Tealeaf CX UI Capture j2 permet également de contrôler certains aspects de l'application, par exemple, des mesures de performances côté client, des messages de alidation d'entrée côté client ainsi que d'autres données concernant l'application. Pour capturer ces aspects et d'autres aspects de l'actiité côté client, le déeloppeur de l'application peut utiliser une API IBM Tealeaf simple pour signaler à la bibliothèque toutes les données qui doient être incluses dans la publication IBM Tealeaf. La mise en oeure des éénements personnalisés est optimisée dans un emplacement centralisé où l'application traitera ses mesures de performance ou de alidation des entrées, par exemple. Remarque : La création d'éénements personnalisés pour insérer des données dans les soumissions à IBM Tealeaf augmente le olume des données qui sont stockées pour chaque session. Créez uniquement des éénements personnalisés pour les données d'entreprise critiques. L'enoi de gros olumes de données d'interface utilisateur augmente les besoins de stockage et de trafic réseau dans IBM Tealeaf et peut affecter les performances de l'application. 42 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

51 Etapes suiantes Voir Chapitre 6, «Référence des API publiques de CX UI Capture j2», à la page 63. Pour des informations supplémentaires sur les pratiques spécifiques à appliquer au déeloppement d'applications Web et à l'implémentation d'ibm Tealeaf CX UI Capture j2, contactez les serices professionnels d'ibm. Chapitre 4. Instructions d'utilisation de CX UI Capture j2 43

52 44 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

53 Chapitre 5. Référence de CX UI Capture j2 Configuration de base La configuration de la bibliothèque IBM Tealeaf CX UI Capture j2 est un conteneur d'objets JSON anonyme constitué de plusieurs sections. Objet de configuration de base : Contient des informations de configuration sur les éénements DOM (Document Object Model) auxquels la bibliothèque est à l'écoute. Voir «Configuration de base». Objet de configuration des serices : Contient des informations de configuration sur les serices indiiduels qui étendent la configuration de base et fournissent les fonctions requises par la bibliothèque. Voir «Configuration des serices», à la page 51. Objet de configuration des modules : Contient des informations de configuration sur les modules qui sont actiés dans la bibliothèque. Voir «Configuration des modules», à la page 59. Vous pouez également configurer les clés pour la capture des données de stockage local. L'objet Configuration de base contient des informations basiques sur les éénements DOM que la bibliothèque IBM Tealeaf CX UI Capture j2 écoute. TLT.init({ /** * Base configuration for the core. * It specifies which modules should listen to which eents and the * modulebase to dynamically load additional modules {Object */ core: { /** * The ieexcludedlinks entry specifies a set of links that should * not trigger the beforeunload eent, which destroys the UI * Capture library. This addresses a known issue with Internet * Explorer */ ieexcludedlinks: ["a.ignore"], /** * This is the module configuration section contains options * releant to the core. * It contains the eents to which the modules attempt to listen. * NOTE: Please do not use this section for module-specific * configuration, which you must access inside of your modules. {Object */ modules: { performance: { enabled: true, eents: [ { name: "load", target: window, { name: "unload", target: window Copyright IBM Corp. 1999,

54 ], replay: { enabled: true, eents: [ /* Lifecycle eents - not optional */ { name: "load", target: window, { name: "unload", target: window, /* User interaction eents - not optional */ { name: "change", target: changetarget, recurseframes: true, { name: "click", recurseframes: true, /* Dwell time and preious state */ { name: "focus", target: "input, select, textarea, [contenteditable]", recurseframes: true, { name: "blur", target: "input, select, textarea, [contenteditable]", recurseframes: true, /* Hash change - optional */ { name: "hashchange", target: window, /* ClientState eents - not optional */ { name: "resize", target: window, { name: "scroll", target: window, /* Mobile DOM eents - optional */ { name: "orientationchange", target: window, { name: "touchend" ],, /* Following settings are related to the TLT.getSessionData() Public API */ 46 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

55 /** * Set the sessiondataenabled flag to true only if it s OK to expose Tealeaf * session data to 3rd party scripts. */ sessiondataenabled: false, /** * The sessiondata object specifies the query parameter name OR cookie name to * get the session id alue from. An actual deployment would only specify one * of the methods to obtain the session id. If both are specified, the * sessionqueryname takes precedence oer sessioncookiename. If neither is * specified, an internal default of "TLTSID" will be looked up in the cookies. */ sessiondata: { /** * Specify sessionqueryname only if the session id is deried from a * query parameter. */ sessionqueryname: "sessionid", /* Optionally, specify the query string delimiter. Default is & */ sessionquerydelim: ";", /* The cookie being used for sessionization in Tealeaf. */ sessioncookiename: "jsessionid", /** * Optionally, specify if the alue needs to be hashed to derie the * session ID. */ sessionvalueneedshashing: true /** * The framesblacklist array specifies the CSS selectors which correspond to the * frame/iframe elements that should not be accessed. */ framesblacklist: [ ".tlblock" ], ); /* End of core configuration */ // Serices configuration... // Module specific configuration... Core Dans Core, ous pouez définir des propriétés qui assurent la capture des éénements d'interface utilisateur. Remarque : Ne modifiez pas ces paramètres à moins qu'ibm Tealeaf ne ous l'ait demandé. Pour plus d'informations, contactez les serices professionnels d'ibm. Chapitre 5. Référence de CX UI Capture j2 47

56 Liens Internet Explorer Dans Internet Explorer, le fait de cliquer sur un lien href=jaascript peut déclencher l'éénement beforeunload. Si ce lien ne déclenche pas une modification de naigation, la bibliothèque CX UI Capture j2 est détruite de manière prématurée, et les éénements d'interface utilisateur suiants sur la page ne sont pas capturés. Pour résoudre ce problème, ous pouez spécifier une série de sélecteurs CSS. Ces sélecteurs seront conertis en éléments HTML et ne déclencheront pas l'éénement beforeunload lorsqu'ils seront actionnés. Dans la zone ieexcludedlinks, ous pouez spécifier ces éléments HTML sous la forme d'un tableau de sélecteurs CSS. Dans l'exemple ci-dessous, la syntaxe spécifie une ancre <a> aec une classe ignore et une ancre aec une classe foo qui contient un élément span. Si l'utilisateur clique sur l'un de ces types d'éléments, l'éénement beforeunload qui en résulte dans Internet Explorer est ignoré. ieexcludedlinks: ["a.ignore", "a.foo span"], Configuration des éénements client par module La sous-section Modules de la configuration de base spécifie les éénements auxquels chaque module est à l'écoute. Remarque : Ne modifiez pas les paramètres par défaut. Voici un exemple de configuration d'un éénement d'interface utilisateur indiiduel. {, name: "load", target: window Où : name identifie le nom W3C de l'éénement d'interface utilisateur. target identifie l'objet client qui est la cible de l'éénement. La cible peut être un élément DOM (Document Object Model), tel qu'un document ou une fenêtre. La cible peut également être une chaîne contenant des sélecteurs CSS, séparés par des irgules, à utiliser comme cibles. Si la cible n'est pas spécifiée, elle prend par défaut la aleur de l'élément document. Remarque : Pour désactier un éénement, mettez l'entrée en commentaire ou supprimez-la. Certains éénements ne sont pas facultatifs et doient rester actiés pour que la bibliothèque fonctionne correctement. Pour certains éénements de l'interface utilisateur, la configuration peut être dans le format suiant : {, name: "click", recurseframes: true Si Recurseframes est défini sur True, l'éaluation est appliquée à tous les cadres et sous-cadres sur la page issue du même domaine que la page. 48 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

57 Performance Le module de performance analyse l'objet de performance Temps de naigation de W3C et inclut ces informations comme le message de performance dans le flux de données JSON qui est renoyé au sereur de capture IBM Tealeaf. Remarque : Pour assurer un fonctionnement correct, ne modifiez pas cette configuration. Si le module de performance n'est pas nécessaire, supprimez cette section de la configuration de base. Relecture Le module de relecture fournit les données sous-jacentes sous la forme de messages JSON qui actient les fonctions suiantes : Relecture RIA (Rich Internet Application) : Relecture sur naigateur et CX RealiTea Viewer. Fonctions de facilité d'emploi d'ibm Tealeaf cxoerstat : Cartes thermiques, analyse de formulaire et carte d'éléments prioritaires. Voir "Manuel de l'utilisateur cxoerstat" dans le document IBM Tealeaf cxoerstat User Manual. Eénements basés sur des étapes. Voir "Eénements basés sur des étapes" dans le document IBM Tealeaf Eent Manager Manual. Les éénements ci-dessous sont suiis à des fins de relecture sur le client. La plupart de ces éénements sont requis pour la relecture. Remarque : La prise en charge de l'ensemble de ces éénements de relecture est fournie en mode Relecture sur naigateur uniquement. Voir "Relecture sur naigateur CX" dans le document IBM Tealeaf cximpact User Manual. Un sous-ensemble des éénements de relecture peut fonctionner dans CX RealiTea Viewer. Voir "RealiTea Viewer - Vue Relecture" dans le document IBM Tealeaf CX RealiTea Viewer User Manual. Propriété Description "load" Eénement de chargement de page. Remarque : Cet éénement est obligatoire. "unload" Eénement de déchargement de page. Remarque : Cet éénement est obligatoire. "change" Eénement de changement des modifications. Remarque : Cet éénement est obligatoire. Par défaut, il est configuré pour assurer le suii de tous les éléments HTML prenant en charge l'éénement de modification. Le cas échéant, ous pouez affecter au paramètre recurseframes la aleur true pour analyser tous les cadres et sous-cadres de la page pour ces éénements. Chapitre 5. Référence de CX UI Capture j2 49

58 "click" Eénements de clic sur la page. Remarque : Cet éénement est obligatoire. Le cas échéant, ous pouez affecter au paramètre recurseframes la aleur true pour analyser tous les cadres et sous-cadres de la page pour ces éénements. "focus" Eénements de focus sur le contrôle. Remarque : Cet éénement est Obligatoire. Le cas échéant, ous pouez affecter au paramètre recurseframes la aleur true pour analyser tous les cadres et sous-cadres de la page pour ces éénements. "blur" Eénements blur sur le contrôle. Remarque : Cet éénement est obligatoire. Le cas échéant, ous pouez affecter au paramètre recurseframes la aleur true pour analyser tous les cadres et sous-cadres de la page pour ces éénements. "hashchange" Lorsque cette option est actiée, elle génère des éénements de ue écran dès lors qu'une modification du hachage a été identifiée dans l'adresse URL de la page. Un screeniew est défini comme un changement de l'état de la page globale. Par exemple, si une page comprend plusieurs onglets, chaque onglet peut être défini en tant que ue écran distincte pour la page. Lorsque cette option est actiée, un éénement de ue écran est inséré dans les données de session, et les éénements d'interface utilisateur qui sont capturés par UI Capture peuent être organisés sous la ue écran sur laquelle ils se sont produits. Voir Référence du schéma d'objet JSON Tealeaf. Si otre application Web n'utilise pas les ues écran, désactiez cette option. "resize" Eénements de redimensionnement sur le client. Voir Référence du schéma d'objet JSON Tealeaf. "scroll" Eénements de défilement sur le client. Voir Référence du schéma d'objet JSON Tealeaf. Remarque : Selon otre application, le suii des fenêtres qui défilent peut générer un nombre important d'éénements. Remarque : La relecture des éénements de défilement est prise en charge pour les sessions mobiles en mode Relecture sur naigateur uniquement. Voir Recherche et relecture pour le Web mobile. "orientationchange" Eénements de modification d'orientation pour les périphériques mobiles. Voir Référence du schéma d'objet JSON Tealeaf. 50 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

59 Configuration des serices Remarque : Ces éénements sont relus uniquement si ous aez acquis une licence pour IBM Tealeaf CX Mobile. Pour plus d'informations, contactez otre interlocuteur IBM Tealeaf. "touchend" Eénements de fin de toucher pour les unités mobiles. Voir Référence du schéma d'objet JSON Tealeaf. Remarque : Ces éénements sont relus uniquement si ous aez acquis une licence pour IBM Tealeaf CX Mobile. Pour plus d'informations, contactez otre interlocuteur IBM Tealeaf. Remarque : Les actions pincer et zoomer peuent être capturées sur la plateforme ios uniquement. Leur capture est impossible sur la plateforme Android. L'objet Configuration des serices contient des options qui sont utilisées par les serices indiiduels faisant partie de la bibliothèque IBM Tealeaf CX UI Capture j2. Remarque : Lorsqu'une bibliothèque est intégrée à une application, il suffit généralement de ne modifier que quelques éléments de configuration. /** * The serice configuration for options used inside of the serices. {Object */ serices: { /** * The queue configuration is an object containing an array * of queues. It must specify at least one default queue. {Array */ queue: { /** * Flag to enable asynchronous XHR on page unload. * WARNING: Enabling this may result in incomplete or missing data. {Boolean false */ asyncreqonunload: false, /** * Array of queues. Must contain at least one default queue. {Array */ queues: [ /** * A default queue configuration. */ { /** * The queue ID for the default queue is "DEFAULT". * For other queues, it could be any string to identify the * queue. {String */ qid: "DEFAULT", /** * The endpoint on the serer where the messages should be * sent. This alue should correspond to a Tealeaf Target page Chapitre 5. Référence de CX UI Capture j2 51

60 , ] * identifier. {String */ endpoint: "TealeafTarget.php", /** * For maxeents, you could specify the number of queued eents * after which the queue should flush and send all of them to * the serer. {Number 25 */ maxeents: 25, /** * The interal at which the queue should be flushed * automatically. * (in milliseconds) * If this option is not present or is set to 0, the timer is * disabled. {Number 0 */ timerinteral: 0 /** * Flag indicating if a cross domain POST should be used. If * enabled then the crossdomainframeselector should specify * the iframe or frame element on the page that has been * configured to POST requests. {Boolean false */ crossdomainenabled: false, /** * A CSS selector that resoles to a single frame or iframe * element on the page that has been configured to POST * requests. {string */ crossdomainframeselector: "#uicxdomain" Configuration du serice de mise en file d'attente Par le biais de la configuration du serice de mise en file d'attente, ous pouez ajouter des files d'attente d'éénements supplémentaires pour le traitement et configurer des propriétés de file d'attente d'éénements reposant sur le olume du trafic. Remarque : L'ajout d'une file d'attente supplémentaire est une option aancée qui n'est pas nécessaire dans la plupart des déploiements. Propriété Description asyncreqonunload Autorise les requêtes XHR asynchrones sur un déchargement de page. qid Remarque : L'actiation de cette option peut se traduire par des données incomplètes ou manquantes. Identifie le nom des files d'attente d'éénements disponibles. 52 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

61 Remarque : Par défaut, une file d'attente est définie comme DEFAULT. Nela supprimez pas et ne modifiez pas son nom. endpoint Identifie la cible ers laquelle les messages sont enoyés. Cette aleur correspond à un identificateur de page cible IBM Tealeaf. Des exemples de cibles pour les enironnements JSP et PHP sont fournis aec la distribution d'ui Capture. maxeents Indique le nombre maximal d'éénements dans une file d'attente. Si ce nombre est dépassé, la file d'attente est automatiquement idée et tous les éénements mis en file d'attente sont enoyés à la cible pour être capturés par IBM Tealeaf. Remarque : Définissez une aleur maximale d'éénements raisonnable, généralement comprise entre 20 et 50. La aleur maximale autorisée est 100. timerinteral Interalle en millisecondes, selon lequel les files d'attente d'éénements sont idées automatiquement. Si cette option n'est pas définie ou a la aleur 0, le minuteur est désactié. Remarque : Laissez ce paramètre désactié sauf si un idage des données plus immédiat est nécessaire, par exemple, lorsque des utilisateurs de IBM Tealeaf effectuent un cliché instantané de la session d'un isiteur. Configuration du serice de naigateur Vous pouez, par le biais de la configuration du serice de naigateur, spécifier les objets et les éléments de naigateur qui possèdent des ID HTML en double ou dynamiques. browser: { /** * sizzleurl is an URL to the sizzle.js file that contains the * Sizzle library. It is used in some older browsers to get * elements ia a CSS selector. * * In such cases, the w3c browserserice will conditionally load * this file. * * This setting is only alid when the W3C flaor of the * browser serice is selected. * {String (only needed for w3c browserserice and if jquery or * Sizzle is not defined on the window) */ sizzleurl: "/scripts/legacyiesupport/sizzle.js", /** * sizzleobject is the location of the Sizzle object on the page. If * this setting is not specified, it is assumed that the Sizzle object * will be in the global scope. i.e. window.sizzle * * This setting is only alid when the W3C flaor of the browser * serice is selected. * {String (only needed for W3C browserserice and if jquery * is not defined) */ Chapitre 5. Référence de CX UI Capture j2 53

62 sizzleobject: "My.location.Sizzle",, /** * jqueryobject is the location of the jquery object on the page. If * this setting is not specified, it is assumed that the jquery object * will be in the global scope. i.e. window.jquery * {String (only needed if jquery is not defined on the window) */ jqueryobject: "My.location.jQuery", /** * To specify elements whose HTML ids cannot be used as identifiers * or in xpath generation. Could be a string object with one or two * properties, "regex" (mandatory) and "flags". These are specified * as strings. The regex that is ealuated against the node id. {Array */ blacklist: [ "duplicateid", {regex: "/password pass pin tan/", flags: "gi" ], /** * If the application uses custom attributes as an ID replacement, * you may specify the attribute name here. {Array */ customid: [ "mycustomid" ] The Sizzle JS engine is required for correct operation of the W3C flaor of the library in legacy browsers (e.g. IE 7) that do not hae natie support for CSS selector based querys. Sizzle is included in jquery by default so if the application has a newer ersion of jquery, the separate include of Sizzle may not required. The library has multiple ways to specify the location of the Sizzle engine. In order of preference these are: sizzleurl - If specified, this will be used and subsequent mechanisms for locating Sizzle will be ignored. sizzleobject - If specified, this will be used instead of window.sizzle window.sizzle jqueryobject - If specified, this will be used instead of window.jquery window.jquery Propriété Description sizzleurl Cet élément de configuration permet de spécifier l'url du fichier sizzle.js qui contient la bibliothèque Sizzle. Cette bibliothèque est utilisée par IBM Tealeaf CX UI Capture j2 pour éaluer les sélecteurs CSS sur les anciens naigateurs. Remarque : Cet élément de configuration est requis uniquement pour le serice de naigateur W3C et si JQuery ou Sizzle n'est pas défini sur l'objet fenêtre de otre application Web. La bibliothèque Sizzle est obligatoire sur certains anciens naigateurs afin d'acquérir des éléments document qui utilisent un sélecteur CSS. Si le naigateur client est dans l'une des ersions affectées, le serice de naigateur W3C peut automatiquement charger ce fichier à partir de otre sereur Web. 54 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

63 La liste des objets peut être spécifiée aec des aleurs séparées par des irgules, qui peuent être des chaînes fixes ou des expressions régulières. Ces aleurs sont éaluées par rapport à l'id noeud. blacklist En option, ous pouez spécifier un ensemble d'éléments document dont les ID HTML ne sont pas garantis être statiques ou uniques. Les ID HTML de ces objets sur liste noire ne sont pas utilisés pour identifier les éléments et les mécanismes de substitution, comme un customid (s'il est configuré) ou un XPath. customid Si otre application Web utilise un attribut personnalisé qui peut être utilisé pour identifier les éléments de manière unique, ous pouez spécifier le nom de l'attribut ici. Configuration du serice de message Utilisez le serice de message pour définir des options telles que des règles de confidentialité qui s'appliquent aux messages JSON soumis au sereur IBM Tealeaf pour la capture. message: { /** * Define priacy rules to modify reported alues in the messages * sent to the serer. {Array */ priacy: [ /** * An example priacy rule. */ { /** * Specify the targets to which this rule should apply. {Array */ targets: [ { id: "htmlid", idtype: -1, { id: "myid=custom", idtype: -3 ], /** * The masktype defines how the alue should get * transformed. * masktype 1: The alue gets set to an empty string * masktype 2: The alue gets replaced with the fixed * string "XXXXX". * masktype 3: The alue gets replaced by a mask where: * each lowercase character gets replaced by "x", * each uppercase character by "X", * each number by "9" * each symbol by "@" * e.g. "HelloWorld123" becomes "XxxxxXxxxx999" * masktype 4: The alue gets replaced by the return * alue of * a custom function that must be specified as * maskfunction. {Number Chapitre 5. Référence de CX UI Capture j2 55

64 , ], { */ masktype: 3 targets: [ { id: "[[\"HTML\",0],[\"BODY\",0],[\"SELECT\",0]]", idtype: -2 ], masktype: 4, /** * A custom mask function that replaces the reported alue * by its return alue ("masked", in this example) {String alue The alue to replace. {String Could return any string. */ maskfunction: function (alue) { return "masked"; Configuration de la confidentialité pour CX UI Capture j2 L'application IBM Tealeaf CX UI Capture j2 permet de bloquer et de masquer les données sensibles dans le naigateur du client aant leur transmission à IBM Tealeaf pour la capture, alors qu'elle permet leur transmission à os sereurs Web pour y être traitées. Les données sensibles qui ont été nettoyées ia CX UI Capture j2 n'arrient jamais jusqu'à IBM Tealeaf, ce qui garantit la sécurisation des interactions de otre client dans CX UI Capture j2. CX UI Capture j2 permet le blocage des données d'entrée utilisateur par élément, ID, nom ou XPath. Les masques peuent être indiqués en tant que chaînes explicites, remplacements de types de caractères ou fonctions ou personnalisées. Pour plus d'informations sur la gestion de la confidentialité des données dans l'ensemble du système IBM Tealeaf, oir "Gestion de la confidentialité des données dans Tealeaf CX" dans le document IBM Tealeaf CX Installation Manual. Remarque : Si ous aez des questions sur l'implémentation de la confidentialité des données dans CX UI Capture j2, contactez les serices professionnels d'ibm. Pour spécifier une règle de confidentialité, ous deez définir : Le type d'identificateur. Les cibles auxquelles la règle s'applique. Le type de masquage à appliquer aux cibles. Spécification d'une règle de confidentialité Dans la configuration, une seule règle de confidentialité est spécifiée dans l'objet priacy à l'aide du modèle de configuration suiant. { targets: [ { id: "htmlid", idtype: IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

65 ], masktype: 3 Spécification des cibles Pour spécifier une cible, ous deez définir les propriétés suiantes. Remarque : Vous pouez spécifier plusieurs cibles d'id ou d'idtype pour chaque règle de masquage. Propriété Description id Identificateur de l'élément cible. Cette aleur est exprimée en fonction de la aleur de l'élément idtype. Dans le fichier de configuration, ous pouez spécifier les identificateurs correspondants à l'aide d'une expression régulière. Par exemple, la configuration cible suiante correspond à l'ensemble des identificateurs HTML se terminant par _pii : message: { priacy: [ { targets: [ { id: { regex: ".+_pii$", idtype: -1, ], "masktype": 3 ] idtype Type d'identificateur. Les types suiants sont pris en charge : Remarque : Les aleurs de l'élément idtype sont enregistrées en tant que nombres négatifs ID HTML -2 - identificateur XPATH -3 - nom HTML ou autre identificateur d'attribut d'élément Sélecteur CSS Dans le fichier de configuration, ous pouez également indiquer des aleurs de sélecteur CSS qui deront correspondre aux éléments CSS pour le masquage de la confidentialité. Dans l'exemple ci-dessous, la règle de confidentialité désignée s'applique à toutes les zones d'entrée de mot de passe : message: { priacy: [ { targets: [ "input[type=password]" ], "masktype": 3 ] Chapitre 5. Référence de CX UI Capture j2 57

66 Spécification du type de masque IBM Tealeaf CX UI Capture j2 prend en charge les types de masque suiants (aleurs masktype) : Tableau 2. Configuration de la confidentialité pour UI Capture j2 Valeur Description Exemple Exemple masqué 1 La aleur est bloquée et remplacée par une chaîne ide. "HelloWorld123" "" 2 La aleur est masquée aec une chaîne de longueur fixe de X. 3 La aleur est masquée en fonction des paramètres suiants : Une lettre minuscule est remplacée par x. Une lettre majuscule est remplacée par X. Un chiffre est remplacé par 9. Une aleur non alphanumérique est remplacée 4 Fonction personnalisée Remarque : Une fonction de masquage doit être définie en tant que maskfunction. "HelloWorld123" "HelloWorld123" "HelloWorld123 XXXXX "XxxxxXxxxx999" Dépend de la fonction définie Configuration du serice du sérialiseur La configuration du serice du sérialiseur ous permet de spécifier quelles fonctions d'analyseur syntaxique et de sérialiseur JSON à utiliser. La bibliothèque utilise JSON pour son format de message. Tous les naigateurs modernes disposent de la prise en charge intégrée de la sérialisation et de l'analyse syntaxique JSON. Certains naigateurs existants, tels qu'internet Explorer 6 et 7, n'en sont en reanche pas dotés. Une bibliothèque tierce fournissant des fonctions de sérialisation et d'analyse syntaxique JSON est alors requise. Par défaut, la bibliothèque CX UI Capture j2 repose sur les fonctions JSON intégrées du naigateur si elles existent, et sur une implémentation interne simplifiée dans les autres cas. Si otre application ou otre enironnement informatique exige l'utilisation d'un analyseur syntaxique ou d'un sérialiseur JSON spécifique, ous pouez le définir à l'aide de cette configuration. Remarque : La sérialisation et l'analyse syntaxique JSON sont essentielles pour que la bibliothèque puisse fonctionner et produire une sortie correcte. Des tests inter-naigateur approfondis sont nécessaires si cette configuration est modifiée. serializer: { json: { /** * If this flag is enabled, the simplified internal * implementation of the JSON serializer and parser will * be used if none of the specified parsers and 58 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

67 * stringifiers are aailable. * * If this flag is disabled, the library will shutdown * if the specified JSON serializer and parser are * not aailable. */ defaulttobuiltin: true, /** * This array specifies an ordered sequence of JSON * parsers that should be used to parse a serialized * JSON object. * * The parser must support the following interface: * ar jsobject = parse(jsonstring); */ parsers: [ "JSON.parse" ], /** * This array specifies an ordered sequence of JSON * serializers that should be used to serialize a * JaaScript object. * * The serializer must support the following interface: * ar jsonstring = stringify(jsobject); */ stringifiers: [ "JSON.stringify" ] Configuration des modules L'objet Configuration des modules contient des options qui sont utilisées par des modules indiiduels actiés dans la bibliothèque IBM Tealeaf CX UI Capture j2. Ces options correspondent aux options disponibles de la spécification Temps de naigation de W3C. Voir modules: { performance: { /** * The calculaterendertime setting only applies on browsers * that do not support the W3C Naigation Timing API. * * If enabled, the library will calculate and report the render * time as a difference between the library load timestamp and * the page load timestamp. * * To ensure an accurate calculation ensure the library is * initialized as early as possible in the page load cycle. Due * to these limitations the render time calculated in this * manner will always be less accurate than what is reported by * the browser. */ calculaterendertime: true, filter: { naigationstart: true, unloadeentstart: true, unloadeentend: true, redirectstart: true, redirectend: true, fetchstart: true, domainlookupstart: true, domainlookupend: true, connectstart: true, Chapitre 5. Référence de CX UI Capture j2 59

68 ); connectend: true, secureconnectionstart: true, requeststart: true, responsestart: true, responseend: true, domloading: true, dominteractie: true, domcontentloadedeentstart: true, domcontentloadedeentend: true, domcomplete: true, loadeentstart: true, loadeentend: true Performance Dans la section Performance, ous pouez configurer les éénements de l'interface client dont les performances sont contrôlées grâce à des mesures. Filtre A l'aide des filtres disponibles dans la section Performance, ous pouez configurer les éénements associés aux performances dans le client à sureiller par CX UI Capture j2. La liste des mesures fournies que ous pouez filtrer est prédéfinie par la spécification de temps de naigation de W3C. Pour plus d'informations, consultez le site Par défaut, les données de performance ne sont pas capturées car elles peuent aoir un impact significatif sur la bande passante. En conséquence, la configuration par défaut filtre toutes les données de performance (mesure des performances : true). Remarque : Lorsqu'un filtre est actié, les données de performance liées à cette propriété ne sont pas capturées par CX UI Capture j2. Pour actier le suii d'une propriété de performance, définissez sa aleur à false. Configuration de la fonction localstorage De nombreux naigateurs prennent en charge la fonction localstorage. Il s'agit d'une méthode rapide qui permet de stocker localement une grande quantité de données sur le naigateur de l'utilisateur. Pour capturer des données, ous deez utiliser le SDK de CX UI Capture j2 aec la fonction de capture localstorage pour définir les clés à capturer. Les données sont stockées dans des paires clé-aleur et une page Web ne peut accéder qu'aux données qu'elle a elle-même stockées. L'objet localstorage stocke les données sans date d'expiration. Les données ne sont pas supprimées lors de la fermeture du naigateur, et elles sont disponibles le jour, la semaine ou l'année suiante. La fonction localstorage d'ibm Tealeaf CX UI Capture j2 capture uniquement les données sur liste blanche. 60 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

69 Remarque : La fonction localstorage n'est pas disponible dans le SDK général de CX UI Capture j2. Pour effectuer des captures sur le stockage local, il ous faut le SDK de CX UI Capture j2 aec la fonction de capture localstorage. Pour configurer la fonction localstorage, ous deez définir une clé à capturer. Cette clé est ajoutée dans la configuration de CX UI Capture j2. En l'absence de clé définie, aucune donnée n'est capturée. CX UI Capture j2 ne capture les clés que si l'api getitem() est utilisée (par exemple, localstorage.getitem("xyz")). Si la notation décimale est utilisée, aucune donnée n'est capturée (par exemple, localstorage.xyz). Exemple : modules: { performance: { filter: {, replay: { storagekeys: ["x", "y"] IBM Tealeaf CX UI Capture j2 ne capture que les clés que ous définissez et leurs aleurs. CX UI Capture j2 capture les éléments localstorage lorsque ous y accédez (par exemple, lors de l'appel de getitem()). CX UI Capture j2 génère un éénement de type 8. Cet éénement renoie ensuite les messages JSON au sereur en l'état. Un exemple de capture de type 8 est illustré ci-dessous. Dans cet exemple, la fonction localstorage est configurée pour ne capturer que la clé username. count: 9 fromweb: true offset: screeniewoffset: type: 8 webstorage:{ key: "usrname" alue: "ssingh" Chapitre 5. Référence de CX UI Capture j2 61

70 62 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

71 Chapitre 6. Référence des API publiques de CX UI Capture j2 TLT.init(object configobject) La bibliothèque IBM Tealeaf CX UI Capture j2 prend en charge les interfaces publiques qui sont indiquées ci-dessous. Dans les ersions de déeloppement de la bibliothèque, plusieurs API génèrent des exceptions et les adressent à la console lorsque la bibliothèque n'est pas initialisée pour les appels d'api qui dépendent de la bibliothèque. Dans les ersions de production de la bibliothèque, l'appel d'api échoue en mode silencieux si la bibliothèque n'a pas été initialisée. Les API qui génèrent cette exception dans les ersions de déeloppement sont les suiantes : getsessiondata logcustomeent logexceptioneent logscreeniewload logscreeniewunload logscreencapture Cette API initialise la bibliothèque IBM Tealeaf CX UI Capture j2 aec l'objet de configuration spécifié. L'exécution de init interient après le chargement du modèle DOM (Document Object Model). Pour les déploiements statiques, l'appel à l'api init peut être intégré à la ressource JaaScript statique. Pour les déploiements dynamiques, l'appel à l'api init peut être lancé à partir de l'application du client. Exemple function callinit(){ TLT.init(); TLT.rebind(/*optional*/ DOMElement root) L'API de redéfinition des accès oblige la bibliothèque IBM Tealeaf CX UI Capture j2 à retraiter ses programmes d'écoute d'éénements. L'application peut l'utiliser pour notifier à la bibliothèque IBM Tealeaf CX UI Capture j2 que l'application a effectué une mise à jour dynamique ayant eu pour conséquence l'ajout de noueaux éléments d'entrée utilisateur au modèle DOM. L'application peut spécifier un élément racine optionnel à partir duquel le retraitement se produit. Si cet élément n'est pas spécifié, le retraitement se produit à partir de l'élément de document. Dans le cas d'un modèle DOM grand et complexe, la spécification du sous-ensemble exact qui a été mis à jour aec les noueaux éléments d'entrée utilisateur améliore l'efficacité. Copyright IBM Corp. 1999,

72 TLT.flushAll(oid) Exemple function callrebind() { TLT.rebind(); Cette API permet aux données mises en mémoire cache, qui ont été collectées par la bibliothèque IBM Tealeaf CX UI Capture j2, d'être idées ers son URL de point d'extrémité configurée. En général, le idage est utilisé en association aec l'appel de l'api setautoflush afin d'aoir un contrôle précis du comportement d'utilisation du réseau dans des applications mobiles pointues. Exemple function callflushall() { TLT.flushAll(); TLT.setAutoFlush(indicateur AutoFlushFlag) Cette API est utilisée pour actier ou désactier le comportement de idage automatique de la bibliothèque. Le idage automatique est actié par défaut et il est contrôlé par la longueur de la file d'attente configurable. Pour désactier le idage automatique, entrez : TLT.setAutoFlush(false) Pour actier le idage automatique, entrez : TLT.setAutoFlush(true) Remarque : Lorsque le idage automatique est désactié, l'application démarre l'api FlushAll() pour que les données mises en mémoire tampon par la bibliothèque soient idées selon les interalles appropriés. TLT.processDOMEent(éénement DOMEent) Cette API est utilisée pour signaler explicitement à la bibliothèque IBM Tealeaf CX UI Capture j2 tout éénement DOM que la bibliothèque doit sureiller mais dont l'application bloque actiement le signalement. Dans ce cas, l'application ou le site peut exécuter un appel d'api explicite. L'argument est l'objet DOMEent qui est transmis au gestionnaire d'éénements par le naigateur. Cela aut également pour des actions similaires qui empêchent la bibliothèque CX UI Capture j2 de traiter automatiquement l'éénement. Exemple $(document).ready(function(){ $( ".disable" ).click(function( eent ) { eent.preentdefault(); eent.stoppropagation(); 64 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

73 // Notify Tealeaf if (TLT && TLT.processDOMEent) { TLT.processDOMEent(eent); $( "<di>" ).append( "default " + eent.type + " preented" ). appendto( "#log" ); ); ); TLT.logCustomEent(DOMString name, object custommsgobj) L'application peut utiliser cette API pour enregistrer un message personnalisé dans le flux de message de la bibliothèque CX UI Capture j2. Le paramètre custommsgobj de cette fonction indique l'objet à sérialiser et à transmettre sous la forme d'un message personnalisé. Le message personnalisé peut être traité sur le sereur principal pour la création d'éénements basés sur des étapes et la génération de rapports. Voir "Eénements basés sur des étapes" dans le document IBM Tealeaf CX Eent Manager Manual. Voir "Générateur de rapport Tealeaf" dans le document IBM Tealeaf cximpact Reporting Guide. Exemple function calllogcustomeent(){ TLT.logCustomEent("logCustomEent name", "This is to test the logcustomeent API"); TLT.logExceptionEent(DOMString msg, /*optional*/ DOMString url, /*optional*/ long line) L'application peut utiliser cette API pour enregistrer un message d'erreur ou d'exception dans le flux de message de la bibliothèque IBM Tealeaf CX UI Capture j2. La spécification de l'url et du numéro de ligne du message d'erreur est facultatie. Exemple function calllogexceptioneenth() { TLT.logExceptionEent("This is to test the TLT.logExceptionEent()","/ APITesting/testRebind.html",101); TLT.logScreeniewLoad(DOMString name, /*optional*/ DOMString referrername, /*optional*/ DOMElement root) L'application peut utiliser cette API pour enregistrer un message de chargement de ue écran dans le flux de message de la bibliothèque IBM Tealeaf CX UI Capture j2. Chapitre 6. Référence des API publiques de CX UI Capture j2 65

74 La spécification du nom de la ue écran de référence et de l'élément racine pour cette ue est facultatie. Exemple function calllogscreeniewload(){ TLT.logScreeniewLoad("logScreeniewLoad name", "This is to test referrername for logscreeniewload", document.getelementbyid("logscreeniewload")); TLT.logScreeniewUnload(DOMString name) L'application peut utiliser cette API pour enregistrer un message de déchargement de ue écran dans le flux de message de la bibliothèque IBM Tealeaf CX UI Capture j2. Exemple function calllogscreeniewunload(){ TLT.logScreeniewUnload("logScreeniewUnload name"); TLT.getSessionData() Cette API renoie un objet de données de session IBM Tealeaf. Les informations d'id de session IBM Tealeaf sont incluses dans ces données. Un indicateur facultatif signale si l'id de session doit être dérié par hachage de la aleur de session de l'objet. Voici un exemple d'une aleur renoyée. { tltscn: "PHPSESSID", tltscv: "joese2pun5nus50p45j38hrak5", tltscvneedshashing: true // Optional Pour que cette API puisse être actiée, la bibliothèque doit être configurée correctement. Les paramètres de configuration indiquent à la bibliothèque l'emplacement d'où dérier les informations d'id de session. Si l'api n'est pas actiée dans la configuration ou que les données spécifiées ne sont pas lisibles, la aleur null est renoyée. Exemple function getsessiondata() { ar _sessiondata = TLT.getSessionData(); ar sessionid = _sessiondata.tltscn; ar sessionval = _sessiondata.tltscv; erifysessiondata(sessionid, sessionval) 66 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

75 TLT.registerBridgeCallbacks Cette API peut être utilisé pour enregistrer des fonctions de rappel, qui sont appelées par la bibliothèque CX UI Capture j2 dans des cas précis. Remarque : Il s'agit d'une API étendue, ce qui peut entraîner un fonctionnement incorrect ou la perte de données en cas d'utilisation erronée. Cette API ne doit pas être utilisée dans une application hybride car les structures de consignation naties d'ibm Tealeaf enregistrent et utilisent des rappels de pont appropriés. Actuellement, trois types de rappels sont pris en charge : messageredirect, screencapture et addrequestheaders. Exemple d'enregistrement d'un rappel TLT.registerBridgeCallbacks([ {enabled: true, cbtype: screencapture, cbfunction: function (){tlbridge.screencapture();, {enabled: true, cbtype: messageredirect, cbfunction: function (data){tlbridge.addmessage(data); ]) Où messageredirectfunc, screencapturefunc et addrequestheadersfunc sont les fonctions de rappel. messageredirect Ce rappel peut être enregistré pour intercepter et rediriger les messages d'ui Capture. Lorsque ce rappel est enregistré, la bibliothèque UI Capture démarre la fonction de rappel pour chaque message aant de l'ajouter à la file d'attente. Deux paramètres sont transmis à la fonction de rappel : le message JSON sérialisé et le même message sous la forme d'un objet JaaScript. La fonction de rappel peut consommer les messages entièrement et renoyer une aleur nulle ou non définie. Dans ce cas, la bibliothèque UI Capture ignore le message. La fonction de rappel peut également modifier l'objet JaaScript ou le renoyer inchangé. Dans ce cas, la bibliothèque UI Capture place l'objet renoyé dans sa file d'attente interne. Cette API ne doit pas être utilisée dans une application hybride car les structures de consignation naties d'ibm Tealeaf enregistrent et utilisent ce rappel de pont. Exemple d'utilisation de messageredirectfunc function messageredirectfunc(msgstr, msg) { // Modify the mousedown type to a click if (msg.type === 4 && msg.eent.type === "mousedown") { msg.eent.type = "click"; return msg; screencapture Cette fonction de rappel peut être enregistrée afin d'actier une API JaaScript (oir screencapture) pour exécuter une capture d'écran. La bibliothèque UI Capture démarre la fonction de rappel lorsque l'api logscreencapture démarre. Chapitre 6. Référence des API publiques de CX UI Capture j2 67

76 TLT.logScreenCapture Cette API ne doit pas être utilisée dans une application hybride car les structures de consignation naties d'ibm Tealeaf enregistrent et utilisent ce rappel de pont. Exemple d'utilisation de screencapture function register_screenshot_enable_callback() { TLT.registerBridgeCallbacks([ { enabled: true, cbtype: "screencapture", cbfunction: mycbfunction ]); addrequestheaders Cette fonction de rappel peut être enregistrée afin d'actier un code JaaScript pour renoyer les en-têtes HTTP personnalisés qui doient être définis dans les requêtes POST des bibliothèques UI Capture. Exemple d'utilisation de addreqheadersfunc count = 1; function addreqheadersfunc() { ar headers = [ { name: "X-Counter", alue: count ]; if (count === 1) { // Add a recurring header the 1st time. headers.push({ name: "X-Custom-Id, alue: customid, recurring: true ); count++; return headers; Cette API commande à la fonctionnalité natie sous-jacente d'exécuter une capture d'écran. Cette fonctionnalité est uniquement disponible lorsqu'un rappel screencapture est enregistré aec la bibliothèque UI Capture par le code natif. Exemple if (TLT && TLT.isInitialized()) { TLT.logScreenCapture(); 68 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

77 Chapitre 7. Foire aux questions sur CX UI Capture j2 Mise en route Cette section est une Foire aux questions concernant l'acquisition, l'implémentation et l'utilisation de la bibliothèque IBM Tealeaf CX UI Capture j2 qui est fournie par CX UI Capture j2. Remarque : Sauf indication contraire, les questions et les réponses présentées dans cette section s'appliquent uniquement à IBM Tealeaf CX UI Capture j2. Définition de CX UI Capture j2 CX UI Capture j2 comprend une bibliothèque JaaScript, un exemple d'application côté sereur et de la documentation. CX UI Capture j2 ous permet de capturer les interactions du isiteur aec la page Web (clics de souris, saisies au claier, actions de défilement, interactions tactiles, etc.), l'enironnement de naigateur (dimensions de fenêtre, etc.) et des informations de performance (par exemple, les temps d'affichage). CX UI Capture j2 collecte ces informations et génère un message qui est ensuite posté dans une page cible sur le sereur d'applications. La page cible n'effectue aucun traitement et renoie un code d'état HTTP 200. La publication peut se produire sur l'éénement unload après un interalle de temps prédéfini ou lorsque la file d'attente de messages a atteint une taille prédéfinie. Comme le produit principal d'ibm Tealeaf capture toutes les interactions de demande et de réponse entre le naigateur et le sereur, les données CX UI Capture j2 postées peuent être utilisées pour relire les interactions utilisateur qui se sont produites dans la page et pour générer des rapports associés. Quelles sont les ersions d'ui Capture disponibles? UI Capture est disponible dans deux ersions. Depuis la ersion 8.6, IBM Tealeaf fournit IBM Tealeaf CX UI Capture j2. CX UI Capture j2 soumet les données dans un schéma JSON mis à jour. IBM Tealeaf CX UI Capture j2 est requis pour IBM Tealeaf cxoerstat. Pourquoi ai-je besoin de l'application CX UI Capture j2? CX UI Capture j2 capture les interactions d'utilisateur aec une application. Certaines données d'acquis utilisateur existent seulement dans le naigateur et ne sont jamais retransmises au sereur. Ces données incluent par exemple les temps de rendu, l'ordre des entrées de champ de formulaire et l'abandon de formulaire. La relecture des applications Web Ajax nécessite l'insertion de CX UI Capture j2 JaaScript afin de permettre la capture des éénements d'interface utilisateur générés suite à l'interaction d'utilisateur aec l'application. Ces éénements d'interface utilisateur capturés sont utilisés pour stimuler l'application au cours de la relecture afin de correspondre aux demandes/réponses Ajax. Copyright IBM Corp. 1999,

78 Procédure d'implémentation de CX UI Capture j2 Les étapes suiantes décrient le processus d'implémentation de base d'ibm Tealeaf CX UI Capture j2. 1. Déterminez les pages qui doient être instrumentées. En général, ces pages incluent des fonctionnalités basées sur JaaScript qui présentent un intérêt. Pour plus d'informations, contactez 2. Procurez-ous la bibliothèque sur otre emplacement de distribution de logiciels. Pour plus d'informations sur le téléchargement d'ibm Tealeaf, oir IBM Passport Adantage Online. Pour obtenir les dernières informations de ersion, consultez les notes sur l'édition publiées à l'adresse Vous pouez accéder à l'aide en ligne d'ibm Tealeaf par le biais du menu Aide dans otre portail IBM Tealeaf. Si ous connaissez la connexion de otre société, utilisez l'adresse URL ci-dessus. 3. Consultez la documentation en ligne ou dans le fichier PDF fourni aec la bibliothèque. La documentation en ligne est la ersion la plus à jour. 4. Déterminez les options de capture qui sont requises pour otre application Web. Ces options peuent arier selon les pages du site Web. 5. En fonction des options sélectionnées, modifiez les fichiers de configuration JaaScript qui sont fournis dans la bibliothèque. Remarque : IBM Tealeaf CX UI Capture j2 intègre une interface graphique pour ous aider à configurer otre solution CX UI Capture j2. Cet assistant de configuration effectue la alidation des données et configure IBM Tealeaf JaaScript en fonction de os sélections. Voir Chapitre 3, «Assistant de configuration de CX UI Capture j2», à la page Modifiez la page JaaSerer (.jsp) fournie par IBM Tealeaf en fonction de os besoins. Vous pouez aussi choisir de la répliquer dans un autre langage de sereur, comme ASP ou PHP. Cette page accepte les publications d'ibm Tealeaf JaaScript exécutées sur le naigateur et renoie un code de succès. Elle n'éalue pas et ne manipule pas non plus les données reçues, qui sont transmises et traitées par otre système IBM Tealeaf. 7. Modifiez les pages qui appellent la bibliothèque CX UI Capture j2 afin d'intégrer IBM Tealeaf JaaScript. 8. Dans un enironnement de test ou dans une page de otre site de production qui n'est pas destinée à la production, publiez la page cible d'ibm Tealeaf, le logiciel IBM Tealeaf JaaScript configuré et les pages modifiées. Remarque : Cet enironnement doit être capturé par IBM Tealeaf en tant qu'instance d'enironnement de test distinct ou en tant qu'instance de production configurée pour séparer le trafic de test du trafic de production. 9. Testez les pages Web pour ous assurer que le logiciel IBM Tealeaf JaaScript ajouté interagit correctement aec la page. 10. Testez le trafic capturé dans otre instance d'ibm Tealeaf afin de érifier que le trafic d'interface utilisateur a été capturé. Dans certaines situations, ous deez modifier les règles de relecture afin de pouoir relire correctement ces sessions. En cas de problème, consultez la documentation ou contactez Après aoir érifié que tous les éléments d'interface utilisateur instrumentés ont été correctement capturés et traités par IBM Tealeaf, publiez les 70 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

79 modifications dans otre enironnement de production en suiant os processus de contrôle des modifications et de publication standard. Quelle est la taille de CX UI Capture j2? Lorsqu'CX UI Capture j2 JaaScript est conerti dans une ersion de production réduite et compressée, il représente eniron 22 Ko. Est-ce que je peux regrouper la bibliothèque CX UI Capture j2 aec d'autres ressources JaaScript? Non. Il n'est pas possible d'associer la bibliothèque CX UI Capture j2 à d'autres ressources JaaScript. IBM Tealeaf reconnaît que certains clients regroupent leurs ressources JaaScript dans un fichier unique afin de simplifier le déploiement des contenus statiques. Toutefois, en raison des risques et des coûts inhérents au regroupement JaaScript, IBM Tealeaf ne prend pas en charge cette opération. Ces risques sont présentés ci-dessous. Risques La bibliothèque IBM Tealeaf est indépendante de tout autre code exécuté dans le cadre de otre application Web. Cette séparation doit rester la règle d'or otre politique générale. Le naigateur traite chaque balise d'inclusion JaaScript comme une unité d'exécution unique. Lorsque ous regroupez des ressources JaaScript, une dépendance est créée entre des bibliothèques indépendantes. Une erreur dans un seul des scripts regroupés peut empêcher l'exécution des autres bibliothèques. Dans le pire des scénarios, une erreur dans un script connexe, tel qu'ibm Tealeaf, peut entraîner l'indisponibilité de l'application. Si le regroupement est inéitable, le client est responsable de la limitation des risques en procédant à des tests exhaustifs du package regroupé pour érifier qu'aucune erreur n'a été introduite. Autres coûts du regroupement Des tests doient être réalisés sur la bibliothèque regroupée par rapport à l'application et sur chaque bibliothèque, le cas échéant. Les ressources IBM Tealeaf JaaScript peuent nécessiter la érification des mises à jour de configuration et des dierses itérations. Les modifications de script ou les mises à nieau de bibliothèque indiiduelles nécessitent un bundle totalement refondu à ersionner, tester et déployer. Problèmes potentiels La résolution des problèmes dans un script regroupé est plus complexe. Les bibliothèques indiiduelles ne peuent pas aisément être actiées ou désactiées à l'aide des outils de proxy tels que Fiddler. Remarque : Si la séparation d'ibm Tealeaf JaaScript est incontournable, dans la plupart des cas IBM Tealeaf JaaScript doit être le dernier composant du bundle. Consultez les serices professionnels d'ibm afin d'assurer une gestion efficace du déeloppement et du déploiement du bundle. Chapitre 7. Foire aux questions sur CX UI Capture j2 71

80 Est-ce que CX UI Capture j2 a impacter les performances ou le comportement de mon site Web? La bibliothèque est conçue pour réduire la charge sur le sereur Web et sur la page Web exécutée dans le naigateur. Dans le cadre de la procédure d'implémentation décrite ci-dessus, le logiciel JaaScript téléchargé est réduit et mis en cache par le naigateur. Grâce aux optimisations du sereur Web, ous pouez améliorer les performances à l'aide des paramètres de mise en cache et de compression côté sereur. Voir Chapitre 2, «Installation et implémentation de CX UI Capture j2», à la page 9. L'application sereur acceptant les publications est très simple et n'a pas d'incidence sur les données. Les publications de la bibliothèque ajoutent un ou deux hits supplémentaires à chaque page capturée par IBM Tealeaf. Comme la taille du hit est petite, les besoins de stockage d'ibm Tealeaf augmentent généralement de moins de 10 %. De par sa conception, le système IBM Tealeaf ne mélange pas ces hits aec les hits de page standard dans les rapports de comptage de pages. Si ous intégrez la bibliothèque, ous derez peut-être configurer otre solution IBM Tealeaf aec de nouelles règles de relecture afin d'obtenir une meilleure fidélité de relecture. Où obtenir la dernière ersion de CX UI Capture j2? Pour obtenir la ersion la plus récente du code JaaScript de CX UI Capture j2, accédez au serice IBM Passport Adantage Online. Quels sont les éléments capturés par CX UI Capture j2? Selon la configuration de la bibliothèque, CX UI Capture j2 peut capturer des temps de rendu, des dimensions de naigateur, des éénements de l'interface utilisateur (clics, entrée de texte, informations de défilement, etc.) et plus encore. Voir Chapitre 1, «IBM Tealeaf CX UI Capture j2», à la page 1. Je rencontre des problèmes lors de l'implémentation de CX UI Capture j2. Comment obtenir de l'aide ou une assistance technique? Pour contacter le serice clients, isitez le portail du support IBM ou connectez-ous à l'aide de otre compte SalesForce. Utilisation de CX UI Capture j2 Comment configurer ce qui est capturé par CX UI Capture j2? Actuellement, la solution IBM Tealeaf CX UI Capture j2 ne prend pas en charge les nieaux de capture dynamiques ou configurables. 72 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

81 CX UI Capture j2 sureille un ensemble prédéfini d'éénements et de propriétés de l'interface utilisateur en enoyant des messages pour ceux qui sont détectés et capturés. Voir "Propriétés JSON Tealeaf" dans le document IBM Tealeaf Client Framework Data Integration Guide. Vous pouez configurer CX UI Capture j2 afin de capturer des éénements personnalisés spécifiques à otre application Web. Voir "UI Capture j2 Public API Reference". Quels sont les éléments capturés à partir des sessions Web mobiles? Les sessions Web mobiles sont capturées à l'aide du même schéma JSON que celui utilisé pour les sessions de bureau, aec certaines exceptions. Voir "Référence de schéma d'objet JSON Tealeaf" dans le document IBM Tealeaf Client Framework Data Integration Guide. Que dois-je faire si je rencontre un bogue dans CX UI Capture j2? Si ous rencontrez un bogue, accédez au portail du support d'ibm pour le signaler. Préparez les informations suiantes : La ersion de CX UI Capture j2 (indiquée dans tealeaf.js ou tealeaf.min.js sous la ) Le numéro de ersion du portail d'ibm Tealeaf (en bas de chaque page du portail) La ersion de CX RealiTea Viewer (s'il est utilisé) Une session IBM Tealeaf ne contenant aucune information sensible Comment créer des éénements à partir des données CX UI Capture j2? IBM Tealeaf CX UI Capture j2 soumet les données au format JSON. Vous pouez créer des éénements et des attributs d'étape à partir de ces données ia l'interface de relecture sur naigateur, en utilisant les éénements basés sur des étapes. Ces objets d'éénement sont modifiables dans Eent Manager en fonction des besoins. Voir "Propriétés JSON Tealeaf" dans le document IBM Tealeaf Client Framework Data Integration Guide. Voir "Eénements basés sur des étapes" dans le document IBM Tealeaf CX Eent Manager Manual. Voir "Tealeaf Eent Manager" dans le document IBM Tealeaf CX Eent Manager Manual. Comment rechercher des données CX UI Capture j2? Les données basées sur JSON sont indexées et disponibles pour la recherche. Vous pouez également rechercher des données CX UI Capture j2 si ous aez créé des éénements et des attributs pour contrôler et capturer les données. Voir "Recherche des données de session" dans le document IBM Tealeaf cximpact User Manual. Voir "Eénements basés sur des étapes" dans le document IBM Tealeaf CX Eent Manager Manual. Chapitre 7. Foire aux questions sur CX UI Capture j2 73

82 Comment faire pour capturer uniquement des éénements mouseoer sur le menu? IBM Tealeaf CX UI Capture j2 ne prend pas en charge la capture des éénements mouseoer. Comment faire pour capturer des éénements keyup? La ersion JSON d'ibm Tealeaf CX UI Capture for AJAX ne permet pas de capturer les éénements keyup proenant du client. A la place, il sureille les éénements change pour les mêmes objets. Comment produire des rapports sur les messages d'erreur/de alidation côté client? IBM Tealeaf capture les données qui sont échangées entre le naigateur et le sereur Web. Pour capturer les données qui ne sont pas échangées entre le naigateur et le sereur Web, telles que la alidation côté client, ous deez créer des éénements personnalisés. Ainsi, toute condition de alidation ou d'erreur détectée sur le sereur et communiquée au client est enregistrée dans la session IBM Tealeaf. La alidation côté client est généralement réalisée par un fichier JaaScript exécuté sur le naigateur de l'utilisateur. Cette alidation n'entraîne pas d'échange de données entre le naigateur et le sereur Web. Alors que les messages de alidation côté client peuent être détectés au cours de la relecture de la session par la relecture des mêmes éénements d'entrée d'utilisateur qui entraînent des échecs de alidation, ils ne peuent pas être détectés par les éénements IBM Tealeaf qui s'exécutent sur le trafic réseau. Une solution consiste à intégrer les déclencheurs de alidation côté client au trafic réseau. A l'aide d'une API fournie aec CX UI Capture j2, ous pouez créer un éénement d'interface utilisateur personnalisé dans le naigateur aec le même code qui détecte et déclenche le message de alidation. Dans l'exemple suiant, une fonction de alidation côté client érifie qu'une zone d'entrée n'est pas ide. function Validation_Check(user_input_element) { if (!user_input_element.alue) { // Input is empty, alidation failed return FAILURE; return SUCCESS; Pour capturer ce déclencheur de alidation dans une session IBM Tealeaf, ous deez créer un éénement personnalisé à l'aide de la méthode TLT.logCustomEent(). La sortie générée peut être capturée à partir du format JSON. Quelle est la procédure à suire pour forcer l'enoi des éénements mis en file d'attente? Par défaut, IBM Tealeaf met en file d'attente les éénements d'interface utilisateur capturés pour la transmission en fonction des seuils prédéfinis. Dans certains cas, il 74 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

83 est nécessaire de forcer l'enoi d'un ensemble d'éénements mis en file d'attente sur le sereur Web pour qu'il soit capturé par IBM Tealeaf. Par exemple, si un élément d'interface utilisateur, tel qu'un bouton Soumettre, déclenche l'éénement onbeforeunload, l'exécution de ce code peut ider la file d'attente d'éénements aant que la chaîne onclick d'éénements n'ait été correctement soumise aux éénements mis en file d'attente. Dans ce cas, l'éénement onclick qui arrie après l'achèement du gestionnaire d'éénement du site est perdu. Pour traiter ces situations, la bibliothèque actie le idage forcé de la file d'attente d'éénements lors de la phase de déchargement. Pour démarrer cette API manuellement dans otre code, appelez TLT.flushAll(). Pour la première phase, la mesure du temps de rendu de page est la seule dont j'ai besoin. Y-a-t-il des paramètres de configuration qui limitent les requêtes POST à ce seul éénement? Vous pouez configurer l'assistant de configuration d'ui Capture de sorte que seules les données de performance soient soumises. Dans l'assistant de configuration d'ui Capture, actiez uniquement le module de performance et désactiez le module de relecture. Cette configuration force IBM Tealeaf CX UI Capture j2 à ne soumettre que les données de performance, qui incluent la mesure du temps de rendu de page. Voir "Assistant de configuration d'ui Capture j2". J'utilise DHTML sur mon formulaire d'emprunt. Est-ce que CX UI Capture j2 a capturer les éléments DOM affichés de manière dynamique? La gestion de DHTML est effectuée grâce à l'appel de TLT.rebind() qui attache les gestionnaires d'éénements à os éléments d'entrée créés dynamiquement. Quelle est la procédure à suire pour obtenir les temps de rendu de CX UI Capture j2? Vous pouez configurer l'assistant de configuration d'ui Capture de sorte que seules les données de performance soient soumises. Dans l'assistant de configuration d'ui Capture, actiez uniquement le module de performance et désactiez le module de relecture. Cette configuration force IBM Tealeaf CX UI Capture j2 à ne soumettre que les données de performance. Concernant tous les naigateurs modernes qui implémentent la spécification Temps de naigation de W3C, les temps de rendu sont obtenus par le biais du module de performance. Voir "Assistant de configuration d'ui Capture j2". Chapitre 7. Foire aux questions sur CX UI Capture j2 75

84 Faut-il absolument que des ID soient affectés aux éléments DOM que je souhaite capturer? Dans la mesure du possible, affectez des ID uniques aux éléments HTML deant faire l'objet d'un suii. Si ce n'est pas possible, affectez des ID uniques à l'élément HTML ancêtre le plus proche. En l'absence d'id, IBM Tealeaf CX UI Capture j2 génère un chemin XPath semblable à un chemin DOM (Document Object Model), qui se termine sur l'ancêtre le plus proche ayant un ID HTML alide. Puis-je personnaliser les codes JaaScript de CX UI Capture j2? Non. IBM Tealeaf UI Capture contient des bibliothèques configurables pour faciliter la capture des éénements d'interface utilisateur des isiteurs de otre application j2, notamment de nombreuses options de configuration pour la personnalisation des éénements à capturer et des méthodes de capture. Ces options sont indiquées dans la documentation du produit et dans les scripts de CX UI Capture j2. Pendant la relecture, Tealeaf et ses objets sont définis sous forme d'objets ides afin de désactier IBM Tealeaf. Ceci permet de bloquer l'exécution de Tealeaf pendant la relecture. Dans le cas précis où ous aez ajouté un code personnalisé, mais que ous ne l'aez pas désactié pendant la relecture, alors que le reste de Tealeaf est désactié pendant la relecture grâce à ReplaySplice JS, des erreurs JaaScript peuent se produire et interrompre cette relecture. Si ous ajoutez un code personnalisé, assurez-ous qu'il soit désactié dans ReplaySplice JS sur le sereur de relecture. Remarque : Les modifications autres que celles apportées au code JaaScript d'ibm Tealeaf CX UI Capture j2, qui ne sont pas implémentées par IBM Tealeaf dans le cadre d'un mandat des serices professionnels d'ibm, annulent la garantie concernant le logiciel. La prise en charge du code modifié n'est donc pas assurée par le programme Maintenance and Support d'ibm Tealeaf. Pour plus d'informations, contactez les serices professionnels d'ibm. Pourquoi des messages d'erreur interdomaine associés aux iframes sur mon site s'affichent-ils dans la console de débogage de mes naigateurs? Lorsque la solution CX UI Capture j2 est initialisée sur une page quelconque de otre application Web, elle tente de se connecter aux éléments frame sur la page. Cependant, si ces éléments frame ne sont pas dans le même domaine que l'application Web, la plupart des naigateurs enregistrent cette action comme un accès interdomaine et interdisent l'exécution du script CX UI Capture j2. Il n'y a aucun moyen d'anticiper le refus d'accès par les naigateurs en raison de cette restriction de sécurité. CX UI Capture j2 continue de fonctionner normalement, mais les actions qui sont exécutées dans l'iframe ne peuent pas être sureillées. 76 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

85 Certains naigateurs enregistrent un message d'erreur dans la console. Pour les besoins des fonctions CX UI Capture j2 qui sont décrites ci-dessus, ce message peut être ignoré car il n'a aucun effet négatif ni sur CX UI Capture j2, ni sur otre application. Mise à nieau de la bibliothèque Comment déterminer la ersion de la bibliothèque utilisée? Dans le cas d'ibm Tealeaf CX UI Capture j2, les informations de ersion de la bibliothèque sont indiquées dans l'en-tête X-Tealeaf. Voir "Présentation d'ui Capture j2". Comment déterminer la ersion du fichier TealeafTarget.jsp utilisée? Par le biais du naigateur, accédez au fichier TealeafTarget.jsp sur otre site Web en utilisant le paramètre de requête Version. L'URL suiante est un exemple. Remarque : Si cette URL ne renoie pas les informations de ersion, cela signifie que ous ne disposez pas de la dernière ersion. Quand procéder à une mise à nieau? Lorsque cela est possible, utilisez la dernière ersion d'ibm Tealeaf CX UI Capture j2. Si ous êtes confronté à des problèmes de capture de l'interface utilisateur, ous deez procéder à la mise à nieau ers la dernière ersion d'ibm Tealeaf CX UI Capture j2 car elle contient les toutes dernières améliorations. Vous pouez intégrer la mise à nieau de CX UI Capture j2 dans les processus de maintenance et de déploiement existants de otre application. Remarque : Aant de procéder à la mise à nieau, oir le document IBM Tealeaf CX UI Capture j2 Release Notes afin d'éaluer sa pertinence pour otre application Web. Comment faire pour rechercher les mises à jour disponibles? 1. Obtenez le numéro de ersion de otre installation en cours d'ibm Tealeaf CX UI Capture j2. Voir «Comment déterminer la ersion de la bibliothèque utilisée?». 2. Comparez ce numéro à la dernière ersion disponible. Pour plus d'informations sur le téléchargement d'ibm Tealeaf, oir IBM Passport Adantage Online. Les informations de ersion sont également publiées dans les Notes d'édition générales dans l'aide en ligne d'ibm Tealeaf. Chapitre 7. Foire aux questions sur CX UI Capture j2 77

86 78 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

87 Chapitre 8. Documentation et aide d'ibm Tealeaf IBM Tealeaf fournit une documentation et une aide aux utilisateurs, déeloppeurs et administrateurs. Affichage de la documentation du produit L'intégralité de la documentation des produits IBM Tealeaf est disponible sur le site Web suiant : Utilisez les informations du tableau suiant pour afficher la documentation des produits d'ibm Tealeaf : Tableau 3. Obtention de l'aide Pour afficher... Procédez comme suit... Documentation du produit Dans le portail IBM Tealeaf, accédez à? > Documentation du produit. Aide d'une page sur le portail IBM Tealeaf Dans le portail IBM Tealeaf, accédez à? > Aide de cette page. Documents disponibles pour les produits IBM Tealeaf Utilisez le tableau suiant pour afficher une liste des documents disponibles pour tous les produits IBM Tealeaf : Tableau 4. Documentation disponible pour les produits IBM Tealeaf Produits IBM Tealeaf Documents disponibles IBM Tealeaf CX IBM Tealeaf Customer Experience - Guide de présentation IBM Tealeaf CX Client Framework - Guide d'intégration des données IBM Tealeaf CX - Guide de configuration Guide d'ibm Tealeaf CX Cookie Injector IBM Tealeaf CX - Guide des bases de données Guide d'ibm Tealeaf CX Eent Manager IBM Tealeaf CX - Glossaire IBM Tealeaf CX - Guide d'installation Guide d'ibm Tealeaf CX PCA IBM Tealeaf CX PCA - Notes sur l'édition Copyright IBM Corp. 1999,

88 Tableau 4. Documentation disponible pour les produits IBM Tealeaf (suite) Produits IBM Tealeaf Documents disponibles IBM Tealeaf CX Guide d'ibm Tealeaf CX RealiTea Viewer Client Side Capture IBM Tealeaf CX RealiTea Viewer - Guide d'utilisation IBM Tealeaf CX - Notes sur l'édition IBM Tealeaf CX Release - Guide de mise à nieau IBM Tealeaf CX Support - FAQ sur le traitement des incidents IBM Tealeaf CX - Guide de traitement des incidents Guide d'ibm Tealeaf CX UI Capture j2 IBM Tealeaf CX UI Capture j2 - Notes sur l'édition IBM Tealeaf cximpact IBM Tealeaf cximpact - Guide d'administration IBM Tealeaf cximpact - Guide d'utilisation IBM Tealeaf cximpact - Guide de génération de rapports IBM Tealeaf cxconnect IBM Tealeaf cxconnect for Data Analysis - Guide d'administration IBM Tealeaf cxconnect for Voice of Customer - Guide d'administration IBM Tealeaf cxconnect for Web Analytics - Guide d'administration IBM Tealeaf cxoerstat IBM Tealeaf cxoerstat - Guide d'utilisation IBM Tealeaf cxreeal IBM Tealeaf cxreeal - Guide d'administration IBM Tealeaf cxreeal - Guide de l'api IBM Tealeaf cxreeal - Guide d'utilisation IBM Tealeaf cxverify IBM Tealeaf cxverify - Guide d'administration IBM Tealeaf cxview IBM Tealeaf cxview - Guide d'utilisation IBM Tealeaf CX Mobile IBM Tealeaf CX Mobile Android Logging Framework Guide IBM Tealeaf Android Logging Framework - Notes sur l'édition IBM Tealeaf CX Mobile - Guide d'administration IBM Tealeaf CX Mobile - Guide d'utilisation Guide d'ibm Tealeaf CX Mobile ios Logging Framework IBM Tealeaf ios Logging Framework - Notes sur l'édition 80 IBM Tealeaf CX UI Capture j2 - Guide d'ibm Tealeaf CX UI Capture j2

89 Annexe A. Communication entre domaines Dans des conditions de fonctionnement normales, CX UI Capture j2 enoie par des requêtes POST les données capturées à l'adresse URL configurée en utilisant le protocole (par exemple, HTTP ou HTTPS), le domaine ( et le port de la page parent. Cette méthode de déploiement est recommandée. Dans certains cas, il peut s'aérer nécessaire d'enoyer la demande POST CX UI Capture j2 à un autre sereur que celui de la page parent. Par exemple, le site peut être déployé aec un sereur dédié pour héberger la page cible disposant de son propre sous-domaine (tealeaf.website.com, par exemple). Ce cas de figure est illustré à la figure suiante : Pour exécuter ce type de requête POST, le site Web doit être configuré comme suit. 1. Déployez les éléments suiants ers le sereur interdomaine. La page cible IBM Tealeaf. Les fichiers JaaScript interdomaine Tealeaf à partir du package CX UI Capture j2. Une source HTML minimale pour inclure le code JaaScript et définir le domaine du document afin d'actier la communication entre domaines. Un exemple de code HTML (xdomainframe.html) est fourni ci-dessous. <!DOCTYPE html> <html> <head> <script type="text/jaascript"> // Ensure the document domain is set to the sub-domain. document.domain = "website.com"; </script> <script src="tealeaf.iframe.js" type="text/jaascript"></script> </head> Copyright IBM Corp. 1999,