Importar projeto

Você pode importar projetos de fontes externas para realizar operações de teste por meio do Test Manager. Use esse recurso para transferir projetos de teste inteiros de diferentes sistemas Application Lifecycle Management (ALM) para o Test Manager.

Como funciona

A importação do projeto segue um esquema que converte projetos do sistema externo (por exemplo, aplicativos de teste) em um formato que pode ser lido pelo Test Manager. Isso inclui objetos como requisitos, casos de teste, conjuntos de testes, resultados de testes, rótulos, campos personalizados, pré-condições, pós-condições e anexos. O processo de importação é feito de forma assíncrona.

Considerações

• Novas IDs de objeto (GUIDs) são geradas durante a importação no Test Manager.
• Os carimbos de hora (Hora de criação,Hora de atualização) são mantidos.
• Created By, and Updated By refer to the user who submitted the project import request. We do not maintain the original user who created the artifact in the ALM system.
• Os anexos de arquivo que excedem os limites de tamanho (90 MB) são ignorados.

Quem pode importar projetos

Qualquer usuário que tenha uma Licença de Gerenciador de Teste válida pode importar projetos.

Para obter mais informações, consulte Gerenciamento de acesso de usuários e grupos.

Getting the schema version

You need the schema version to build the TMH file. Retrieving the schema version involves using API calls in Swagger. To retrieve the schema version, follow the steps below:

1. Vá até o Swagger usando o ponto de extremidade do Test Manager que você usa atualmente. Para conectar o Swagger ao seu Test Manager, acesse Referências da API.
2. Go to the ProjectMigrationSchema request.
3. Execute GET /api/v2/migration/schema/versions and copy the version generated in the Response Body.
4. Input the copied schema version as a parameter for GET /api/v2/migration/schema/{schemaVersion} and execute the API.
5. Select Download file from the Response body section.

Results: A ZIP file is downloaded, that has the schema of different testing artifacts in the TMH file. The ZIP file contains the following folders and files:

• An attachments folder - contains subfolders corresponding to the attachments associated with each object, object Id is folder name (test cases, test sets, requirements, test executions, etc.).
• An objects folder - contains subfolders corresponding to all types of objects available in Test Manager.
• A JSON manifest file - holds basic metadata about your WebExtension.
• A readme.txt file - contains instructions for preparing data that goes inside the folders.

Preparing the TMH file

Quando você estiver preparando seus arquivos TMH para importação, recomendamos usar um tamanho de arquivo que não exceda 2 GB. Ao manter o tamanho do arquivo dentro desse limite, você pode evitar que o processo de importação seja anulado no meio do caminho.

Especifique todos os objetos que deseja importar para arquivos JSON, seguindo os esquemas de amostra dentro de cada subpasta.

Example: To specify a Test Case, use the sample schema below:

{
  "testCases": [
    {
      "id": "string (100)",
      "version": "string (100)",
      "name": "string (100)",
      "inputParams": "string",
      "description": "string",
      "automationId": "string (100)",
      "automationTestCaseName": "string (100)",
      "automationProjectName": "string (100)",
      "foreignRef": "string",
      "connectorTestCaseId": "string",
    }
  ]
}

Make sure to change the data between parentheses with the data corresponding to your Test Case.

1. Após criar arquivos JSON para cada objeto de um projeto, adicione-os à subpasta correspondente na pasta de objetos . Você pode nomear os arquivos JSON da maneira que quiser, mas os nomes das subpastas devem permanecer os mesmos Exemplo: adicione os arquivos JSON que contêm dados sobre Casos de teste à subpasta testcases .
   Importante:

   If you have a large number of objects to import, split them into multiple files, such as testcases-1.json, and testcases-2.json. We recommend adding a maximum number of 500 files per subfolder.

2. Add the attachment files associated with the objects under the attachments folder, using the following folder hierarchy: /attachments/object-id/file name.
   • object-id - substitua pelo ID do objeto associado.
   • file name - substitua pelo nome do anexo.

Quem pode importar projetos

Qualquer usuário que tenha uma Licença de Gerenciador de Teste válida pode importar projetos.

Para obter mais informações, consulte Gerenciamento de acesso de usuários e grupos.

Importing a project in Test Manager

Prepare o arquivo TMH exportado e revise os detalhes de importação do projeto no Test Manager.

Importante:

Quando você estiver preparando seus arquivos TMH para importação, recomendamos usar um tamanho de arquivo que não exceda 2 GB. Ao manter o tamanho do arquivo dentro desse limite, você pode evitar que o processo de importação seja anulado no meio do caminho.

1. Faça logon no Test Manager.
2. Click Import project.
3. Add the TMH file. Project details are automatically fetched and listed in the Objects in project section so you can review before starting the import process.
4. (Opcional) Edite o nome, o prefixo e a descrição do projeto.
5. Include automation information for test cases is automatically selected so you can import automation and other relevant information. For example, an automation linked to a test case will be imported to Test Manager with all the details and test case steps.
6. Review information and click Import to start the process.
   Observação:

   Importing the project typically takes around 10-15 minutes, but it might take longer for larger projects.

The imported project shows up in the Projects page, grayed out until the process is completed.

Importando para um projeto existente no Test Manager

1. Faça logon no Test Manager.

2. Selecione Importar projeto.

3. Adicione o arquivo TMH que você baixou aqui

   Os detalhes do projeto são buscados e listados automaticamente na seção Objetos no arquivo do projeto para que você possa revisá-los antes de iniciar o processo de importação.

4. Selecione Projeto existente em Destino.

5. Selecione o projeto de destino, para onde os dados são importados, no menu suspenso Projeto .

   Dica:

   • Se você tiver arquivos TMH de tamanhos maiores, poderá dividi-los em vários arquivos e importá-los separadamente dentro do mesmo projeto de destino.
   • Se você exportar vários projetos, poderá importá-los de volta para um projeto existente.

6. Include automation information for test cases is automatically selected so you can import automation and other relevant information. For example, an automation linked to a test case will be imported to Test Manager with all the details and test case steps.

7. Revise as informações e selecione Importar para iniciar o processo.

   AVISO:

   O campo Resultados do teste é sempre 0, porque os resultados do teste não são exportados.

   Quando o processo de importação de um projeto existente for concluído, você receberá uma notificação Importação do projeto concluída sobre o evento.

   

8. Selecione a notificação para acessar a guia Anexos do projeto novo, onde você poderá visualizar:

   1. logs para as etapas de migração (arquivo ZIP)
   2. logs para os objetos migrados (arquivo ZIP)
   3. resumo de importação (arquivo TXT) - mostra o número total de entidades e quantas delas foram importadas ou ignoradas.

Etapas pós-importação

Etapas pós-importação

Revise o relatório do projeto de importação exibido no Test Manager como uma notificação após o processo ser concluído. O arquivo PDF de resumo de importação mostra o status dos objetos importados. É possível investigar objetos individuais que não foram importados no arquivo csv do log de migração de objetos. Se a importação do projeto falhar, entre em contato com o Suporte da UiPath®.

Como visualizar informações de automação

Para visualizar informações sobre a automação que gerou um caso de teste específico:

1. In the Import project page, select Include automation information for test cases at the bottom.

2. Finish the import, and filter through the imported test cases, applying the automationcleared label filter.

3. Open every returned test case, and go to the Details tab to retrieve the information about the automation that generated the test case.

   Figura 1. A lista suspensa Rótulos exibindo o rótulo automationcleared

   

As informações de automação exibidas na guia Detalhes incluem:

• ID da Automação

• AutomationProjectName

• AutomaçãoTestCaseName