클라우드 실행기 TestGenerationApi – 범위가 지정됨, 전역

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

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

    다음 작업에 이 API를 사용할 수 있습니다.
    • 테스트 생성 작업을 시작합니다.
    • 테스트 생성 작업의 진행률을 확인합니다.
    • 테스트 생성 작업을 취소합니다.

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

    참조:

    TestGenerationApi – cancelJob(String snboqId)

    테스트 생성 작업 및 관련 업데이트 세트 기록을 완료 상태로 설정합니다. 실행 중인 생성된 테스트의 루트 추적기를 취소합니다. 취소 시 테스트 작업이 진행 중인 경우 이 메서드는 생성된 진행 중인 테스트 기록을 건너뜀으로 설정합니다.

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

    다음 예시에서는 인시던트 테이블에 대한 테스트 생성을 시작하고 테스트 생성을 취소하는 방법을 보여줍니다. 전역 범위에서는 sn_atf_tg 네임스페이스를 사용합니다.

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

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

    TestGenerationApi – 진행률(문자열, snboqId)

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

    표 3. 매개변수
    이름 유형 설명
    snboqId 문자열 필수 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록 sys_id입니다.
    표 4. 반환
    유형 설명
    객체 테스트 작업에 대한 정보입니다. 생성된 테스트 [sn_atf_tg_generated_test] 테이블에서 고급 테스트 상세 정보를 찾을 수 있습니다.
    {
  "testsFailed": Number,
  "testsInProgress": Number,
  "testsPending": Number,
  "testsSkipped": Number,
  "testsSucceeded": Number
}
    테스트 실패 생성된 실패한 테스트 수입니다. 실패한 이유는 생성된 테스트 [sn_atf_tg_generated_test] 테이블에 나열됩니다.

    데이터 유형: 숫자
    testsInProgress 생성 중인 사용 사례 수입니다.

    데이터 유형: 숫자
    테스트 보류 중 생성할 남아 있는 사용 사례 수입니다.

    데이터 유형: 숫자
    tests건너뜀 작업 취소로 인해 건너뛴 테스트 수입니다.

    데이터 유형: 숫자
    테스트 성공 성공적으로 생성된 테스트 수입니다.

    데이터 유형: 숫자

    다음 예시에서는 인시던트 테이블에 대한 테스트 생성을 시작하고, 진행률을 가져오고, 테스트 생성을 취소하는 방법을 보여줍니다. 전역 범위에서는 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});

    출력:

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

    TestGenerationApi – startJob(String tableEncodedQuery, String userEncodedQuery, String catalogEncodedQuery, Number maxTestCount, Number maxTestCountPerTable, Number maxTestCountPerItem, String email)

    BOQ(브라우저 오케스트레이션 큐) [sn_atf_tg_sn_boq] 테이블에 기록을 삽입하여 테스트 작업을 시작합니다.

    표 5. 매개변수
    이름 유형 설명
    카탈로그 인코딩쿼리 문자열 옵션입니다. 테스트를 생성할 카탈로그 항목(CI)을 지정하는 인코딩된 쿼리입니다.

    기본값: 모든 CI(빈 문자열)
    이메일 문자열 옵션입니다. 테스트 생성이 완료될 때 알림을 보낼 이메일 주소입니다.

    기본값: 이메일 없음(빈 문자열)
    maxTestCount 번호 옵션입니다. 생성할 최대 테스트 수입니다.

    가능한 값: 1-9999

    기본값: 9999(최대값)
    maxTestCountPerTable 번호 옵션입니다. 테이블당 생성할 최대 테스트 수입니다.

    가능한 값: 1-10

    기본값: 10(최대값)
    maxTestCountPerItem 번호 옵션입니다. CI당 생성할 최대 테스트 수입니다.

    가능한 값: 1-10

    기본값: 10(최대값)
    separateUpdateSetPerScope 부울

    옵션입니다. 생성된 테스트를 각각의 도구 모음, 업데이트 세트 및 범위로 구분할지 또는 테스트를 하나의 도구 모음, 업데이트 세트 및 범위에 배치할지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 테스트는 각 테이블 또는 카탈로그 항목의 범위에 따라 해당 제품군 및 업데이트 세트에 배치됩니다.
    • false: 생성된 모든 테스트가 동일한 도구 모음, 업데이트 세트 및 범위에 배치됩니다. false인 scopeForGeneratingTests 경우 요청에 필수입니다.

    기본값: true
    scopeForGeneratingTests 문자열 false로 설정된 경우 separateUpdateSetPerScope 필요합니다. 생성된 모든 테스트를 배치할 범위의 Sys_id입니다.

    기본값: sys_id 없음(빈 문자열)
    tableEncodedQuery 문자열 옵션입니다. 테스트를 생성할 테이블을 지정하는 인코딩된 쿼리입니다. Encoded query strings 문서를 참조하십시오.

    기본값: 모든 테이블(빈 문자열)
    userEncodedQuery 문자열 옵션입니다. 테스트를 생성할 사용자를 지정하는 인코딩된 쿼리입니다.

    기본값: 모든 사용자(빈 문자열)
    표 6. 반환
    유형 설명
    문자열 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록 sys_id입니다.

    다음 예에서는 인시던트 테이블에 대한 테스트 생성을 시작하는 방법을 보여줍니다. 전역 범위에서는 sn_atf_tg 네임스페이스를 사용합니다.

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

gs.info(insertedSnboqId);

    출력:

    <sys_id of inserted BOQ record>