Trabalhando com mapa de calor

Esta página orienta você pela jornada do usuário para interagir com o mapa de calor. A página guia você por várias etapas, incluindo a criação de casos de teste no Studio, a configuração de proporções e configurações do mapa de calor, o exame e o teste de transações e a execução de conjuntos de testes. Consulte os seguintes tópicos para começar a usar o Mapa de calor.

Você trabalha com uma visualização de mapa de calor de dois níveis:

• Componentes do aplicativo: contêineres visuais que agrupam transações SAP relacionadas sob um componente ou módulo específico.
• Transações: caixas dentro de componentes que representam transações ou programas SAP individuais. Cada caixa exibe dados de transação, como:
  • Nome da transação
  • Código do SAP
  • Status e cobertura dos testes

Criar casos de teste no Studio

Para começar com o Mapa de calor, você precisa criar casos de teste para suas transações SAP com o UiPath Studio. Para garantir que o mapa de calor mostre com precisão quais transações são cobertas pelos testes e seus status, você precisa definir a configuração Habilitar monitoramento do SAP do projeto do Studio como True.

Ligação e conexão entre mapa de calor, casos de teste e transações

Todas as transações dentro do mapa de calor têm um rótulo exclusivo automaticamente atribuído a elas no runtime. O rótulo tem o seguinte formato: TRAN:SAP_CODE ou PROG:SAPPROGRAM.

As informações sobre transações reais executadas e suas dependências são coletadas no runtime. Para permitir que casos de teste vinculem--se às transações executadas, acesse suas configurações de projeto do Studio e, em Automação de Interface Gráfica Clássica, defina Habilitar monitoramento SAP como True. Essa configuração está disponível apenas para projetos de Automação de Testes.

Observação: habilitar o monitoramento SAP na Automação de Interface Gráfica Clássica também vinculará casos de teste e transações para atividades modernas de Automação de Interface Gráfica.

Por exemplo, uma transação chamada Create Purchase Order, com ME21N como seu código SAP, tem o rótulo  TRAN:ME21N. Se você deseja criar um caso de teste para uma transação, o mesmo rótulo aparece no campo Rótulos ou na caixa de diálogo Criar caso de teste.

Configurar as proporções e configurações do Mapa de calor

Após criar casos de teste no UiPath Studio para suas transações SAP, você pode configurar as proporções e configurações com base nas quais o mapa de calor exibirá a relevância e a cobertura do teste.

Alterando as configurações do mapa de calor

O Mapa de calor é gerado com base nos valores de cinco atributos SAP. Você pode configurar as proporções de atribuição para priorizar os atributos mais relevantes para sua estratégia de testes.

Atributo SAP	Description	Valor padrão
Usuários	O número de usuários usando a transação.	40
Execução	O número de execuções por transação.	10
Hora	O tempo geral de processamento necessário para uma transação ser executada.	10
Object	O número de objetos de desenvolvimento usados em uma transação, como telas, módulos funcionais, tabelas.	10
Intensidade	O tipo de transação: Transações de alta intensidade são consideradas o tipo de transação Criar Transações de média intensidade são consideradas o tipo de transações Alterar Transações de baixa intensidade são consideradas o tipo de transações Exibição)	30

Importante:

A soma de todas as taxas de atribuição deve ser igual a 100.

Páginas de destino do SAP FIORI

Além disso, você pode habilitar ou desabilitar a Visibilidade das páginas de destino do SAP Fiori no mapa de calor.

Conexão direta com a instância do SAP

1. Selecione o ícone de engrenagem no canto superior direito para abrir as Configurações do Mapa de calor.
2. Altere as taxas de atribuição de acordo com seu caso de uso.
   Por exemplo, para realçar as transações mais intensas (do tipo Criar), em vez das mais utilizadas, altere a razão do Usuário para 10, e depois a razão da Intensidade para 60.
3. Em Visibilidade, selecione a opção Exibir páginas de destino do SAP FIORI para exibir páginas de destino do SAP FIORI no Mapa de calor.

Conexão com arquivo CSV

Depois de executar o programa Z_UIPATH_CUST_HEATMAP_DOWNLOAD, acesse a guia Parâmetros e configure as proporções.

Analisar e testar transações

Após criar testes para suas transações SAP e configurar as proporções do Mapa de calor, você pode começar a analisar os resultados e testar transações específicas. Consulte as seguintes seções para obter informações sobre como aproveitar o Mapa de calor.

