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 por testes e seu status, você precisa definir a configuração Habilitar monitoramento 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 total de todas as proporções 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.

For example, to highlight the most intense transactions (of type Create), rather than the most used ones, change the User ratio to 10, and then the Intensity ratio to 60. 3. Under Visibility, select the Display SAP FIORI landing pages toggle, to display SAP FIORI landing pages in the heatmap.

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

The start and end time of transactions is displayed next to the Time Period dropdown. 3. Select the types of transactions that you want to appear from the All transaction types dropdown:

1. Transações padrão
2. Transações personalizadas
3. 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 de 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

Observação:

Feature availability depends on the cloud platform you use. For details, refer to the Test Manager feature availability page.

Você pode gerar testes manuais usando o 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:

• autopilot-generated
• TRAN:<transactionCode>

Prerequisites: (For Cloud Commercial only) If you want to leverage RAG when generating tests, you need to start using Context Grounding, which RAG is a component of. To get started with Context Grounding, visit the dedicated Best practices page.

1. No Mapa de calor, selecione uma transação desejada.

2. Selecione Gerar testes. A janela Fornecer contexto adicional é aberta, focada em Adicionar documentos solicitando 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.

Figure 2. The Add documents section for generating tests (For Cloud Commercial only)

2. (For Cloud Commercial only) In the Leverage RAG section of the Provide additional context window, select an index which stores your data uploaded to Context Grounding. The selected index helps Autopilot in generating more accurate tests by giving it context about the applications that you are trying to automate. For example, you can leverage RAG when a requirement document has incomplete information or refers to additional details in other sections. In this case, you can leverage RAG to draw those details from indexed references. :::note For best practices on working with Context Grounding, visit Best practices. ::: 1. From the Select folder dropdown list, select the folder where you store the indexes storing the desired information you want to share with Autopilot. 2. From the Select index dropdown list, select the specific index that you want Autopilot to reference. 3. For Number of results, enter the number of tests you want Autopilot to generate based on the referenced information.

Figure 3. The Leverage RAG section for generating tests

3. Select Next and provide additional instructions that Autopilot^TM should use when generating test cases. Choose from a prompt from the Prompt library or type these instructions in the Provide additional guidance window. These are some of the instructions that Autopilot can follow:

• Você pode instruir o 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 o Autopilot^TM para cobrir todas as etapas do usuário e critérios de aceitação descritos no requisito de solicitação de empréstimo.
• Você pode instruir o Autopilot^TM para gerar pré-condições.
• Você pode especificar o Autopilot^TM para gerar um resultado esperado para cada etapa do teste.
• By default, Autopilot considers existing tests linked to a requirement to prevent duplicating tests. However, you can instruct Autopilot to disregard existing tests during new test generation. You can do this by providing an instruction like: "Do not consider tests that are linked to this requirement when generating tests".Figure 4. Additional instructions entered in the Provide additional guidance window

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.

2. 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.
3. 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.

Figure 5. Selecting the tests that you want to create and expanding a test case

6. If you are not satisfied with the generated test cases, select Refine tests, and provide additional details about your use case.

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:

• autopilot-generated
• 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: Manter 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 testes e configure o conjunto de testes que você deseja criar.

   Dica:

   Para facilitar o processo de vinculação de um conjunto de teste a uma transação, adicione o rótulo da transação ao conjunto de testes que você 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é Conjunto de testes no Test Manager.

5. Pesquise o conjunto de teste que você criou e abra-o.

You can search for the test set using the label that you added at Step 3. 6. Select Tasks > Assign Test Cases > Static Assignment. 7. Search for the test cases that you created at Step 1 and assign them to this test set.

8. Navigate back to the Heatmap page, select the transaction, and check out the test set assigned to it.

Executar conjuntos de testes para uma transação

1. Vincule um conjunto de teste a uma transação.
2. Select More Options inline with the test set that you want to execute.
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 geram 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.