Cloud Runner TestRunnerApi – com escopo, global

Gerencia os testes 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 um teste ATF ou pacote de testes no navegador do Cloud Runner.
• Verifique o andamento do trabalho de teste.
• Cancele o trabalho 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:

• TestGenerationApi do Cloud Runner – com escopo, global
• TestUserApi do executor na nuvem – com escopo, global
• REST API do usuário de teste do executor na nuvem (Implementação de REST)

TestRunnerApi – cancelJob(cadeia de caracteres snboqId)

Define o trabalho do executor de teste para o status concluído e cancela os rastreadores raiz de todos os testes gerados que estão em execução.

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 uma simulação de um teste ATF, exibir o andamento e parar a simulação. No escopo global, use o namespace sn_atf_tg.

var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({
	"testId": "<sys_id>"
});

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

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

Saída:

{progress: 64, state: running}

TestRunnerApi – andamento (cadeia de caracteres snboqId)

Fornece o status de cada teste executado 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	Objeto JSON indicando o andamento do teste. { "progress": Number, "state": "String" }
Objeto.andamento	Indica a porcentagem de conclusão do andamento do teste. Tipo: Número
Objeto.estado	Estado do registro de BOQ. Valores possíveis: Pendente - a atividade de teste solicitada foi criada e está aguardando a execução. Processamento: a instância está verificando em busca de registros para garantir que os rastreadores de execução sejam marcados para o executor na nuvem antes que a solicitação seja enviada para a infraestrutura em nuvem. Navegadores solicitados: uma solicitação foi enviada à infraestrutura em nuvem para iniciar navegadores para geração de teste ou execução de teste. Em execução: os navegadores de infraestrutura em nuvem localizam e executam testes pendentes. Concluído - a tarefa de teste está concluída. Estado de falha: a tarefa de teste falhou. Tipo: cadeia de caracteres
Erro	Em caso de falha, possíveis mensagens de erro: Nenhum ID de BOQ passado: o objeto JSON fornecido não tem uma entrada de ID de BOQ. Verifique se o objeto JSON está estruturado como {snboqId: "<sys_id> "} . sys_id de BOQ inválido passado – o ID fornecido deve ser para um registro de BOQ na tabela Fila de orquestração do navegador [sn_atf_tg_sn_boq].

O exemplo a seguir mostra como iniciar uma simulação de um teste ATF, exibir o andamento e parar a simulação. No escopo global, use o namespace sn_atf_tg.

var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({
	"testId": "<sys_id>"
});

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

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

Saída:

{progress: 64, state: running}

TestRunnerApi – startJob(cadeia de caracteres testId)

Inicia um teste ATF ou um pacote de testes no navegador do Cloud Runner.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
testId	Cadeia de caracteres	Obrigatório. O sys_id do teste ATF ou pacote de testes a ser executado no navegador do Cloud Runner. Localizado em uma das seguintes tabelas: Teste [sys_atf_test] Pacotes de testes [sys_atf_test_suite]

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 iniciar uma simulação de um teste ATF, exibir o andamento e parar a simulação. No escopo global, use o namespace sn_atf_tg.

var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({
	"testId": "<sys_id>"
});

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

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

Saída:

{progress: 64, state: running}