Entendendo os resultados do mapa de calor

A análise dos resultados do Mapa de calor envolve a visualização da cobertura de teste das suas transações, a filtragem de tipos de cobertura de teste e a revisão da visão geral das transações. Explore os seguintes tópicos para obter uma compreensão abrangente de como examinar os resultados do Mapa de calor.

Como visualizar a cobertura de teste para transações

Para ver quais transações têm testes automatizados e os resultados:

1. No mapa de calor selecione Aprovado para ver as transações que passaram nos seus resultados de teste.
2. No mapa de calor, selecione Reprovado para ver as transações que não passaram nos seus resultados de teste.
3. No mapa de calor, selecione Nenhum caso de teste executado para ver as transações para as quais nenhum caso de teste foi executado.
4. No mapa de calor, selecione Nenhum caso de teste atribuído para ver as transações que não têm casos de teste atribuídos a elas.
5. No mapa de calor, selecione Mostrar todas (selecionado por padrão) para ver todas as transações acima.

Filtrando transações de mapa de calor

1. Abra o Mapa de calor e selecione o número de transações que você deseja que apareçam no menu suspenso Todas as transações:
   1. Todas as transações (padrão)
   2. As 10 Principais Transações
   3. As 20 Principais Transações
2. Selecione o horário de início das transações no menu suspenso Última semana:
   1. Último mês (padrão)
   2. Last Week
   3. Last Day
      A hora de início e término das transações é exibida ao lado do menu suspenso Período de tempo .
3. Selecione os tipos de transações que você deseja que apareçam no menu suspenso Todos os tipos de transações:
   1. Transações padrão
   2. Transações personalizadas
4. Selecione os tipos de interfaces onde deseja ver as transações no menu suspenso Todos os tipos de interface:
   1. [T] - Transação no SAP WinGui
   2. [R] - Relatório/programa no SAP WinGui
   3. [W] - Transação no SAP WebGui
   4. [F] - Aplicativo no SAP Fiori

Verificando a visão geral de uma transação

1. Selecione uma transação no mapa de calor.
2. Em Detalhes da transação selecionada: manter códigos da transação, selecione Visão geral
3. Verifique o Nome da transação e seu Código SAP.
   O código SAP de uma transação é usado para gerar um rótulo exclusivo

Geração de casos de teste para uma transação específica

Você pode gerar testes manuais usando Autopilot^TM para transações visualizadas como parte do Mapa de calor. Os casos de teste gerados terão os seguintes rótulos atribuídos:

• gerado pelo autopilot
• TRAN:<transactionCode>

Pré-requisitos: se você quiser aproveitar o RAG ao gerar testes, você precisa começar a usar a Embasamento de Contexto, do qual o RAG é um componente. Para começar com o embasamento por contexto, acesse a página dedicada a Práticas recomendadas .

1. No Mapa de calor, selecione uma transação desejada.
2. Selecione Gerar testes.

   A janela Fornecer contexto adicional é aberta, focada em Adicionar documentos que solicitam anexos ou outros documentos necessários para gerar casos de teste.

   Figura 1. Exemplo do botão Gerar testes para a transação selecionada
   

   

   
   
   1. Na seção Adicionar documentos , selecione anexos adicionais.

      Esses são usados ao gerar testes. Você também pode carregar outros arquivos por conta própria.

      Figura 2. A seção Adicionar documentos para gerar testes
      

      

      
      
   2. Na seção Aproveitar RAG da janela Fornecer contexto adicional , selecione um índice que armazene seus dados carregados no Embasamento de Contexto.
      O índice selecionado ajuda o Autopilot a gerar testes mais precisos, fornecendo contexto sobre os aplicativos que você está tentando automatizar. Por exemplo, você pode aproveitar o RAG quando um documento de requisito tiver informações incompletas ou se referir a detalhes adicionais em outras seções. Nesse caso, você pode aproveitar o RAG para extrair esses detalhes de referências indexadas.

      Observação: para obter as melhores práticas sobre como trabalhar com embasamento de contexto, acesse Melhores práticas.
      1. Na lista suspensa Selecionar pasta , selecione a pasta na qual você armazena os índices que armazenam as informações desejadas que você deseja compartilhar com o Autopilot.
      2. Na lista suspensa Selecionar índice , selecione o índice específico que você deseja que o Autopilot faça referência.
      3. Para Número de resultados, insira o número de testes que você deseja que o Autopilot gere com base nas informações referenciadas.
      Figura 3. A seção Aproveitar RAG para gerar testes
      

      

      
      
