Home

IBM Tealeaf Structure de journalisation mobile d`Android CX Guide

1. public void onPause G rez Tealeaf pendant l v nement onPause Tealeaf onPause this logicalPageName super onPause public void onResume G rez Tealeaf pendant l v nement onResume Tealeaf onResume this logicalPageName super onResume public void onDestroy G rez Tealeaf pendant l v nement onResume Tealeaf onDestroy this logicalPageName super onDestroy Impl mentation de screenViews Pour les pages dans lesquelles l tat ou le contexte peut tre modifi sans effectuer de rendu de la page IBM Tealeaf segmente les donn es entre les tats en utilisant un objet screen View Par exemple si une page contient plusieurs onglets chacun repr sentant une tape diff rente dans un processus de r glement des achats vous pouvez instrumenter chaque onglet de la page comme screen View distinct Pour impl menter un screenView pour une page compl tez les tapes suivantes Chapitre 1 Installation et mise en oeuvre 15 1 Si vous effectuez une extension partir de UICActivity d finissez un logicalPageName pour indiquer l utilisation de l activit Sinon logicalPageName est d fini sur le nom de la classe de l activit 2 Si l tape pr c dente n est pas termin e appelez Tealeaf logScreenview et transmettez logicalPageName Vous devez galement indiquer si la page en train de charger et de d charger est facultative Par exemple Tealeaf logScreenview activ
2. Remarque La derni re version de Structure de journalisation mobile d Android CX inclut de nouvelles configurations requises Voir Configuration de base la page 16 7 V rifiez que les types de contenu appropri sont captur s et transf r s par IBM Tealeaf Application de capture passive CX Voir Application de capture passive CX v rification de capture de trafic la page 26 Remarque Cette tape met sous tension le commutateur pour d marrer la capture et le traitement des donn es de l application mobile dans Tealeaf En fonction du volume de donn es vous pouvez utiliser le commutateur d arr t Voir Gestion du volume de trafic la page 26 8 Testez votre solution mise niveau Chapitre 1 Installation et mise en oeuvre 33 34 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Chapitre 2 Fichier de configuration Ce fichier de configuration pour la biblioth que Structure de journalisation mobile d Android CX est plac dans le dossier de documents d une application Android Il s appelle TLFConfigurableltems properties qui est un fichier de propri t s Java Param tres de niveau de consignation Les param tres de niveau de consignation configurent les param tres de consignation de base Tableau 1 Param tres de niveau de consignation ID article Description Valeurs LoggingLevel Le niveau actuel de consignation s applique Entier 0 5 uniquement lorsque le
3. ManualPostEnabled Si la valeur true est d finie la structure envoie des donn es au serveur uniquement lorsque votre application appelle requestManualServerPost Si la valeur false est d finie vous devez configurer les param tres suivants Remarque Vous ne pouvez pas activer ce param tre et DoPostOnIntervals ensemble true false DoPostOnintervals PostMessageTimelntervals Si la valeur true est d finie la structure envoie des donn es au serveur intervalles r guliers sp cifi s par PostMessageTimelntervals lorsque l application est en premier plan Cette valeur doit tre d finie sur true si ManualPostEnabled false Remarque Vous ne pouvez pas activer ce param tre et ManualPostEnabled ensemble A quelle fr quence la structure envoie t elle des donn es au serveur lorsque DoPostOnIntervals est d fini sur true Remarque Cette valeur doit tre d finie pour tre sup rieure PostMessageTimeout plus PostMessageDelayTimeToSendData true false Secondes Chapitre 2 Fichier de configuration 37 Tableau 4 Param tres de publication suite ID article Description Valeurs PostMessageTimeout D lai d attente pour les publications de la Secondes structure sur le serveur Si la structure ne re oit pas de r ponse du serveur dans ce d lai elle continue d essayer d envoyer des donn es Param tres de masque Ces param tres contr lent le masq
4. gt lt uses permission android name android permission ACCESS NETWORK STATE gt lt uses permission android name android permission ACCESS WIFI STATE gt lt uses permission android name android permission SET DEBUG APP gt Configurations syst me requises Pour d velopper les applications Android avec le kit de d veloppement de logiciels Android suivez ces configurations syst me et logiciel requises Syst mes d exploitation pris en charge Les versions prises en charge des syst mes d exploitation Windows Mac et Linux sont les suivantes e Windows XP 32 bits Vista 32 ou 64 bits ou Windows 7 32 ou 64 bits e Mac OS X 10 5 8 o version sup rieure x86 uniquement e Linux test sur Ubuntu Linux Lucid Lynx GNU C Library glibc 2 7 ou version sup rieure n cessaire Sur Ubuntu Linux version 8 04 ou version sup rieur n cessaire Les distributions 64 bits doivent pouvoir ex cuter des applications 32 bits Pour plus d informations concernant la prise en charge d applications de 32 bits consultez les notes d installation Ubuntu Linux Environnements de d veloppement sugg r s L environnement de d veloppement int gr Eclipse peut tre utilis pour d ployer Structure de journalisation mobile d Android CX Eclipse IDE 3 6 Helios ou version sup rieure Remarque Eclipse 3 5 Galileo n est pas pris en charge par la derni re version d Android Development Tools e Plug in d outils de d
5. CookieDomain ibm com Que vous souhaitiez cr er un cookie s curis qui peut uniquement tre envoy l aide de url https dans PostMessageUrl CookieSecure false Formats de date valides ASCTIME RFC1036 RFC1123 CookieExpiresFormat ASCTIME Lorsque la publication est envoy e l expiration des cookies correspond l heure actuelle le d lai d attente de session Le d lai d attente de session est en minutes SessionTimeout 30 Remarque Il est important d appeler votre serveur en premier pour obtenir un premier cookie sur lequel effectuer des mises en sessions qui est automatiquement obtenu lorsque vous activez l URL de commutateur d arr t sur l application Il est utilis pour regrouper toutes les donn es de capture Application de capture passive CX Configurez les requ tes dans une application Android IBM Tealeaf a besoin de toutes les requ tes pour que l identifiant de session soit plac dans les cookies de la requ te Cela active le syst me IBM Tealeaf pour collecter toutes les ressources en une seule session Si vous utilisez org apache http impl client DefaultHttpClient vous pouvez utiliser com tl uic http TLDefaultHttpClient qui ajoute l identifiant de session appropri dans le cookie de la requ te Si vous d cidez de ne pas utiliser la classe IBM Tealeaf tendue vous devez ajouter le code suivant aux classes suivantes Etendre org apache http impl client DefaultHTTPClient Si vous d cidez de ne
6. IBM Tealeaf Structure de journalisation mobile d Android Version 9 0 12 juin 2014 IBM Tealeaf Structure de journalisation mobile d Android CX Guide all m Important Avant d utiliser le pr sent document et le produit associ prenez connaissance des informations figurant la section Remarques la page 77 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 nouvelle dition inclut les mises jour Les informations qui y sont fournies sont susceptibles d tre modifi es avant que les produits d crits ne deviennent eux m mes disponibles En outre il peut contenir des informations ou des r f rences concernant certains produits logiciels ou services 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 vous aux documents d annonce disponibles dans votre pays ou adressez vous votre partenaire commercial Vous pouvez galement consulter les serveurs Internet suivants e http www fr ibm com serveur IBM en France e http www can ibm com serveur IBM au Canada e http www ibm com serveur IBM aux Etat
7. Classe Tealeaf la page 49 Biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX utilis e pour capturer les actions utilisateur com tl uic http Classe TLDefaultHttpClient la page 58 Etend DefaultHttpClient pour surveiller les requ tes d URL TLHttpRequestInterceptor Etend HttpRequestInterceptor pour ajouter des en t tes IBM Tealeaf pour la mise en sessions Classe TLHttpResponselnterceptor la page 61 Etend HttpResponselnterceptor pour obtenir des d tails pour l objet de connexion Tealeaf com tl uic webkit Classe UICWebView la page 62 WebView utilis pour ajouter un ID de session ID aux requ tes d en t tes Classe UICWebChromeClient la page 64 Etend WebChromeClient pour surveiller si le navigateur a termin son action il est ensuite possible d effectuer des captures d cran IBM Tealeaf Structure de journalisation mobile d Android CX Guide Tableau 18 Classe TLHttpRequestinterceptor suite Package Classe Description Classe UICWebViewClient la page 65 Etend WebViewClient pour surveiller le chargement des URL pour ajouter des en t tes de mise en sessions IBM Tealeaf Classe TLHttpResponselnterceptor La classe com tl uic http TLHttpResponselnterceptor tend org apache http HttpResponselnterceptor Vous pouvez utiliser TLHttpResponselnterceptor pour obten
8. Modifications de projet Android Une fois que vous avez acquis IBM Tealeaf Structure de journalisation mobile d Android CX compl tez les tapes suivantes pour installer les biblioth ques Structure de journalisation mobile d Android CX dans un projet d application Android Votre projet Eclipse doit inclure les structures suivantes Test de Structure de journalisation mobile d Android CX associ Android 2 2 4 3 3 Installation de UICAndro d jar Utilisation d Eclipse pour installer uicandroid jar Suivez ces instructions pour utiliser l environnement de d veloppement Eclipse int gr pour installer uicandroid jar dans une application Android 1 Dans Eclipse ouvrez l application Android instrumenter 2 Placez uicandroid jar dans le dossier lib 3 Effectuez un clic droit sur uicandroid jar et s lectionnez Build Path 4 Cliquez sur Add on Build Path Installation de uicandroid jar dans un autre environnement Dans des environnements de d veloppement int gr s autre que Eclipse ajoutez UICAndroid jar au chemin de g n ration de l application que vous souhaitez instrumenter Installation de TLFConfigurableltems properties Pour installer le fichier TLFConfigurableltems properties placez le dans le dossier assets de l application Android Auto instrumentation non prise en charge Android permet d utiliser un gestionnaire la fois pour n importe quel objet Par cons quent Structure de journalisation mobile
9. extraire Remarque Pour Application de capture passive CX build 3502 ou ult rieur cette d compression se fait automatiquement Si vous utilisez une de ces versions Application de capture passive CX cette tape de la configuration n est pas n cessaire 1 Dans la console Web Application de capture passive CX cliquez sur l onglet Pipeline 2 S lectionnez Inflate compressed requests and responses 3 Enregistrez les modifications Les POST compress s sont d sormais automatiquement extraits par Application de capture passive CX et trait s normalement Options de contr le des captures et du traitement Vous pouvez utiliser diff rents outils pour tester vos captures de configuration et de contr le sur une base continue A la page cible Vous pouvez tester la fonctionnalit de base de la page cible en d clenchant les actions GET et POST sur l URL o la page cible a t install e Voir UI Capture for Ajax Installation and Implementation dans le guide IBM Tealeaf Capture d interface utilisateur CX pour AJAX Dans le pipeline Windows Vous pouvez contr ler la capture et le traitement des occurrences dans le pipeline Windows en temps r el en passant par le syst me de gestion IBM Tealeaf Voir TMS Pipeline Status Tab dans le document IBM Tealeaf cxImpact Administration Manual Configuration de la mise en sessions pour les applications Android dans IBM Tealeaf IBM Tealeaf fournit plusieurs m canismes d ide
10. 57 R f rence Tableau 16 Classe Tealeaf Package Classe Description com tl uic app Classe UICActivity la page 45 UICActivity utilis pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX Classe UICApplication la page 48 Application utilis e pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX com tl uic TeaLeaf Biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX utilis e pour capturer les actions utilisateur com tl uic http Classe TLDefaultHttpClient Classe TLHttpRequestInterceptor la page 60 Etend DefaultHttpClient pour surveiller les requ tes d URL Etend HttpRequestInterceptor pour ajouter des en t tes IBM Tealeaf pour la mise en sessions Classe TLHttpResponselnterceptor la page 61 Etend HttpResponselnterceptor pour obtenir des d tails pour l objet de connexion IBM Tealeaf com tl uic webkit Classe UICWebView la page 62 WebView utilis pour ajouter un ID de session ID aux requ tes d en t tes Classe UICWebChromeClient la page 64 Etend WebChromeClient pour surveiller le navigateur il est ensuite possible d effectuer des captures d cran Classe UICWebViewClient la page 65 Etend WebViewClient pour surveiller le chargement des URL pour ajouter des en t t
11. IBM Tealeaf Structure de journalisation mobile d Android CX 8 8 iOS Logging Framework for Windows sur IBM Passport Advantage en ligne Le package contient les composants logiciels suivants Copyright IBM Corp 1999 2014 1 e KillSwitch Code pour impl menter le gestionnaire de trafic du commutateur d arr t pour diff rentes technologies de serveur ASPX killswitch aspx page avec logique web config fichier de configuration utilis par la page JSP killswitch jsp page avec logique config properties fichier de configuration utilis par la page PHP killswitch php page avec logique config ini fichier de configuration utilis par la page e UICAndroid uicandroid jar fichier JAR de biblioth que Android qui contient Structure de journalisation mobile d Android CX TLFConfigurableItems properties fichier de configuration e SampleCode contient les versions suivantes d un chantillon d application Android UICSP_Clean une application Android sans IBM Tealeaf Structure de journalisation mobile d Android CX int gr UICSP_ManualLog une application Android avec IBM Tealeaf Structure de journalisation mobile d Android CX int gr UICSP_ManualLog_ServerSessionID une application Android avec IBM Tealeaf Structure de journalisation mobile d Android CX int gr l aide d un ID de session fourni par une application Web Voir Sample Code dans le guide IBM Te
12. Jows soa u s 74 Chapitre 8 Documentation et aide d IBM Tealeaf 75 Remarques a 77 Marques 5 479 Remarques sur les r gles de confidentialit e iii iv IBM Tealeaf Structure de journalisation mobile d Android CX Guide Avis aux lecteurs canadiens Le pr sent document a t traduit en France Voici les principales diff rences et particularit s dont vous devez tenir compte Illustrations Les illustrations sont fournies titre d exemple Certaines peuvent contenir des donn es propres la France Terminologie La terminologie des titres IBM peut diff rer d un pays l autre Reportez vous au tableau ci dessous au besoin IBM France IBM Canada ing nieur commercial repr sentant agence commerciale succursale ing nieur technico commercial informaticien inspecteur technicien du mat riel Claviers Les lettres sont dispos es diff remment le clavier fran ais est de type AZERTY et le clavier fran ais canadien de type QWERTY OS 2 et Windows Param tres canadiens Au Canada on utilise e les pages de codes 850 multilingue et 863 fran ais canadien e le code pays 002 e le code clavier CF Nomenclature Les touches pr sent es dans le tableau d quivalence suivant sont libell es diff remment selon qu il s agit du clavier de la France du clavier du Canada ou du clavier des tats Unis Reportez vous ce
13. 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 Certaines juridictions n autorisent pas l exclusion des garanties implicites auquel cas l exclusion ci dessus ne vous sera pas applicable Copyright IBM Corp 1999 2014 77 78 Le pr sent document peut contenir des inexactitudes ou des coquilles Ce document est mis jour p riodiquement Chaque nouvelle dition inclut les mises jour IBM peut tout moment et sans pr avis modifier les produits et logiciels d crits dans ce document Les r f rences des sites Web non IBM sont fournies titre d information uniquement et n impliquent en aucun cas une adh sion aux donn es qu ils contiennent Les l ments figurant sur ces sites Web ne font pas partie des l ments du pr sent produit IBM et l utilisation de ces sites rel ve de votre seule responsabilit IBM pourra utiliser ou diffuser de toute mani re qu elle jugera appropri e et sans aucune obligation de sa part tout ou partie des informations qui lui seront fournies Les licenci s souhaitant obtenir des informations permettant i l change des donn es entre des logiciels cr s de fa on ind pendante et d autres logiciels dont celui ci et ii l utilisation mutuelle des donn es ainsi chang es doivent adresser leur demande IBM Bay Area Lab 1001 E Hillsdale Boulevard Foster City Californ
14. Tealeaf pour la mise en sessions Classe TLHttpResponselnterceptor la page 61 Etend HttpResponselnterceptor pour obtenir des d tails pour l objet de connexion IBM Tealeaf com tl uic webkit Classe UICWebView la page 62 WebView utilis pour ajouter un ID de session ID aux requ tes d en t tes Classe UICWebChromeClient la page 64 UICWebViewClient Etend WebChromeClient pour surveiller si le navigateur a termin son action il est ensuite possible d effectuer des captures d cran Etend WebViewClient pour surveiller le chargement des URL pour ajouter des en t tes de mise en sessions IBM Tealeaf IBM Tealeaf Structure de journalisation mobile d Android CX Guide Chapitre 6 Code d chantillon Ce chapitre contient un chantillon de code pour IBM Tealeaf Structure de journalisation mobile d Android CX Comment instrumenter les contr les TextView Comme les contr les TextView sont utilis s pour les champs de texte vous devez instrumenter OnFocusChangeListener pour obtenir du temps de passage et d autres donn es afin de savoir quel moment un utilisateur commence et termine de saisir du texte Obtenez un contr le TextView final EditText nameEditText EditText findViewById R id nameEditText Cr ez un OnFocusChangeListener OnFocusChangeListener focusListen nouveau OnFocusChangeListener public vide onFocusChange View view bool en hasFocu
15. d Android CX ne peut pas effectuer d auto instrumentation d objets Vous devez appliquer l instrumentation dans le cadre du d veloppement de votre application 4 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Pr paration la mise en production Pour am liorer les performances de la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX d finissez les configurations ci apr s dans la biblioth que Dans le fichier TLFConfigurableltems properties Affectez DisplayLogging la valeur false car vous n avez pas besoin de messages logcat suppl mentaires Assurez vous de disposer d un commutateur d arr t activ et d une URL op rationnelle Sp cifiez un niveau de consignation correct pour la production si en phase de d veloppement sa valeur tait plus lev e Assurez vous que les valeurs de mise en sessions sont ajust es pour la page cible du serveur de production Affectez GetImageDataOnScreenLayout la valeur false pour d sactiver la capture des donn es base64 qui augmente le contenu Int gration l aide des classes Android IBM Tealeaf tendues Pour cette m thode les d veloppeurs tendent partir de la classe de la biblioth que de capture IBM Tealeaf qui s tend partir de la biblioth que de structure Android Modifications de code du fichier android app Application le fichier d application g re le cycle de vie d une application Android IBM Tealeaf g r
16. de android app Application Pour localiser le fichier qui s tend partir de android app Application 1 Ouvrez le fichier Java existant qui s tend partir de la classe android app Application Si ce fichier n existe pas vous devez le cr er et lui demander d couter le cycle de vie complet d une application Android pour contr ler la biblioth que et consigner les informations n cessaires 2 Ajoutez les importations suivantes a import com tl uic Tealeaf 3 Dans onCreate a Ajoutez Tealeaf tealeaf new Tealeaf this qui initialise la biblioth que IBM Tealeaf avec une r f rence l application instrument e b Ajoutez Tealeaf enable qui initialise la capture d actions utilisateur dans l application 4 Dans onLowMemory a Ajoutez Tealeaf onLowMemory avant super pour qu il puisse ajuster la biblioth que en raison d une m moire faible 5 Dans onTerminate a Ajoutez Tealeaf disable avant super pour qu il puisse d sactiver la biblioth que Chapitre 1 Installation et mise en oeuvre 7 6 Ajustez Androi dManifest xml pour indiquer la classe d application Par exemple si votre classe d application s intitule MyApplication vous pouvez ajouter Aandroid name MyApplication dans le noeud lt application gt 7 Ajoutez les droits suivants dans Andro dManifest xml lt uses permission android name android permission INTERNET gt lt uses permission android name android permission ACC
17. de dialogue d alerte e message Message affich dans la bo te de dialogue d alerte Indique si la disposition a t consign e logScreenLayoutSetOnCreate public static Boolean logScreenLayoutOnCreate final Activity activity final String name Consignez la disposition de l activit avec OnGlobalLayoutListener pour savoir quand la vue est termin e e activity Activit consigner e name Nom de la disposition Indique si la disposition a t consign e logConnection public static java lang Boolean logConnection final java lang String url final org apache http HttpResponse httpResponse final java util Date initTime final long loadTime final long responseTime Consignez une connexion e url Url de la connexion e httpResponse HttpResponse de la connexion e initTime Heure initiale de la r ponse e loadTime Heure de chargement de la r ponse 56 IBM Tealeaf Structure de journalisation mobile d Android CX Guide e responseTime Temps de r ponse Renvoie True False si une connection a t consign e takeScreenShot public static java lang Boolean takeScreenShot final View view final java lang String imageFileName Effectuez une capture d cran de la vue donn e Remarque cette m thode n cessite de pouvoir enregistrer sur le terminal pour effectuer une capture d cran e vue Vue pour effectuer une capture d cran e imageFileName Nom de l image Renvoie True False si une c
18. du gestionnaire d v nements e eventType Type d v nement de gestionnaire d v nements e logLevel Niveau de journalisation de la biblioth que TeaLeaf Renvoie True False s il a t capable de consigner un v nement logCustomEvent public static java lang Boolean logCustomEvent final java lang String eventName public static java lang Boolean logCustomEvent final java lang String eventName final int logLevel public static java lang Boolean logCustomEvent final java lang String eventName final java util HashMap lt java lang String final java lang String gt data public static java lang Bool en logCustomEvent final java lang String eventName final java util HashMap lt java lang String java lang String gt data final int logLevel Consignez un v nement personnalis e _eventName Nom d v nement consigner IBM Tealeaf Structure de journalisation mobile d Android CX Guide e donn es Cl et paire de valeurs consigner e logLevel Niveau de journalisation de la biblioth que TeaLeaf Renvoie True False s il a t capable de consigner un v nement logException public static java lang Boolean logException final java lang Throwable exception public static java lang Boolean logException final java lang Throwable exception final java lang String extraMessage Consignez une exception e exception Exception consigner e extraMessage Message suppl mentaire qui a t plac a
19. es acquises depuis l environnement du client IBM Tealeaf recommande d utiliser les m thodes r f renc es ci dessous e Voir Configuration File dans le guide IBM Tealeaf Structure de journalisation mobile d Android CX e Pour plus d informations concernant la gestion de donn es sensibles en g n ral voir Managing Data Privacy in Tealeaf CX dans le document IBM Tealeaf CX Installation Manual Configuration de la mise en sessions pour les applications Android sur le client Structure de journalisation mobile d Android CX cr e automatiquement un ID de session si aucun ne vous est fourni Cet ID de session est utilis pour identifier la session sur le serveur IBM Tealeaf IBM Tealeaf injecte des cookies pour cr er une session dans le syst me IBM Tealeaf 16 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Remarque Lorsqu une application Android native ou hybride est plac e en arri re plan la biblioth que vide les donn es collect es et s arr te au lieu de d sactiver l application Cela se produit moins que la session ne soit arriv e expiration en raison de la propri t de d lai d expiration de session Cette propri t est indiqu e par SessionTimeout dans le fichier TLFConfigurableltems properties La valeur par d faut de cette propri t est de 30 minutes Une fois ce d lai coul un nouvel identificateur de session est cr Il existe deux moyens de configurer la mise en session
20. la messagerie JSON partir de cette structure client La version tapes de la messagerie JSON partir de cette structure client a t introduite avec la version 8 5 Pour les versions 8 5 et ult rieures IBM Tealeaf continue de prendre en charge la m thode existante de soumission des donn es partir des structures client qui ont entra n la scission de donn es soumises en occurrences individuelles dans le pipeline Windows Remarque Dans une version ult rieure la m thode de traitement de scission d occurrences des donn es soumises partir de structures client sera certainement obsol te Les instructions d installation et de mise en oeuvre pour la version existante sont similaires mais n cessitent une configuration suppl mentaire dans le pipeline Windows Pour plus d informations concernant les versions ant rieures notamment les tapes de mise en oeuvre utilisez les liens qui suivent D marrage rapide de l instrumentation de votre application Android Consultez les sections suivantes pour plus d informations concernant l instrumentation de votre application pour que Structure de journalisation mobile d Android CX puisse effectuer une capture de l interface utilisateur et des v nements d application Contenus du package Un seul fichier contient Structure de journalisation mobile d Android CX et ses composants logiciels IBM Tealeaf Structure de journalisation mobile d Android CX est distribu dans
21. pour applications mobiles Pour plus d informations contactez votre interlocuteur IBM Tealeaf Les licences doivent tre impl ment es dans leur code d application fourni par IBM Tealeaf Pour plus d informations sur le t l chargement d IBM Tealeaf voir IBM Passport Advantage en ligne Le guide IBM Tealeaf Structure de journalisation mobile d Android CX fournit des instructions sur la mani re d activer la capture de donn es d applications mobiles directement sur l application install e sur le p riph rique Android du visiteur Remarque Utilisez la derni re version du logiciel IBM Tealeaf Structure de journalisation mobile d Android CX d s que possible Copyright IBM Corp 1999 2014 vii viii IBM Tealeaf Structure de journalisation mobile d Android CX Guide Chapitre 1 Installation et mise en oeuvre Le IBM Tealeaf Structure de journalisation mobile d Android CX pour les applications mobiles natives requiert la licence IBM Tealeaf CX Mobile pour applications mobiles Pour plus d informations contactez votre repr sentant IBM Tealeaf Les licences doivent tre impl ment es dans leur code d application fourni par IBM Tealeaf Pour plus d informations sur le t l chargement d IBM Tealeaf voir IBM Passport Advantage en ligne Versions de structure client prises en charge dans cette documentation Les instructions d installation et de mise en oeuvre dans ce guide s appliquent la version tapes de
22. straussandplesser com UITebB Controller UINavigetionContraller TProtcLogirisewController Mtp fivw straussandpiesser com UITabBar Controller UINavigstionController TProtoCategonestiemControlier Hitp f we straussandplesser com TProto plashtemControlier Ptp ivaew straussandpiesser comJUTT aba Controller fUINavigationControli r TProkoLoginNiemControler H tp fivmer sraussandplesser com UIT abs Controller fINavgebenContraller TBrotoC ategonestenController htpc www straussandplesser com UITab ar Controller UIMavigationcontroller TProtoOvderswewController Htps fuwew straussandplesser comTProtoSplashvemController H tpef veuw straussandplesser comUITab sr Controller uIMavigstionController TProtcLogintemControler te vwew straussandaiesser comUITabEsr Controler UINavigetionControiler TProtoCstegonesvienControlier H tp fiuam straussandplesser comUITat w Controller UINavigstionController TProtoOrdersiewConkraller tpe straussandplesser com UIT abBar Controler UIMereNavigstinControi r UIMar tetConkroller hetp juw straussandpiesser com TProtoSplashiewControler etp fivem straussandplesser comUITabEar Controler UINavigationControlisr TProtoLoginiienC ontroer http juw straussandplesser com UITabBa Controller UlNawgstiorController TProtoCategoresiewControler hetpe fvaw straussandpiesser comUITabEs Controler AINawigationControiker TProtoOrdersviewontrolier http jvew straussandpiesser comjUIT ab8a Controller UiMoreNavigstionCorntraler UlMoreLstCont
23. tiHttpRequestInterceptor Etendre org apache http HttpRequestinterceptor Cette classe est utilis e pour injecter un identifiant de session en tant que cookie et des en t tes suppl mentaires que le syst me IBM Tealeaf utilise Importation java io I0Exception Importation java util Map Entry Importation org apache http HttpException Importation org apache http HttpRequest Importation org apache http HttpRequestInterceptor Importation org apache http protocol HttpContext Importation android webkit CookieManager Importation com tl uic Tealeaf Importation com tl uic util LogInternal xx author ohernandez La classe publique TLHttpRequestInterceptor met HttpRequestInterceptor en oeuvre Cha ne priv e url Cha ne finale priv e sessionId x x Constructeur TLHttpRequestInterceptor public super Chapitre 1 Installation et mise en oeuvre 19 this sessionid null xx x Constructeur x param sessionId identifiant de session Tealeaf TLHttpRequestInterceptor public cha ne finale sessionId this sessionId sessionId xx Obtenir l URL de la requ te Greturn l url de la requ te Cha ne publique finale getUrl return url xx x Url de la requ te Gparam url Url de la requ te Cha ne publique finale vide setUrl cha ne finale url this url url xx x inheritDoc Processus public final vide requ te HttpReq
24. utilisez le lorsque vous activez ou d marrez une nouvelle session dans Structure de journalisation mobile d Android CX Chapitre 1 Installation et mise en oeuvre 21 Si la structure de journalisation Android est activ e utilisez Tealeaf enable Tealeaf enable votre id de session Si la structure de journalisation Android est activ e et qu une nouvelle session doit tre cr e utilisez Tealeaf startSession Tealeaf startSession votre id de session Applications hybrides Une application est consid r e comme hybride si elle contient WebView dans l application Android Si vous utilisez WebView vous devez utiliser UICWebView pour consigner une activit de requ te dans WebView UICWebView tend WebView partir de la structure Android qui ins re l en t te IBM Tealeaf avec l ID de session actuel pour la mise en sessions Si vous d cidez de ne pas utiliser UICWebView vous devez alors tendre Webview pour ajouter une mise en session Voir UICWebView Class dans le guide IBM Tealeaf Structure de journalisation mobile d Android CX Etendre android webkit WebView Le mod le de code qui suit tend la base Android WebView avec UICWebView Importation java util Date Importation java util Map Importation org apache http HttpResponse Importation android annotation SuppressLint Importation android content Context Importation android util AttributeSet Importation android webkit WebView Importat
25. veloppement Java Eclipse inclus dans la plupart des packages Eclipse IDE e Pour plus d informations propos du t l chargement de l installation ou de la mise jour d Eclipse voir http www eclipse org downloads Diff rents types de packages Eclipse sont disponibles pour chaque plateforme Pour le d veloppement d applications Android installez un de ces packages e Eclipse IDE pour les d veloppeurs Java Java version 1 6 Java version 1 7 peut tre utilis s en mode compatibilit e Eclipse Classic e Eclipse IDE pour les d veloppeurs Java EE Kit Java Development 5 ou kit Java Development 6 l environnement d ex cution Java seul ne suffit pas Plug in Android Development Tools Non compatible avec le compilateur GNU pour Java gcj Chapitre 1 Installation et mise en oeuvre 3 Autres environnements de d veloppement Structure de journalisation mobile d Android CX peut tre d ploy par d autres environnements de d veloppement Un d veloppeur qui poss de de solides connaissances peut appliquer les exemples r pertori s ci dessous depuis Eclipse vers d autres environnements comme ant Incidence sur les ressources de p riph rique Dans les test de performances Structure de journalisation mobile d Android CX a les effets suivants sur les ressources du p riph rique du visiteur e 2 3 de consommation de m moire suppl mentaire e Effet minimum sur la dur e de vie de la batterie
26. 1 Classe UICActivity Package Classe Description com tl uic app UICActivity UICActivity utilis pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX Classe UICApplication la page 48 Application utilis e pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX com tl uic Classe Tealeaf la page 49 Biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX utilis e pour capturer les actions utilisateur com tl uic http Classe TLDefaultHttpClient la page 58 Etend DefaultHttpClient pour surveiller les requ tes d URL Classe TLHttpRequestInterceptor la page 60 Classe TLHittpResponselnterceptor la page 61 Etend HttpRequestInterceptor pour ajouter des en t tes IBM Tealeaf pour la mise en sessions Etend HttpResponselnterceptor pour obtenir des d tails pour l objet de connexion Tealeaf com tl uic webkit Classe UICWebView la page 62 WebView utilis pour ajouter un ID de session ID aux requ tes d en t tes Classe UICWebChromeClient la page 64 Etend WebChromeClient pour surveiller si le navigateur a termin son action il est ensuite possible d effectuer des captures d cran Classe UICWebViewClient la page 65 Etend WebViewClient pour surveiller le chargement des URL pour ajouter des en t tes de m
27. ESS NETWORK STATE gt lt uses permission android name android permission ACCESS WIFI STATE gt lt uses permission android name android permission SET DEBUG APP gt Exemple import android app Application import com tl uic Tealeaf public class MyApplication extends Application Override public void onCreate super onCreate Tealeaf tealeaf new Tealeaf this Tealeaf enable GOverride public void onLowMemory Tealeaf onLowMemory super onLowMemory Override public void onTerminate Tealeaf disable super onTerminate Modifications de code du fichier android app Activity Le fichier d activit g re le cycle de vie d une page dans une application Android native similaire aux t ches d une page dans une application Web IBM Tealeaf coute les v nements suivants onPause qui a lieu lorsque l application se met en arri re plan onResume qui a lieu lorsque l application se met en premier plan et onDestroy lorsque l activit n est plus en m moire et collecte les restes Localiser le fichier qui s tend partir de android app Application Pour localiser le fichier qui s tend partir de andro d app Activity 1 Ouvrez le fichier Java existant qui s tend partir de android app Activity 2 Ajoutez les importations suivantes a Importation com tl uic Tealeaf 3 Chaque activit a besoin d un nom de page logique qui permet d indiquer quelle activit e
28. Guide Entier Pourcentage Secondes Chapitre 3 Echantillon d applications L chantillon de code fourni avec la distribution de logiciel contient une application Android qui peut tre utilis e pour tester le syst me IBM Tealeaf Une version de code est fournie Version Description UICAndro dControlsAppDarkHolo Application Android qui disposent des contr les actuellement pris en charge que vous pouvez relire dans BBR avec des exemples d utilisation des programmes d coute d v nements avec l API Tealeaf Copyright IBM Corp 1999 2014 41 42 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Chapitre 4 Instructions Appliquez les conseils suivants au d veloppement et l int gration de votre application de IBM Tealeaf Structure de journalisation mobile d Android CX Utilisez le commutateur d arr t pour contr ler la journalisation de l application Android Voir Chapitre 6 Code d chantillon la page 67 Ajoutez des identifiants tous les contr les d interface utilisateur que vous souhaitez capturer Appliquez le masque ou le blocage de confidentialit de toutes les donn es client sensibles en passant par Structure de journalisation mobile d Android CX Remarque L dition 8 5 IBM Tealeaf a introduit les v nements tapes qui simplifient et unifient la capture d v nements partir de tous les environnements de capture c t client tout en am lioran
29. I_KEYBOARD_ DID SHOW NOTIFICATION Tealeaf logEvent v Tealeaf TLF ON FOCUS CHANGE IN else Tealeaf logEvent v com tl uic Tealeaf TLF ON FOCUS CHANGE OUT InputMethodManager imm InputMethodManager v getContext getSystemService Context INPUT METHOD SERVICE imm hideSoftInputFromWindow v getWindowToken 0 Chapitre 1 Installation et mise en oeuvre 11 12 KeyboardView keyboardView new KeyboardView v getContext getApplicationContext null Tealeaf logEvent keyboardView Tealeaf TLF UI_KEYBOARD _DID HIDE NOTIFICATION H Tealeaf registerFormField textView activity EditText et EditText findViewById R id editText1 addFocusAndRegister et this Pour plus d informations examinezControlsActivity3 java dans l exemple de projet de code UICAndro dControlsAppdarkHolo Contr les pris en charge IBM Tealeaf relit les contr les tendus partir des contr les ci apr s Pour chaque contr le IBM Tealeaf remplit la valeur t1Type dans l objet json qui est renvoy au serveur ToggleButton et Switch Utilise le mod le switch RadioGroup et RadioButton Utilise le mod le radioButton CheckBox Utilise le mod le checkBox Button Utilise le mod le button Scroller HorizontalScrollView Scroll View Utilise le mod le scroll AbsSeekBar Utilise le mod le slider ProgressBar Utilise le mod le progressSpinner ou progressBar AbsSpinner Utilise le mod le selectList EditTex
30. InMS Relecture des bo tes de dialogue d alerte Vous devez savoir quand une bo te de dialogue d alerte est affich e afin qu elle puisse tre captur e correctement OnShowListener est l emplacement correct utiliser pour cela Capture l arri re plan et l alerte lorsqu elle est affich e Tealeaf logScreenLayoutSetOnShowListener activity dialog Si OnShouListener existe d j suivez cet exemple Ceci est plac dans OnShowListener Tealeaf logScreenLayout activity dialog Pour capturer un v nement de bo te de dialogue d alerte suivez cet exemple public void onClick DialogInterface dialog int id Tealeaf logDialogEvent dialog id Relecture des v nements de clavier Android ne fournit pas d v nement pour d terminer quand un clavier logiciel appara t et dispara t Suivez l exemple ci apr s pour effectuer les ajustements n cessaires sur les contr les bas s sur TextView public static void addFocusAndRegister TextView textView Activity activity textView setOnFocusChangeListener new OnFocusChangeListener GOverride public void onFocusChange View v boolean hasFocus if hasFocus InputMethodManager imm InputMethodManager v getContext getSystemService Context INPUT METHOD SERVICE imm showSoftInput v InputMethodManager SHOW_ FORCED KeyboardView keyboardView new KeyboardView v getContext getApplicationContext null Tealeaf logEvent keyboardView Tealeaf TLF U
31. _MANUAL_POST_ENABLED Activation ou d sactivation du contr le d articles sur la page cible Le d veloppeur est responsable des articles sur la page cible static java lang String TLF_DO_POSTS_ON_INTERVALS Configurer ou non les articles de structures intervalles d finis static java lang String TLF_POST_MESSAGE_TIME_INTERVALS Intervalle de temps entre les articles static java lang String TLF_POST_MESSAGE_MAX_BYTES_SIZE Taille maximum en octets pour la publication d un message static java lang String TLF_HAS_MASKING Masquer ou non les valeurs de contr les static java lang String TLF_MASK_ID_LIST Cha ne d limit e par des virgules qui peut avoir des ID de contr les ou des expressions r guli res pour trouver les ID de contr les static java lang String TLF_HAS_CUSTOM_MASK Utilisation ou non de valeurs de masque personnalis es remplacer Si elle est d finie sur false la structure de journalisation renvoie une cha ne videg Chapitre 5 R f rence 51 Tableau 15 Classe Tealeaf suite Zone R capitulatif Description static TLF_SENSITIVE SMALL CASE _ALPHABET Lettre minuscule java lang String remplacer pendant le masque personnalis static TLF_SENSITIVE_CAPITAL_CASE_ALPHABET Lettre en java lang String majuscule remplacer pendant le masque personnalis static TLF_SENSITIVE
32. _SYMBOL Symbole java lang String remplacer pendant le masque personnalis static TLF_SENSITIVE_NUMBER Nombre java lang String remplacer pendant le masque personnalis Constructeur Public Tealeaf Application app TeaLeaf est une biblioth que qui permet de capturer des actions utilisateur d une application Android Param tres e application R f rence l application Android actuelle D tails des m thodes getCurrentSessionId public static java lang String getCurrentSessionId Obtenez l ID de session actuel getPhoneld public static java lang String getPhoneld Obtenez l ID utilis avec la liste blanche sur le serveur du commutateur d arr t setPhoneld public static setPhoneld vide java lang String phoneld D finissez l ID de t l phone utilis avec la liste blanche sur le serveur de commutateur d arr t isEnabled public static java lang Boolean isEnabled Activation d une biblioth que Indique si la biblioth que TeaLeaf a t activ e getApplication public static android app Application getApplication R f rence l application Android actuelle IBM Tealeaf Structure de journalisation mobile d Android CX Guide Renvoie les r f rences l application Android actuelle getMessageVersion public static String getMessageVersion Obtenez la version de message JSON actuelle Renvoie la version de message JSON actuelle getLibrary Version public static java lang Strin
33. ache http HttpResponse Importation org apache http HttpResponselnterceptor Importation org apache http protocol HttpContext Importation com tl uic TLFCache Importation com tl uic Tealeaf Importation com tl uic util LogInternal xx x author ohernandez La classe publique TLHttpResponseInterceptor met HttpResponseInterceptor en oeuvre TLHttpRequestInterceptor tlHttpRequestInterceptor priv final Date finale priv e startTime initTime final priv long xx Constructeur param tlHttpRequestInterceptor TLHttpRequestInterceptor utilis TLHttpResponseInterceptor public TLHttpRequestInterceptor final tlHttpRequestInterceptor this tlHttpRequestInterceptor tlHttpRequestInterceptor this startTime nouvelle date this initTime TLFCache timestampFromSession xx x inheritDoc Processus public final vide r ponse HttpResponse finale Contexte HttpContext final met HttpException IOException try Date finale endTime nouvelle date Date finale startLoad nouvelle date loadTime final long nouvelle date getTime startLoad getTime responseTime final long endTime getTime this startTime getTime Tealeaf logConnection this tlHttpRequestInterceptor getUrl r ponse this initTime loadTime responseTime intercepter exception finale e LogInternal logException e Utilise un ID de session non IBM Tealeaf Obtenez votre ID de session g n r et
34. aleaf Structure de journalisation mobile d Android CX Utilisation du mod le d application Vous pouvez d ployer le mod le d application fourni par IBM Tealeaf pour tester les capacit s et mesurer les effets de Structure de journalisation mobile d Android CX Au lieu d int grer Structure de journalisation mobile d Android CX avec votre application en d veloppement vous pouvez d ployer le mod le d application et compl ter les tapes n cessaires la configuration sur le reste de cette page pour commencer capturer les donn es d application mobile dans votre instance de IBM Tealeaf Voir Chapitre 3 Echantillon d applications la page 41 Exigences minimales D velopper les applications Android avec un niveau 8 API minimum ce qui correspond 2 2 Froyo Consultez le Google Android Dev Center pour toute la documentation et les outils techniques Android Les structures de client IBM Tealeaf ne prennent pas en charge la transmission des donn es d application des syst mes de parties tiers Les donn es d application doivent tre transmises au serveur qui h te l application native 2 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Manifeste d application Android Le fichier manifeste pour l application Android donne le droit aux articles suivants d activer le mode coute sur les actions de l utilisateur dans l application lt uses permission android name android permission INTERNET
35. ant de r ssayer d acc s au commutateur d arr t static java lang String TLF_USE_WHITE_LIST Utilisation ou non de la liste blanche static java lang String TLF_WHITE_LIST_PARAM Param tres utilis s par cette liste blanche static java lang String TLF_USE_RANDOM_SAMPLE Utilisation ou non de l chantillon al atoire static java lang String TLF_RANDOM_SAMPLE_PARAM Param tres utilis s par l chantillon al atoire static java lang String TLF_HAS_TO_PERSIST_LOCAL_CACHE Possibilit ou non d enregistrer le cache sur le terminal static java lang String TLF_CACHED_LEVEL Niveau de cache enregistrer sur le terminal static java lang String TLF_CACHED_FILE_MAX_BYTES_SIZE Taille maximum du cache en octets enregistrer sur le terminal static java lang String TLF_POST_MESSAGE_URL URL de la page cible IBM Tealeaf Structure de journalisation mobile d Android CX Guide Tableau 15 Classe Tealeaf suite Zone R capitulatif Description static TLF_ POST MESSAGE_LEVEL_WIFI Niveau de java lang String journalisation si le niveau de connexion est le Wi Fi static java lang String TLF_POST_MESSAGE_LEVEL_CELLULAR Niveau de journalisation si le niveau de connexion est cellulaire static java lang String TLF_MAX_STRINGS_LENGTH Longueur de cha ne maximum static java lang String TLF
36. apshotAfterCreate Effectuer une capture d cran ou non apr s cr ation getTookImage public Boolean getTookImage Si la capture d cran a t faite ou non setTookImage public void setTookImage final Boolean tookImage Si la capture d cran a t faite ou non tookImage Si la capture d cran a t faite ou non getLogicalPageName public String getLogicalPageName Nom de page logique de l Activity Renvoie le nom de page logique de l Activity Si aucun n a t attribu il re oit un nom de la classe d activit et un trait de soulignement _ avec l heure actuelle en millisecondes est ajout setLogicalPageName public void setLogicalPageName final String logicalPageName Nom de page logique de l Activity Copyright IBM Corp 1999 2014 45 logicalPageName Nom de page logique de l Activity getImageBackground public int getImageBackground Couleur d arri re plan de l image de la capture d cran Renvoie la couleur d arri re plan de l image de la capture d cran setimageBackground public void setImageBackground final int imageBackground Couleur d arri re plan de l image de la capture d cran imageBackground Couleur d arri re plan de l image de la capture d cran getView public vue getView Vue utiliser pour la capture d cran Renvoie la vue utiliser pour la capture d cran set View public vide setView final View view Vue utiliser pour la capture d cran vie
37. apture d cran a t faite startSession public static void startSession public static void startSession final sessionId Indiquez si vous souhaitez un d marrage avec un ID de session donn ou g n r e sessionId ID de session utiliser requestManualServerPost public static java lang Boolean requestManualServerPost Publiez les donn es actuelles consign es Renvoie True False si des donn es ont t publi es getApplicationContextOffset public static long getApplicationContextOffset D calage actuel du contexte de l application Renvoie long d calage actuel du contexte de l application register FormField public static Boolean registerFormField final View formField final Activity activity public static Boolean registerFormField final View formField final Activity activity final int logLevel Enregistrez le champ de formulaire qui permet d obtenir des statistiques e formField Champ de formulaire enregistrer e activit Activit disposant d un champ de formulaire e logLevel Niveau de journalisation pour la biblioth que IBM Tealeaf Renvoie True False si un champ de formulaire a t enregistr isApplicationInBackground public static Boolean isApplicationInBackground Renvoie si l application a t plac e en arri re plan si elle n avait aucune activit affich e au premier plan Renvoie True False si l applicatin a t plac e en arri re plan Chapitre 5 R f rence
38. comportement de la biblioth que n est pas modifi Capture de la disposition native LogViewLayoutOnScreenTransition true Lors du pr d ploiement vous devez effectuer tous les sc narios de relecture pour collecter toutes les images avec Get ImageDataOnScreenLayout d fini sur true Cela cr e un contenu volumineux envoy au serveur qui contient les images base64 utilis es pour la relecture Lorsque l application est pr te tre d ploy e sur le Play Store la valeur false doit tre sp cifi e pour GetImageDataOnScreenLayout Effectu uniquement sur ImageView GetImageDataOnScreenLayout true 10 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Comprendre votre activit Dans Android une activit peut tre consid r e comme une page qui est affich sur le p riph rique mobile Par d faut vous devez enregistrer une activit affich e Pour plus d informations voir http developer android com training basics activity lifecycle starting html Vous pouvez enregistrer une activit affich e en pla ant les informations ci apr s dans la m thode OnCreate Indique le nom de la page logique Tealeaf logScreenview activity Name ScreenviewType LOAD Extrait la disposition de la page une fois qu elle a t cr e Tealeaf logScreenLayoutOnCreate activity Name Si vous devez consigner une disposition vous pouvez utiliser ce qui suit Tealeaf logScreenLayout activity Name delay
39. d pour identifier la page c AjoutezsetImageBackground 16777216 Pour d finir un arri re plan noir pour la capture d cran car l arri re plan est transparent La valeur ci dessus pour la couleur de l arri re plan peut tre remplac e par n importe quelle constante de couleur pour d finir la couleur de l arri re plan de vos captures d cran Exemple Importation com tl uic app UICActivity La classe publique LoginActivity tend UICActivity Override Cha ne publique vide onCreate Bundle savedInstanceState this setTakeSnapshotAfterCreate true Pour activer les captures d cran automatiques setLogicalPageName LoginPage Recommand pour identifier la page setImageBackground 16777216 Pour d finir l arri re plan de Capture d cran super onCreate savedInstanceState Int gration l aide de classes Android sans les classes IBM Tealeaf tendues Pour cette m thode des d veloppeurs ajoutent des fragments de code qui aident la biblioth que de capture IBM Tealeaf Modifications de code du fichier android app Application Le fichier d application g re le cycle de vie d une application Android IBM Tealeaf g re la biblioth que en coutant onLowMemory pour d sactiver la biblioth que si vous obtenez un avertissement onTerminate pour nettoyer la biblioth que et onCreate pour initialiser la biblioth que IBM Tealeaf vous recommande cette meilleure pratique Localiser le fichier qui s tend partir
40. e public vide setHttpResponse final HttpResponse httpResponse HttpResponse partir de la connexion httpResponse HttpResponse partir de la connexion getInitTime public Date getinitTime Heure initiale partir de la connexion Renvoie Date heure initiale partir de la connexion setInitTime public vide setInitTime final Date initTime Heure initiale partir de la connexion InitTime heure initiale partir de la connexion getResponseTime public long getResponseTime Heure de r ponse partir de la connexion long heure de r ponse partir de la connexion setResponseTime public vide setResponseTime final long responseTime Heure de r ponse partir de la connexion ResponseTime heure de r ponse partir de la connexion logConnection public vide logConnection Consigne l heure actuelle de connexion de webview R f rence Tableau 20 Classe UICWebView Package Classe Description com tl uic app Classe UICActivity la page 45 UICActivity utilis pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX Classe UICApplication la page 48 Application utilis e pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX com tl uic Classe Tealeaf la page 49 Biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX utilis e pour capturer les actions ut
41. e adress e aux fournisseurs de ces produits Toute instruction relative aux intentions d IBM pour ses op rations venir est susceptible d tre modifi e ou annul e sans pr avis et doit tre consid r e uniquement comme un objectif Le pr sent document peut contenir des exemples de donn es et de rapports utilis s couramment dans l environnement professionnel Ces exemples mentionnent des noms fictifs de personnes de soci t s de marques ou de produits des fins IBM Tealeaf Structure de journalisation mobile d Android CX Guide illustratives ou explicatives uniquement Toute ressemblance avec des noms de personnes de soci t s ou des donn es r elles serait purement fortuite LICENCE DE COPYRIGHT Le pr sent logiciel contient des chantillons de programmes d application en langage source destin s illustrer les techniques de programmation sur diff rentes plateformes d exploitation Vous avez le droit de copier de modifier et de distribuer ces chantillons de programmes sous quelque forme que ce soit et sans paiement d aucune redevance IBM des fins de d veloppement d utilisation de vente ou de distribution de programmes d application conformes aux interfaces de programmes d application pour lesquels ils ont t crits Ces programmes exemples n ont pas t rigoureusement test s dans toutes les conditions Par cons quent IBM ne peut garantir express ment ou implicitement la fiabilit la servi ab
42. e d attente avant d autoriser les utilisateurs de votre application mobile native d ouvrir une vue Web Si cette tape n est pas effectu e les occurrences peuvent para tre dans le d sordre pendant la relecture dans IBM Tealeaf Voir Search and Replay for Mobile App dans le document IBM Tealeaf CX Mobile User Manual Copyright IBM Corp 1999 2014 43 44 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Chapitre 5 R f rence Cette section contient des informations de r f rence de classe propos de la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX Classe UICActivity La classe com tl uic app UICActivity tend com tl uic app Activity UICActivity permet de capturer les actions utilisateur d une application Android et d activer la capture d cran apr s la cr ation de l Activity Remarque Pour activer la capture d cran dans IBM Tealeaf vous devez configurer le PCA pour qu il capture les POST binaires d images png Voir Chapitre 1 Installation et mise en oeuvre la page 1 D tail sur une m thode getTakeSnapshotAfterCreate public Boolean getTakeSnapshotAfterCreate Effectuer une capture d cran ou non apr s cr ation Indique si la capture d cran doit tre faite apr s cr ation setTakeSnapshotAfterCreate public vide setTakeSnapshotAfterCreate final Boolean takeSnapshotAfterCreate Effectuer une capture d cran ou non apr s cr ation takeSn
43. e la biblioth que en coutant onLowMemory pour d sactiver la biblioth que si vous obtenez un avertissement onTerminate pour nettoyer la biblioth que et onCreate pour initialiser la biblioth que IBM Tealeaf vous recommande cette meilleure pratique Localiser le fichier qui s tend partir de android app Application Pour localiser le fichier qui s tend partir de android app Application 1 Ouvrez le fichier Java existant qui s tend partir de la classe d application Si ce fichier n existe pas vous devez le cr er et lui demander d couter le cycle de vie complet d une application Android pour contr ler la biblioth que et consigner les informations n cessaires Vous devez galement modifier le fichier pour qu il s tende partir de com tl uic app UICApplication au lieu d android app Application Ajoutez les importations suivantes a import com tl uic Tealeaf b import com tl uic app UICApplication Dans la m thode onCreate ajoutez Tealeaf enable qui initialise la capture d actions utilisateur dans l application Ajustez Andro dManifest xml pour indiquer la classe d application Par exemple si votre classe d application s intitule MyApplication vous pouvez ajouter Aandroid name MyApplication dans le noeud lt application gt Ajoutez les droits suivants dans Andro dManifest xml lt uses permission android name android permission INTERNET gt lt uses permission android name android permissi
44. e s applique Entier 0 5 que si HasToPersistLocalCache est true 0 a la plus haute priorit CachedFileMaxBytesSize Nombre maximal d octets stocker sur Octets IBM Tealeaf Structure de journalisation mobile d Android CX Guide Param tres de publication Ces param tres contr lent le niveau de consignation l URL le volume et la fr quence des publications sur la page cible Tableau 4 Param tres de publication ID article PostMessageUrl Description URL de publication de donn es sur votre serveur Remarque Pour activer le transport s curis entre la structure de consignation et la page cible configurez cette URL afin qu elle commence par https Pour plus d informations propos de la page cible voir Chapitre 1 Installation et mise en oeuvre la page 1 Valeurs Adresse URL PostMessageLevel WiFi Niveau de consignation d v nements envoyer au serveur par Wi Fi lorsque la performance r seau est bonne 0 a la plus haute priorit 0 5 PostMessageLevelCellular Niveau de consignation d v nements envoyer au serveur par le r seau mobile 3G 0 a la plus haute priorit 0 5 MaxStringsLength Longueur de cha ne maximale envoyer la page cible par valeur dans les instructions de consignation Emp che les cha nes longues de prendre trop d espace de stockage et de bande passante Remarque Cette valeur doit tre d finie sur 1 Entier
45. eName Nom de page logique de l activit Cha ne publique finale vide setLogicalPageName cha ne finale logicalPageName this logicalPageName logicalPageName Cha ne vide prot g e onPause Tealeaf onPause this getLogicalPageName super onPause Cha ne vide prot g e onResume Tealeaf onResume this getLogicalPageName super onResume Cha ne vide prot g e onDestroy Tealeaf onDestroy this getLogicalPageName super onDestroy Chapitre 1 Installation et mise en oeuvre 9 Consignation de la disposition d cran pour la relecture de sessions d application mobile IBM Tealeaf dispose de fonctions permettant de consigner les dispositions d cran des vues d cran des sessions d application mobile natives Vous pouvez relire une session d application mobile dans une relecture sur navigateur cxImpact comme pour une session Web HTML au lieu d afficher la session d application mobile comme une s rie de captures d cran Les dispositions d cran des sessions d application mobile native sont captur es au format JSON d IBM Tealeaf Les dispositions d cran sont ensuite renvoy es au serveur de relecture Ce dernier utilise un moteur de mod le qui interpr te les donn es JSON au format HTML Vous pouvez ensuite relire la disposition d cran partir de la session d application mobile native sous forme de pages HTML dans une relecture sur navigateur cxImpact Il exis
46. endLoad this endLoad endLoad xx x Lorsque la page commence charger Greturn Lorsque la page commence charger Date publique finale getStartLoad return startLoad xx Lorsque la page commence charger Gparam startLoad Lorsque la page commence charger Cha ne publique finale vide setStartLoad date finale startLoad this startLoad startLoad xx x HttpResponse partir de la connexion Greturn HttpResponse partir de la connexion HttpResponse publique finale getHttpResponse return httpResponse xx x HttpResponse partir de la connexion Gparam httpResponse HttpResponse partir de la connexion Cha ne publique finale vide setHttpResponse HttpResponse finale httpResponse this httpResponse httpResponse xx x Heure initiale partir de la connexion return Heure initiale partir de la connexion Date publique finale getInitTime Chapitre 1 Installation et mise en oeuvre 23 return initTime xx Heure initiale partir de la connexion param initTime Heure initiale partir de la connexion Cha ne publique finale vide setInitTime date finale initTime this initTime initTime this connectionInitFromSession TLFCache timestampFromSession xx x Heure de r ponse partir de la connexion Greturn Heure de r ponse partir de la connexion getResponseTime publique finale longue re
47. ent peut tre utilis s il n enfreint aucun droit d IBM Il est de la responsabilit de l utilisateur d valuer et de v rifier lui m me les installations et applications r alis es avec des produits logiciels ou services non express ment r f renc s par IBM IBM peut d tenir des brevets ou des demandes de brevet en cours couvrant les produits mentionn s dans le pr sent document La remise de ce document ne vous accorde aucun licence sur ces brevets Si vous d sirez recevoir des informations concernant l acquisition de licences veuillez en faire la demande par crit l adresse suivante IBM Director of Licensing IBM Corporation North Castle Drive Armonk NY 10504 1785 U S A Pour le Canada veuillez adresser votre courrier IBM Director of Commercial Relations IBM Canada Ltd 3600 Steeles Avenue East Markham Ontario L3R 977 Canada Pour toute demande au sujet des licences concernant les jeux de caract res cod s sur deux octets DBCS contactez le service Propri t intellectuelle IBM de votre pays ou adressez vos questions par crit Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd 19 21 Nihonbashi Hakozakicho Chuo ku Tokyo 103 8510 Japon Le paragraphe suivant ne s applique ni au Royaume Uni ni dans aucun pays dans lequel il serait contraire aux lois locales LE PRESENT DOCUMENT EST LIVRE EN L ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE IBM DECLINE
48. es de mise en sessions IBM Tealeaf Classe TLDefaultHttpClient La classe com tl uic http TLDefaultHttpClient tend org apache http impl client DefaultHttpClient Vous pouvez utiliser TLDefaultHttpClient pour comprendre comment une valeur d URL a t r cup r e pour ajouter l objet de connexion IBM Tealeaf 58 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Remarque Des instances des classes TIHttpRequestInterceptor et TIHttpRequestinterceptor sont ajout es TLDefaultHttpClient pour obtenir des d tails pour l objet de connexion IBM Tealeaf R f rence Tableau 17 Classe TLDefaultHttpClient Package Classe Description com tl uic app Classe UICActivity la page 45 UICActivity utilis pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX Classe UICApplication la page 48 Application utilis e pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX com tl uic Classe Tealeaf la page 49 Biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX utilis e pour capturer les actions utilisateur com tl uic http TLDefaultHttpClient Etend DefaultHttpClient pour surveiller les requ tes d URL Classe TLHttpRequestInterceptor la page 60 Etend HittpRequestInterceptor pour ajouter des en t tes IBM Tealeaf pour la mise en s
49. es instructions sont list es ci dessous Lorsque cette modification est appliqu e le nom de vue Android comme URL se trouve dans la liste Navigable Pages dans la vue de relecture Browser Based Replay et Visualiseur CX RealiTea au lieu de l URL de page cible the generic IBM Tealeaf habituelle e Browser Based Replay ou BBR Chapitre 1 Installation et mise en oeuvre 29 Ce client Web est accessible gr ce au portail IBM Tealeaf et r cup re ses sessions via le serveur de relecture dans votre environnement IBM Tealeaf Voir CX Browser Based Replay dans le manuel d utilisation IBM Tealeaf cxlmpact Voir Configuring the Replay Server dans le manuel de configuration IBM Tealeaf CX e IBM Tealeaf Visualiseur CX RealiTea ou RTV Ce client de relecture est une application Windows autonome qui doit tre install e s par ment sur votre bureau Via Visualiseur CX RealiTea vous pouvez rechercher et relire des sessions stock es dans votre environnement IBM Tealeaf Voir le manuel d utilisateur IBM Tealeaf Visualiseur CX RealiTea Pour modifier le profil de relecture vous pouvez utiliser ces options e Appliquer la modification du nom de la vue en local Vous pouvez appliquer les modifications en local via IBM Tealeaf Visualiseur CX Realilea une application de bureau pour l affichage et la relecture d v nements Vous pouvez utiliser cette option pour tester les modifications avant de reconfigurer le serveur de relect
50. esample sampleRate intval ini_array percentagesample rate kKillbysamplerate sampleRate si chantillon par la liste blanche autre fonction killbysamplerate sampleRate randomnumber rand 1 100 si randomnumber lt sampleRate cho 1 autre cho 0 fonction killbywhitelist whitelistpath gt Figure 5 killswitch php Fichier de configuration web config pour PHP Il s agir d un chantillon de fichier de configuration Les commentaires commencent par comme dans le fichier php ini configtype killswitchtype percentagesample percentagesample taux 50 whitelist x y z Figure 6 config ini 72 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Chapitre 7 Traitement des incidents Conseils relatifs l utilisation de r solution Inclusion de requ te brute et d en t tes de r ponse A des fins de d bogage vous pouvez inclure la requ te brute les en t tes de r ponse des donn es pass es par Application de capture passive CX vers le canister Cette m thode est utile si vous ne voyez aucune donn e JSON qui analys e dans IBM Tealeaf Remarque Inclure ces en t tes dans vos sessions IBM Tealeaf peut consid rablement augmenter les exigences de stockage pour les sessions mobiles Activez ces options uniquement pour d boguer Dans l onglet Application de capture passive CX Pipeline d finissez les propr
51. essions Classe TLHttpResponselnterceptor la page 61 Etend HittpResponselnterceptor pour obtenir des d tails pour l objet de connexion IBM Tealeaf com tl uic webkit Classe UICWebView la page 62 WebView utilis pour ajouter un ID de session ID aux requ tes d en t tes Classe UICWebChromeClient la page 64 Etend WebChromeClient pour surveiller si le navigateur a termin son action il est ensuite possible d effectuer des captures d cran Classe UICWebViewClient la page 65 Etend WebViewClient pour surveiller le chargement des URL pour ajouter des en t tes de mise en sessions IBM Tealeaf Chapitre 5 R f rence 59 Classe TLHttpRequestinterceptor 60 La classe com tl uic http TLHttpRequestInterceptor tend org apache http HttpRequestInterceptor Vous pouvez utiliser TLhttpRequestInterceptor pour ajouter des en t tes Tealeaf pour la mise en sessions M thodes red finies e processus R f rence Tableau 18 Classe TLHttpRequestinterceptor Package Classe Description com tl uic app Classe UICActivity la page 45 UICActivity utilis pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX Classe UICApplication la page 48 Application utilis e pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX com tl uic
52. g getLibraryVersion R f rence la version de biblioth que actuelle Renvoie les r f rences la version de biblioth que actuelle activation public static java ladng Boolean enable public static java lang Boolean enable sessionld Activation de la biblioth que avec un ID de session donn ou g n r e sessionId ID de session donn utiliser Indique si la biblioth que TeaLeaf a t activ e d sactivation public static java lang Boolean disable D sactivation d une biblioth que Renvoie si la biblioth que IBM Tealeaf est d sactiv e onPause public static Boolean onPause final Activity activity final String logicalPageName Si vous n utilisez pas UICActivity ajoutez cet appel votre m thode de fichier d activit s onPause avant d appeler super e activit Activit qui appelle onPause e logicalPageName Nom descriptif de l activit qui appelle onPause Renvoie True False s il a t capable de correctement mettre en pause onResume public static Boolean onResume final Activity activity final String logicalPageName Si vous n utilisez pas UICActivity ajoutez cet appel votre m thode de fichier d activit s onResume avant d appeler super e activit Activit qui appelle onResume e logicalPageName Nom descriptif de l activit qui appelle onResume Renvoie True False s il a t capable de reprendre correctement onDestroy public static Boolean onDestroy final Acti
53. hanged R f rence Tableau 21 Classe UICWebChromeClient Package Classe Description com tl uic app Classe UICActivity la page 45 UICActivity utilis pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX IBM Tealeaf Structure de journalisation mobile d Android CX Guide Tableau 21 Classe UICWebChromeClient suite Package Classe Description Classe UICApplication la page 48 Application utilis e pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX com tl uic Classe Tealeaf la page 49 Biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX utilis e pour capturer les actions utilisateur com tl uic http Classe TLDefaultHttpClient la page 58 Etend DefaultHttpClient pour surveiller les requ tes d URL Classe TLHttpRequestInterceptor la page 60 Etend HttpRequestInterceptor pour ajouter des en t tes IBM Tealeaf pour la mise en sessions Classe TLHttpResponselnterceptor la page 61 Etend HttpResponselnterceptor pour obtenir des d tails pour l objet de connexion IBM Tealeaf com tl uic webkit Classe UICWebView la page 62 WebView utilis pour ajouter un ID de session ID aux requ tes d en t tes UICWebChromeClient Etend WebChromeClient pour surveiller si le naviga
54. hromeClient page 64 pour surveiller si le navigateur a termin son action il est ensuite possible d effectuer des captures d cran Classe UICWebViewClient la page Etend WebViewClient 65 pour surveiller le chargement des URL pour ajouter des en t tes de mise en sessions IBM Tealeaf Classe UICWebView 62 La classe com tl uic webkit UICWebView tend android webkit WebView Vous pouvez utiliser UICWebView pour ajouter un ID de session aux requ tes d en t te des fin de mise en sessions Cette classe ajoute un objet de connexion pour fournir des informations concernant WebView D tail sur une m thode getEndLoad public Date getEndLoad Lorsque la page a termin de charger Renvoie Date lorsque la page a termin de charger setEndLoad public vide setEndLoad final Date endLoad Lorsque la page a termin de charger endLoad Lorsque la page a termin de charger getStartLoad public Date getStartLoad Lorsque la page commence charger Renvoie Date lorsque la page commence charger setStartLoad public vide setStartLoad final Date startLoad Lorsque la page commence charger StartLoad lorsque la page commence charger getHttpResponse public HttpResponse getHttpResponse HttpResponse partir de la connexion Renvoie HttpResponse HttpResponse partir de la connexion IBM Tealeaf Structure de journalisation mobile d Android CX Guide setHttpRespons
55. i t s suivantes Param tre Valeur Include Raw Request true Include Response Headers true Voir PCA Web Console Pipeline Tab dans le document IBM Tealeaf Application de capture passive CX Gestion des probl mes client La section qui suit d crit comment IBM Tealeaf Structure de journalisation mobile d Android CX g re les pannes les exceptions ou les autres probl mes d application qui peuvent se produire sur le p riph rique mobile ou le r seau Exceptions ou pannes Les exceptions d application sont consign es et signal es IBM Tealeaf au format JSON Pour les p riph riques qui ex cutent iOS une tentative de transmission de l exception en cours vers le serveur est effectu e Une copie est ajout e l ensemble des messages mis en file d attente localement et est envoy e la prochaine fois que l application est lanc e Pour les p riph riques Android toutes les donn es locales du p riph rique sont vid es L objet d exception est transmis au serveur Voir Tealeaf JSON Object Schema Reference dans le document IBM Tealeaf Client Framework Data Integration Guide Copyright IBM Corp 1999 2014 73 Pannes d alimentation Les pannes d alimentation sur un p riph rique ne peuvent pas tre anticip es ou g r es par le logiciel Les donn es sont perdues Remarque Une exception TL Library Error File Not Found peut tre caus e par une interruption de l application surveill e Si l utilisa
56. ia 94404 U S A Ces informations peuvent tre soumises des conditions particuli res pr voyant notamment le paiement d une redevance Le programme sous licence d crit dans le pr sent document et tous les l ments sous licence disponibles s y rapportant sont fournis par IBM conform ment aux dispositions du Livret Contractuel IBM des Conditions internationales d utilisation des Logiciels IBM ou de tout autre contrat quivalent Les donn es de performance indiqu es dans ce document ont t d termin es dans un environnement contr l Par cons quent les r sultats peuvent varier de mani re significative selon l environnement d exploitation utilis Certaines mesures valu es sur des syst mes en cours de d veloppement ne sont pas garanties sur tous les syst mes disponibles En outre elles peuvent r sulter d extrapolations Les r sultats peuvent donc varier Il incombe aux utilisateurs de ce document de v rifier si ces donn es sont applicables leur environnement d exploitation Les informations concernant des produits non IBM ont t obtenues aupr s des fournisseurs de ces produits par l interm diaire d annonces publiques ou via d autres sources disponibles IBM n a pas test ces produits et ne peut confirmer l exactitude de leurs performances ni leur compatibilit Elle ne peut recevoir aucune r clamation concernant des produits non IBM Toute question concernant les performances de produits non IBM doit tr
57. ibles un message de journal personnalis est g n r Pour les p riph riques qui ex cutent iOS les donn es utilisateur sont tronqu es dans la m moire jusqu ce qu un espace de m moire suppl mentaire devienne disponible Pour les p riph riques Android toutes les donn es collect es sur le p riph rique sont vid es et Structure de journalisation mobile d Android CX est d sactiv pour le p riph rique 74 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Chapitre 8 Documentation et aide d IBM Tealeaf IBM Tealeaf fournit une documentation et une aide aux utilisateurs d veloppeurs et administrateurs Affichage de la documentation du produit L int gralit de la documentation des produits IBM Tealeaf est disponible sur le site Web suivant https tealeaf support ibmcloud com Utilisez les informations du tableau suivant pour afficher la documentation des produits d IBM Tealeaf Tableau 23 Obtention de l aide Pour afficher Proc dez comme suit Documentation du produit Dans le portail IBM Tealeaf acc dez gt Documentation du produit Aide d une page sur le portail IBM Tealeaf Dans le portail IBM Tealeaf acc dez gt Aide de cette page Documents disponibles pour les produits IBM Tealeaf Utilisez le tableau suivant pour afficher une liste des documents disponibles pour tous les produits IBM Tealeaf Tableau 24 Documentation d
58. igur pour capturer et traiter les donn es soumises partir d infrastructures de consignation Les donn es sont soumises l aide de types de contenu sp cifique que Application de capture passive CX capture g n ralement par d faut Vous devez v rifier que ces types de contenu ont t activ s pour tre capturer par la console Web Application de capture passive CX Remarque Apr s avoir effectu les tapes de cette section les donn es sont trait es par IBM Tealeaf V rification des configurations Application de capture passive CX de type de capture Vous pouvez utiliser cette proc dure pour v rifier que Application de capture passive CX est configur pour capturer les types de contenu soumis par Structure de journalisation mobile d Android CX Remarque En fonction de la version de Application de capture passive CX install e les types de contenu n cessaires peuvent d j tre configur s pour la capture Structure de journalisation mobile d Android CX soumet des messages l aide du type de contenu text json Remarque Chaque structure de journalisation IBM Tealeaf peut utiliser un type de contenu diff rent pour soumettre des v nements capturer pour IBM Tealeaf Assurez vous de v rifier le type de contenu de chaque environnement de capture c t client 1 Connectez vous la console Web Application de capture passive CX lt PCAServer gt 8080 26 IBM Tealeaf Structure de journalisation mobi
59. ilisateur Chapitre 5 R f rence 63 Tableau 20 Classe UICWebView suite Package Classe Description com tl uic http Classe TLDefaultHttpClient la page 58 Etend DefaultHttpClient pour surveiller les requ tes d URL Classe TLHttpRequestInterceptor la page 60 Etend HttpRequestInterceptor pour ajouter des en t tes Structure de journalisation mobile d Android CX pour la mise en sessions Classe TLHttpResponselnterceptor la page 61 Etend HttpResponselnterceptor pour obtenir des d tails pour l objet de connexion Structure de journalisation mobile d Android CX com tl uic webkit UICWebView WebView utilis pour ajouter un ID de session ID aux requ tes d en t tes Classe UICWebChromeClient Etend WebChromeClient pour surveiller si le navigateur a termin son action il est ensuite possible d effectuer des captures d cran Classe UICWebViewClient la page 65 Etend WebViewClient pour surveiller le chargement des URL pour ajouter des en t tes de mise en sessions Structure de journalisation mobile d Android CX Classe UICWebChromeClient La classe com tl uic webkit UICWebChromeClient tend android webkit WebChromeClient Vous pouvez utiliser UICWebChromeClient pour contr ler la progression du navigateur afin d effectuer une capture d cran du 64 p riph rique M thodes red finies _onProgressC
60. ilit ou le fonctionnement de ces programmes Les exemples de programmes sont fournis en l tat sans garantie d aucune sorte IBM ne sera en aucun cas responsable des dommages li s l utilisation de ces programmes exemples Marques IBM le logo IBM et ibm com sont des marques d International Business Machines Corp dans de nombreux pays D autres noms de produits et de services peuvent tre des marques d IBM ou d autres soci t s Une liste de marques IBM est actuellement disponible sur Internet sur le site Copyright and trademark information l adresse www ibm com legal copytrade shtml Remarques sur les r gles de confidentialit Les produits IBM Software notamment les logiciels sous forme de services Offre logicielles peuvent utiliser des cookies ou d autres technologies pour collecter des informations d utilisation en vue d am liorer l exp rience de l utilisateur final d ajuster les interactions avec l utilisateur final ou d autres fins Un cookie est une donn e qu un site Web peut envoyer votre navigateur et qui peut ensuite tre stock e sur votre ordinateur sous la forme d une balise identifiant ce dernier Dans la plupart des cas aucune information personnelle n est collect e par ces cookies Si vous utilisez une Offre logicielle qui vous permet de collecter des informations personnelles via des cookies et des technologies similaires tenez compte des sp cificit s suivantes En fonction de la c
61. ion IBM Tealeaf cxConnect for Voice of Customer Guide d administration IBM Tealeaf cxConnect for Web Analytics Guide d administration IBM Tealeaf cxOverstat IBM Tealeaf cxOverstat Guide d utilisation IBM Tealeaf cxReveal e IBM Tealeaf cxReveal Guide d administration e IBM Tealeaf cxReveal Guide de l API e IBM Tealeaf cxReveal 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 Structure de journalisation mobile d Android CX Guide e IBM Tealeaf CX Mobile Android Logging Framework Guide IBM Tealeaf Android Logging Framework Notes sur l dition e IBM Tealeaf CX Mobile Guide d administration e IBM Tealeaf CX Mobile Guide d utilisation e Guide d IBM Tealeaf CX Mobile iOS Logging Framework e IBM Tealeaf iOS Logging Framework Notes sur l dition Remarques Le pr sent document peut contenir des informations ou des r f rences concernant certains produits logiciels ou services IBM non annonc s dans ce pays Contactez votre interlocuteur IBM IBM local pour plus de d tails sur les produits et les services actuellement disponibles dans votre pays Toute r f rence un produit logiciel ou service IBM n implique pas que seul ce produit logiciel ou service puisse tre utilis Tout autre l ment fonctionnellement quival
62. ion com tl uic TLFCache Importation com tl uic Tealeaf Importation com tl uic app UICActivity Importation com tl uic javascript JavaScriptInterface xx author ohernandez La classe publique UICWebView tend WebView Date priv e endLoad Date priv e startLoad Cha ne priv e url HttpResponse priv e httpResponse Date priv e initTime responseTime priv long connectionInitFromSession priv long xx x Contexte param contexte Android x UICWebView final Context context public super context init xx Contexte param contexte Android x Jeu d attributs Gparam d un AttributeSet pass au parent UICWebView contexte final jeu d attributs AttributeSet final public super context attrs 22 IBM Tealeaf Structure de journalisation mobile d Android CX Guide init xx Contexte param contexte Android x Jeu d attributs param d un AttributeSet pass au parent x param ID de ressource de style defStyle par d faut UICWebView contexte final jeu d attributs AttributeSet final final int defStyle super contexte jeu d attributs defStyle init xx Lorsque la page a termin de charger Greturn Lorsque la page a termin de charger Date publique finale getEndLoad return endLoad xx x Lorsque la page a termin de charger Gparam endLoad Lorsque la page a termin de charger Cha ne publique finale vide setEndLoad date finale
63. ir des d tails pour l objet de connexion IBM Tealeaf M thodes red finies e Processus R f rence Tableau 19 Classe TLHttpResponselnterceptor Package Classe Description com tl uic app Classe UICActivity la page 45 UICActivity utilis pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX Classe UICApplication la page 48 Application utilis e pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX com tl uic Classe Tealeaf la page 49 Biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX utilis e pour capturer les actions utilisateur com tl uic http Classe TLDefaultHttpClient la page 58 Etend DefaultHttpClient pour surveiller les requ tes d URL Classe TLHttpRequestInterceptor la page 60 Etend HttpRequestInterceptor pour ajouter des en t tes IBM Tealeaf pour la mise en sessions TLHttpResponselnterceptor Etend HttpResponselnterceptor pour obtenir des d tails pour l objet de connexion IBM Tealeaf com tl uic webkit Classe UICWebView la page 62 WebView utilis pour ajouter un ID de session ID aux requ tes d en t tes Chapitre 5 R f rence 61 Tableau 19 Classe TLHttpResponselnterceptor suite Package Classe Description Classe UICWebChromeClient la Etend WebC
64. ise avec elle 6 Cliquez sur Edit Raw Profile 7 Compl tez les tapes suivantes r pertori es dans la section qui suit Vous modifiez le fichier XML brut stock sur votre bureau local Voir Appliquer la modification du nom de la vue au serveur de relecture la page 31 30 IBM Tealeaf Structure de journalisation mobile d Android CX Guide 8 Apr s avoir modifi le profil cliquez sur Save Changes amp Exit 9 Cliquez sur OK 10 Permet de relire la session Cliquez sur Replay dans la barre d outils 11 Dans la liste Navigable Pages les URL r pertori es refl tent le nom de vue Android pour l cran comTProtoSplashhiemControlier H tp f www straussandplesser comultsbBs Controller LiNavigstionController TProtcLogiritewController Matp fivww straussandpiesser com UITab6ar Controller fUINavigaticnController TProtoCategonestiemControlier H tpeffumnw straussandplesser cam TProtoSplashiewController htp vaw straussandpiesser com UITabBar Controller fUINavigstionControlier TProtoLoginviewController H tp fivwew straussandoiesser comUIT abs Controler UNavpstiorControler TProroCategonesiewC Controler htp jw straussandplesser comi TProtoSplashiowControler http fu straussandplesser com UIT abar Controller fUINavgstionContraller TProtoLogiritemControiler hetp jwaww straussandpiesser com UITabBw Controler UNa vigatiorController TProtoCategoriesrewC ontroer Htp ve straussandpiesser com TProtoSplashiiewControler H tpaf vww
65. ise en sessions IBM Tealeaf Chapitre 5 R f rence 47 Classe UICApplication La classe com tl uic app UICApplication tend android app Application UICApplication permet de capturer les actions utilisateur d une application Android D tail sur une m thode getTealeaf public Tealeaf getTealeaf Obtenez l instance en cours de IBM Tealeaf Renvoie l instance en cours de IBM Tealeaf R f rence Tableau 12 Classe UICApplication Package Classe Description com tl uic app Classe UICActivity la page 45 UICApplication UICActivity utilis pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX Application utilis e pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX com tl uic Classe Tealeaf la page 49 Biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX utilis e pour capturer les actions utilisateur com tl uic http Classe TLDefaultHttpClient la page 58 Etend DefaultHttpClient pour surveiller les requ tes d URL Classe TLHttpRequestInterceptor la page 60 Etend HttpRequestInterceptor pour ajouter des en t tes IBM Tealeaf pour la mise en sessions Classe TLHttpResponselnterceptor la page 61 Etend HttpResponselnterceptor pour obtenir des d tails pour l objet de connexion IBM Tealeaf com tl uic webk
66. isponible pour les produits IBM Tealeaf Produits IBM Tealeaf Documents disponibles IBM Tealeaf CX IBM Tealeaf Customer Experience Guide de pr sentation e IBM Tealeaf CX Client Framework Guide d int gration des donn es e IBM Tealeaf CX Guide de configuration e Guide d IBM Tealeaf CX Cookie Injector e IBM Tealeaf CX Guide des bases de donn es e Guide d IBM Tealeaf CX Event Manager e IBM Tealeaf CX Glossaire e IBM Tealeaf CX Guide d installation e Guide d IBM Tealeaf CX PCA e IBM Tealeaf CX PCA Notes sur l dition Copyright IBM Corp 1999 2014 75 76 Tableau 24 Documentation disponible pour les produits IBM Tealeaf suite Produits IBM Tealeaf Documents disponibles IBM Tealeaf CX e Guide d IBM Tealeaf CX RealiTea Viewer Client Side Capture e IBM Tealeaf CX Realilea Viewer Guide d utilisation e IBM Tealeaf CX Notes sur l dition e IBM Tealeaf CX Release Guide de mise niveau e IBM Tealeaf CX Support FAQ sur le traitement des incidents e IBM Tealeaf CX Guide de traitement des incidents e Guide d IBM Tealeaf CX UI Capture j2 e IBM Tealeaf CX UI Capture j2 Notes sur l dition IBM Tealeaf cxImpact IBM Tealeaf cxConnect e IBM Tealeaf cxImpact Guide d administration e IBM Tealeaf cxImpact Guide d utilisation e IBM Tealeaf cxImpact Guide de g n ration de rapports e IBM Tealeaf cxConnect for Data Analysis Guide d administrat
67. it Classe UICWebView la page 62 WebView utilis pour ajouter un ID de session ID aux requ tes d en t tes Classe UICWebChromeClient la page 64 Etend WebChromeClient pour surveiller si le navigateur a termin son action il est ensuite possible d effectuer des captures d cran 48 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Tableau 12 Classe UICApplication suite Package Classe Description Classe UICWebViewClient la page 65 Etend WebViewClient pour surveiller le chargement des URL pour ajouter des en t tes de mise en sessions IBM Tealeaf Classe Tealeaf La classe com t1 uic TeaLeaf tend java lang 0bject La biblioth que TeaLeaf permet de capturer les actions utilisateur d une application Android Zones Tableau 13 Classe Tealeaf Zone R capitulatif Description static TLF_SESSION_HEADER Cl d en t te utilis e pour java lang String effectuer des mises en sessions de X Tealeaf Session static java lang String BALISE UICAndroid utilis dans LogCat Les champs utilis s dans les gestionnaires d v nements pour afficher correctement les actions utilisateur Tableau 14 Classe Tealeaf Zone static java lang String R capitulatif TLF_ON_FOCUS_CHANGE_IN Description Utilis dans les contr les TextView pour indiquer la priorit in static java lang Stri
68. ity logicalPageName ScreenviewType LOAD Tealeaf logScreenview activity logicalPageName ScreenviewType UNLOAD Configuration de base Vous devez configurer une page cible sur votre serveur Web Voir D marrage rapide pour la configuration du serveur la page 25 D finissez l adresse de la page cible dans le fichier de configuration TLFConfigurableltems properties sous la cl PostMessageUrl Voir Configuration File dans le guide IBM Tealeaf Structure de journalisation mobile d Android CX Confidentialit des donn es IBM Tealeaf fournit des m canismes pour masquer ou bloquer les informations sensibles des clients comme les num ros de carte de cr dit d tre transmises et captur es par IBM Tealeaf Structure de journalisation mobile d Android CX permet de sp cifier les champs qui doivent tre bloqu s ou masqu s dans votre application Web Si elle est appliqu e la confidentialit des donn es assure que ces l ments de donn es ne sont jamais transmis IBM Tealeaf Remarque En raison de modifications dans la fa on dont les donn es de structure client sont soumises IBM Tealeaf afin d tre captur es la meilleure m thode de masque ou de blocage de donn es sensibles est d appliquer le filtre en capturant la structure de capture du client M me si d autres fonctions peuvent tre d ploy es pour g rer les donn es confidentielles il n est pas facile de les impl menter au nouveau format de donn
69. l l appel doit tre retard Indique si la disposition a t consign e Chapitre 5 R f rence 55 public static Boolean logScreenLayout final Activity activity final AlertDialog alertDialog final String title final String message public static Boolean logScreenLayout final Activity activity final AlertDialog alertDialog final String name final String title final String message Consignez la disposition de la bo te de dialogue d alerte e activity Activit dans laquelle AlertDialog doit tre consign e alertDialog AlertDialog consigner e name Nom de la vue d cran dans laquelle l alerte appara t e title Titre affich dans la bo te de dialogue d alerte e message Message affich dans la bo te de dialogue d alerte Indique si la disposition a pu tre consign e logScreenLayoutSetOnShowListener public static Boolean logScreenLayoutSetOnShowListener final Activity activity final AlertDialog alertDialog final String title final String message public static Boolean logScreenLayoutSetOnShowListener final Activity activity final AlertDialog alertDialog final String name final String title final String message Consignez la disposition de la bo te de dialogue d alerte e activity Activit dans laquelle AlertDialog doit tre consign e alertDialog AlertDialog consigner e name Nom de la vue d cran dans laquelle l alerte appara t e title Titre affich dans la bo te
70. l moment un utilisateur ouvre ou ferme un contr le vous pouvez instrumenter OnDrawerOpenListener et OnDrawerCloseListener Obtenez un contr le SlidingDrawer final SlidingDrawer sd SlidingDrawer findViewById R id sd sd setOnDrawer0OpenListener nouveau OnDrawer0penListener public vide onDrawerOpened Tealeaf logEvent slidingDrawer c5 Tealeaf TLF ON DRAWER OPENED 3 sd setOnDrawerCloseListener nouveau OnDrawerCloseListener public vide onDrawerClosed Tealeaf logEvent slidingDrawer c5 Tealeaf TLF ON DRAWER CLOSED DE Comment masquer les contr les Le masque personnalis est une fonctionnalit qui correspond des ID sp cifi s et des expressions r guli res et qui effectue des substitutions de caract res Dans l exemple qui suit le masque personnalis convertit les valeurs actuelles en lettres fournies en remplacement Si le masque personnalis est d fini sur false il renvoie une cha ne vide Vous devez sp cifier le masque dans le fichier TLFConfigurableltem properties qui se trouve dans le dossier de documents de l application Android Param tres de masque HasMasking true 11 peut s agir d une s rie d id et d expressions r guli res d limit s par une virgule MaskIdList com tealeaf sp id EditTextx com tealeaf sp id login password S il est d fini sur false il renverra une cha ne vide HasCustomMask true I1 transformera des lettres minuscules en valeurs donn es SensitiveSma
71. lasse d application est trouv e continuez vers les tapes suivantes 2 Ouvrez le fichier Java existant qui s tend partir de android app Application class 3 Ajoutez les importations suivantes a import com tl uic Tealeaf b import com tl uic app UICApplication 4 Dans onCreate a Ajoutez Tealeaf tealeaf new Tealeaf this qui initialise la biblioth que Tealeaf avec une r f rence l application instrument e b Ajoutez Tealeaf enable qui initialise la capture d actions utilisateur dans l application 5 Dans onLowMemory a Ajoutez Tealeaf onLowMemory avant super pour qu il puisse ajuster la biblioth que en raison d une m moire faible 6 Dans onTerminate a Ajoutez Tealeaf disable avant super pour qu il puisse d sactiver la biblioth que 7 Ajustez Andro dManifest xml pour indiquer la classe d application en ajoutant android name MyApplication Exemple de classe d application import android app Application import com tl uic Tealeaf public class MyApplication extends Application Override public void onCreate super onCreate Tealeaf tealeaf new Tealeaf this Chapitre 1 Installation et mise en oeuvre 13 Tealeaf enable Override public void onLowMemory Tealeaf onLowMemory super onLowMemory Override public void onTerminate Tealeaf disable super onTerminate Exemple dans Androi idManifest xml lt ap
72. le d Android CX Guide o lt PCAServer gt est le nom d h te du serveur Application de capture passive CX 2 Cliquez sur l onglet Pipeline 3 Cliquez sur Edit Type Lists 4 Dans la bo te de dialogue Capture All POST Types v rifiez que les valeurs suivantes sont incluses text json text x json application json application x json 5 Cliquez sur Ajouter 6 Application de capture passive CX est d sormais configur pour capturer les types de contenu requis Toutes les occurrences ult rieures de ce type sont captur es 7 Enregistrez les modifications Voir PCA Web Console Pipeline Tab dans le manuel IBM Tealeaf Application de capture passive CX Configuration de Application de capture passive CX pour les captures d cran de la structure de consignation Vous pouvez galement activer Structure de journalisation mobile d Android CX pour effectuer des captures d cran pendant le chargement initial de chaque vue ou cran de votre application Web Ces captures d cran sont transmises la page cible IBM Tealeaf au format PNG pour une capture et utilisation pendant l affichage de session Voir Classe UICActivity la page 45 Lorsque cette option est activ e vous devez configurer Application de capture passive CX pour effectuer ces captures d cran Par d faut Application de capture passive CX supprime les captures d cran de contenu binaire ou statique vous devez donc le configurer pour capturer les i
73. llCaseAlphabet x 11 transformera des lettres majuscules en valeurs donn es SensitiveCapitalCaseAlphabet X I1 transformera des symboles en valeurs donn es SensitiveSymbol I1 transformera des chiffres en valeurs donn es SensitiveNumber 9 Fonction d chantillonnage KillSwitch c t serveur 68 Lorsque Killswitch est activ dans la configuration client Structure de journalisation mobile d Android CX interroge l URL de KillSwitch pour d terminer s il est activ ou d sactiv pour la session Si Structure de journalisation mobile d Android CX est d sactiv la session n est pas captur e et est exclue de l chantillon de donn es Dans les chantillons de code qui suivent l URL KillSwitch renvoie 1 pour activer Structure de journalisation mobile d Android CX et 0 pour d sactiver Structure de journalisation mobile d Android CX IBM Tealeaf Structure de journalisation mobile d Android CX Guide Fonction d chantillonnage pour ASPX killswitch aspx Cet chantillon ASPX affiche un retour de 1 afin d activer Structure de journalisation mobile d Android CX et de 6 afin de d sactiver Structure de journalisation mobile d Android CX lt Page Language C AutoEventWireup true gt lt script runat server gt public int Sampler Random rand nouveau Random int nextRandom rand Next 1 100 int samplepercent Convert Tolnt32 ConfigurationManager AppSettings rate si nextRandom lt samplepe
74. mages soumises en tant que POST binaires sur la page cible 1 Connectez vous la console Web Application de capture passive CX lt PCAServer gt 8080 O lt PCAServer gt est le nom d h te du serveur Application de capture passive CX Cliquez sur l onglet Pipeline Cliquez sur Edit Type Lists Dans la liste Excluded File Extensions v rifiez que png est r pertori g D Dans la liste Included File Extensions v rifiez que png n est pas r pertori Remarque Si une extension de fichier est incluse dans cette liste toutes les instances qui sont envoy es en r ponse sont captur es ce qui agrandit consid rablement le volume des donn es captur es par le Application de capture passive CX La capture de cette mani re n est pas requise 6 Dans la case des types de POST binaires saisissez la valeur suivante image png 7 Cliquez sur Ajouter 8 Le type de POST image png est ajout et activ afin d tre captur Ce param tre permet aux publications PNG d tre captur es par Application de capture passive CX Chapitre 1 Installation et mise en oeuvre 27 9 Enregistrez les modifications Voir PCA Web Console Pipeline Tab dans le document IBM Tealeaf Application de capture passive CX Activation de l extraction automatis e de POST compress s Structure de journalisation mobile d Android CX compresse automatiquement les donn es POST Vous devez configurer Application de capture passive CX pour les
75. modifier les param tres internes 40 Chapitre 3 Echantillon d applications 41 Chapitre 4 Instructions 43 Chapitre 5 R f rence 45 Classe UICActivity 45 Classe UICApplication 48 Classe Tealeaf 5 on en as amp 4 Classe TLDefaultHttpClient un L 2 x 68 Classe TLHttpRequestInterceptor 60 Classe a R an Soa s g o AOL Classe UICWebView So og a e a OA Classe UICWebChromeClient ENE 64 Classe UICWebViewClient 65 Chapitre 6 Code d chantillon 67 Comment instrumenter les contr les TextView 67 Comment instrumenter les contr les ExpandableListView 67 Comment instrumenter les conti les SlidingDrawer 68 Comment masquer les contr les 68 Fonction d chantillonnage KillSwitch c t serveur 68 Fonction d chantillonnage pour ASPX 69 Fonction d chantillonnage pour JSP 69 Fonction d chantillonnage pour PHP 71 Chapitre 7 Traitement des incidents 73 Conseils relatifs l utilisation de r solution 73 Inclusion de requ te brute et d en t tes de r ponse o amp a poa 4 478 Gestion des probl mes client E Ure a E y e S Exceptions ou pannes 73 Pannes d alimentation 74 Commutateur d arr t 74 Probl mes de r seau D oO e T4 M moire faible ou stockage lo l
76. ng TLF_ON_FOCUS_CHANGE_OUT Utilis dans les contr les TextView pour indiquer la priorit static java lang String TLF_ON_GROUP_COLLAPSE Utilis dans les contr les ExpandableListView pour indiquer quel groupe a t r duit static java lang String TLF_ON_GROUP_EXPAND Utilis dans les contr les ExpandableListView pour indiquer quel groupe a t d velopp static java lang String TLF_ON_DRAWER_OPENED Utilis dans les contr les SlidingDrawer pour indiquer quel tiroir est ouvert static java lang String TLF_ON_DRAWER_CLOSED Utilis dans les contr les SlidingDrawer pour indiquer quel tiroir est ferm Chapitre 5 R f rence 49 50 Champs utilis s pour acc der aux valeurs de fichier de configuration Tableau 15 Classe Tealeaf Zone static java lang String static java lang String R capitulatif TLF_LOGGING_LEVEL DISPLAY_LOGGING Description Niveau de journalisation par d faut Afficher ou non les instructions de d bogage dans LogCat java lang String static TLF_KILL_SWITCH_ENABLED Activation ou java lang String d sactivation du commutateur d arr t static TLF_KILL_SWITCH_URL Url pour le java lang String commutateur d arr t static TLF_KILL_SWITCH_MAX_NUMBER_OF_TRIES Nombre maximum d essais static java lang String TLF_KILL_SWITCH_TIME_INTERVAL Intervalle de temps av
77. nguage java contentType text html charset IS0 8859 1 pageEncoding IS0 8859 1 gt lt page import java util Properties gt lt page import java util Date gt lt page import java net x gt lt page import java io x errorPage gt lt Flux InputStream application getResourceAsStream config properties Propri t s props nouveau Properties props load stream Bool en DEBUG false DEBUG true equals props getProperty debug Cha ne id request getParameter id Cha ne randomsample request getParameter randomsample Cha ne kil11SwitchResponse Cha ne debugstr liste blanche si id null amp amp id isEmpty InputStream whitestream application getResourceAsStream props getProperty WhiteListFile Entr e BufferedReader nouveau BufferedReader nouveau InputStreamReader whitestream Cha ne line Bool en correspondance false pendant que line input readLine null ligne line trim si line equals id kil1SwitchResponse 1 correspondance true rupture input close si match kil1SwitchResponse 0 Si le commutateur d arr t est par taux d chantillon autre si randomsample null int rand int Math random 100 int sampleRate Integer parselnt props getProperty samplerate si rand lt sampleRate kil1SwitchResponse 1 autre kil1S
78. nistration Manual 8 S lectionnez Sessioning session agent Cliquez sur Edit 9 Dans la configuration de l agent de mise en sessions modifiez la valeur PrimarySessField de la mani re suivante PrimarySessField AppEnv SessionID env HTTP_X TEALEAF SESSION 10 Enregistrez le fichier de configuration 11 Effectuez la modification sur tous les serveurs Un red marrage est requis pour que les nouvelles cl s de mise en sessions fassent effet Nom de la vue Android comme URL pendant la relecture Les erreurs qui peuvent se produire pendant la relecture de session peuvent tre r solues l aide du nom de vue Android comme URL pendant la relecture Lorsque vous essayez de relire une session captur e par Structure de journalisation mobile d Android CX un message d erreur peut indiquer qu aucune page n est visualisable dans la session Cette erreur est li e la mani re dont les pages sont mapp es sur les terminaux Android Au lieu d afficher l URL pendant la relecture vous pouvez configurer des clients de relecture IBM Tealeaf pour afficher le nom de vue Android qui limine ce message d erreur esth tique Pour utiliser le nom de vue Android comme URL lorsque vous reliez la session compl tez les tapes suivantes pour configurer la r gle du profil de relecture appropri e Remarque La configuration de cette r gle doit actuellement tre appliqu e en passant par le profil de relecture stock sur le serveur de relecture L
79. niveau de consignation n est pas indiqu dans les instructions de consignation 0 a la plus haute priorit Pour d sactiver la consignation lancez Tealeaf Disable Voir Chapitre 5 R f rence la page 45 DisplayLogging Lorsque la valeur true est d finie les Bool en instructions de consignation de d bogage sont affich es dans LogCat Filtre de la balise UICAndroid LogViewLayout Si la valeur est true UICAndroid consigne la Bool en OnScreenTransition disposition de l cran Si la valeur est False la disposition de l cran n est pas consign e Param tres de commutateur d arr t Ces param tres contr lent le commutateur d arr t et l utilisation ou non d une liste blanche de num ros de t l phone dont il est possible de capturer les v nements Tableau 2 Param tres de commutateur d arr t ID article Description Valeurs KillSwitchEnabled Si la valeur est true la structure true false v rifie la page cible du commutateur d arr t avant de d marrer Vous devez sp cifier les propri t s suivantes Si KillSwitchEnabled false la structure d marre toujours KillSwitchUrl D finit l URL v rifier pour le Adresse URL commutateur d arr t La structure requiert une r ponse positive afin d effectuer une initialisation lorsque Kil1SwitchEnabled est d fini sur true Copyright IBM Corp 1999 2014 35 Tableau 2 Param tres de commutateu
80. nt d URL pour le mappage de requ tes Localisez l en t te suivant lt RequestEntry name URL gt 5 Ajoutez le nom de cl suivant comme nouvelle entr e la liste des entr es lt Nom de cl HTTP_X TEALEAF VIEW CLASS enabled 1 gt 6 Enregistrez le fichier Chapitre 1 Installation et mise en oeuvre 31 Configuration d ex cution Si n cessaire vous pouvez modifier les param tres du serveur depuis l application client Tous les l ments de configuration peuvent tre configur s de mani re dynamique depuis le client Vous pouvez planifier la gestion de la configuration du serveur pendant l initialisation de l application puis effectuer une mise jour s lective et si n cessaire pendant l ex cution Voir TeaLeaf Class dans le guide IBM Tealeaf Structure de journalisation mobile d Android CX IBM Tealeaf v nements pour Structure de journalisation mobile d Android CX Le format JSON est utilis pour suivre les donn es captur es par le Structure de journalisation mobile d Android CX Type de donn es Description Donn es d environnement de capture c t client JSON Si vous utilisez une cr ation d v nements tapes les donn es de l environnement de capture c t client sont soumises au format JSON et disponibles gr ce Browser Based Replay pour v rification et cr ation d v nements Voir Step Based Eventing dans le IBM Tealeaf Event Manager Manual Pour plus d explications c
81. ntification et de suivi des sessions de visiteurs individuels Pour Structure de journalisation mobile d Android CX une configuration suppl mentaire peut tre requise Passez en revue les tapes et compl tez les tapes requises pour mettre votre application mobile en session Pour activer la mise en sessions d occurrences captur es par Structure de journalisation mobile d Android CX vous devez d ployer l agent de mise en sessions Voir Sessioning Session Agent dans le document IBM Tealeaf CX Configuration 28 IBM Tealeaf Structure de journalisation mobile d Android CX Guide 1 Connectez vous au portail en tant qu administrateur 2 Dans le menu Portal s lectionnez Tealeaf gt TMS Le syst me de gestion IBM Tealeaf s ouvre Voir Tealeaf Management System dans le document IBM Tealeaf cxImpact Administration Manual 3 Cliquez sur l onglet World View 4 Pour View s lectionnez Servers Voir TMS WorldView Tab dans le document IBM Tealeaf cxImpact Administration Manual 5 Cliquez sur le noeud Transport Service 6 S lectionnez Transport Service configuration Puis cliquez sur View Edit 7 Pipeline Editor s ouvre Remarque V rifiez que l agent de mise en session a t install e S il ne l a pas t faites le glisser de la fen tre Available Session Agents vers le pipeline e Pour plus d informations propos de son d ploiement voir TMS Pipeline Editor dans le document IBM Tealeaf cxImpact Admi
82. on ACCESS NETWORK STATE gt lt uses permission android name android permission ACCESS WIFI STATE gt lt uses permission android name android permission SET DEBUG APP gt Chapitre 1 Installation et mise en oeuvre 5 6 Exemple import com tl uic Tealeaf import com tl uic app UICApplication public class MyApplication extends UICApplication Override public void onCreate super onCreate Tealeaf enable Modifications de code du fichier android app Activity Le fichier d activit g re le cycle de vie d une page dans une application Android native similaire aux t ches d une page dans une application Web IBM Tealeaf coute les v nements suivants onPause qui ont lieu lorsque l application se met en arri re plan onResume ce qui a lieu lorsque l application se met en premier plan et onDestroy lorsque l activit n est plus en m moire et collecte les restes Localiser le fichier qui s tend partir de android app Activity Pour chaque fichier d activit que vous souhaitez consigner tendez la l aide de UICActivity Cela permet d tendre l activit de base de la structure Android UICActivity ajoute des fonctionnalit s requises par la biblioth que de structure de consignation IBM Tealeaf afin d activer et de d sactiver les t ches asynchrones et d effectuer des captures d cran du p riph rique apr s sa cr ation Pour localiser le fichier qui s tend partir de andro d app Activit
83. oncernant la capture de ces donn es en v nements IBM Tealeaf voir Integrating Client Framework Data into Tealeaf dans le document IBM Tealeaf Client Framework Data Integration Guide Donn es d environnement de capture c t client scission d occurrences Voir Versions de structure client prises en charge dans cette documentation la page 1 Mise niveau de Structure de journalisation mobile d Android CX Lors de la mise niveau de IBM Tealeaf Structure de journalisation mobile d Android CX vous compl tez les t ches g n rales suivantes Remarque Certaines tapes peuvent varier en fonction de vos environnements de d veloppement et d application 1 Passez en revue les exigences actuelles Voir Exigences minimales la page 2 2 Passez en revue les contenus du package Voir Contenus du package la page 1 3 Au lieu d int grer Structure de journalisation mobile d Android CX votre application en d veloppement vous pouvez utiliser l chantillon d application fourni par IBM Tealeaf Voir Utilisation du mod le d application la page 2 4 V rifiez que votre environnement d application est configur afin de respecter les exigences du projet 5 V rifiez que les modifications de code d exigences ont t appliqu es Voir Modifications de projet Android la page 4 32 IBM Tealeaf Structure de journalisation mobile d Android CX Guide 6 Appliquez la configuration de base
84. onfiguration d ploy e cette Offre logicielle peut utiliser des cookies de session et des cookies permanents qui collectent le nom de chaque utilisateur ainsi que d autres informations personnelles des fins de gestion des sessions de convivialit am lior e pour l utilisateur ou d autres objectifs de suivi de l utilisation ou fonctionnels Ces cookies peuvent tre d sactiv s mais leur d sactivation limine galement la fonctionnalit qu ils activent Diverses juridictions r gulent la collecte d informations personnelles via les cookies et autres technologies similaires Si la configuration d ploy e pour cette Offre logicielle vous permet en tant que client de collecter des informations personnelles d utilisateurs finaux via des cookies et autres technologies vous devez rechercher votre propre avis l gal concernant les lois applicables cette collecte de donn es dont toutes les exigences de mention et d accord le cas ch ant IBM exige que les Clients 1 fournissent un lien clair et visible vers les conditions d utilisation du site Web du client par exemple les r gles de confidentialit avec Remarques 79 un lien vers les collectes de donn es et les pratiques d utilisation d IBM et du Client 2 indiquent que des cookies et des alarmes Web gifs invisibles sont plac s sur l ordinateur du visiteur par IBM pour le compte du Client en expliquant l objectif de cette technologie et 3 selon les conditions requises pa
85. pas utiliser la classe IBM Tealeaf tendue TLDefaultHttpClient vous devez ajouter le code suivant aux classes suivantes Importation org apache http conn ClientConnectionManager Importation org apache http impl client DefaultHttpClient Importation org apache http params HttpParams 1x x Gauthor ohernandez La classe publique TLDefaultHttpClient tend DefaultHttpClient xx TLDefaultHttpClient public super this init null xx Gparam params param tres Http IBM Tealeaf Structure de journalisation mobile d Android CX Guide TLDefaultHttpClient public param tres HttpParams finaux super params this init null xx Gparam params param tres Http x param sessionId identifiant de session Tealeaf TLDefaultHttpClient public param tres HttpParams finaux Cha ne finale sessionId super params this init sessionId x param conman ClientConnectionManager x param params param tres Http TLDefaultHttpClient public final ClientConnectionManager conman Param tres HttpParams finaux super conman params this init null xx x param sessionId identifiant de session Tealeaf init vide priv cha ne finale sessionId TLHttpRequestInterceptor tlHttpRequestInterceptor final nouveau TLHttpRequestInterceptor sessionld this addRequestInterceptor tlHttpRequestInterceptor this addResponselnterceptor new TLHttpResponselnterceptor
86. plication android label string app name android debuggable true android icon drawable icon android name TLWorklightTealeafApplication gt Modifications de code de fichier org apache cordova DroidGap com worklight androidgap WLDroidGap Le fichier s tend partir de la classe Activity qui g re le cycle de vie d une page dans une application Android native semblable ce qu une page fait dans une application Web IBM Tealeaf coute les v nements suivants onPause qui a lieu lorsque l application se met en arri re plan onResume qui a lieu lorsque l application est au premier plan et onDestroy lorsque l activit n est plus dans la m moire et qu elle collecte les restes Localiser le fichier qui s tend partir de extends from org apache cordova DroidGap com worklight androidgap WLDroidGap 1 Ouvrez le fichier Java existant qui s tend partir de android app Activity 2 Ajoutez les importations suivantes a import com tl uic Tealeaf b import com tl uic app UICApplication c import com tl uic model ScreenviewType 3 Chaque activit a besoin d un nom de page logique qui permet d indiquer quelle activit est actuellement affich e Si aucun nom de page logique est indiqu IBM Tealeaf recommande d utiliser un nom de classe qui donne des indications sur l activit affich e Ajoutez le texte suivant la classe Cha ne priv e logicalPageName MainPage 4 Dans la m thode onPause a Ajo
87. r 1 100 PercentToCompress Image Pourcentage de compression des images Ce param tre peut uniquement tre utilis pour les images JPG Les images PNG ignorent ce param tre et d finissent 100 par d faut Entie r 1 100 Chapitre 2 Fichier de configuration 39 Ne pas modifier les param tres internes 40 Ne modifiez pas ces param tres sauf si IBM Tealeaf vous y invite Tableau 10 Ne pas modifier les param tres internes ID article Description Valeurs PostMessageSocketTimeout D lai de d passement du socket pour les publications de structure sur le serveur Si la structure ne re oit pas de r ponse du serveur dans ce d lai elle continue d essayer d envoyer des donn es Secondes CompressPostMessage S ils ont true comme valeur les POST HTTP soumis partir de la structure sont compress s Remarque Pour extraire les POST compress s une configuration suppl mentaire du serveur peut tre requise Voir Chapitre 1 Installation et mise en oeuvre la page 1 true false BufferLimit BufferPercent TimelntervalBetweenSnapshots Nombre de messages stocker dans la m moire envoyer au serveur Pourcentage supprimer de Bufferlimit avant qu il ne soit enregistr sur le cache s il est activ Intervalle de temps pour prendre des instantan s de donn es environnementales IBM Tealeaf Structure de journalisation mobile d Android CX
88. r d arr t suite ID article Description Valeurs KillSwitchTimelnterval KillSwitchMaxNumberOfTries Nombre de fois o la structure v rifie l URL du commutateur d arr t avant d abandonner Cette valeur doit tre d finie sur 1 ne r pond pas Entier Temps d attente avant de rev rifier Secondes l URL du commutateur d arr t si elle UseWhiteList Si la valeur est true et Ki11SwitchEnabled la structure attribuer avant d appelerEnable pour v rifier la liste blanche d identifiants de t l phone Si la valeur est false structure utilise un chantillon al atoire requiert un identifiant de t l phone etKil1SwitchEnabled par d faut la true false WhiteListParam Param tre utilis pour envoyer l identifiant de liste blanche correspondant l identifiant du t l phone Le serveur actuel de la liste blanche utilise id Param tres du fichier de cache local 36 Vous utiliserez ces param tres pour configurer l utilisation du cache local du p riph rique Tableau 3 Param tres du fichier de cache local ID article Description Valeurs HasToPersistLocalCache Si la valeur true est d finie les donn es sont stock es dans un stockage local sur le p riph rique au lieu de la m moire Les param tres suivants doivent galement tre configur s true false le p riph rique CachingLevel Niveau de cache actuel N
89. r la loi obtiennent le consentement des visiteurs du site Web avant de placer les cookies et les alarmes Web gifs par le Client ou IBM sur leurs unit s Pour plus d informations sur l utilisation des diverses technologies notamment des cookies reportez vous la section intitul e Cookies Web Beacons and Other Technologies d IBM l adresse http www ibm com privacy details us en 80 IBM Tealeaf Structure de journalisation mobile d Android CX Guide ne
90. rcent retour 1 autre retour 0 lt script gt lt si ConfigurationManager AppSettings killswitchtype Equals percentagesample gt X lt Sampler gt lt autre gt Figure 1 killswitch aspx Fichier de configuration web config pour ASPX lt xml version 1 0 gt lt l Pour plus d informations concernant la configuration de votre configuration ASP NET consultez la page suivante http go microsoft com fwlink LinkId 169433 gt lt configuration gt lt appSettings gt lt add key killswitchtype value percentagesample gt lt add key rate value 50 gt lt appSettings gt lt configuration gt Figure 2 web config Fonction d chantillonnage pour JSP killswitch jsp Cet chantillon JSP affiche un retour de 1 afin d activer Structure de journalisation mobile d Android CX et de 0 afin de d sactiver Structure de journalisation mobile d Android CX e Si la requ te ne dispose pas de param tres l environnement de capture c t client est toujours d sactiv e Si le param tre de requ te d id existe il est utilis pour v rifier la liste blanche Chapitre 6 Code d chantillon 69 e Si le param tre randomsample existe le taux de pourcentage du fichier config properties est utilis pour d terminer la mani re dont le serveur r pond Les journaux de d bogage sont g n r s si la propri t debug est d finie sur true lt page la
91. res de cookie ID article Description Valeurs CookieSecure S il a pour valeur TRUE un param tre de s curit est ajout au cookie Ce param tre ne peut tre utilis que dans les url de publication https TRUE FALSE CookieExpiresFormat Ce param tre est utilis pour indiquer le format d expiration du cookie Formats de date valides ASCTIME RFC1036 ou RFC1123 Param trage de la temporisation de session Ce param tre contr le les temporisations de session Tableau 8 Param trage de la temporisation de session ID article Description Valeurs SessionTimeout Lorsque SessionTimeout est d fini Minutes l expiration des cookies est l heure actuelle plus la valeur de temporisation de session Param tres de capture d cran Ces param tres contr lent les captures d cran Remarque Vous pouvez stocker les captures d cran sur la m moire au lieu d une m moire locale sur le p riph rique Pour permettre aux captures d cran d tre enregistr es sur la m moire vous devez d finir HasToPersistLocalCache sur false dans les param tres de fichier de cache local Tableau 9 Param tres de capture d cran originales de la capture d cran auquel les captures d cran publi es sont soumises 1 100 ID article Description Valeurs ScreenshotFormat Format de la capture d cran PNG JPG PercentOfScreenshotsSize Pourcentage des dimensions pixel Entie
92. roller hetp jwaww straussandpiesser cam TProtoSplashiomControhor hetn liun lt ranerandaimeser rml Tahar anteri Nanan ontrellert Teren anli nnrir 200 20 200 200 200 200 20 200 200 200 20 200 20 200 20 200 200 20 Y SB EBBBBERSE 12 Si la liste Navigable Pages est correctement remplie vous pouvez renvoyer vos modifications au serveur de relecture pour qu elles soient d ploy es aux autres utilisateurs du serveur a Dans le menu RTV s lectionnez Tools gt Options b Cliquez sur l onglet Profils c Cliquez sur T l chargez les param tres sur le serveur Appliquer la modification du nom de la vue au serveur de relecture Compl tez les tapes suivantes sur le serveur de relecture pour que tous les utilisateurs du serveur de relecture sur navigateur voient le nom de vue Android pendant la relecture Dans la proc dure qui suit vous pouvez appliquer les modifications au serveur de relecture en acc dant au serveur et en modifiant le fichier appropri Cette modification est ensuite disponible tous les utilisateurs du profil du serveur de relecture ce qui inclut tous les utilisateurs sur navigateur 1 Connectez vous au serveur h bergeant le serveur de relecture en tant qu administrateur 2 Modifiez le fichier suivant lt Tealeaf_install_ directory gt system ReplayServerProfile xml 3 Localisez la section RequestMapping qui doit se trouver en haut du fichier 4 Ajoutez une entr e d l me
93. s si hasFocus false Tealeaf logEvent view Tealeaf TLF ON FOCUS CHANGE OUT autre Tealeaf logEvent view Tealeaf TLF ON FOCUS CHANGE_ IN D finissez OnFocusChangeListener sur le contr le TextView nameEditText setOnFocusChangeListener focusListen Enregistrez le contr le TextView Tealeaf registerFormField nameEditText this Comment instrumenter les contr les ExpandableListView Pour les contr les ExpandableListView afin de savoir quel moment un utilisateur d veloppe ou r duit un contr le vous pouvez instrumenter OnGroupCollapseListener et OnGroupExpandListener Obtenez un contr le ExpandableListView final ExpandableListView elv ExpandableListView findViewById R id elv elv setOnChildClickListener nouveau OnChildClickListener public bool en onChildClick ExpandableListView parent View view int groupPosition int childPosition Long id Tealeaf logEvent view renvoie true elv setOnGroupCollapseListener nouveau OnGroupCollapseListener public vide onGroupCollapse int groupPosition Tealeaf logEvent elv Tealeaf TLF ON GROUP COLLAPSE elv setOnGroupExpandListener nouveau OnGroupExpandListener public vide onGroupExpand int groupPosition Tealeaf logEvent elv Tealeaf TLF ON GROUP EXPAND Copyright IBM Corp 1999 2014 67 Comment instrumenter les contr les SlidingDrawer Pour les contr le SlidingDrawer afin de savoir que
94. s via l ID TLTSID fourni par IBM Tealeaf ou via l ID session client appel JSESSIONID Ces deux m thodes fonctionnent comme un identificateur de session unique dans l environnement Structure de journalisation mobile d Android CX pour qu IBM Tealeaf puisse effectuer le suivi des sessions client CookieParam peut tre d fini de sorte utiliser l ID session client ou JSESSIONID Le code suivant est un exemple type de configuration dans le fichier TLFConfigurableltems properties qui utilise l ID session client Param tres de mise en sessions sur les cookies client CookieUrl http www sample com CookieDomain sample com CookiePath CookieParam JSESSIONID CookieExpires false SessionTimeout 30 SessoinTimeoutKillSwitch false Dans cet exemple le cookie arrive expiration 30 minutes apr s l heure actuelle Lorsque la session arrive expiration Structure de journalisation mobile d Android CX extrait le nouveau cookie de votre serveur d applications et envoie le reste de la demande au serveur d applications l aide de ce nouveau cookie acquis dans l en t te de demande PCA regroupe tous les ID JSESSIONID utilis s dans une m me session bien que l ID JSESSIONID changeait en permanence Si des cookies g n r s partir du serveur d applications du client sont utilis s SessoinTimeoutKil1Switch peut tre d fini sur true ou false Si vous sp cifiez false pour SessoinTimeoutKil1Switch l utilisateur de la session arri
95. s Unis Compagnie IBM France Direction Qualit 17 avenue de l Europe 92275 Bois Colombes Cedex Cette dition s applique la version 9 dition 0 modification 0 de IBM Tealeaf Structure de journalisation mobile d Android CX et toutes les ditions et modifications ult rieures jusqu mention contraire dans les nouvelles ditions Copyright IBM Corporation 1999 2014 Table des mati res Avis aux lecteurs canadiens V IBM Tealeaf Structure de journalisation mobile d Android CX Guide vii Chapitre 1 Installation et mise en oeuvre RE E E T Versions de structure dient prises en a dans cette documentation D marrage rapide de linstr mentatoh de voire application Android Contenus du package Utilisation du mod le d application Exigences minimales Configurations syst me requises Incidence sur les ressources de p riph rique Modifications de projet Android Pr paration la mise en production Int gration l aide des classes Android IBM Tealeaf tendues 5 Int gration l aide de el ss s Android sans l s classes IBM Tealeaf tendues s a Consignation de la disposition d cran pour ja relecture de sessions d application mobile 10 Int gration pour les applications Apache Cordova PhoneGap et IBM Worklight l aide des classes Android sans les classes IBM Tealeaf 13 g A AONNE e Impl mentation de screenViews 15 Config
96. st actuellement affich e Si aucun nom de page logique est indiqu IBM Tealeaf recommande d utiliser un nom de classe qui donne des indications sur l activit affich e Ajoutez le texte suivant la classe Cha ne priv e logicalPageName Cha ne publique finale getLogicalPageName si this logicalPageName null this logicalPageName equals 8 IBM Tealeaf Structure de journalisation mobile d Android CX Guide 4 Dans la m thode onPause a Ajoutez Tealeaf onPause this getLogicalPageName 5 Dans la m thode onResume a Ajoutez Tealeaf onResume this getLogicalPageName 6 Dans la m thode onDestroy a Ajoutez Tealeaf onDestroy this getLogicalPageName Exemple this logicalPageName this getClass getName substring this getClass getName lastIndexOf 1 return this logicalPageName Importation com tl uic Tealeaf La classe publique BaseActivity tend l activit Cha ne priv e logicalPageName xx x Nom de page logique de l activit return Nom de page logique de l activit Cha ne publique finale getLogicalPageName Si this logicalPageName null this logicalPageName equals this getClass getName substring this getClass this logicalPageName getName lastIndexOf 1 Renvoyez this logicalPageName xx x Nom de page logique de l activit param logicalPag
97. t Utilise le mod le label TextView Utilise le mod le switch Image View Utilise le mod le image FrameLayout LinearLayout ViewStub View Utilise le mod le canvas AbsListView Utilise le mod le grid AlertDialog Utilise le mod le alert TabWidget Utilise le mod le tabBar IBM Tealeaf Structure de journalisation mobile d Android CX Guide TabHost Utilise le mod le tabContainer Int gration pour les applications Apache Cordova PhoneGap et IBM Worklight l aide des classes Android sans les classes IBM Tealeaf Pour cette m thode des d veloppeurs ajoutent des fragments de code qui aident la biblioth que de capture IBM Tealeaf Modifications de code du fichier android app Application le fichier d application g re le cycle de vie d une application Android IBM Tealeaf g re la biblioth que en coutant onLowMemory pour d sactiver la biblioth que si vous obtenez un avertissement onTerminate pour nettoyer la biblioth que et onCreate pour initialiser la biblioth que IBM Tealeaf vous recommande cette meilleure pratique Localiser le fichier qui s tend partir de android app Application Ce fichier n existe probablement pas vous devez donc le cr er et l ajouter au cycle de vie complet d coute d une application Android pour contr ler la biblioth que et consigner les informations n cessaires 1 Cr ez une classe d application partir de android app Application et ajoutez le texte suivant Si la c
98. t les performances En raison de modifications dans la fa on dont les donn es sont regroup es vous pouvez d sormais appliquer la confidentialit des donn es via les environnements client individuels au lieu d utiliser les m thodes du serveur IBM Tealeaf pour la confidentialit des donn es Voir Chapitre 1 Installation et mise en oeuvre la page 1 Pour plus d informations sur la confidentialit d une mani re g n rale voir le chapitre Managing Data Privacy in Tealeaf CX dans le document IBM Tealeaf CX Installation Manual Suivez les instructions pour l extension de fichier d application Voir Chapitre 1 Installation et mise en oeuvre la page 1 Suivez les instructions pour l extension de fichier d activit Voir Chapitre 1 Installation et mise en oeuvre la page 1 D bogage local dans Eclipse l aide de LogCat Pour afficher les messages de d bogage dans l onglet LogCat d Eclipse saisissez la cha ne suivante tag UICAndroid Suivez les instructions d utilisation de TLDefaultHttpClient concernant les requ tes et les r ponses pour obtenir des indicateurs de connexion Voir Classe TLDefaultHttpClient la page 58 Suivez les instructions concernant l utilisation de zones de texte pour obtenir plus d indicateurs Voir Classe Tealeaf la page 49 En raison de la mani re dont les messages JSON sont captur s et transmis forcez une soumission de tous les messages en fil
99. tableau pour faire correspondre les touches fran aises figurant dans le pr sent document aux touches de votre clavier Copyright IBM Corp 1999 2014 V vi France Canada Etats Unis K Posi K Home Fin Fin End Pgar PgUp PgAv PgDn Inser Inser Ins Suppr Suppr Del Echap Echap Esc Attn Intrp Break Impr Seran ImpEc PrtSc Verr Num N num gm Lock Arr t 2 Scroll d fil D ni Lock Verr maj FixMaj w AltGr AltCar dote Brevets Il est possible qu IBM d tienne des brevets ou qu elle ait d pos des demandes de brevets portant sur certains sujets abord s dans ce document Le fait qu IBM vous fournisse le pr sent document ne signifie pas qu elle vous accorde un permis d utilisation de ces brevets Vous pouvez envoyer par crit vos demandes de renseignements relatives aux permis d utilisation au directeur g n ral des relations commerciales d IBM 3600 Steeles Avenue East Markham Ontario L3R 977 Assistance t l phonique Si vous avez besoin d assistance ou si vous voulez commander du mat riel des logiciels et des publications IBM contactez IBM direct au 1 800 465 1234 IBM Tealeaf Structure de journalisation mobile d Android CX Guide IBM Tealeaf Structure de journalisation mobile d Android CX Guide Le IBM Tealeaf Structure de journalisation mobile d Android CX pour les applications mobiles natives requiert la licence IBM Tealeaf CX Mobile
100. te plusieurs avantages utiliser des donn es JSON pour relire une session d application mobile au lieu de captures d cran e R duction de la bande passante Les captures d cran de chaque vue d cran g n rent une quantit de donn es d image relativement importante Non seulement elle consomment une quantit importante de bande passante sans fil et cellulaire mais elles utilisent galement plus de m moire l int rieur du p riph rique Elles ont galement un impacts sur les performances des applications mobiles e Masquage des informations sensibles Vous ne pouvez pas masquer les donn es sensibles dans une capture d cran Si vous utilisez des donn es JSON pour relire des sessions d application mobile vous pouvez masquer EditTexts en ajoutant View IDs l attribut MaskIdList dans le fichier TLFConfigurableltems properties e Repr sentation des interactions des utilisateurs v nements UI dans les pages HTML cr es partir des donn es JSON Pour plus d informations sur les mod les de relecture de session d application mobile reportez vous la rubrique sur la personnalisation de la relecture de session d application native dans le document IBM Tealeaf CX Guide de configuration Modifications apport es TLFConfigurableltems properties Pour que la relecture de session d application native soit activ e vous devez affecter LogViewLayoutOnScreenTransition la valeur true Si vous ne le faites pas le
101. teur a mis l application hors tension ou s il l a ferm e la t che d imputation est d sactiv e Lorsque l application red marre la biblioth que commence envoyer les messages JSON en file d attente Cependant si certaines de ces images de r f rence ne sont plus disponibles l erreur File Not Found est g n r e e Si les checs d alimentation persistent vous pouvez configurer l application client afin d effectuer des enregistrements sur le disque local de plus petits intervalles et d effectuer des envois sur le serveur des intervalles plus fr quents e Pour plus d informations concernant la configuration de la taille du cache local cache voir Chapitre 2 Fichier de configuration la page 35 e Pour plus d informations concernant la configuration de POST du client voir Chapitre 2 Fichier de configuration la page 35 Commutateur d arr t Si le p riph rique ne parvient pas se connecter la page cible il ne capture pas de donn es Probl mes de r seau S il existe des probl mes de connectivit au r seau ces v nements consign s comme objets de connexion avec des d tails sur les probl mes e Pour les probl mes GET dus aux interruptions de l application un objet d exception est g n r e Si la connexion r seau est interrompue les actions utilisateur sont sauvegard es et envoy es plus tard M moire faible ou stockage local Si la m moire ou le stockage local deviennent fa
102. teur a termin son action il est ensuite possible d effectuer des captures d cran Classe UICWebViewClient Etend WebViewClient pour surveiller le chargement des URL pour ajouter des en t tes de mise en sessions IBM Tealeaf Classe UICWebViewClient La classe com tl uic webkit UICWebViewClient tend android webkit WebViewClient Vous pouvez utiliser UICWebViewClient pour contr ler le chargement d une URL afin d ajouter des en t tes IBM Tealeaf pour la mise en sessions M thodes red finies e shouldOverrideUrlLoading Chapitre 5 R f rence 65 66 R f rence Tableau 22 Classe UICWebViewClient Package Classe Description com tl uic app Classe UICActivity la page 45 UICActivity utilis pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX Classe UICApplication la page 48 Application utilis e pour contr ler la biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX com tl uic Classe Tealeaf la page 49 Biblioth que IBM Tealeaf Structure de journalisation mobile d Android CX utilis e pour capturer les actions utilisateur com tl uic http Classe TLDefaultHttpClient la page 58 Etend DefaultHttpClient pour surveiller les requ tes d URL Classe TLHttpRequestInterceptor la page 60 Etend HttpRequestInterceptor pour ajouter des en t tes IBM
103. tion this url this httpResponse this connectionInitFromSession loadTime this responseTime Etendre android webkit WebViewClient Le mod le de code qui suit tend la base Android WebViewClient avec UICWebVienClient Importation android webkit WebView Importation android webkit WebViewClient xx author ohernandez La classe publique UICWebViewClient tend WebViewClient xx x inheritDoc x Override shouldOverrideUrlLoading public bol en vue WebView finale cha ne url finale view loadUr1 url return true Mise en sessions pour les applications PhoneGap Puisqu aucune requ te ou r ponse n est renvoy e au serveur IBM Tealeaf ne requiert pas le d veloppement de WebView pour l ajout d une mise en sessions D marrage rapide pour la configuration du serveur Cette section d crit les tapes de base de la configuration de serveurs IBM Tealeaf Application de capture passive CX et Windows pour capturer et traiter les donn es soumises partir de Structure de journalisation mobile d Android CX Pour activer le processus de donn es soumises vous pouvez compl ter les tapes dans les sections suivantes Page cible pour la capture de trafic IBM Tealeaf est con u pour capturer le trafic entre un client et un serveur Web Pour faciliter la capture vous devez ajouter une page cible votre environnement de serveur Web auquel Structure de journalisation mobile d Android CX peut soume
104. ttre des publications Vous pouvez utiliser la m me page cible disponible pour IBM Tealeaf Capture d interface utilisateur CX pour AJAX Chapitre 1 Installation et mise en oeuvre 25 Voir UI Capture for Ajax Installation and Implementation dans le guide IBM Tealeaf Capture d interface utilisateur CX pour AJAX Apr s avoir ajout la page cible votre environnement Web et activ les bonnes autorisations d acc s vous devez configurer l URL pour la page cible la page TLFConfigurableltems properties Remarque Si n cessaire vous pouvez configurer la structure du client pour soumettre par HTTPS en ajoutant l identificateur de protocole l URL de publication Voir Chapitre 2 Fichier de configuration la page 35 Gestion du volume de trafic Vous pouvez ajouter une fonction d chantillonnage pour travailler avec le commutateur d arr t Structure de journalisation mobile d Android CX Vous pouvez utiliser cette fonction d chantillonnage pour r guler le taux d chantillonnage et ainsi le volume du trafic transmis pour la capture Pour plus d informations propos des fonctions d chantillonnage pour diff rents environnements de serveur voir Sample Code dans le guide IBM Tealeaf Structure de journalisation mobile d Android CX Application de capture passive CX v rification de capture de trafic Vous devez v rifier que IBM Tealeaf Application de capture passive CX dans votre environnement IBM Tealeaf est conf
105. turn responseTime xx x Heure de r ponse partir de la connexion Gparam responseTime Heure de r ponse partir de la connexion Cha ne publique finale vide setResponseTime responseTime finale longue this responseTime responseTime xx x inheritDoc Override Cha ne publique vide loadData donn es de cha ne finales cha ne mimeType finale Cha ne finale encoding this url null this initTime null this connectioninitFromSession 0 this responseTime 0 this httpResponse null this startLoad new Date super loadDataWithBaseURL this url donn es mimeType codage xx x inheritDoc x Override Cha ne publique vide loadUrl cha ne finale url loadUrl url null xx x inheritDoc Cha ne publique finale vide loadUrl Cha ne url finale mappage final lt Cha ne cha ne gt extraHeaders this url url Tealeaf setTLCookie this url super loadUrl url extraHeaders xx x Initialise WebView Cha ne vide priv e init this setWebViewClient nouveau UICWebViewClient this addJavascriptInterface nouvelle JavaScriptInterface 24 IBM Tealeaf Structure de journalisation mobile d Android CX Guide this getContext tiBridge xx x Consignez l heure de chargement de WebView Cha ne publique finale vide logConnection loadTime final long this getEndLoad getTime this getStartLoad getTime Tealeaf logConnec
106. ue de confidentialit Tableau 5 Param tres de masque ID article Description Valeurs HasMasking Les valeurs peuvent tre true ou Bool en false pour masquer les valeurs de contr le Si HasMasking true compl tez la valeur suivante MaskldList Identifiants ou expressions Cha ne r guli res d limit s par des virgules pour trouver les identifiants HasCustomMask Cela peut tre true ou false d utiliser Bool en true est la valeur d finie les prochaines valeurs ci dessous si SensitiveSmallCaseAlphabet Caract re utiliser pour les Cha ne minuscules SensitiveCapitalCaseAlphabet Caract re utiliser pour les Cha ne majuscules SensitiveSymbol Caract re utiliser pour les Cha ne symboles SensitiveNumber Caract re utiliser pour les chiffres Cha ne Param tre de type de message de filtre Ce param tre d termine les types de message qui sont renvoy s au serveur Tableau 6 Param tre de type de message de filtre ID article Description Valeurs FilterMessageTypes S il a TRUE comme valeur seuls les MessageTypes inclus dans la liste s par e par des virgules sont renvoy s au serveur S il a FALSE comme valeur tous les types de message sont renvoy s au serveur TRUE FALSE 38 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Param tres de cookie Ces param tres contr lent les cookies Tableau 7 Param t
107. uest finale final Contexte HttpContext met HttpException IOException try this url request getRequestLine getUri Si request containsHeader Tealeaf TLF HEADER request addHeader Tealeaf TLF HEADER device Android Lib Tealeaf getLibraryVersion Si request containsHeader Tealeaf TLF PROPERTY HEADER request addHeader Tealeaf TLF PROPERTY HEADER Tealeaf getHttpXTealeafProperty Si Tealeaf getAdditionalHeaders null pour l entr e final EntryString lt String gt Tealeaf getAdditionalHeaders entrySet request addHeader entry getKey entry getValue Cookies StringBuffer finaux nouveau StringBuffer Tealeaf getTLCookie this sessionld Si this getUrl null Cha ne finale extistingCookies CookieManager getInstance getCookie this getUrl Si extistingCookies null cookies append cookies append extistingCookies request addHeader Cookie cookies toString LogInternal log Session cookie cookies toString catch final Exception e 20 IBM Tealeaf Structure de journalisation mobile d Android CX Guide Tealeaf logException e Etendre org apache http HttpResponselnterceptor Cette classe est utilis e pour obtenir des informations afin de remplir un objet de connexion IBM Tealeaf Importation java io I0Exception Importation java util Date Importation org apache http HttpException Importation org ap
108. uration de base 16 Confidentialit des donn es 16 Configuration de la mise en sessions pour les applications Android sur le client 16 Configurez les ne dans une application Android 18 Utilise un ID de session non TBM Tealeaf zop 21 Applications hybrides 5 22 D marrage rapide pour la configuration du serveur 25 Page cible pour la capture de trafic 25 Gestion du volume de trafic 26 Application de capture passive CX v rification de capture de trafic 26 Options de contr le des captures et du traitement 28 Configuration de la mise en sessions pour les applications Android dans IBM Tealeaf 28 Configuration d ex cution 82 IBM Tealeaf v nements pour Siracture Je journalisation mobile d Android CX 32 Mise niveau de Structure de journalisation mobile d Android EX 2 4 xx 2 w 4 4 482 Chapitre 2 Fichier de configuration 35 Param tres de niveau de consignation 35 Param tres de commutateur d arr t 35 Copyright IBM Corp 1999 2014 Param tres du fichier de cache local 36 Param tres de publication 37 Param tres de masque so ogr agp h ue 00 Param tre de type de message de filtre Op o t 4 88 Param tres de cookie 54 509 Param trage de la temporisation d session 39 Param tres de capture d cran 39 Ne pas
109. ure e Appliquer la modification du nom de la vue au serveur de relecture la page 31 Si vous n avez pas acc s Visualiseur CX RealiTea vous pouvez modifier les param tres du serveur Remarque Les utilisateurs Visualiseur CX RealiTea doivent synchroniser leurs profils de relecture local sur le profil de serveur pour appliquer les modifications Appliquer la modification du nom de la vue en local Compl tez les tapes suivantes dans Visualiseur CX RealiTea pour effectuer des modifications en local et tester l utilisation du nom de la vue Android pendant la relecture 1 D marrez l application Visualiseur CX RealiTea sur votre bureau local Remarque Visualiseur CX RealiTea doit tre install en local sur votre bureau Windows Voir RealiTea Viewer RTV User Manual dans le guide d utilisation IBM Tealeaf Visualiseur CX RealiTea 2 Chargez une session captur e partir de Structure de journalisation mobile d Android CX 3 Dans le menu Visualiseur CX RealiTea s lectionnez Tools gt Options 4 Cliquez sur l onglet Profiles Voir RealiTea Viewer Profile Options dans le guide d utilisation IBM Tealeaf Visualiseur CX RealiTea 5 Si vous ne l avez pas encore fait saisissez le nom du serveur de relecture qui contr le le profil de relecture dans la case du serveur Cliquez sur Rechercher les mises jour maintenant Si une version de serveur du profil est disponible votre version locale se synchron
110. utez Tealeaf onPause this logicalPageName 5 Dans la m thode onResume a Ajoutez Tealeaf onResume this logicalPageName 6 Dans la m thode onDestroy a Ajoutez Tealeaf onDestroy this logicalPageName 7 Dans onCreate ajoutez apr s super onCreate a Tealeaf logScreenview this logicalPageName ScreenviewType LOAD 14 IBM Tealeaf Structure de journalisation mobile d Android CX Guide b appView addJavascriptInterface new JavaScriptInterface this getContext tlBridge Exemple d IBM Worklight package com TLWorklightTealeaf import android os Bundle import com tl uic Tealeaf import com tl uic javascript JavaScriptInterface import com tl uic model ScreenviewType import com worklight androidgap WLDroidGap public class TLWorklightTealeaf extends WLDro dGap private String logicalPageName MainPage GOverride public void onCreate Bundle savedInstanceState super onCreate savedInstanceState Consignez la vue d cran pour cette activit Tealeaf logScreenview this logicalPageName ScreenviewType LOAD DeviceAuthManager getInstance setProvisioningDelegate lt Utilisez la classe ProvisioningDelegatelmpl par d faut ou remplacez la par votre impl mentation IProvisioningDelegate gt Ajoutez un pont pour que les donn es Tealeaf soient renvoy es appView addJavascriptiInterface nouvelle JavaScriptInterface this getContext tIBridge super loadUrl getWebMainFilePath
111. v e expiration ne rev rifie pas Ki11SwitchUrl pour d terminer s il r pond Le trafic r seau utilis dans l application contient uniquement des requ tes Structure de journalisation mobile d Android CX utilise les cookies pour ajouter des valeurs au fichier TLFConfigurableltems properties Utilise l ID de session g n r par IBM Tealeaf Structure de journalisation mobile d Android CX Structure de journalisation mobile d Android CX utilise les cookies pour ajouter les valeurs suivantes dans TLFConfigurableltems properties e CookieUrl est pour l url du site publi et qui obtient des cookies pour une mise en session e CookieParam est le param tre qui poss de un id de session e CookiePath est le chemin d acc s du cookie e CookieDomain est le domaine auquel le cookie appartient e CookieSecure permet d ajouter un cookie s curis qui peut uniquement tre post sur une url https qui poss de un certificat valide Chapitre 1 Installation et mise en oeuvre 17 18 e CookieExpiresFormat peut avoir le format de date ASCTIME RFC1036 ou RFC1123 qui a une date d expiration qui correspond l heure actuelle le d lai d attente de session indiqu dans la variable ci dessous e SessionTimeout est le d lai d attente de session en minutes Lorsque cette valeur expire un nouvel id de session est cr Un exemple suit Param tres de mise en sessions CookieUrl http m ibm com CookieParam TLTSID CookiePath
112. vant d obtenir les d tails d exception Renvoie True False si une exception a t consign e logScreenview public static Boolean logScreenview final Activity activity final String logicalPageName final ApplicationContextType applicationContextType public static Boolean logScreenview final Activity activity final String logicalPageName final ApplicationContextType applicationContextType final String referrer Consignez un contexte d application screen View e activit Activit avec une modification de contexte d application screenView e logicalPageName Nom d activit ou nom descriptif cr sur le terminal e applicationContextType ApplicationContextType du contexte d application e r f renceur Page de r f renceur qu une page logique utilise Renvoie True False si une exception a t consign e logScreenLayout public static Boolean logScreenLayout final Activity activity Consignez la disposition de l activit imm diatement sans nom de disposition public static Boolean logScreenLayout final Activity activity final String name Consignez la disposition de l activit imm diatement avec un nom de disposition public static Boolean logScreenLayout final Activity activity final String name final int delayMS Consignez la disposition d une activit avec un d lai d ex cution e activity Activit consigner e name Nom de la disposition e delayMS Nombre de millisecondes duque
113. vity activity final String logicalPageName Si vous n utilisez pas UICActivity ajoutez cet appel votre m thode de fichier d activit s onDestroy avant d appeler super e activit Activit qui appelle onResume e logicalPageName Nom descriptif de l activit qui appelle onResume Chapitre 5 R f rence 53 54 Renvoie True False s il a t capable de d truire correctement OnLowMemory public static java lang Boolean OnLowMemory Si vous n utilisez pas UICApplication ajoutez cet appel votre m thode de fichier d activit s OnLowMemory avant d appeler super Renvoie True False s il a t capable de nettoyer correctement terminer public static java lang Boolean terminate Si vous n utilisez pas UICApplicaion ajoutez cet appel votre fichier d application de m thode terminate avant d appeler super Renvoie True False s il a t capable de terminer correctement vidage public static java lang Boolean flush A utiliser pour vider les donn es Renvoie True False s il a t capable de vider les donn es sur le serveur logEvent public static java lang Boolean logEvent final View view public static java lang Boolean logEvent final View view final java lang String eventType public static java lang Boolean logEvent final View view final java lang String eventType final int logLevel Consigner un v nement partir d un gestionnaire d v nements e vue Contr le partir
114. w Vue utiliser pour la capture d cran getNumOnGlobalLayoutListener public int getNumOnGlobalLayoutListener Nombre de OnGlobalLayoutListener d finis sur des vues Renvoie le d lai en millisecondes avant que la capture d cran soit prise car plus de temps est n cessaire pour obtenir un bon rendu setNumOnGlobalLayoutListener public void setNumOnGlobalLayoutListener final int numOnGlobalLayoutListener Nombre de OnGlobalLayoutListener d finis sur des vues millisecondSnapshotDelay D lai en millisecondes avant que la capture d cran soit prise car plus de temps est n cessaire pour obtenir un bon rendu getMillisecondSnapshotDelay public long getMillisecondSnapshotDelay D lai en millisecondes avant que la capture d cran soit prise car plus de temps est n cessaire pour obtenir un bon rendu Renvoie le d lai en millisecondes avant que la capture d cran soit prise car plus de temps est n cessaire pour obtenir un bon rendu setMillisecondSnapshotDelay public vide setMillisecondSnapshotDelay final long millisecondSnapshotDelay D lai en millisecondes avant que la capture d cran soit prise car plus de temps est n cessaire pour obtenir un bon rendu 46 IBM Tealeaf Structure de journalisation mobile d Android CX Guide millisecondSnapshotDelay D lai en millisecondes avant que la capture d cran soit prise car plus de temps est n cessaire pour obtenir un bon rendu R f rence Tableau 1
115. witchResponse 0 autre killSwitchResponse 0 out print killSwitchResponse Figure 3 killswitch jsp 70 IBM Tealeaf Structure de journalisation mobile d Android CX Guide toujours indiquer le chemin partir de la racine Ainsi vous tes s r qu il fonctionne chaque fois Cha ne nameOfTextFile props getProperty logfile PrintWriter pw si DEBUG essai pw new PrintWriter nouveau FileOutputStream nameOfTextFile true Date date new java util Date debugstr date toString t si request getQueryString null debugstr request getQueryString si 0 equals killSwitchResponse pw printin debugstr tDisable autre pw printin debugstr tEnable nettoyage pw close interception I0Exception e out printIn e getMessage Fichier de configuration web config pour JSP WhiteListFile whitelist txt samplerate 50 debug true logfile killswitchlog txt Figure 4 config properties Fonction d chantillonnage pour PHP killswitch php Cet chantillon PHP affiche un retour de 1 afin d activer Structure de journalisation mobile d Android CX et de 0 afin de d sactiver Structure de journalisation mobile d Android CX Chapitre 6 Code d chantillon 71 lt php ini_array parse ini _file config ini true lprint_r ini_array si chantillon par pourcentage si ini_array configtype killswitchtype percentag
116. y 1 Ouvrez le fichier Java existant qui s tend de la classe android app Activity et modifiez le afin de l tendre de com tl uic app UICActivity au lieu de android app Activity 2 Ajoutez les importations suivantes a Importation com tl uic Tealeaf b Importation com tl uic app UICApplication 3 Dans la m thode onCreate a Ajoutez this setTakeSnapshotAfterCreate true Pour activer les captures d cran automatiques Remarque Pour viter de capturer des donn es priv es potentielles Structure de journalisation mobile d Android CX prend des captures d cran d s que l image appara t sur le p riph rique Par cons quent aucun champ d fini par l utilisateur n est rempli dans une image de capture d cran Android ne prend pas en charge la capture des fen tres en incrustation Pour les applications hybrides les captures d cran peuvent tre manquantes ou dans le d sordre en raison de probl mes de d lai Remarque La m thode mentionn e ci dessus permet d effectuer des captures d cran automatique partir de l application client Si vous n activez pas cet l ment l aide de UICActivity vous pouvez effectuer des captures d cran manuellement l aide de la structure de consignation Voir Reference dans le guide IBM Tealeaf Structure de journalisation mobile d Android CX IBM Tealeaf Structure de journalisation mobile d Android CX Guide b Ajoutez setLogicalPageName LoginPage Recomman

IBM Tealeaf Structure de journalisation mobile d`Android CX Guide

Contents

Download Pdf Manuals

Related Search

Related Contents