--- sourceDocument: Xanadu API 참조 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference Release : - xanadu ft:locale : - ko-KR ft:publication_title : - Xanadu API 참조 ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Cloud Runner TestGenerationApi -- 범위가 지정됨, 전역 # Cloud Runner TestGenerationApi -- 범위가 지정됨, 전역 {#ariaid-title1} * 릴리스 버전: Xanadu * * 업데이트 날짜 2024년 08월 01일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분 ATF(Automated Test Framework)용 클라우드 실행기에서 실행할 테스트 작업 생성을 관리합니다. 이 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=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) 활성화되어 있어야 합니다. 참고 항목: * [Cloud Runner TestRunnerApi -- 범위가 지정됨, 전역](https://servicenow-prod.fluidtopics.net/ONcquMmQrMisBmzaaa6ufg#cloudrnr-TestRunnerAPI-scoped "Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트를 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.") * [클라우드 실행기 TestUserApi -- 범위가 지정됨, 전역](https://servicenow-prod.fluidtopics.net/TZ3q1ZeGFE8MLtLJw1Md6g#cloudrnr-TestUserAPI-scoped "ATF(Automated Test Framework)용 클라우드 실행기에서 실행할 테스트 사용자 작업을 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.") * [클라우드 실행기 테스트 생성 REST API](https://servicenow-prod.fluidtopics.net/ZC5qUok80xZU7qz6A_qhVg#cloudrunner-testgeneration-api "ATF(Automated Test Framework)용 클라우드 실행기에서 실행할 테스트 작업 생성을 관리합니다.") {#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 -- 진행률(문자열, 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 (테스트인프로그레스) | 생성 중인 사용 사례 수입니다. 데이터 유형: 숫자 | | testsPending (테스트 보류 중) | 생성할 남아 있는 사용 사례 수입니다. 데이터 유형: 숫자 | | testsTeams(테스트 건너뜀) | 작업 취소로 인해 건너뛴 테스트 수입니다. 데이터 유형: 숫자 | | testsSucceeded | 성공적으로 생성된 테스트 수입니다. 데이터 유형: 숫자 | [표 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, 문자열 이메일) {#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(최대값) | | maxTestCountPerTable (영문) | 번호 | 옵션입니다. 테이블당 생성할 최대 테스트 수입니다. 가능한 값: 1-10 기본값: 10(최대값) | | maxTestCountPerItem | 번호 | 옵션입니다. CI당 생성할 최대 테스트 수입니다. 가능한 값: 1-10 기본값: 10(최대값) | | separateUpdateSetPerScope (별도 업데이트 설정PerScope) | 부울 | 옵션입니다. 생성된 테스트를 각각의 도구 모음, 업데이트 세트 및 범위로 분리할지, 또는 테스트를 하나의 도구 모음, 업데이트 세트 및 범위에 배치할지를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 테스트가 각 테이블 또는 카탈로그 항목의 범위에 따라 해당 도구 모음 및 업데이트 세트에 배치됩니다. * false: 생성된 모든 테스트가 동일한 도구 모음, 업데이트 세트 및 범위에 배치됩니다. false인 scopeForGeneratingTests 경우 요청에 필요합니다. {#cr-TestGen-startJob_S_S_S_N_N_N_S__ul_l4b_qfj_y1c} 기본값: true | | scopeForGeneratingTests (영문) | 문자열 | 가 아니오로 설정된 경우 separateUpdateSetPerScope 필요합니다. 생성된 모든 테스트를 배치할 범위의 Sys_id입니다. 기본값: sys_id 없음(빈 문자열) | | tableEncodedQuery | 문자열 | 옵션입니다. 테스트를 생성할 테이블을 지정하는 인코딩된 쿼리입니다. [Encoded query strings](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-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", maxTestCount: 10 }); gs.info(insertedSnboqId); 출력: