Etapas de teste da IU personalizada
Teste interfaces de usuário personalizadas, como páginas de IU e macros de IU, recuperando seus componentes de página HTML e JavaScript e identificando as ações de teste compatíveis.
As etapas de teste de IU personalizada exigem Automated Test Framework para recuperar e identificar os componentes testáveis de uma página da Web de destino.
Componentes testáveis
Os componentes de página testáveis consistem em HTML e JavaScript padrão com essas características.
- São definidos ou clicados pela interação do usuário
- Os componentes de página testáveis permitem que os usuários definam um valor ou cliquem neles.
- São acessíveis a partir do modelo de objeto de documento (DOM)
- Os componentes de página testáveis podem ser acessados pelo DOM e oferecem suporte à manipulação JavaScript do DOM. As etapas de teste de IU personalizada não podem acessar componentes de página no shadow DOM.
- Estão acessíveis para JavaScript
- Os componentes de página testáveis podem ser acessados pelo JavaScript. As etapas de teste de IU personalizada não podem acessar componentes de página que interagem diretamente com o sistema operacional, como campos de arquivo, ou exibir conteúdo não HTML, como arquivos Excel ou PDF.
- Não foram excluídos do teste de IU personalizada
- Os componentes de página testáveis não são excluídos do teste de IU personalizada. Automated Test Framework exclui componentes de página que já podem ser testados por outras categorias de etapa de teste e também exclui componentes de página associados a recursos Now Platform.
- Podem ser acessados pelo Inspetor de páginas
- Os componentes de página testáveis devem retornar resultados quando exibidos a partir do Inspetor de Páginas. Os designers de teste podem usar o Inspetor de páginas para identificar os componentes testáveis de uma página.
- Botões
- Links
- Texto da página
- Controles de IU
- Macros de IU
- data_ui
- ui_date_time
- ui_reference
- Páginas de IU
- Assistentes
Exemplos de componentes de página não testáveis incluem esses elementos de IU.
| Motivo não testável | Componentes de página não testáveis |
|---|---|
| Não são configuráveis ou clicáveis | Controles ocultos |
| Comentários HTML | |
| Elementos de layout HTML, como div, seção e período. | |
| Elementos de script HTML | |
| Estão inacessíveis pelo DOM | Painéis |
| Imagens | |
| Listas | |
| Relatórios | |
| DOM de sombra | |
| Estão inacessíveis para JavaScript | Arquivos do Excel |
| Campos de arquivo | |
| Arquivos PDF | |
| São Now Platform recursos | Flow Designer |
| Studio | |
| Monitor de upgrades | |
| São testáveis por outras categorias de etapa de teste | Rótulos de campo de formulário |
| Valores do campo de formulário | |
| Catálogo de serviços | |
| Espaços |
Componentes de página configuráveis
Um componente configurável é um elemento de IU que tem um valor dinâmico, como um campo de entrada de texto. Os componentes configuráveis são compatíveis com essas ações de teste e etapas de teste.
| Ações do Inspetor de páginas | Etapas de teste da IU personalizada |
|---|---|
| Definir Valor do Componente | Definir Valores de Componente (IU Personalizada) |
| Obter Valor do Componente | Declarar Texto na Página (IU Personalizada) |
| Validação de Valor do Componente (IU Personalizada) | |
| Componente Desabilitado | Validação de Estado do Componente (IU Personalizada) |
Os componentes configuráveis têm um tipo de dados que determina quais valores uma etapa de teste de IU personalizada pode definir. Por exemplo, um componente de página destinado a exibir uma referência a um registro específico pode ter um tipo de dados de referência para exibir somente valores de SYS ID.
- Data
- Data e hora
- Referência
Para obter mais informações, consulte Substituir tipo de dados do componente.
Componentes de página clicáveis
Um componente clicável é um elemento de IU com o qual os usuários podem interagir clicando, como entradas do tipo caixa de seleção ou rádio. Os componentes clicáveis são compatíveis com essas ações de teste.
| Ações do Inspetor de páginas | Etapas de teste da IU personalizada |
|---|---|
| Clique no componente | Clique em Componente (IU Personalizada) |
| Obter Valor do Componente | Declarar Texto na Página (IU Personalizada) |
| Validação de Valor do Componente (IU Personalizada) | |
| Componente Desabilitado | Validação de Estado do Componente (IU Personalizada) |
Os componentes clicáveis não têm um tipo de dados, pois não têm valores dinâmicos.
Componentes de página recuperados
Automated Test Framework armazena uma lista dos componentes de página recuperados para cada página de IU personalizada testada. As etapas de teste de IU personalizada exibem a lista de componentes recuperados dos campos Componente e Valores de componente.
Por padrão, a lista de componentes da página é estática e só é atualizada quando os Designers de teste clicam manualmente em Recuperar componentes. Os administradores podem habilitar a propriedade do sistema sn_atf.page_data_capture.enabled para atualizar a lista de componentes da página sempre que uma etapa de teste de IU personalizada for executada. A habilitação desta propriedade durante o design de teste garante que os designers de teste sempre tenham acesso à lista mais atual de componentes de página. Desabilitar esta propriedade após a conclusão do design de teste permite que os testes sejam executados mais rapidamente porque as etapas de teste podem usar a lista recuperada anteriormente de componentes da página.
O Now Platform trata a lista de componentes de página recuperados como dados e não os inclui em conjuntos de atualizações ou arquivos de aplicações. Ao transferir testes de uma instância para outra, os designers de teste devem recuperar manualmente os componentes da página novamente.
Considerações de design
Siga estas considerações de design ao testar páginas de IU personalizadas e componentes de página.
- Use o inspetor de página para identificar componentes de página testáveis
- O inspetor de página determina quais componentes de página estão disponíveis para testes de IU personalizados. Os componentes de página que não estão disponíveis para o inspetor de página também não estão disponíveis para o teste de IU personalizado.
- Navegue até a IU personalizada que você deseja testar
- Use as etapas de teste existentes para navegar até a IU personalizada de destino. Por exemplo, para testar um artigo da Base de conhecimento, use as etapas de teste existentes para navegar até um módulo ou para abrir um registro existente. A maioria dos testes de IU personalizados requer o uso de categorias de etapa de teste existentes como parte do teste.
- Use a área de componentes para identificar os componentes da página
- A área de componentes descreve o elemento de layout HTML que contém o componente, como um elemento
<div>ou<section>. A área ajuda os designers de teste a distinguir entre os componentes, fornecendo o local no layout da página. - Teste sua IU personalizada em vez de Now Platform IU
- O Automated Test Framework impede o teste de IU personalizada dos recursos Now Platform. Por exemplo, você não pode testar painéis ou designers gráficos. Em vez disso, crie testes para validar suas páginas e elementos de IU personalizados, já que você tem controle direto sobre essas interfaces de usuário.
- Use atributos HTML para substituir as propriedades de teste do componente da página
- Altere as propriedades de teste de um componente de página específico usando atributos HTML que são específicos para Automated Test Framework. Consulte Substituir ações de teste de componente.
- Recupere os componentes da página novamente ao mover os testes para outra instância
- As etapas de teste de IU personalizada não armazenam componentes de IU como metadados. Os testadores devem recuperar manualmente os componentes da página novamente ao mover testes entre instâncias.
Exemplo de teste de IU personalizada
Você pode usar a lista de componentes recuperados para projetar etapas de teste de IU personalizadas. Por exemplo, suponha que você queira testar a revisão e os comentários em um artigo da Base de conhecimento. Um artigo da Base de conhecimento contém vários componentes de página que exigem etapas de IU personalizadas para serem testados.
- O número de exibições do artigo.
- Os botões para marcar o artigo como Útil.
- A área de texto para deixar um comentário.
- Navegue até Módulo. Navegue até o módulo "Publicado" na aplicação "Conhecimento".
- Abra um registro existente. Abra o formulário "Conhecimento" com o ID "Conhecimento: KB0011110".
- Clique em uma Ação de IU. Clique na Ação de IU "Exibir artigo" no formulário "Conhecimento".
- Declarar texto na página (IU personalizada). Declare que o texto "desenvolvedores" está na página.
- Definir Valores de Componente (IU Personalizada). Defina os componentes na página da seguinte forma: 'Textarea <textarea> [article_comments]' = Atualize com o artigo real em vez da URL para o artigo em outro lugar.
- Clique em Componente (IU Personalizada). Clique no componente: 'Botão <button>: Comentário'.
- Declarar texto na página (IU personalizada). Declarar que o texto "Atualizar com artigo real em vez de URL para artigo em outro lugar." está na página.
Versão e ordem do componente de IU personalizada
Quando você seleciona um componente em qualquer uma das etapas de teste da IU personalizada, a versão da IU personalizada pode ser exibida. Se houver vários componentes duplicados, a ordem dos componentes será exibida.
- A versão da IU personalizada será exibida somente se houver pelo menos dois componentes diferentes com versões diferentes da IU personalizada.
- O pedido será exibido somente se houver componentes duplicados no menu suspenso do componente. Você pode eliminar a ambiguidade de acordo com a ordem exibida.
- A versão da IU personalizada e o pedido serão exibidos se houver vários componentes duplicados de versões diferentes.
Identificando componentes
<button sn-atf-id="consistentValue">Test</button>Melhorar a identificação do componente ATF
Identifique seu componente usando o caminho do rótulo incluído na coluna Área da página. A partir da versão Rome, a propriedade sn_atf.element.use_label_path foi definida como verdadeira por padrão.
Se um componente tiver o atributo sn-atf-area, a coluna Área da página exibirá o valor sn-atf-area. Se o atributo sn-atf-area não estiver presente, o caminho do rótulo para esse componente será mostrado na coluna Área da página.
sn-atf-area ou um caminho de rótulo, o valor será exibido como padrão.Quando você seleciona o componente necessário na lista e clica em Enviar, a descrição da etapa de teste também é atualizada com mais detalhes.