---
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


---

# ATF 코드 범위 API

# ATF 코드 범위 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 24분

ATF 코드 범위 API는 Automated Test Framework(ATF) 실행에서 코드 범위를 계산하는 엔드포인트를 제공합니다. 필터링된 라인 번호, 특정 스크립트 ID 또는 일련의 테스트 도구 모음/테스트 실행에 포함된 모든 스크립트별로 범위를 검색할 수 있습니다.

ATF 코드 범위는 ATF 테스트 도구 모음에 포함되는 배포 요청의 코드 백분율을 결정할 수 있는 도구입니다.

기본적으로 ATF 테스트 도구 모음이 배포 요청에 있는 코드의 70% 미만을 다루는 경우 ReleaseOps는 배포 요청을 조정 상태로 전환하고 테스트 실패 작업이 자동으로 생성됩니다. 배포 요청 평가 플레이북에서 ATF 코드 범위 임계치를 조정할 수 있습니다. 자세한 내용은 [Set Automated Test Framework (ATF) code coverage](https://www.servicenow.com/docs/access?context=set-atf-code-coverage-threshold&version=australia&pubname=australia-application-development&ft:locale=en-US) 문서를 참조하십시오.

ATF 및 성능 분석기에 대한 자세한 내용은 다음을 참조하십시오. [Testing and debugging applications](https://www.servicenow.com/docs/access?context=testing-and-debugging-applications&version=australia&pubname=australia-application-development&ft:locale=en-US)

[Deployment analyzer in ReleaseOps](https://www.servicenow.com/docs/access?context=deployment-analyzer&version=australia&pubname=australia-application-development&ft:locale=en-US)

## ATF 코드 범위 - POST /now/atf/code_coverage/all {#ariaid-title2}

제공된 ATF 실행에 포함된 모든 스크립트의 범위를 집계합니다. 테스트 도구 모음 실행과 개별 테스트 실행의 결합을 지원합니다.

### URL 형식

버전이 지정된 URL: /api/now/v1/atf/code_coverage/all

기본 URL: /api/now/atf/code_coverage/all

### 지원되는 요청 매개변수

{#atf_code_covg-POST-all__entry__2}{#atf_code_covg-POST-all__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 1. 경로 매개변수]

{#atf_code_covg-POST-all__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 2. 쿼리 매개변수]

{#atf_code_covg-POST-all__entry__10}

| 이름 | 설명 |
|-|-|
| test_suite_result_ids | `test_result_ids` 제공되지 않는 한 필수입니다. 테스트 도구 모음 결과 sys_ids의 목록입니다. 테이블: 테스트 도구 모음 결과 \[sys_atf_test_suite_result\] 데이터 유형: 문자열 배열 |
| test_result_ids | `test_suite_result_ids` 제공되지 않는 한 필수입니다. 포함할 테스트 결과 sys_ids 목록입니다(도구 모음과 결합 가능). 테이블: 테스트 결과 \[sys_atf_test_result\] 데이터 유형: 문자열 배열 |
| 자세한 정보 | 각 사용자 지정 테스트 스크립트에 대한 응답에 제공할 상세 정보 수준을 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 응답 본문 details 객체에 항목별 자세한 범위를 포함합니다. * false: 응답 본문 details 객체가 비어 있거나 전혀 반환되지 않습니다. {#atf_code_covg-POST-all__ul_qm3_ycy_l3c} 기본값: false 데이터 유형: 부울 |
| sys_scopes | 지정된 애플리케이션 범위(예: `["x_my_app", "global"]`)로 결과를 필터링합니다. 여러 범위는 OR 논리를 사용하므로 일치하는 모든 범위가 포함됩니다. 빈 배열이나 NULL 배열이 제공되면 필터링이 발생하지 않습니다. 데이터 유형: 문자열 배열 |
[표 3. 요청 본문 매개변수(JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#atf_code_covg-POST-all__entry__20}{#atf_code_covg-POST-all__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 4. 요청 헤더]

{#atf_code_covg-POST-all__entry__24}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#atf_code_covg-POST-all__entry__28}{#atf_code_covg-POST-all__entry-200-status-code}{#atf_code_covg-POST-all__entry-400-status-code}{#atf_code_covg-POST-all__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수(JSON)

{#atf_code_covg-POST-all__table_10z_n1c_i8e__entry__2}

| 이름 | 설명 |
|-|-|
| 링크 | 요청 기록에 대한 링크입니다. 데이터 유형: 문자열 |
| details.\<scriptId\> | 스크립트 sys_id별로 각 사용자 지정 테스트 스크립트의 ATF 집계 범위 백분율을 나열합니다. 데이터 유형: 숫자 |
| api_request_sys_id | 요청의 sys_id입니다. 테이블: ATF 코드 범위 API 요청 \[sys_atf_code_coverage_request\] 데이터 유형: 문자열 |
| 결과 | 성공 또는 오류 메시지입니다. 오류 응답 형식: * 400 잘못된 요청`{ "결과": "확인 오류: <specific_error_message>" }` * 500 내부 서버 오류`{ "result": "내부 서버 오류: <error_message>" }` {#atf_code_covg-POST-all__ul_apt_1ss_l3c} 가능한 오류: * 요청 본문 확인 - `요청 본문은 필수이며 비워둘 수 없습니다.` * 테스트 ID 확인 - `test_result_ids 또는 test_suite_result_ids에 하나 이상의 유효한(비어 있지 않은) ID를 제공해야 합니다`. * 유형 불일치 - `요청 매개변수에 잘못된 데이터 유형` {#atf_code_covg-POST-all__ul_qzs_kts_l3c} 데이터 유형: 문자열 |
| 합계 | 속성에 나열 details 된 스크립트의 결합된 ATF 코드 범위를 반영하는 전체 코드 범위 백분율입니다. 제공된 테스트와 연결된 사용자 지정 스크립트가 없거나 코드 범위의 백분율이 제공되지 않은 경우 값은 0입니다. 가능한 값: 0-100 데이터 유형: 숫자 |
| truncation_message | 지속성 중에 요청 데이터가 잘린 경우 정보를 잘린 스크립트에 대한 상세 정보를 제공합니다. 예시 메시지: `truncation_message: "필드 atf_code_coverage_request.metadata_info가 5,000자에서 4,000자로 잘렸습니다(최대: 4,000자). 데이터 손실을 방지하기 위해 열 길이를 늘리는 것이 좋습니다."` 데이터 유형: 문자열 |
| was_truncated | 지속성 중에 요청 데이터가 잘렸는지 여부를 나타내는 플래그입니다. 잘림을 줄이기 위해 지원되는 기본 문자 수를 변경할 수 있습니다. 예: `request_data_truncated: true`. 유효한 값은 다음과 같습니다. * true: 지속성 중에 요청 데이터가 잘렸습니다. * false: 지속성 중에 요청 데이터가 잘리지 않았습니다. {#atf_code_covg-POST-all__ul_ihd_rdy_l3c} 데이터 유형: 부울 기본 문자 수: 4000 |
[ ]

{#atf_code_covg-POST-all__table_10z_n1c_i8e}  

### cURL 요청

다음 예제에서는 선택한 테스트 결과 도구 모음 및 테스트 결과에 대한 모든 코드 범위를 검색하는 방법을 보여 줍니다.

    curl "https://instance.service-now.com/api/now/atf/code_coverage/all" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"test_suite_result_ids\": [\"5f81c7c4ff943210b88affffffffffc5\"],
      \"test_result_ids\": [\"bb8daec1ff103210b88affffffffff1c\"],
      \"verbose\": true,
      \"sys_scopes\": [\"x_my_app\", \"global\"]
    }" \
    --user 'username':'password'

출력:

    {
      "result": "success",
      "total": 73,
      "details": {
        "sys_script_include_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6": 85,
        "sys_script_include_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7": 92,
        "sys_ui_script_c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8": 45,
        "sys_script_d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9": 68,
        "sys_script_include_e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0": 100
      },
      "api_request_sys_id": "f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1",
      "link": "https://instance.service-now.com/sys_atf_code_coverage_request.do?sys_id=f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1"
    }

## ATF 코드 범위 - POST /now/atf/code_coverage/by_script_id {#ariaid-title3}

특정 스크립트 기록의 범위를 계산합니다.
지정된 ATF 실행에 포함되는 모든 스크립트의 코드 범위를 계산하려면 엔드포인트 /now/atf/code_coverage/all을 사용하십시오.

### URL 형식 {#atf_code_covg-POST-byScriptId__section_tr5_5b2_l3c}

버전이 지정된 URL: /api/now/v1/atf/code_coverage/by_script_id

기본 URL: /api/now/atf/code_coverage/by_script_id

### 지원되는 요청 매개변수

{#atf_code_covg-POST-byScriptId__entry__2}{#atf_code_covg-POST-byScriptId__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 7. 경로 매개변수]

{#atf_code_covg-POST-byScriptId__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 8. 쿼리 매개변수]

{#atf_code_covg-POST-byScriptId__entry__10}

| 이름 | 설명 |
|-|-|
| test_suite_result_ids | `test_result_ids` 제공되지 않는 한 필수입니다. 테스트 도구 모음 결과 sys_ids의 목록입니다. 테이블: 테스트 도구 모음 결과 \[sys_atf_test_suite_result\] 데이터 유형: 문자열 배열 |
| test_result_ids | `test_suite_result_ids` 제공되지 않는 한 필수입니다. 포함할 테스트 결과 sys_ids 목록입니다(도구 모음과 결합 가능). 테이블: 테스트 결과 \[sys_atf_test_result\] 데이터 유형: 문자열 배열 |
| script_array | 필수 코드 범위를 평가할 하나 이상의 유효한 스크립트 sys_ids입니다. 유효한(비어 있지 않은) 스크립트 식별자를 하나 이상 포함해야 합니다. null, 비어 있음 또는 공백만 있는 항목은 필터링됩니다. 테이블: 메타데이터 추적 \[sys_traced_metadata\] 데이터 유형: 배열 |
| 자세한 정보 | 각 사용자 지정 테스트 스크립트에 대한 응답에 제공할 상세 정보 수준을 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 응답 본문 details 객체에 항목별 자세한 범위를 포함합니다. * false: 응답 본문 details 객체가 비어 있거나 전혀 반환되지 않습니다. {#atf_code_covg-POST-byScriptId__ul_qm3_ycy_l3c} 기본값: false 데이터 유형: 부울 |
| sys_scopes | 지정된 애플리케이션 범위(예: `["x_my_app", "global"]`)로 결과를 필터링합니다. 여러 범위는 OR 논리를 사용하므로 일치하는 모든 범위가 포함됩니다. 빈 배열이나 NULL 배열이 제공되면 필터링이 발생하지 않습니다. 데이터 유형: 문자열 배열 |
[표 9. 요청 본문 매개변수(JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#atf_code_covg-POST-byScriptId__entry__22}{#atf_code_covg-POST-byScriptId__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 10. 요청 헤더]

{#atf_code_covg-POST-byScriptId__entry__26}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#atf_code_covg-POST-byScriptId__entry__30}{#atf_code_covg-POST-byScriptId__entry-200-status-code}{#atf_code_covg-POST-byScriptId__entry-400-status-code}{#atf_code_covg-POST-byScriptId__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 12. 상태 코드]

### 응답 본문 매개변수(JSON) {#atf_code_covg-POST-byScriptId__section_j35_dqx_l3c}

{#atf_code_covg-POST-byScriptId__table_10z_n1c_i8e__entry__2}

| 이름 | 설명 |
|-|-|
| 링크 | 요청 기록에 대한 링크입니다. 데이터 유형: 문자열 |
| details.\<scriptId\> | 스크립트 sys_id별로 각 사용자 지정 테스트 스크립트의 ATF 집계 범위 백분율을 나열합니다. 데이터 유형: 숫자 |
| api_request_sys_id | 요청의 sys_id입니다. 테이블: ATF 코드 범위 API 요청 \[sys_atf_code_coverage_request\] 데이터 유형: 문자열 |
| 결과 | 성공 또는 오류 메시지입니다. 오류 응답 형식: * 400 잘못된 요청`{ "결과": "확인 오류: <specific_error_message>" }` * 500 내부 서버 오류`{ "result": "내부 서버 오류: <error_message>" }` {#atf_code_covg-POST-byScriptId__ul_apt_1ss_l3c} 가능한 오류: * 요청 본문 확인 - `요청 본문은 필수이며 비워둘 수 없습니다.` * 제공된 요청 항목이 script_array null이거나 비어 있거나 공백인 경우 스크립트 배열 확인 결과 - `"script_array는 필수이며 비워둘 수 없음 - script_array는 하나 이상의 유효한 스크립트 식별자를 포함해야 합니다."` * 테스트 ID 확인 - `test_result_ids 또는 test_suite_result_ids에 하나 이상의 유효한(비어 있지 않은) ID를 제공해야 합니다`. * 유형 불일치 - `요청 매개변수에 잘못된 데이터 유형` {#atf_code_covg-POST-byScriptId__ul_qzs_kts_l3c} 데이터 유형: 문자열 |
| 합계 | 속성에 나열 details 된 스크립트의 결합된 ATF 코드 범위를 반영하는 전체 코드 범위 백분율입니다. 제공된 테스트와 연결된 사용자 지정 스크립트가 없거나 코드 범위의 백분율이 제공되지 않은 경우 값은 0입니다. 가능한 값: 0-100 데이터 유형: 숫자 |
| truncation_message | 지속성 중에 요청 데이터가 잘린 경우 정보를 잘린 스크립트에 대한 상세 정보를 제공합니다. 예시 메시지: `truncation_message: "필드 atf_code_coverage_request.metadata_info가 5,000자에서 4,000자로 잘렸습니다(최대: 4,000자). 데이터 손실을 방지하기 위해 열 길이를 늘리는 것이 좋습니다."` 데이터 유형: 문자열 |
| was_truncated | 지속성 중에 요청 데이터가 잘렸는지 여부를 나타내는 플래그입니다. 잘림을 줄이기 위해 지원되는 기본 문자 수를 변경할 수 있습니다. 예: `request_data_truncated: true`. 유효한 값은 다음과 같습니다. * true: 지속성 중에 요청 데이터가 잘렸습니다. * false: 지속성 중에 요청 데이터가 잘리지 않았습니다. {#atf_code_covg-POST-byScriptId__ul_ihd_rdy_l3c} 데이터 유형: 부울 기본 문자 수: 4000 |
[ ]

{#atf_code_covg-POST-byScriptId__table_10z_n1c_i8e}

### 추가 정보 {#atf_code_covg-POST-byScriptId__id_lvt_1qx_l3c}

요청 데이터가 데이터베이스 필드 제한을 초과하는 경우 큰 요청 페이로드는 지속될 때 잘릴 수 있습니다.  
ATF 코드 범위 API 요청 \[sys_atf_code_coverage_request\] 테이블의 다음 필드는 잘릴 수 있습니다.

* test_suite_results - 테스트 도구 모음 결과 ID의 JSON 배열입니다.
* test_results - 테스트 결과 ID의 JSON 배열입니다.
* metadata_info - 필터링된 줄 또는 스크립트 배열을 포함하는 JSON 객체입니다.
{#atf_code_covg-POST-byScriptId__ul_pcf_xsh_m3c}

속성이 was_truncated 예이면 응답 본문의 속성에 truncation_message 상세 정보가 제공됩니다. 또한 시스템은 다음 메시지를 기록합니다.

`필드 <table_name>.<field_name>이 <original_length>자에서 <truncated_length>자(최대: <max_field_length>자)로 잘렸습니다. 데이터 손실을 방지하기 위해 열 길이를 늘리는 것이 좋습니다."`  
glide.db.truncate_utf8 시스템 속성 잘라내기 동작:

* 예일 경우 glide.db.truncate_utf8 UTF-8바이트 경계에서 정보가 잘립니다. 이 설정은 멀티바이트 문자에 더 안전합니다.
* false(기본값)인 경우 glide.db.truncate_utf8 문자 경계에서 정보가 잘립니다. 기본 경계는 4000자입니다.
{#atf_code_covg-POST-byScriptId__ul_j11_tth_m3c}  

### cURL 요청

다음 예제에서는 특정 테스트 스크립트로 필터링된 선택한 테스트 결과 도구 모음의 코드 범위를 검색하는 방법을 보여줍니다. verbose 가 `false`이거나 생략되면 객체가 details 비어 있습니다. 전체 total 백분율만 반환됩니다.

    curl "https://instance.service-now.com/api/now/atf/code_coverage/by_script_id" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"test_suite_result_ids\": [\"5f81c7c4ff943210b88affffffffffc5\"],
      \"script_array\": [
        \"sys_script_include_db95cb370a0a0b2b00244880b5cacda7\",
        \"sys_script_include_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6\"
      ]
    }" \
    --user 'username':'password'

출력:

    {
      "result": "success",
      "total": 78,
      "details": {},
      "api_request_sys_id": "a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2",
      "link": "https://instance.service-now.com/sys_atf_code_coverage_request.do?sys_id=a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2"
    }

## ATF 코드 범위 - POST /now/atf/code_coverage/by_line_number {#ariaid-title4}

메타데이터 기록당 필터링된 라인 번호 집합을 사용하여 코드 범위를 계산합니다.

### URL 형식

버전이 지정된 URL: /api/now/v1/atf/code_coverage/by_line_number

기본 URL: /api/now/atf/code_coverage/by_line_number

### 지원되는 요청 매개변수

{#atf_code_covg-POST-byLineNumber__entry__2}{#atf_code_covg-POST-byLineNumber__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 13. 경로 매개변수]

{#atf_code_covg-POST-byLineNumber__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 14. 쿼리 매개변수]

{#atf_code_covg-POST-byLineNumber__table_fyr_lf4_k3c__entry__2}{#atf_code_covg-POST-byLineNumber__atfCC-reqParms-filtered_lines}{#atf_code_covg-POST-byLineNumber__atfCC-reqParms-filtered_linesID}{#atf_code_covg-POST-byLineNumber__atfCC-reqParms-filtered_linesScrpt}

| 이름 | 설명 |
|-|-|
| test_suite_result_ids | `test_result_ids` 제공되지 않는 한 필수입니다. 테스트 도구 모음 결과 sys_ids의 목록입니다. 테이블: 테스트 도구 모음 결과 \[sys_atf_test_suite_result\] 데이터 유형: 문자열 배열 |
| test_result_ids | `test_suite_result_ids` 제공되지 않는 한 필수입니다. 포함할 테스트 결과 sys_ids 목록입니다(도구 모음과 결합 가능). 테이블: 테스트 결과 \[sys_atf_test_result\] 데이터 유형: 문자열 배열 |
| filtered_lines | 필수 코드 범위에 지정할 메타데이터 sys_ids 및 해당 코드 라인의 맵입니다(예: `{ "<metadata_sys_id>": { "script": [...] } }`). 데이터 유형: 객체 |
| filtered_lines.\<sys_id\> | 필수이며 비워둘 수 없습니다. 코드 범위를 평가할 하나 이상의 스크립트 sys_ids입니다. 유효한(비어 있지 않은) 스크립트 식별자를 하나 이상 포함해야 합니다. null, 비어 있음 또는 공백만 있는 항목은 필터링됩니다. 테이블: 메타데이터 추적 \[sys_traced_metadata\] 데이터 유형: 객체 |
| filtered_lines.\<sys_id\>.script | 필수 라인 번호 및 라인 번호 범위의 문자열 목록입니다. 제공된 모든 값은 1보다 크거나 같은 양의 정수여야 합니다. 유효한 라인 번호 형식: * 개별 라인: \[1, 7, 10\] * 범위: 예를 들어 \["1-7"\]은 \[1, 2, 3, 4, 5, 6, 7\]으로 확장됩니다. * 형식은 시작-끝이며 시작 값은 끝보다 작거나 같습니다. * 최대 범위는 10000줄입니다. {#atf_code_covg-POST-byLineNumber__ul_sg3_q2s_l3c} * 혼합 형식입니다. 예를 들어 \[1, "3-6", 7\]은 \[1, 3, 4, 5, 6, 7\]로 확장됩니다. {#atf_code_covg-POST-byLineNumber__ul_n1v_5f4_k3c} 예제: { "filtered_lines": { "sys_script_include_db95cb370a0a0b2b00244880b5cacda7": { "script": [1, "3-6", 7, "10-12"] } } } 데이터 유형: 배열 |
| 자세한 정보 | 각 사용자 지정 테스트 스크립트에 대한 응답에 제공할 상세 정보 수준을 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 응답 본문 details 객체에 항목별 자세한 범위를 포함합니다. * false: 응답 본문 details 객체가 비어 있거나 전혀 반환되지 않습니다. {#atf_code_covg-POST-byLineNumber__ul_qm3_ycy_l3c} 기본값: false 데이터 유형: 부울 |
| sys_scopes | 지정된 애플리케이션 범위(예: `["x_my_app", "global"]`)로 결과를 필터링합니다. 여러 범위는 OR 논리를 사용하므로 일치하는 모든 범위가 포함됩니다. 빈 배열이나 NULL 배열이 제공되면 필터링이 발생하지 않습니다. 데이터 유형: 문자열 배열 |
[표 15. 요청 본문 매개변수(JSON)]

{#atf_code_covg-POST-byLineNumber__table_fyr_lf4_k3c}

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#atf_code_covg-POST-byLineNumber__entry__26}{#atf_code_covg-POST-byLineNumber__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 16. 요청 헤더]

{#atf_code_covg-POST-byLineNumber__entry__30}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 17. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#atf_code_covg-POST-byLineNumber__entry__34}{#atf_code_covg-POST-byLineNumber__entry-200-status-code}{#atf_code_covg-POST-byLineNumber__entry-400-status-code}{#atf_code_covg-POST-byLineNumber__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 18. 상태 코드]

### 응답 본문 매개변수(JSON) {#atf_code_covg-POST-byLineNumber__section_wkx_2qx_l3c}

{#atf_code_covg-POST-byLineNumber__table_10z_n1c_i8e__entry__2}

| 이름 | 설명 |
|-|-|
| 링크 | 요청 기록에 대한 링크입니다. 데이터 유형: 문자열 |
| details.\<scriptId\> | 스크립트 sys_id별로 각 사용자 지정 테스트 스크립트의 ATF 집계 범위 백분율을 나열합니다. 데이터 유형: 숫자 |
| api_request_sys_id | 요청의 sys_id입니다. 테이블: ATF 코드 범위 API 요청 \[sys_atf_code_coverage_request\] 데이터 유형: 문자열 |
| 결과 | 성공 또는 오류 메시지입니다. 오류 응답 형식: * 400 잘못된 요청`{ "결과": "확인 오류: <specific_error_message>" }` * 500 내부 서버 오류`{ "result": "내부 서버 오류: <error_message>" }` {#atf_code_covg-POST-byLineNumber__ul_apt_1ss_l3c} 가능한 오류: * 필터링된 라인 확인 - `"filtered_lines이 필요하며 비워둘 수 없습니다." - "filtered_lines에는 유효한 라인 번호가 있는 메타데이터 항목이 하나 이상 포함되어야 합니다."` * 필터링된 라인 구조 오류: * `"filtered_lines에서 잘못된 라인 번호 형식: <details>"` * `"filtered_lines의 데이터 유형이 잘못되었습니다. 라인 번호가 정수 또는 유효한 범위 문자열(예: '1-7')인지 확인하십시오."` * `"filtered_lines 구조에서 Null 값이 발견되었습니다. 모든 메타데이터 ID, 필드 이름 및 줄 번호 목록은 null이 아니어야 합니다."` * `"처리 filtered_lines 예기치 않은 오류 발생: <exception_type>: <message>"` {#atf_code_covg-POST-byLineNumber__ul_zkv_yqh_m3c} * 라인 번호 형식 오류: * 일반 구문 분석 실패 - `"잘못된 라인 번호 형식: <item>"` - * 라인 번호 \< 1 - `"라인 번호는 양수여야 함: <line_number>"` * 라인 범위 선택 오류(예: "a-b" - `"잘못된 범위 형식: <range>. 시작과 끝은 모두 유효한 정수여야 합니다."` * 라인 범위 선택 오류(예: "10-5" - `"잘못된 범위: <range>. 시작 값(<start>)은 종료 값(<end>)보다 작거나 같아야 합니다.` * "-5-10" - `"잘못된 범위: <range>와 같은 회선 범위 선택 오류입니다. 라인 번호는 양수여야 합니다(시작: <시작>)"` * 라인 범위 선택 오류(예: "1-50000" - `"범위가 너무 큼: <range>. 최대 범위 크기는 10000줄입니다(요청됨: <size>)"` {#atf_code_covg-POST-byLineNumber__ul_klw_1sh_m3c} * 요청 본문 확인 - `요청 본문은 필수이며 비워둘 수 없습니다.` * 테스트 ID 확인 - `test_result_ids 또는 test_suite_result_ids에 하나 이상의 유효한(비어 있지 않은) ID를 제공해야 합니다`. * 유형 불일치 - `요청 매개변수에 잘못된 데이터 유형` {#atf_code_covg-POST-byLineNumber__ul_qzs_kts_l3c} 데이터 유형: 문자열 |
| 합계 | 속성에 나열 details 된 스크립트의 결합된 ATF 코드 범위를 반영하는 전체 코드 범위 백분율입니다. 제공된 테스트와 연결된 사용자 지정 스크립트가 없거나 코드 범위의 백분율이 제공되지 않은 경우 값은 0입니다. 가능한 값: 0-100 데이터 유형: 숫자 |
| truncation_message | 지속성 중에 요청 데이터가 잘린 경우 정보를 잘린 스크립트에 대한 상세 정보를 제공합니다. 예시 메시지: `truncation_message: "필드 atf_code_coverage_request.metadata_info가 5,000자에서 4,000자로 잘렸습니다(최대: 4,000자). 데이터 손실을 방지하기 위해 열 길이를 늘리는 것이 좋습니다."` 데이터 유형: 문자열 |
| was_truncated | 지속성 중에 요청 데이터가 잘렸는지 여부를 나타내는 플래그입니다. 잘림을 줄이기 위해 지원되는 기본 문자 수를 변경할 수 있습니다. 예: `request_data_truncated: true`. 유효한 값은 다음과 같습니다. * true: 지속성 중에 요청 데이터가 잘렸습니다. * false: 지속성 중에 요청 데이터가 잘리지 않았습니다. {#atf_code_covg-POST-byLineNumber__ul_ihd_rdy_l3c} 데이터 유형: 부울 기본 문자 수: 4000 |
[ ]

{#atf_code_covg-POST-byLineNumber__table_10z_n1c_i8e}

### 추가 정보 {#atf_code_covg-POST-byLineNumber__id_lvt_1qx_l3c}

요청 데이터가 데이터베이스 필드 제한을 초과하는 경우 큰 요청 페이로드는 지속될 때 잘릴 수 있습니다.  
ATF 코드 범위 API 요청 \[sys_atf_code_coverage_request\] 테이블의 다음 필드는 잘릴 수 있습니다.

* test_suite_results - 테스트 도구 모음 결과 ID의 JSON 배열입니다.
* test_results - 테스트 결과 ID의 JSON 배열입니다.
* metadata_info - 필터링된 줄 또는 스크립트 배열을 포함하는 JSON 객체입니다.
{#atf_code_covg-POST-byLineNumber__ul_pcf_xsh_m3c}

속성이 was_truncated 예이면 응답 본문의 속성에 truncation_message 상세 정보가 제공됩니다. 또한 시스템은 다음 메시지를 기록합니다.

`필드 <table_name>.<field_name>이 <original_length>자에서 <truncated_length>자(최대: <max_field_length>자)로 잘렸습니다. 데이터 손실을 방지하기 위해 열 길이를 늘리는 것이 좋습니다."`  
glide.db.truncate_utf8 시스템 속성 잘라내기 동작:

* 예일 경우 glide.db.truncate_utf8 UTF-8바이트 경계에서 정보가 잘립니다. 이 설정은 멀티바이트 문자에 더 안전합니다.
* false(기본값)인 경우 glide.db.truncate_utf8 문자 경계에서 정보가 잘립니다. 기본 경계는 4000자입니다.
{#atf_code_covg-POST-byLineNumber__ul_j11_tth_m3c}  

### cURL 요청

다음 예제에서는 선택한 테스트 결과 도구 모음 및 테스트 결과에 대한 모든 코드 범위를 검색하는 방법을 보여 줍니다.

    curl "https://instance.service-now.com/api/now/atf/code_coverage/by_line_number" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"test_suite_result_ids\": [\"5f81c7c4ff943210b88affffffffffc5\"],
      \"test_result_ids\": [\"bb8daec1ff103210b88affffffffff1c\"],
      \"filtered_lines\": {
        \"sys_script_include_db95cb370a0a0b2b00244880b5cacda7\": {
          \"script\": [1, \"3-6\", 7, \"10-12\"]
        }
      },
      \"verbose\": true,
      \"sys_scopes\": [\"x_my_app\", \"global\"]
    }" \
    --user 'username':'password'

출력:

    {
      "result": "success",z
      "total": 64,
      "details": {
        "sys_script_include_db95cb370a0a0b2b00244880b5cacda7": 80,
        "sys_ui_script_c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8": 50
      },
      "api_request_sys_id": "b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3",
      "link": "https://instance.service-now.com/sys_atf_code_coverage_request.do?sys_id=b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3",
      "was_truncated": false
    }