Cloud Runner TestGenerationApi – 범위가 지정됨, 전역

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기6분

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

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

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

    참고 항목:

    TestGenerationApi – cancelJob(문자열, 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 (테스트인프로그레스) 생성 중인 사용 사례 수입니다.

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

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

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

    데이터 유형: 숫자

    다음 예에서는 인시던트 테이블에 대한 테스트 생성을 시작하고, 진행률을 가져오고, 테스트 생성을 취소하는 방법을 보여줍니다. 전역 범위에서 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(문자열 tableEncodedQuery, 문자열 userEncodedQuery, 문자열 catalogEncodedQuery, 숫자 maxTestCount, 숫자 maxTestCountPerTable, 숫자 maxTestCountPerItem, 문자열 이메일)

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

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

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

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

    가능한 값: 1-9999

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

    가능한 값: 1-10

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

    가능한 값: 1-10

    기본값: 10(최대값)
    separateUpdateSetPerScope (별도 업데이트 설정PerScope) 부울

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

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

    기본값: true
    scopeForGeneratingTests (영문) 문자열 가 아니오로 설정된 경우 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>