--- sourceDocument: 호주 API 참조 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference Release : - australia ft:locale : - ko-KR ft:publication_title : - 호주 API 참조 ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # 클라우드 실행기 TestGenerationApi - 범위, 전역 # 클라우드 실행기 TestGenerationApi - 범위, 전역 {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분 Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트 작업 생성을 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다. 다음 작업에 이 API를 사용할 수 있습니다. * 테스트 생성 작업을 시작합니다. * 테스트 생성 작업의 진행률을 확인합니다. * 테스트 생성 작업을 취소합니다. {#cloudrnr-TestGenerationAPI-scoped__cloudrnr-TestGenerationAPI-scoped_ul_vwb_wvn_31c} 전역 범위에서 이 API는 sn_atf_tg 네임스페이스 내에서 실행됩니다. 이 API를 사용하려면 (sn_atf_tg) 플러그인이 활성화되어 있어야 합니다 [ATF Test Generator and Cloud Runner](https://www.servicenow.com/docs/access?context=atf-tg-cr-intro&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) . 참조 : * [클라우드 실행기 TestRunnerApi -- 범위, 전역](https://servicenow-prod.fluidtopics.net/fd7xPlOEOW_6VoOFU66KNw#cloudrnr-TestRunnerAPI-scoped "Automated Test Framework(ATF)에 대한 클라우드 실행기에서 실행할 테스트를 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.") * [클라우드 실행기 TestUserApi - 범위, 전역](https://servicenow-prod.fluidtopics.net/liIGMaY80uOkcdjI0WE0WQ#cloudrnr-TestUserAPI-scoped "Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트 사용자 작업을 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.") * [클라우드 실행기 테스트 생성 REST API](https://servicenow-prod.fluidtopics.net/gd5fAkM6ShuLCYrLtnNj1g#cloudrunner-testgeneration-api "Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트 작업 생성을 관리합니다.") {#cloudrnr-TestGenerationAPI-scoped__ul_gd4_zsn_31c} ## TestGenerationApi -- cancelJob(문자열 snboqId) {#ariaid-title2} 테스트 생성 작업 및 관련 업데이트 세트 기록을 완료 상태로 설정합니다. 실행 중인 생성된 테스트의 루트 추적기를 취소합니다. 취소 시 진행 중인 테스트 작업이 있는 경우, 이 메서드는 생성된 진행 중인 테스트 기록을 건너뜀으로 설정합니다. {#cr-TestGen-cancelJob_S__table_epx_lv4_g1c__entry__3}{#cr-TestGen-cancelJob_S__cr-snboqId-ph-desc} | 이름 | 유형 | 설명 | |-|-|-| | snboqId | 문자열 | 필수 브라우저 오케스트레이션 큐 \[sn_atf_tg_sn_boq\] 테이블의 BOQ 기록 sys_id입니다. | [표 1. 매개변수] {#cr-TestGen-cancelJob_S__table_epx_lv4_g1c} {#cr-TestGen-cancelJob_S__table_fpx_lv4_g1c__entry__2} | 유형 | 설명 | |-|-| | null | 성공하면 Null이고, 그렇지 않으면 오류 메시지입니다. | [표 2. 반환] {#cr-TestGen-cancelJob_S__table_fpx_lv4_g1c} 다음 예는 인시던트 테이블에 대한 테스트 생성을 시작하고 테스트 생성을 취소하는 방법을 보여줍니다. 전역 범위에서 sn_atf_tg 네임스페이스를 사용합니다. var insertedSnboqId = CloudRunnerAPI.TestGenerationAPI.startJob({ tableEncodedQuery: "nameISincident", catalogEncodedQuery: "sysIdISEMPTY", maxTestCount: 10 }); CloudRunnerAPI.TestGenerationAPI.cancelJob({snboqId: insertedSnboqId}); ## TestGenerationApi -- progress(문자열 snboqId) {#ariaid-title3} 제공된 BOQ(브라우저 오케스트레이션 큐) 기록에 대해 생성된 각 테스트의 상태를 제공합니다. {#cr-TestGen-progress_S__table_epx_lv4_g1c__entry__3}{#cr-TestGen-progress_S__cr-snboqId-ph-desc} | 이름 | 유형 | 설명 | |-|-|-| | snboqId | 문자열 | 필수 브라우저 오케스트레이션 큐 \[sn_atf_tg_sn_boq\] 테이블의 BOQ 기록 sys_id입니다. | [표 3. 매개변수] {#cr-TestGen-progress_S__table_epx_lv4_g1c} {#cr-TestGen-progress_S__table_fpx_lv4_g1c__entry__2} | 유형 | 설명 | |-|-| | 객체 | 테스트 작업에 대한 정보입니다. 생성된 테스트 \[sn_atf_tg_generated_test\] 테이블에서 고급 테스트 상세 정보를 찾을 수 있습니다. { "testsFailed": Number, "testsInProgress": Number, "testsPending": Number, "testsSkipped": Number, "testsSucceeded": Number } | | 테스트 실패 | 생성된 실패한 테스트 수입니다. 실패 이유는 생성된 테스트 \[sn_atf_tg_generated_test\] 테이블에 나열됩니다. 데이터 유형: 숫자 | | testsInProgress | 생성 중인 사용 사례 수입니다. 데이터 유형: 숫자 | | 테스트 보류 중 | 생성할 남아 있는 사용 케이스 수입니다. 데이터 유형: 숫자 | | 테스트 건너뜀 | 작업 취소로 인해 건너뛴 테스트 수입니다. 데이터 유형: 숫자 | | tests성공 | 성공적으로 생성된 테스트 수입니다. 데이터 유형: 숫자 | [표 4. 반환] {#cr-TestGen-progress_S__table_fpx_lv4_g1c} 다음 예시에서는 인시던트 테이블에 대한 테스트 생성을 시작하고, 진행률을 확인하고, 테스트 생성을 취소하는 방법을 보여줍니다. 전역 범위에서 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, 문자열 이메일, 부울 separateUpdateSetPerScope, 문자열 scopeForGeneratingTests, 문자열 suiteName) {#ariaid-title4} 테스트 작업을 시작하기 위해 브라우저 오케스트레이션 큐(BOQ) \[sn_atf_tg_sn_boq\] 테이블에 기록을 삽입합니다. {#cr-TestGen-startJob_S_S_S_N_N_N_S__table_epx_lv4_g1c__entry__3}{#cr-TestGen-startJob_S_S_S_N_N_N_S__store-2024-05} | 이름 | 유형 | 설명 | |-|-|-| | catalogEncodedQuery | 문자열 | 옵션입니다. 테스트를 생성할 카탈로그 항목(CI)을 지정하는 인코딩된 쿼리입니다. 기본값: 모든 CI(빈 문자열) | | 이메일 | 문자열 | 옵션입니다. 테스트 생성이 완료될 때 알림을 보낼 이메일 주소입니다. 기본값: 이메일 없음(빈 문자열) | | maxTestCount | 번호 | 옵션입니다. 생성할 테스트의 최대 수입니다. 가능한 값: 1-9999 기본값: 9999(최대값) | | maxTestCountPerItem | 번호 | 옵션입니다. CI당 생성할 최대 테스트 수입니다. 가능한 값: 1-10 기본값: 10(최대값) | | maxTestCountPerTable | 번호 | 옵션입니다. 테이블당 생성할 최대 테스트 수입니다. 가능한 값: 1-10 기본값: 10(최대값) | | scopeForGeneratingTests | 문자열 | false로 설정된 경우 separateUpdateSetPerScope 필요합니다. 생성된 모든 테스트를 배치할 범위의 Sys_id입니다. 기본값: sys_id 없음(빈 문자열) | | separateUpdateSetPerScope | 부울 | 옵션입니다. 생성된 테스트를 각 도구 모음, 업데이트 세트 및 범위로 분리할지 또는 테스트를 하나의 도구 모음, 업데이트 세트 및 범위에 배치할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 테스트는 각 테이블 또는 카탈로그 항목의 범위에 따라 해당 도구 모음 및 업데이트 세트에 배치됩니다. * false: 생성된 모든 테스트가 동일한 도구 모음, 업데이트 세트 및 범위에 배치됩니다. false scopeForGeneratingTests 인 경우 요청에 필요합니다. {#cr-TestGen-startJob_S_S_S_N_N_N_S__ul_l4b_qfj_y1c} 기본값: true | | 테스트 도구 모음 | 문자열 | 옵션입니다. 테스트 생성을 통해 만들 테스트 도구 모음의 이름을 설정합니다. 데이터 유형: 문자열 기본값: ATF 생성 도구 모음 - \ | | tableEncodedQuery | 문자열 | 옵션입니다. 테스트를 생성할 테이블을 지정하는 인코딩된 쿼리입니다. [Encoded query strings](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) 문서를 참조하십시오. 기본값: 모든 테이블(빈 문자열) | | userEncodedQuery | 문자열 | 옵션입니다. 테스트를 생성할 사용자를 지정하는 인코딩된 쿼리입니다. 기본값: 모든 사용자(빈 문자열) | [표 5. 매개변수] {#cr-TestGen-startJob_S_S_S_N_N_N_S__table_epx_lv4_g1c} {#cr-TestGen-startJob_S_S_S_N_N_N_S__table_fpx_lv4_g1c__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 브라우저 오케스트레이션 큐 \[sn_atf_tg_sn_boq\] 테이블의 BOQ 기록 sys_id입니다. | [표 6. 반환] {#cr-TestGen-startJob_S_S_S_N_N_N_S__table_fpx_lv4_g1c} 다음 예는 인시던트 테이블에 대한 테스트 생성을 시작하는 방법을 보여줍니다. 전역 범위에서 sn_atf_tg 네임스페이스를 사용합니다. var insertedSnboqId = CloudRunnerAPI.TestGenerationAPI.startJob({ tableEncodedQuery: "nameISincident", catalogEncodedQuery: "sysIdISEMPTY", suiteName: "Suite123", maxTestCount: 10 }); gs.info(insertedSnboqId); 출력: