클라우드 실행기 TestRunnerApi – 범위 지정, 전역

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기4분

    • Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트를 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.

    다음 작업에 이 API를 사용할 수 있습니다.
    • 클라우드 실행기 브라우저에서 ATF 테스트 또는 테스트 도구 모음을 시작합니다.
    • 테스트 작업의 진행률을 확인합니다.
    • 테스트 작업을 취소합니다.

    전역 범위에서 이 API는 sn_atf_tg 네임스페이스 내에서 실행됩니다. 이 API를 사용하려면 (sn_atf_tg) 플러그인이 ATF Test Generator and Cloud Runner 활성화되어 있어야 합니다.

    참조:

    TestRunnerApi – cancelJob(String snboqId)

    테스트 러너 작업을 완료 상태로 설정하고 실행 중인 생성된 테스트의 루트 추적기를 취소합니다.

    표 1. 매개변수
    이름 유형 설명
    snboqId 문자열 필수 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록 sys_id입니다.
    표 2. 반환
    유형 설명
    null 성공하면 Null, 그렇지 않으면 오류 메시지입니다.

    다음 예제에서는 테스트를 시작하고, ATF 테스트를 실행하고, 진행률을 표시하고, 테스트 실행을 중지하는 방법을 보여 줍니다. 전역 범위에서는 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});

    출력:

    {progress: 64, state: running}

    TestRunnerApi – progress(String snboqId)

    제공된 BOQ(브라우저 오케스트레이션 큐) 기록에 대해 실행된 각 테스트의 상태를 제공합니다.

    표 3. 매개변수
    이름 유형 설명
    snboqId 문자열 필수 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록 sys_id입니다.
    표 4. 반환
    유형 설명
    객체 테스트 진행률을 나타내는 JSON 객체입니다.
    {
  "progress": Number,
  "state": "String"
}
    객체.진행률 테스트 진행률 백분율 완료를 나타냅니다.

    유형: 번호
    객체.상태 BOQ 기록의 상태입니다.
    가능한 값:
    • 보류 중 - 요청한 테스트 활동이 생성되어 실행 대기 중입니다.
    • 처리 중 – 요청이 클라우드 인프라로 전송되기 전에 인스턴스가 실행 추적기가 클라우드 실행기에 대해 표시되는지 확인하기 위해 기록을 스캔합니다.
    • 브라우저 요청됨 – 테스트 생성 또는 테스트 실행을 위해 브라우저를 시작하기 위해 요청이 클라우드 인프라로 전송되었습니다.
    • 실행 중 – 클라우드 인프라 브라우저에서 보류 중인 테스트를 찾아 실행합니다.
    • 완료됨 – 테스트 작업이 완료되었습니다.
    • 실패 상태 - 테스트 작업이 실패했습니다.

    유형: 문자열
    오류 실패하면 다음과 같은 오류 메시지가 나타날 수 있습니다.
    • BOQ ID가 전달되지 않음 – 제공된 JSON 개체에 BOQ ID 항목이 없습니다. JSON 객체가 {snboqId: "<sys_id>"}로 구조화되어 있는지 확인합니다.
    • 잘못된 BOQ sys_id 전달됨 – 입력한 ID는 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록에 대한 것이어야 합니다.

    다음 예제에서는 테스트를 시작하고, ATF 테스트를 실행하고, 진행률을 표시하고, 테스트 실행을 중지하는 방법을 보여 줍니다. 전역 범위에서는 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});

    출력:

    {progress: 64, state: running}

    TestRunnerApi – startJob(문자열 testId)

    클라우드 실행기 브라우저에서 ATF 테스트 또는 테스트 도구 모음을 시작합니다.

    표 5. 매개변수
    이름 유형 설명
    testId 문자열 필수 클라우드 실행기 브라우저에서 실행할 ATF 테스트 또는 테스트 도구 모음의 sys_id입니다. 다음 테이블 중 하나에 있습니다.
    • 테스트 [sys_atf_test]
    • 테스트 도구 모음 [sys_atf_test_suite]
    표 6. 반환
    유형 설명
    문자열 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록 sys_id입니다.

    다음 예제에서는 테스트를 시작하고, ATF 테스트를 실행하고, 진행률을 표시하고, 테스트 실행을 중지하는 방법을 보여 줍니다. 전역 범위에서는 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});

    출력:

    {progress: 64, state: running}