Importar projeto

You can import projects from external sources to conduct testing operations through Test Manager. Use this feature to transfer entire testing projects from different Application Lifecycle Management (ALM) systems to Test Manager.

Como funciona

Importing the project follows a schema that converts external system projects (e.g., testing applications) into a format that can be read by Test Manager. This includes objects such as requirements, test cases, test sets, test results, labels, custom fields, and attachments. The import process is done asynchronously.

Considerações

• New Object IDs (GUIDs) are generated during import in Test Manager.
• Os carimbos de data/hora (hora criada,hora atualizada) são mantidos.
• Criado pore Atualizado por referem-se ao usuário que enviou a solicitação de importação do projeto. Não mantemos o usuário original que criou o artefato no sistema ALM.
• Os anexos de arquivo que excedem os limites de tamanho (90 MB) são ignorados.

Quem pode importar projetos

Any user having a valid Test Manager License can import projects.

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

Obtendo a versão do esquema

Você precisa da versão do esquema para construir o arquivo TMH. A recuperação da versão do esquema envolve o uso de chamadas de API no Swagger. Para recuperar a versão do esquema, siga as etapas abaixo:

1. Go to Swagger, using the Test Manager endpoint that you currently use. To connect Swagger to your Test Manager, visit API References
2. Acesse a solicitação ProjectMigrationSchema .
3. Execute GET /api/v2/migration/schema/versions e copie a versão gerada no Response Body.
4. Insira a versão do esquema copiado como um parâmetro para GET /api/v2/migration/schema/{schemaVersion} e execute a API.
5. Selecione Baixar arquivo na seção Corpo da resposta .

Resultados: É feito o download de um arquivo ZIP com o esquema de diferentes artefatos de teste no arquivo TMH. O arquivo ZIP contém as seguintes pastas e arquivos:

• Uma pasta de anexos - contém subpastas correspondentes aos anexos associados a cada objeto, ID do objeto é o nome da pasta (casos de teste, conjuntos de teste, requisitos, execuções de teste, etc.).
• An objects folder - contains subfolders corresponding to all types of objects available in Test Manager.
• Um arquivo de manifesto JSON - contém metadados básicos sobre sua WebExtension.
• Um arquivo readme.txt - contém instruções para preparar os dados que vão dentro das pastas.

Preparando o arquivo TMH

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.

Exemplo: Para especificar um Caso de Teste, use o esquema de amostra abaixo:

{
  "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",
    }
  ]
}

Certifique-se de alterar os dados entre parênteses com os dados correspondentes ao seu caso de teste.

1. Depois de criar arquivos JSON para cada objeto de um projeto, adicione-os à subpasta correspondente na pasta de objetos . Você pode nomear os arquivos JSON como 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: Se você tiver um grande número de objetos para importar, divida-os em vários arquivos, como testcases-1.jsone testcases-2.json. Recomendamos adicionar um número máximo de 500 arquivos por subpasta.
2. Adicione os arquivos de anexo associados aos objetos na pasta de anexos , usando a seguinte hierarquia de pastas: /attachments/object-id/file name.
   • object-id - substitua pelo ID do objeto associado.
   • file name - substitua pelo nome do anexo.

Quem pode importar projetos

Any user having a valid Test Manager License can import projects.

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

Importing a Project in Test Manager

Prepare the exported TMH file and then review the project import details in 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. Sign in to Test Manager.
2. Clique em Importar projeto.
3. Adicione o arquivo TMH. Os detalhes do projeto são buscados e listados automaticamente na seção Objetos no projeto para que você possa revisá-los antes de iniciar o processo de importação.
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. Revise as informações e clique em Importar para iniciar o processo.
   Nota: A importação do projeto normalmente leva de 10 a 15 minutos, mas pode demorar mais para projetos maiores.

O projeto importado aparece na página Projetos , esmaecido até que o processo seja concluído.

Importing into an existing project in Test Manager

1. Sign in to Test Manager.
2. Selecione Importar projeto.
3. Adicione o arquivo TMH que você baixou aqui

   Os detalhes do projeto são buscados automaticamente e listados 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, 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 Test Results é 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 de Project Import Completed sobre o evento.

   
   

   

   
   
8. Selecione a notificação para ir para a aba Anexos do novo projeto, 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

Review the import project report displayed in Test Manager as a notification after the process is completed. The import summary PDF file shows the status of the imported objects. You can investigate individual objects that haven't been imported in object migration log csv file. If the project import fails, contact UiPath® Support.

Como visualizar informações de automação

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

1. Na página Importar projeto , selecione Incluir informações de automação para casos de teste na parte inferior.
2. Conclua a importação e filtre os casos de teste importados, aplicando o filtro de rótulo de limpeza de automação .
3. Abra cada caso de teste retornado e vá para a guia Detalhes para recuperar as informações sobre a automação que gerou o caso de teste.
   

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

• ID da Automação
• AutomationProjectName

• AutomaçãoTestCaseName