TestGenerationApi do Cloud Runner – com escopo, global

Gerencia a geração de trabalhos de teste a serem executados em um executor na nuvem para o Automated Test Framework (ATF). Esta API faz parte da inclusão de script CloudRunnerApi.

Você pode usar esta API para as seguintes tarefas:

• Inicie o trabalho de geração de teste.
• Verifique o andamento do trabalho de geração de teste.
• Cancele o trabalho de geração de teste.

No escopo global, esta API é executada no namespace sn_atf_tg. Você deve ter o plug-in ATF Test Generator and Cloud Runner (sn_atf_tg) ativado para usar esta API.

Consulte também:

• Cloud Runner TestRunnerApi – com escopo, global
• TestUserApi do executor na nuvem – com escopo, global
• REST API de geração de teste do Cloud Runner (Implementação de REST)

TestGenerationApi – cancelJob(cadeia de caracteres snboqId)

Define o trabalho de geração de teste e seu registro de conjunto de atualizações associado para o status concluído. Cancela os rastreadores raiz de todos os testes gerados que estão em execução. Se algum trabalho de teste estiver em andamento no cancelamento, este método definirá qualquer um dos registros de teste em andamento gerados como ignorados.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
snboqId	Cadeia de caracteres	Obrigatório. O sys_id do registro BOQ na tabela Fila de orquestração do navegador [sn_atf_tg_sn_boq].

Tabela 2. Retorna

Tipo	Descrição
nulo	Nulo se bem-sucedido, caso contrário, mensagem de erro.

O exemplo a seguir mostra como iniciar a geração de testes para a tabela de incidentes e cancelar a geração de testes. No escopo global, use o namespace sn_atf_tg.

var insertedSnboqId = CloudRunnerAPI.TestGenerationAPI.startJob({
  tableEncodedQuery: "nameISincident",
  catalogEncodedQuery: "sysIdISEMPTY",
  maxTestCount: 10
});

CloudRunnerAPI.TestGenerationAPI.cancelJob({snboqId: insertedSnboqId});

TestGenerationApi - andamento (cadeia de caracteres snboqId)

Fornece o status de cada teste gerado para um registro de Fila de Orquestração do Navegador (BOQ) fornecido.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
snboqId	Cadeia de caracteres	Obrigatório. O sys_id do registro BOQ na tabela Fila de orquestração do navegador [sn_atf_tg_sn_boq].

Tabela 4. Retorna

Tipo	Descrição
Objeto	Informações sobre o trabalho de teste. Você pode encontrar detalhes do teste avançado na tabela Testes gerados [sn_atf_tg_generated_test]. { "testsFailed": Number, "testsInProgress": Number, "testsPending": Number, "testsSkipped": Number, "testsSucceeded": Number }
testesReprovados	O número de testes com falha gerados. Os motivos da falha são listados na tabela Testes gerados [sn_atf_tg_generated_test]. Tipo de dados: número
testesEm andamento	O número de casos de uso que estão sendo criados. Tipo de dados: número
testesPendentes	O número de casos de uso restantes a serem gerados. Tipo de dados: número
testesOmitidos	O número de testes ignorados devido ao cancelamento do trabalho. Tipo de dados: número
testesBem-sucedidos	O número de testes gerados com sucesso. Tipo de dados: número

O exemplo a seguir mostra como iniciar a geração de testes para a tabela de incidentes, obter o andamento e cancelar a geração de testes. No escopo global, use o namespace sn_atf_tg.

var snboqId = CloudRunnerAPI.TestGenerationAPI.startJob({
  "tableEncodedQuery": "nameISincident",
  "catalogEncodedQuery": "sysIdISEMPTY",
  "maxTestCount": 10
});

gs.info(JSON.stringify(CloudRunnerAPI.TestGenerationAPI.progress({snboqId: snboqId})));

CloudRunnerAPI.TestGenerationAPI.cancelJob({"snboqId": snboqId});

Saída:

{
  "testsSucceeded": 4,
  "testsFailed": 2,
  "testsPending": 2,
  "testsInProgress": 8,
  "testsSkipped": 0
}

TestGenerationApi – startJob(cadeia de caracteres tableEncodedQuery, cadeia de caracteres userEncodedQuery, cadeia de caracteres catalogEncodedQuery, número maxTestCount, número maxTestCountPerTable, número maxTestCountPerItem, cadeia de caracteres e-mail)

Insere um registro na tabela Fila de orquestração do navegador (BOQ) [sn_atf_tg_sn_boq] para iniciar um trabalho de teste.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
tableEncodedQuery	Cadeia de caracteres	Opcional. Consulta codificada que especifica as tabelas nas quais os testes serão gerados. Consulte Encoded query strings. Padrão: todas as tabelas (cadeia de caracteres vazia)
userEncodedQuery	Cadeia de caracteres	Opcional. Consulta codificada que especifica os usuários para os quais serão gerados testes. Padrão: todos os usuários (cadeia de caracteres vazia)
catalogEncodedQuery	Cadeia de caracteres	Opcional. Consulta codificada que especifica os itens do catálogo (ICs) nos quais os testes serão gerados. Padrão: todos os ICs (cadeia de caracteres vazia)
maxTestCount	Número	Opcional. Número máximo de testes a serem gerados. Padrão: 9999 (valor máximo)
maxTestCountPerTable	Número	Opcional. Número máximo de testes a serem gerados por tabela. Padrão: 10 (valor máximo)
maxTestCountPerItem	Número	Opcional. Número máximo de testes a serem gerados por IC. Padrão: 10 (valor máximo)
e-mail	Cadeia de caracteres	Opcional. O endereço de e-mail para o qual uma notificação será enviada quando a geração de teste for concluída. Padrão: sem e-mail (cadeia de caracteres vazia)

Tabela 6. Retorna

Tipo	Descrição
Cadeia de caracteres	O sys_id do registro BOQ na tabela Fila de orquestração do navegador [sn_atf_tg_sn_boq].

O exemplo a seguir mostra como começar a gerar testes para a tabela de incidentes. No escopo global, use o namespace sn_atf_tg.

var insertedSnboqId = CloudRunnerAPI.TestGenerationAPI.startJob({
  tableEncodedQuery: "nameISincident",
  catalogEncodedQuery: "sysIdISEMPTY",
  maxTestCount: 10
});

gs.info(insertedSnboqId);

Saída:

<sys_id of inserted BOQ record>