3. Selecione Avançar e forneça instruções adicionais que o Autopilot^TM deve usar ao gerar casos de teste. Escolha entre um prompt na Biblioteca de prompts ou digite essas instruções na janela Fornecer orientação adicional .
   Estas são algumas das instruções que o Autopilot pode seguir:

   • Você pode instruir Autopilot^TM o número de casos de teste que você deseja gerar. O número máximo de casos de teste é 50.
   • Você pode especificar Autopilot^TM para cobrir todas as etapas do usuário e os critérios de aceitação descritos no requisito de solicitação de empréstimo.
   • Você pode instruir Autopilot^TM para gerar pré-condições.
   • Você pode especificar Autopilot^TM para gerar um resultado esperado para cada etapa do teste.
   • Por padrão, o Autopilot considera os testes existentes vinculados a um requisito para evitar a duplicação de testes. No entanto, você pode instruir o Autopilot para desconsiderar testes existentes durante a geração de novos testes. Você pode fazer isso fornecendo uma instrução como: "Não considere testes vinculados a este requisito ao gerar testes".
   Figura 4. Instruções adicionais inseridas na janela Fornecer orientação adicional
   

   

   
   
   1. Opcionalmente, na lista suspensa Modelo , selecione o modelo de IA que o Autopilot deve usar.

      O Autopilot usa o Claude 3.7 Sonnet por padrão ao gerar testes, que também é o modelo recomendado.

      Observação: os modelos disponíveis na lista suspensa Modelo dependem da Política de AI Trust Layer aplicada à sua organização e tenant. Se todos os modelos compatíveis estiverem habilitados, Claude 3.7 Sonnet aparece como a opção recomendada. Se apenas um tipo de modelo estiver habilitado (por exemplo, Azure OpenAI), então o modelo GPT 4o é o único exibido e automaticamente recomendado.
4. Selecione Gerar testes para iniciar o processo.

   Quando a geração terminar, você receberá uma notificação Geração de caso de teste concluída. Dependendo de suas preferências de notificação, você pode receber a notificação no aplicativo e por email.

5. Selecione a notificação Geração de teste concluída para revisar os casos de teste gerados.
   1. Expanda cada caso de teste no painel Gerar testes e revise os casos de teste gerados.
   2. Se você estiver satisfeito com o conteúdo deles, selecione Criar testes.
   Figura 5. Selecionando os testes que você deseja criar e expandindo um caso de teste
   

   

   
   
6. Se você não estiver satisfeito com os casos de teste gerados, selecione Refinar testes e forneça detalhes adicionais sobre seu caso de uso.
   1. Anexe os documentos mais relevantes para o Autopilot^TM usar.
   2. Clique em Avançar e digite detalhes adicionais na caixa de texto Fornecer instruções.
   3. Após refinar as etapas, selecione Gerar testes novamente.
   4. Clique na notificação Geração de teste concluída para acessar os casos de teste gerados novamente.
   5. Expanda cada caso de teste e revise-os.
   6. Selecione os casos de teste com os quais você está satisfeito e, em seguida, selecione Criar testes.

Os casos de teste que são gerados terão esses rótulos:

• gerado pelo autopilot
• TRAN:<transactionCode>

Por exemplo, se o rótulo da transação escolhida for TRAN:SE38, esse mesmo rótulo será aplicado a todos os casos de teste gerados a partir dela.

Tipos de arquivos compatíveis

O Autopilot pode processar vários tipos de arquivos. Dependendo do tipo de arquivo, o Autopilot pode processar determinado conteúdo dele. A lista a seguir apresenta os tipos de arquivo que você pode oferecer ao Autopilot, juntamente com detalhes sobre o tipo de conteúdo que o Autopilot pode processar de cada tipo:

• Processa apenas conteúdo de texto - O Autopilot processa apenas o conteúdo de texto desses tipos de arquivo:
  • TXT
  • BPMN
  • CSV
• Processa o conteúdo de texto e imagem - O Autopilot processa o texto e as imagens desses tipos de arquivo:
  • DOCX
  • XLSX
  • PNG
  • JPG
  • PDF

Criação de casos de teste e conjuntos de testes

Após analisar os resultados exibidos no Mapa de calor, você pode começar a melhorar seu portfólio de testes, criando casos de testes e conjuntos de testes para transações não descobertas ou com falha. Consulte as páginas a seguir para obter etapas sobre a criação de casos de teste e conjuntos de testes para uma transação específica.

Criando casos de teste para uma transação específica

Todas as transações dentro do mapa de calor têm um rótulo exclusivo automaticamente atribuído a elas no runtime. O rótulo tem o seguinte formato: TRAN:SAP_CODE ou PROG:SAPPROGRAM.

As informações sobre transações reais executadas e suas dependências são coletadas no runtime. Para permitir que casos de teste vinculem--se às transações executadas, acesse suas configurações de projeto do Studio e, em Automação de Interface Gráfica Clássica, defina Habilitar monitoramento SAP como True. Essa configuração está disponível apenas para projetos de Automação de Testes.

Observação: habilitar o monitoramento SAP na Automação de Interface Gráfica Clássica também vinculará casos de teste e transações para atividades modernas de Automação de Interface Gráfica.

Por exemplo, uma transação chamada Create Purchase Order, com ME21N como seu código SAP, tem o rótulo  TRAN:ME21N. Se você deseja criar um caso de teste para uma transação, o mesmo rótulo aparece no campo Rótulos ou na caixa de diálogo Criar caso de teste.

1. Selecione uma transação no mapa de calor.
2. Em Detalhes da transação selecionada: Atualizar códigos de transação, selecione Casos de teste.
3. Selecione Criar caso de teste e configure o caso de teste que você deseja criar.
   Você pode adicionar outros rótulos àquele que já está atribuído ao caso de teste.

   Importante:

   Quando criar um caso de teste para uma transação específica, certifique-se de deixar o rótulo já atribuído à transação intocado. Caso contrário, o caso de teste que você criar não será vinculado à transação.

   Neste exemplo, o rótulo que já está atribuído é TRAN:SE16.

Criando conjuntos de teste para uma transação específica

1. Criar casos de teste para uma transação específica.
2. Selecione a transação para a qual você criou os casos de teste.
3. Em Detalhes da transação selecionada: manter códigos de transação, selecione Conjuntos de testee configure o conjunto de teste que deseja criar.
   Dica:

   Para facilitar o processo de vinculação de um conjunto de teste a uma transação, inclua o rótulo da transação no conjunto de teste que deseja vincular. Dessa forma, você pode pesquisar o conjunto de testes que acabou de criar, usando esse rótulo específico.

   Para este exemplo, adicionamos ao conjunto de testes o mesmo rótulo que usamos para criar os casos de teste (TRAN:SE16).
   
   

   

   
   
4. Depois de criar o conjunto de testes, navegue até Conjuntos de testes no Test Manager.
5. Pesquise o conjunto de teste que você criou e abra-o.
   Você pode pesquisar o conjunto de testes usando o rótulo que você adicionou na Etapa 3.
6. Selecione Tarefas > Atribuir casos de teste > Atribuição estática.
7. Pesquise os casos de teste que você criou na Etapa 1 e atribua-os a este conjunto de testes.
   
   

   

   
   
8. Navegue de volta para a página Heatmap , selecione a transação e verifique o conjunto de teste atribuído a ela.

Vinculação do conjunto de teste do Orchestrator a uma transação

1. Selecione uma transação e, em Detalhes da transação selecionada: Atualizar códigos de transação, selecione Conjuntos de teste.
2. Selecione Link, escolha os conjuntos de teste do Orchestrator que você deseja vincular e selecione Link.

Executar conjuntos de testes para uma transação

1. Vincule um conjunto de teste a uma transação.
2. Selecione Mais opções em linha com o conjunto de testes que você deseja executar.
3. Selecione um dos seguintes:
   • Executar manualmente
   • Executar com automação
4. Verificar os resultados do teste no mapa de calor.

anexos de mapa de calor

Os dados SAP que gera o mapa de calor podem ser encontrados no Painel do Test Manager, em Anexos:

• Para ConnectSapInstance como Origem de dados: três arquivos JSON são anexados (para Dia, Semana e Mês)
• Para UploadFromCSV como Origem de dados: o arquivo CSV carregado é anexado.