IBM Tealeaf CX Mobile iOS SDK - Notas
Transcrição
IBM Tealeaf CX Mobile iOS SDK - Notas
IBM Tealeaf Versão 9 Release 0.2 18 de setembro de 2015 iOS SDK - Notas sobre a Liberação IBM Nota Antes de utilizar estas informações e o produto suportado por elas, leia as informações em “Avisos” na página 13. Esta edição aplica-se à versão 9, liberação 0, modificação 1 de IBM Tealeaf CX Mobile iOS SDK e a todas as liberações e modificações subsequentes, até que seja indicado de outra forma em novas edições. © Copyright IBM Corporation 1999, 2015. Índice Capítulo 1. Notas sobre a Liberação do IBM Tealeaf CX Mobile iOS SDK . . .. Novos recursos e mudanças no feature pack do in 9.0.2 e 9.0.2A . . . . . . . . . . . . .. Novos Recursos e Mudanças em 9.0.2 e 9.0.2A . .. Novos Recursos e Mudanças em 9.0.1 e 9.0.1A . .. Novos Recursos e Mudanças na Versão 9.0 e 9.0A Enhanced International Character Support (EICS) .. Compilação 9.0.0.23 . . . . . . . . . .. Novos Recursos e Mudanças na Versão 8.8 . . .. Compilação 8.8.2.22 . . . . . . . . . .. Compilação 8.8.2.6 . . . . . . . . . .. Compilação 8.8.1.56 . . . . . . . . . .. Compilação 8.8.1.8 . . . . . . . . . .. © Copyright IBM Corp. 1999, 2015 1 1 1 2 3 3 5 5 5 5 6 Compilação 8.8.1.7 . . . . . . . . . .. Novos Recursos e Mudanças na Versão 8.7 . . .. Compilação 8.7.5.25 . . . . . . . . . .. Compilação 8.7.5.21 . . . . . . . . . .. Compilação 8.7.5.16. . . . . . . . . .. Compilação 8.7.4.13. . . . . . . . . .. 9 9 9 9 10 10 Capítulo 2. Documentação e ajuda do IBM Tealeaf . . . . . . . . . . . .. 11 Avisos . . . . . . . . . . . . . .. 13 Marcas Registradas . . . . . . Considerações de Política Privada . . . . . . . . . .. .. 15 15 iii iv IBM Tealeaf: IBM Tealeaf CX Mobile iOS SDK - Notas Capítulo 1. Notas sobre a Liberação do IBM Tealeaf CX Mobile iOS SDK Estas notas sobre a liberação referem-se ao IBM Tealeaf CX Mobile iOS SDK. Para obter mais informações sobre o IBM Tealeaf CX Mobile iOS SDK, consulte o Guia do IBM Tealeaf CX Mobile iOS SDK . Novos recursos e mudanças no feature pack do in 9.0.2 e 9.0.2A O feature pack contém modificações e adições para as mensagens JSON que são geradas pelos SDKs. Novos Recursos v As mensagens JSON afetadas incluem: – Tipo 1 (ambiente do cliente) - as definições para orientação, largura, altura, deviceWidth e deviceHeight foram atualizadas. O campo referente foi incluído na mensagem. – Tipo 11 (gestos) - os campos scrollX e scrollY foram incluídos. – Tipo 12 (captura de DOM) - agora mostra as mudanças em uma página para suportar o serviço diff do DOM. Novos Recursos e Mudanças em 9.0.2 e 9.0.2A Novos recursos v A documentação foi atualizada e modificada para uso no IBM® Knowledge Center. Com a documentação do IBM Knowledge Center, o usuário pode: – Procurar em toda a documentação do Tealeaf e em toda a documentação do produto IBM – Criar coleções de tópicos específicos frequentemente utilizados – Criar documentação em pdf das coleções criadas v O IBM Tealeaf CX Mobile iOS SDK agora dispõe de meios para capturar informações de localização geográfica no dispositivo do usuário. O programador de aplicativos deve solicitar permissão de usuário para coletar os dados de localização geográfica. As informações podem ser coletadas automaticamente quando o aplicativo: – For Iniciado – Acessa o plano de fundo – Retorna do plano de fundo As informações de localização geográfica podem ser coletadas manualmente como pontos específicos no aplicativo com a API de localização geográfica. v A integração do SDK de iOS com o Swift agora é suportada. Mudanças v Mensagens JSON foram incluídas para obter eventos de captura de localização geográfica. Agora existem 13 tipos de mensagens JSON suportadas. A mensagem incluída na documentação nesta liberação é: © Copyright IBM Corp. 1999, 2015 1 – Tipo 13: Localização Geográfica - Informações de localização geográfica. Se o usuário não fornecer a permissão para coletar dados de informação geográfica, será enviada uma mensagem de erro do tipo 13. v IDs dinâmicos não são mais designados para controles em um aplicativo que não possui IDs designados pelo desenvolvedor de aplicativos. Em vez disso, o XPath para o controle é usado para identificar o controle. Um ID específico permite que o usuário CX defina eventos e relatórios em controles de forma confiável. Novos Recursos e Mudanças em 9.0.1 e 9.0.1A Novos recursos v O IBM Tealeaf CX Mobile iOS SDK agora dispõe de meios para capturar gestos que o usuário faz em um aplicativo móvel. Os gestos que são capturados incluem: – Toque – Toque e retenção – Toque duplo – Deslizamento de dedos vertical – Deslizamento de dedos horizontal – Abertura de pinça – Fechamento de pinça v A Captura de DOM agora é uma opção para aplicativos iOS que não podem usar PCA. A Captura de DOM Capture conta com o Document Object Model (DOM), que fornece uma representação estruturada da página da web (documento). O Serviço de Captura do DOM captura uma "captura instantânea" do DOM renderizado. Mudanças v O processo de integração do Tealeaf com o Worklight 6.1 e 6.2 foi atualizado. v Mudanças foram feitas nas APIs de iOS. As APIs (BOOL)logNSExceptionEvent:(NSException *)exception level:(kTLFMonitoringLevelType)level; e (BOOL)logNSExceptionEvent:(NSException *)exception dataDictionary:(NSDictionary*)dataDictionary level:(kTLFMonitoringLevelType)level; foram descontinuadas em 09/09/2014. Três novas APIs foram incluídas: – (BOOL)logNSExceptionEvent:(NSException *)exception – (BOOL)logNSExceptionEvent:(NSException *)exception dataDictionary:(NSDictionary*)dataDictionary; – (BOOL)logNSExceptionEvent:(NSException *)exception dataDictionary:(NSDictionary*)dataDictionary isUnhandled:(BOOL)unhandled; v A ponte híbrida foi expandida para que as APIs de iOS Nativas agora estejam acessíveis na Captura de IU do JavaScript. As APIs de iOS TLFApplicationHelper APIs disponíveis no JavaScript são: – -(void)enableTealeafFramework; – -(void)disableTealeafFramework; – -(void)requestManualServerPost; – -(BOOL)startNewTLFSession; 2 IBM Tealeaf: IBM Tealeaf CX Mobile iOS SDK - Notas – – – – – -(NSString*)currentSessionId; -(BOOL)setConfigurableItem:(NSString*)configItem value:(id)value; -(id)valueForConfigurableItem:(NSString*)configItem; -(id)defaultValueForConfigurableItem:(NSString*)configItem; -(void) addAdditionalHttpHeader:(NSString*)value forName:(NSString*)name; As APIs de iOS do TLFCustomEvent disponíveis em JavaScript são: – - (BOOL)logEvent:(NSString*)eventName; – - (BOOL)logEvent:(NSString*)eventName values:(NSDictionary*)values; – - (BOOL)logPrintScreenEvent; v Mensagens de JSON foram incluídas para captura de gestos e eventos de captura DOM. Existem 12 tipos de mensagens de JSON suportados. As mensagens incluídas na documentação nesta liberação são: – Tipo 1: Estado do cliente - Estado atual do cliente. – Tipo 2: Contexto de Aplicativos - Mensagem para indicar divisões na visualização do aplicativo que pode ser um usuário atual de página/visualização/atividade ativo. – Tipo 3: Conexão - Todos os aplicativos de solicitação/resposta são executados durante a captura. – Tipo 4: Controle - Controle de interface com o usuário que dispara um evento recebido para captura. – Tipo 5: Evento Customizado - Todo evento de log customizado de qualquer local no aplicativo. – Tipo 6: Exceção - Todo aplicativo de exceção pode ser lançado. – Tipo 7: Desempenho - Dados de desempenho a partir de um navegador. – Tipo 8: Armazenamento da Web - Um objeto que contém informações sobre informações de armazenamento local no navegador. – Tipo 9: Evento de ajuda instantânea do Overstat - Um objeto que contém informações sobre ajuda instantânea e a atividade de passar o mouse sobre e clicar. – Tipo 10: Layout - Layout de exibição atual da página nativa. – Tipo 11: Gesto - Gesto que dispara um evento de toque mais alto do Tealeaf recebe e captura. – Tipo 12: Captura DOM - Um objeto que contém dados HTML serializados (captura instantânea DOM) da página. v Instruções para exceções de criação de log foram incluídas na documentação. Novos Recursos e Mudanças na Versão 9.0 e 9.0A - Enhanced International Character Support (EICS) Esta seção descreve os novos recursos e mudanças que introduziram versões 9.0 e 9.0A Enhanced International Character Support (EICS) do IBM TealeafCX Mobile iOS SDK. Compilação 9.0.0.23 Novos Recursos v O IBM Tealeaf CX Mobile iOS SDK agora dispõe de funções para registrar layouts de tela para visualizações de telas de sessões de aplicativos móveis nativos. Isto permite reproduzir uma sessão de aplicativo móvel no Browser Capítulo 1. Notas sobre a Liberação do IBM Tealeaf CX Mobile iOS SDK 3 v v v v v v 4 Based Replay do cxImpact como se fosse uma sessão de web de HTML, ao invés de visualizar a sessão de aplicativo móvel como uma série de capturas de tela. Os layouts de tela das sessões de aplicativos móveis nativas são capturados em formato JSON do IBM Tealeaf. Os layouts de tela então são enviados de volta ao servidor de reprodução. O servidor de reprodução usa um mecanismo de modelo, que interpreta o JSON para o formato HTML. É possível então reproduzir o layoyt de tela a partir da sessão de aplicativo móvel nativa como páginas HTML no Browser Based Replay do IBM Tealeaf. Para implementar esta funcionalidade, use o método logScreenLayout. Novas configurações são incluídas para colocar em sessão em TLFConfigurableItems.properties. – O CookieExpires pode ser configurado para true se desejar incluir uma propriedade de expiração no cookie. – O SessionTimeout é usado para determinar o período, em minutos da expiração do cookie após inatividade. – O SessionTimeoutKillSwitch pode ser configurado para true ou false. Configurar SessionTimeoutKillSwitch para false significa que o usuário do tempo limite da sessão não volta a verificar o KillSwitchURL para ver se eles está respondendo. Existe uma nova API de classe TLFCustomEvent; logNSURLSession. Use esta API para registrar falhas que ocorrem quando se tenta uma conexão; geralmente a partir do NSURLConnectionDelegatedidFailWithError ou quando o sendSynchronousRequest retorna um erro. O primeiro parâmetro é o objeto de conexão e o segundo parâmetro é o erro recebido. Esta configuração pode ser definida somente de forma manual. O tipo de dispositivo usado durante a captura, o osType, agora é incluído nos dados de ambiente capturados na inicialização. Três novas APIs são incluídas como parte da classe TLFApplicatoinHelper, que está disponível para instrumentação manual. – -(BOOL) sessionizeRequest:(NSMutableURLRequest*)request; - Use esta API para que o IBM Tealeaf CX Mobile iOS SDK possa incluir diversos Cabeçalhos e Cookies que podem ser usados para reunir todas as ocorrências da sessão do aplicativo no servidor. – -(BOOL) isTealeafHybridBridgeRequest:(NSURLRequest*)request webView:(UIWebView*)webView; - A API determina se a solicitação é específica para e destinada a para o CX Mobile iOS SDK a partir do CX UI Capture SDK. – -(BOOL) InjectTealeafHybridBridgeOnWebViewDidFinishLoad:(UIWebView *)webView; - Use esta API para injetar o JavaScript do IBM Tealeaf específico em sua página da web. A injeção do JavaScript ajuda a transferir dados a partir do CX UI Capture SDK para o CX Mobile iOS SDK. Duas definições são incluídas para configurar a dimensão, tamanho e formato das capturas de tela em TLFConfigurableItems.plist. – O ScreenshotFormat pode ser usado para configurar o formato da captura de tela. É possível escolher entre o formato PNG ou JPG. – O PercentOfScreenshotsSize pode ser usado para configurar a porcentagem das dimensões do pixel original da captura de tela a que são submetidas as capturas de tela postadas. Existem duas propriedades incluídas recentemente em TLFConfigurableItems.plist, LogViewLayoutOnScreenTransition e GetImageDataOnScreenLayout. IBM Tealeaf: IBM Tealeaf CX Mobile iOS SDK - Notas – Para obter instrumentação automática, é possível usar LogViewLayoutOnScreenTransition = YES, que registra automaticamente o layout de tela. Para obter instrumentação manual, é possível usar logScreenLayoutWithViewController com a visualização desejada. – Junto com o LogViewLayoutOnScreenTransition, é possível configurar o GetImageDataOnScreenLayout. Se o GetImageDataOnScreenLayout = YES, a imagem será registrada como base64. Se o GetImageDataOnScreenLayou = NO, somente a soma de verificação MD5 e imagens png ou jpg serão registradas. Isso resulta em menores cargas úteis em produção. Novos Recursos e Mudanças na Versão 8.8 Esta seção descreve os novos recursos e mudanças introduzidas na versão 8.8 do IBM TealeafCX Mobile iOS SDK. Compilação 8.8.2.22 Correções de Bugs Os seguintes problemas foram resolvidos nesta liberação do IBM Tealeaf CX Mobile iOS SDK. v O logPrintScreenEvent agora retorna uma imagem que corresponde à resolução do ponto do dispositivo. Antigamente, esta imagem estava limitada a 320x480 pixels. Isto corrige distorção de razão da imagem e qualidade geral. v A captura da tela é movida para o encadeamento principal como mandatos Apple, usando estrutura UIKit em encadeamento principal. O upload de dados binários de imagem de tela é movido para o encadeamento secundário para acelerar o desempenho da API logPrintScreenEvent. v Em versões anteriores do IBM Tealeaf CX Mobile iOS SDK, uma API do Linux foi usada para obter endereço IP do dispositivo. Em determinadas redes, foi observado que esta API toma mais ciclos de processadores do que o necessário. Para melhorar o desempenho de obter um endereço IP, esta API agora é substituída por uma nova API do Linux. Compilação 8.8.2.6 Correções de Bugs O IBM Tealeaf CX Mobile iOS SDK versão 8.8.2.6 corrige um problema com o Camera Preview exibido como uma tela preta em determinados casos. A Apple não recomenda nenhuma classe, variável ou API da estrutura de UIKit a ser referenciada de um encadeamento secundário. Como resultado, o Camera Preview é exibido ocasionalmente como uma tela preta. A parte do CX Mobile iOS SDK referida na estrutura de UIKit em um encadeamento secundário agora é movida para o encadeamento principal por recomendações da Apple para corrigir este problema. Compilação 8.8.1.56 Novos recursos Os seguintes nomes de API foram alterados. Arquivo: TLFPublicDefinitions.h @protocol TLFCustomControlDelegate <NSObject> Capítulo 1. Notas sobre a Liberação do IBM Tealeaf CX Mobile iOS SDK 5 Tabela 1. @protocol TLFCustomControlDelegate <NSObject> Nome API descontinuado Nome de API incluído - (BOOL)isControlHidden; - (BOOL)isTLFCustomControlHidden; - (NSInteger)controlTag; - (NSInteger)tagTLFCustomControl; - (id)controlParent; - (id)parentTLFCustomControl; - (CGRect)controlFrame; - (CGRect)frameTLFCustomControl; - (UIColor*)controlColor; - (UIColor*)colorTLFCustomControl; - (UIColor*)controlBackgroundColor; - (UIColor*)backgroundColorTLF CustomControl; - (NSString*)controlText; - (NSString*)textTLFCustomControl; - (BOOL)isTextHidden; - (BOOL)isTLFCustomControlTextHidden; - (CGRect)textFrame; - (CGRect)textFrameTLFCustomControl; - (UIColor*)textColor; - (UIColor*)textTLFCustomControlColor; - (UIColor*)textBackgroundColor; - (UIColor*)textTLFCustomControl BackgroundColor; - (UIImage*)controlImage; - (UIImage*)imageTLFCustomControl; - (BOOL)isImageHidden; - (BOOL)isTLFCustomControlImageHidden; - (CGRect)imageFrame; - (CGRect)imageFrameTLFCustomControl; - (UIColor*)imageOpacity; (UIColor*)imageOpacityTLFCustomControl; - (UIColor*)imageBackgroundColor; - (UIColor*)imageBackgroundColorTLF CustomControl; @protocol TLFCustomControlDelegateX <NSObject> Tabela 2. @protocol TLFCustomControlDelegateX <NSObject> Nome API descontinuado Nome de API incluído - (NSArray*) imageViews; - (NSArray*) imageViewsTLF CustomControl; - (NSArray*) controls; - (NSArray*) controlsTLFCustomControl; Compilação 8.8.1.8 Novos recursos Novas APIs foram criadas para permitir instrumentação manual do SDK de iOS do IBM Tealeaf. Nota: A instrumentação manual não é recomendada, devido ao grande esforço de configuração, alta chance de erros e possibilidade de cobertura incompleta. Se você escolher usar instrumentação manual, você será responsável pela implementação destas mudanças. Ao usar SDK de iOS com a instrumentação automática DESLIGADA, há um conjunto de ações que é necessário concluir e que a instrumentação automática faria de outra forma. Abaixo, a lista de ações necessárias. v Mudanças no Controlador de Visualização devem ser registradas usando a API logAppContext a partir da classe TLFCustomEvent. 6 IBM Tealeaf: IBM Tealeaf CX Mobile iOS SDK - Notas v Atualizações da Conexão HTTP devem ser registradas usando a API logConnection a partir da classe TLFCustomEvent. v Existem três APIs logConnection; uma para cada inicialização, resposta bem sucedida e falha. v Eventos de clique de botão devem ser registrados usando a API logClickEvent a partir da TLFCustomEvent. v Eventos de toque do UITableViewCell devem ser registrados usando a API logValueChangeEvent a partir da classe TLFCustomEvent. v Eventos de mudança de texto para UITextField, UITextView e UILabel devem ser registrados usando a API logTextChangeEvent a partir da classe TLFCustomEvent. v Todos os objetos do NSURLMutableRequest devem ser divididos em sessões usando a API sessionizeRequest a partir da classe TLFApplicationHelper. v Todas as solicitações feitas pelo UIWebView devem ser rastreadas a partir de UIWebViewDelegate’s shouldStartLoadWithRequest usando a API isTealeafHybridBridgeRequest a partir da classe TLFApplicationHelper. v Todos os carregamentos de páginas da web devem injetar a ponte híbrida do Tealeaf no JavaScript a partir do UIWebViewDelegate’s webViewDidFinishLoad usando a API InjectTealeafHybridBridgeOnWebViewDidFinishLoad a partir da classe TLFApplicationHelper. No arquivo TLFConfigurableItems.plist, localizado no TLFResources.bundle, configure a sinalização do DisableAutoInstrumentation para YES. Isso desabilitará a instrumentação automática. Ao fazer isso, nenhum método swizzling ocorre, o estado do aplicativo não é monitorado e mudanças na tela ou nenhum outro evento é rastreado automaticamente. Use as seguintes informações para rastrear manualmente diversos eventos usando a classe TLFCustomEvent. v -(BOOL)logAppContext:(NSString*)logicalPageName applicationContext:(NSString*)applicationContext referrer: (NSString*)referrer v -(BOOL)logEvent:(NSString*)eventName values: (NSDictionary*)values; v -(BOOL)logConnection:(NSURLConnection*)connection error: (NSError*)error Esta API deve ser usada para registrar falha enquanto faz uma conexão, geralmente a partir de NSURLConnectionDelegate’s didFailWithError ou quando o sendSynchronousRequest retorna erro. Este primeiro parâmetro é o objeto de conexão e o segundo parâmetro é o erro recebido. v -(BOOL)logConnection: (NSURLConnection*)connection response: (NSURLResponse*)response responseTimeInMilliseconds:(long long)responseTime; Esta API deve ser usada para registrar conexões bem sucedidas; geralmente a partir de NSURLConnectionDelegate’s didReceiveResponse ou quando o sendSynchronousRequest retornar bem sucedido. O primeiro parâmetro é objeto de conexão. O segundo parâmetro é a resposta recebida, e o terceiro é o tipo de resposta da conexão em milissegundos. v -(BOOL)logConnection:(NSURLConnection*)connection request: (NSURLRequest*)request; Esta API deve ser usada para registrar a inicialização da conexão; geralmente antes ou após chamar NSURLConnection’s initWithRequest. O primeiro parâmetro é objeto de conexão e o segundo parâmetro é o objeto da solicitação. v -(BOOL)logClickEvent:(UIView*)view data:(NSDictionary*)data; Capítulo 1. Notas sobre a Liberação do IBM Tealeaf CX Mobile iOS SDK 7 v v v v Esta API deve ser usada para registrar eventos de clique de botão. Chame-a a partir dos manipuladores de eventos de cliques de botões. A primeira visualização de parâmetro é o objeto UIButton no qual o evento de clique aconteceu. O segundo parâmetro é opcional e é para uso futuro. É possível passar Nil por enquanto. -(BOOL)logValueChangeEvent:(UIView*)view data: (NSDictionary*)data; Esta API deve ser usada para registrar eventos de toque de UITableViewCell. Chame-a a partir de UITableViewDelegate’s didSelectRowAtIndexPath. A primeira visualização de parâmetro é o objeto UITableViewCell no qual o evento de toque aconteceu. O segundo parâmetro é opcional e é para uso futuro. É possível passar Nil por enquanto. -(BOOL)logTextChangeEvent:(UIView*)view data: (NSDictionary*)data; Esta API deve ser usada para registrar eventos de mudança de texto para UITextField, UITextView e UILabel. Chame isso de seu aplicativo sempre que o conteúdo destes três controles for alterado. Se você incluir o observador do UITextViewTextDidEndEditingNotification, será possível chamá-lo de lá. A primeira visualização do parâmetro é o objeto de qualquer um de UITextField, UITextView e UILabel, cujo texto foi editado. O segundo parâmetro é opcional e é para uso futuro. É possível passar Nil por enquanto. Todas as APIs estão bloqueando chamadas. Todos eles são opcionais e devem ser chamados com base no design do aplicativo e da máquina de estado. Todas as APIs retornam YES se os dados forem registrados e NO em caso de falha. O registro de depuração do console mostra a razão da falha. Os seguintes itens a partir da classe TLFApplicationHelper devem ser usados para instrumentação manual. v -(BOOL) sessionizeRequest:(NSMutableURLRequest*)request; Esta API deve ser chamada para que o SDK de iOS do Tealeaf possa incluir diversos Cabeçalhos e Cookies que podem ser usados para reunir todas as ocorrências da sessão do aplicativo no servidor. Chame esta API assim que o objeto do NSMutableURLRequest for criado e antes de iniciar a conexão HTTP. O primeiro parâmetro é o objeto do NSMutableURLRequest que o SDK do Tealeaf SDK atualiza. v -(BOOL) isTealeafHybridBridgeRequest:(NSURLRequest*)request webView:(UIWebView*)webView; Esta API deve ser chamada a partir do UIWebViewDelegate’s shouldStartLoadWithRequest. O primeiro parâmetro é objeto de NSURLRequest, e o segundo é objeto do UIWebView atual. A API determina se a solicitação é específica para, e destinada ao SDK de iOS do Tealeaf a partir do SDK do JavaScript do Tealeaf. Se for, a API consumirá os dados enviados pelo SDK do JavaScript do Tealeaf. Se não, manipule a solicitação no seu shouldStartLoadWithRequest. Por exemplo, se esta API retornar YES, ignore a solicitação e retorne NO a partir do shouldStartLoadWithRequest. Não foi uma solicitação de navegação de página real a partir do HTML ou do JavaScript. Se esta API retornar NO, manipule a solicitação, já que ela veio de sua própria página HTML ou do JavaScript. v -(BOOL) InjectTealeafHybridBridgeOnWebViewDidFinishLoad: (UIWebView *)webView; Esta API deve ser usada para injetar o JavaScript específico do Tealeaf na página da web. A injeção do JavaScript ajuda a transferir dados do SDK UIC do JavaScript do Tealeaf para o SDK de iOS do Tealeaf Native. O primeiro parâmetro é o objeto de UIWebView no qual a página da web atual é carregada. 8 IBM Tealeaf: IBM Tealeaf CX Mobile iOS SDK - Notas Chame-o toda vez que a nova página é carregada no UIWebView. O local recomendado é UIWebViewDelegate’s webViewDidFinishLoad. Compilação 8.8.1.7 Novos recursos v O IBM TealeafCX Mobile iOS SDK incluiu uma configuração de cronômetro em TLFConfigurableItems.properties para criar uma nova sessão quando o aplicativo for movido para o segundo plano e depois retornou ao primeiro plano após um período de configuração. A configuração SessionTimeout é o intervalo de tempo de configuração em minutos para esta configuração. v TLFConfigurableItems.properties contém agora uma configuração para controlar os tipos de mensagens que foram enviadas de volta para o servidor. Se o FilterMessageTypes estiver configurado para TRUE, somente o MessageTypes incluído na lista separada por vírgula será enviado de volta para o servidor. Se configurado para FALSE, todos os tipos de mensagens serão enviados de volta para o servidor. v Mudanças foram feitas na estrutura e no código para integração de iOS sem TLFApplication. Para obter mais informações sobre estas mudanças, consulte Iniciação rápida para instrumentar seu aplicativo iOS no Guia de Referência do IBM Tealeaf iOS Logging Framework. v Suporte foi incluído para o processamento de JPG no servidor para imagens provenientes de dispositivos iOS. Em TLFConfigurableItems.properties, é possível configurar o ScreenshotFormat para aceitar formatos de arquivos PNG ou JPG. JPG é um formato compacto, ao passo que o PNG é um formato descompactado. O tamanho de um arquivo JPG está entre 6 KB e 15 KB aproximadamente. Comparativamente, o tamanho de um arquivo PNG está entre 20 KB e 35 KB aproximadamente. Novos Recursos e Mudanças na Versão 8.7 Esta seção descreve os novos recursos e mudanças introduzidos na versão 8.7 do IBM TealeafCX Mobile iOS SDK. Compilação 8.7.5.25 Uma chamada de conexão fez com que o iOS Framework executasse um loop e travasse o aplicativo ao carregar um arquivo XML. Consulte as bibliotecas estáticas do Technical Q&A QA1490 Building Objective-C com categorias, disponíveis em https://developer.apple.com/library/mac/#qa/ qa2006/qa1490.html. Em suas configurações de compilação de aplicativos, sob Outros Sinalizadores de Vinculadores, deve-se incluir -ObjC. Compilação 8.7.5.21 Novos recursos v Suporte foi incluído para Visibilidade, textColor, textAlphaColor, textBackgroundColor, textBackgroundAlphaColor, backgroundColor, backgroundAlphaColor para controles de UITextField e UIButton. v Aprimoramentos foram feitos para rastreamento do controle de customização. v Uma configuração de cronômetro foi incluída para criar uma nova sessão, após um período de tempo para iOS. Capítulo 1. Notas sobre a Liberação do IBM Tealeaf CX Mobile iOS SDK 9 Correções de Bugs v Mudanças foram feitas para substituir o deslocamento proveniente de um website e usar o deslocamento de biblioteca nativa. v O iOS serialNumber agora é iniciado em 1, em vez de 0 como era anteriormente. v O objeto de iOs clientEnvironment não estava contido na matriz sessões. Este problema foi corrigido. v Problemas corrigidos com o método swizzling em hierarquia de classes objetiva-c. Compilação 8.7.5.16 Correções de Bugs O Eliminar Comutador agora permite um caractere ? em um caminho de URL. Aprimoramentos no desempenho foram feitos para o iOS para reduzir travamentos e aumentar a funcionalidade. O SDK de iOS agora está em conformidade com ARC para ajudar no gerenciamento de memória. Compilação 8.7.4.13 Correções de Bugs Aprimoramentos no desempenho foram feitos para o SDK de iOS para implementação híbrida de tablet, SDK de iOS em conformidade com ARC e dispositivos iOS para reduzir travamentos e aumentar a funcionalidade. No iOS Logging Framework, a seção clientEnvironment estava vazia e nenhum evento de ambiente foi disparado. Este problema foi resolvido. Ao incluir um Servidor de Caixa, a lista de servidores de pop-up de processamento exibidos por determinado tempo então desapareceu. Este bug não está relacionado à biblioteca de capturas. Este problema foi resolvido. O travamento que aconteceu na biblioteca TLE foi corrigido. O log do console SDK de iOS não mostra mais a mensagem Host desconhecido. Ao invés de usar o analisador e o serializador JSON de terceiros, use agora a classe NSJSONSerialization da Apple. 10 IBM Tealeaf: IBM Tealeaf CX Mobile iOS SDK - Notas Capítulo 2. Documentação e ajuda do IBM Tealeaf O IBM Tealeaf fornece a documentação e ajuda para usuários, desenvolvedores e administradores. Visualizando a documentação do produto Toda a documentação do produto do IBM Tealeaf está disponível no website a seguir: https://tealeaf.support.ibmcloud.com/ Use as informações na tabela a seguir para visualizar a documentação do produto para o IBM Tealeaf: Tabela 3. Obtendo ajuda Para visualizar... Faça isto... Documentação do produto No portal IBM Tealeaf, acesse ? > Documentação do produto. IBM Tealeaf Knowledge Center No portal do IBM Tealeaf, acesse ? > Documentação do produto e selecione IBM Tealeaf Experiência de cliente no ExperienceOne Knowledge Center. Ajuda para uma página no IBM Tealeaf Portal No portal do IBM Tealeaf, acesse ? > Ajuda para esta página. Ajuda para o IBM Tealeaf CX PCA Na interface da web do IBM Tealeaf CX PCA, selecione Guia para acessar o IBM Tealeaf CX PCA Manual. Documentos disponíveis para produtos do IBM Tealeaf A tabela a seguir é uma lista de documentos disponíveis para todos os produtos do IBM Tealeaf: Tabela 4. Documentação disponível para produtos do IBM Tealeaf. Produtos do IBM Tealeaf Documentos disponíveis IBM Tealeaf CX v Guia de Visão Geral do IBM Tealeaf Customer Experience v Guia do IBM Tealeaf CX Client Framework Data Integration v Manual de Configuração do IBM Tealeaf CX v Manual do IBM Tealeaf CX Cookie Injector v Guia do IBM Tealeaf CX Databases v Manual do IBM Tealeaf CX Event Manager v Glossário do IBM Tealeaf CX v Manual de Instalação do IBM Tealeaf CX v Manual do IBM Tealeaf CX PCA v Notas sobre a Liberação do IBM Tealeaf CX PCA IBM Tealeaf CX v Manual do IBM Tealeaf CX RealiTea Viewer Client Side Capture v Manual do Usuário do IBM Tealeaf CX RealiTea Viewer v Notas Sobre a Liberação do IBM Tealeaf CX v Manual de Atualização de Liberação do IBM Tealeaf CX v Perguntas Mais Frequentes sobre a Resolução de Problemas do IBM Tealeaf CX Support v Guia de resolução de problemas do IBM Tealeaf CX v IBM Tealeaf CX UI Capture j2 Guide v Notas sobre a Liberação do IBM Tealeaf CX UI Capture j2 IBM Tealeaf cxImpact v Manual de Administração do IBM Tealeaf cxImpact v Manual do Usuário do IBM Tealeaf cxImpact v Guia de Relatório do IBM Tealeaf cxImpact © Copyright IBM Corp. 1999, 2015 11 Tabela 4. Documentação disponível para produtos do IBM Tealeaf (continuação). Produtos do IBM Tealeaf Documentos disponíveis IBM Tealeaf cxConnect v Manual de Administração do IBM Tealeaf cxConnect for Data Analysis v Manual de Administração do IBM Tealeaf cxConnect for Voice of Customer v Manual de Administração do IBM Tealeaf cxConnect for Web Analytics IBM Tealeaf cxOverstat Manual do Usuário do IBM Tealeaf cxOverstat IBM Tealeaf cxReveal v Manual de Administração do IBM Tealeaf cxReveal v Guia de API do IBM Tealeaf cxReveal v Manual do Usuário do IBM Tealeaf cxReveal IBM Tealeaf cxVerify v Guia de Instalação do IBM Tealeaf cxVerify v Guia do Usuário do IBM Tealeaf cxVerify IBM Tealeaf cxView Guia do Usuário do IBM Tealeaf cxView IBM Tealeaf CX Mobile v IBM Tealeaf CX Mobile Android Logging Framework Guide v Notas sobre a Liberação do IBM Tealeaf Android Logging Framework v Manual de Administração do IBM Tealeaf CX Mobile v Manual do Usuário do IBM Tealeaf CX Mobile v IBM Tealeaf CX Mobile iOS Logging Framework Guide v Notas sobre a Liberação do IBM Tealeaf iOS Logging Framework 12 IBM Tealeaf: IBM Tealeaf CX Mobile iOS SDK - Notas Avisos Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. É possível que a IBM não ofereça os produtos, serviços ou recursos discutidos nesta publicação em outros países. Consulte seu representante IBM local para obter informações sobre os produtos e serviços atualmente disponíveis em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser usados. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM poderá ser usado em substituição a esse produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM são de responsabilidade do Cliente. A IBM pode ter patentes ou solicitações de patentes pendentes que cobrem os assuntos descritos neste documento. O fornecimento desta publicação não lhe garante direito algum sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para: Gerência de Relações Comerciais e Industriais da IBM Brasil Av. Pasteur, 138-146 Botafogo Rio de Janeiro, RJ CEP 22290-240 Para consultas sobre licença relacionadas a informações de byte duplo (DBCS), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie consultas sobre licença, por escrito, para: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan O parágrafo a seguir não se aplica ao Reino Unido ou qualquer outro país em que tais disposições não estejam de acordo com a legislação local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS A ELAS NÃO SE LIMITANDO, AS GARANTIAS IMPLÍCITAS DE NÃO-INFRAÇÃO, COMERCIALIZAÇÃO OU ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, esta disposição pode não se aplicar ao Cliente. Estas informações podem conter imprecisões técnicas ou erros tipográficos. Periodicamente, são feitas alterações nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode, a qualquer momento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nesta publicação, sem aviso prévio. © Copyright IBM Corp. 1999, 2015 13 Referências nestas informações a Web sites não IBM são fornecidas apenas como conveniência e não representam de forma alguma um endosso a esses Web sites. Os materiais nesses websites não fazem parte dos materiais desse produto IBM e a utilização desses websites é de inteira responsabilidade do Cliente. A IBM pode usar ou distribuir as informações fornecidas da forma que julgar apropriada sem incorrer em qualquer obrigação para com o Cliente. Licenciados deste programa que desejam obter informações sobre este assunto com objetivo de permitir: (i) a troca de informações entre programas criados independentemente e outros programas (incluindo este) e (ii) o uso mútuo das informações trocadas, devem entrar em contato com: Gerência de Relações Comerciais e Industriais da IBM Brasil AV. Pasteur, 138-146, Botafogo Rio de Janeiro, RJ CEP 22290-240 Tais informações podem estar disponíveis, sujeitas a termos e condições apropriadas, incluindo em alguns casos o pagamento de uma taxa. O programa licenciado descrito nesta publicação e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, do Contrato de Licença de Programa Internacional IBM ou de qualquer outro contrato equivalente. Todos os dados de desempenho aqui contidos foram determinados em um ambiente controlado. Portanto, os resultados obtidos em outros ambientes operacionais podem variar significativamente. Algumas medidas podem ter sido tomadas em sistemas em nível de desenvolvimento e não há garantia de que estas medidas serão as mesmas em sistemas disponíveis em geral. Além disso, algumas medidas podem ter sido estimadas através de extrapolação. Os resultados reais podem variar. Os usuários deste documento devem verificar os dados aplicáveis para seu ambiente específico. As informações sobre produtos não-IBM foram obtidas junto aos fornecedores dos respectivos produtos, seus anúncios publicados e outras fontes disponíveis publicamente. A IBM não testou esses produtos e não pode confirmar a precisão de seu desempenho, compatibilidade nem qualquer outra reivindicação relacionada a produtos não IBM. Dúvidas sobre os recursos de produtos não-IBM devem ser encaminhadas diretamente a seus fornecedores. Todas as declarações relacionadas aos objetivos e intenções futuras da IBM estão sujeitas a alterações ou cancelamento sem aviso prévio e representam apenas metas e objetivos. Estas informações contêm exemplos de dados e relatórios usados nas operações diárias de negócios. Para ilustrá-los de forma mais completa possível, os exemplos podem incluir nomes de indivíduos, empresas, marcas e produtos. Todos estes nomes são fictícios e qualquer semelhança com nomes e endereços usados por uma empresa real é mera coincidência. LICENÇA DE COPYRIGHT: Estas informações contêm programas aplicativos de amostra no idioma de origem, que ilustram técnicas de programação em diversas plataformas operacionais. O 14 IBM Tealeaf: IBM Tealeaf CX Mobile iOS SDK - Notas Cliente pode copiar, modificar e distribuir esses programas de amostra sem a necessidade de pagar à IBM, com objetivos de desenvolvimento, uso, marketing ou distribuição de programas aplicativos em conformidade com a interface de programação de aplicativos para a plataforma operacional para a qual os programas de amostra são criados. Esses exemplos não foram totalmente testados sob todas as condições. Portanto, a IBM não pode garantir ou implicar a confiabilidade, manutenção ou função desses programas. Os programas de amostra são fornecidos "NO ESTADO EM QUE SE ENCONTRAM", sem garantia de tipo algum. A IBM não será responsável por quaisquer danos decorrentes do uso pelo Cliente dos programas de amostra. Marcas Registradas IBM, o logotipo da IBM e ibm.com são marcas ou marcas registradas da International Business Machines Corp., registradas em muitas jurisdições em todo o mundo. Outros nomes de produtos e serviços podem ser marcas registradas da IBM ou de outras empresas. Uma lista atual de marcas registradas IBM está disponível na web em “Informações de Copyright e Marca Registrada” no endereço www.ibm.com/legal/copytrade.shtml. Considerações de Política Privada Produtos IBM Software, incluindo soluções de software como serviço, ("Ofertas de Software") podem usar cookies ou outras tecnologias para coletar informações de uso do produto, ajudar a melhorar a experiência do usuário final, ajustar interações com o usuário final ou para outros propósitos. Um cookie é uma parte de dados que um website pode enviar ao seu navegador e, então, ser armazenado em seu computador como uma tag que identifica o computador. Em muitos casos, nenhuma informação pessoal é coletada por esses cookies. Se uma Oferta de Software que estiver sendo usada permitir coletar informações pessoais por meio dos cookies e de tecnologias semelhantes, nós informaremos sobre os detalhes abaixo. Dependendo das configurações implementadas, esta Oferta de Software pode usar cookies de sessão e persistentes que coletam o nome de usuário de cada usuário e outras informações pessoais para fins de gerenciamento de sessões, usabilidade de usuário aprimorada ou outros fins de controle de uso ou funcionais. Esses cookies podem ser desativados, mas desativá-los também irá eliminar a funcionalidade que eles ativam. Várias jurisdições regulam a coleta de informações pessoais por cookies e tecnologias semelhantes. Se as configurações implementadas por esta Oferta de Software fornecerem a você, como cliente, a possibilidade de coletar informações pessoais de usuário final via cookies e outras tecnologias, você deverá solicitar conselho jurídico, por conta própria, sobre as leis aplicáveis quanto a tais coletas de dados, incluindo quaisquer requisitos quanto a avisos e consentimentos, quando adequado. A IBM requer que os Clientes (1) forneçam um link claro e notável para os termos de uso do website do Cliente (ex., política de privacidade) que inclui um link para a coleta de dados e práticas de uso da IBM e do Cliente, (2) notificar que os cookies e gifs/web beacons claros estão sendo colocados no computador do visitante pela IBM em nome do Cliente junto com uma explicação do propósito de tal tecnologia e (3) até onde exigido por lei, obtenham consentimento dos visitantes do website antes da colocação de cookies e gifs/web beacons claros colocados pelo Cliente ou IBM em nome do Cliente nos dispositivos do visitante do website Avisos 15 Para obter mais informações sobre o uso de várias tecnologias, incluindo cookies, para estes propósitos, consulte a Declaração de Privacidade Online da IBM em: http://www.ibm.com/privacy/details/us/en seção titulada "Cookies, Web Beacons and Other Technologies". 16 IBM Tealeaf: IBM Tealeaf CX Mobile iOS SDK - Notas Avisos 17 IBM® Impresso no Brasil