Etapas de teste de 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 o 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 DOM (Document Object Model, modelo de objeto de documento)
- 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.
- São acessíveis para JavaScript
- Os componentes da página testáveis podem ser acessados pelo JavaScript. As etapas de teste de IU personalizada não podem acessar componentes da 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 personalizado
- Os componentes de página testáveis não são excluídos do teste de IU personalizado. 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 aos recursos Now Platform.
- Estão acessíveis para o Inspetor de páginas
- Os componentes de página testáveis devem retornar resultados quando exibidos no Inspetor de Páginas. Os designers de teste podem usar o Inspetor de página 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 que não podem ser testados incluem esses elementos de IU.
| Motivo que não pode ser testado | Componentes de página não testáveis |
|---|---|
| Não são definí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 no DOM | Painéis |
| Imagens | |
| Listas | |
| Relatórios | |
| Sombra DOM | |
| 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 definíveis oferecem suporte a essas ações de teste e etapas de teste.
| Ações do Inspetor de páginas | Etapas de teste de 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 definí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. Componentes clicáveis oferecem suporte a essas ações de teste.
| Ações do Inspetor de páginas | Etapas de teste de 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. Habilitar esta 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 do teste permite que os testes sejam executados mais rapidamente porque as etapas de teste podem usar a lista recuperada anteriormente de componentes de 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 teste de IU personalizado. Os componentes de página que estão indisponíveis para o inspetor de página não estão disponíveis para testes de IU personalizados.
- 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 componente 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 personalizado 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 do usuário.
- Usar 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 específicos de Automated Test Framework. Consulte Substituir ações de teste do componente.
- Recuperar componentes de página novamente ao mover 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 o comentário 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é o Módulo. Navegue até o módulo "Publicado" na aplicação "Conhecimento".
- Abrir 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 personalizado
Identificando componentes
<button sn-atf-id="consistentValue">Test</button>Melhorar a identificação do componente do ATF
Identifique seu componente usando o caminho do rótulo incluído na coluna Área da página. Começando com a versão Rome, a propriedade sn_atf.element.use_label_path foi definida como verdadeira por padrão.
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 desse 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.