Importar projeto

Importe um arquivo TMH de um sistema externo para o Test Manager como um projeto novo ou existente, migrando requisitos, casos de teste, conjuntos de testes e anexos.

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.
• Time stamps (Created Time, Updated Time) are maintained.
• Criado por e 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.
• Os links de automação não são transferidos durante a importação, porque a vinculação depende de IDs de automação que são exclusivos para cada tenant.

Observação:

Após importar um projeto para um tenant diferente, desvincule e vincule novamente a automação de cada caso de teste para a automação correspondente no Orchestrator do tenant de destino. Caso contrário, as execuções automatizadas para esse caso de teste permanecem presas em um estado pendente.

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

A versão do esquema é necessária para criar o arquivo TMH, e você a recupera com chamadas de API no Swagger.

Etapas

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.

Resultado

Um arquivo ZIP é baixado. Ele contém o esquema dos diferentes artefatos de teste no arquivo TMH.

O arquivo ZIP contém as seguintes pastas e arquivos:

• 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"
    }
  ]
}

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

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.

Importação de um projeto no Test Manager

A importação de um projeto cria um novo projeto do Test Manager a partir de um arquivo TMH exportado.

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.

Etapas

1. Faça logon no Test Manager.
2. Selecione 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. Revise a seção Objetos no projeto e verifique os objetos de dados incluídos no arquivo do projeto.
5. (Opcional) Para incluir a automação como parte da sua importação, selecione a caixa de seleção Incluir informações de automação para casos de teste .
6. (Opcional) Para incluir a configuração do projeto como parte de sua importação, marque a caixa de seleção Importar configuração do projeto .
7. (Opcional) Edite o nome, o prefixo e a descrição do projeto.
8. Revise as informações e selecione Importar para iniciar o processo.
   Observação:

   A importação do projeto normalmente leva cerca de 10 a 15 minutos, mas pode levar mais tempo para projetos maiores.

9. 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.
   Observação:

   Se a importação do projeto falhar, entre em contato com o Suporte da UiPath®.

Resultado

O projeto importado aparece na página Projetos , acinzentado até que o processo seja concluído. Uma notificação Importação de projeto concluída confirma a importação.

Importando para um projeto existente no Test Manager

A importação para um projeto existente mescla os requisitos, casos de teste, conjuntos de testes e outros artefatos de um arquivo TMH no projeto de destino.

Etapas

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 revisar antes de iniciar o processo de importação.

4. Revise a seção Objetos no arquivo do projeto e verifique os objetos de dados incluídos no arquivo do projeto.

5. (Opcional) Para incluir a automação como parte da sua importação, selecione a caixa de seleção Incluir informações de automação para casos de teste .

6. (Opcional) Para incluir a configuração do projeto como parte de sua importação, marque a caixa de seleção Importar configuração do projeto .

7. Selecione Projeto existente em Destino.

8. 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.

9. 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.

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

    

11. Selecione a notificação para acessar a guia Anexos do novo projeto, onde você pode 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.

12. 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.

    Observação:

    Se a importação do projeto falhar, entre em contato com o Suporte da UiPath®.

Resultado

Os dados do arquivo TMH são importados para o projeto selecionado, e uma notificação Importação de projeto concluída confirma a importação.

Como visualizar informações de automação

A guia Detalhes de um caso de teste importado mostra a automação que o gerou, desde que você tenha incluído as informações da automação na importação.

Etapas

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.

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

   

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

Resultado

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

• ID da Automação
• AutomationProjectName
• AutomaçãoTestCaseName

Artigos relacionados

• Especificação do formato de arquivo TMH