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


---

# FieldReadConfiguration 클래스 - Android

# FieldReadConfiguration 클래스 - Android {#ariaid-title1}

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

FieldReadConfiguration 클래스는 응답 기록에서 반환하거나 반환하지 않을 필드를 정의하는 기능을 제공합니다.  
{#FieldReadConfigAndroidAPI__table_rrr_12w_wpb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| include필드 | [Collection](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-collection/)\<String\> | 응답에서 반환할 필드입니다. |
| queryItems | [맵](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-map/)\<문자열, 문자열\> | 읽기 전용입니다. 읽기 구성을 나타내는 쿼리 항목의 컬렉션입니다. |
| queryParams | QueryParams | 요청 쿼리 매개변수의 이름-값 쌍을 포함하는 반복 가능한 구조입니다. 이러한 매개변수를 사용하여 요청을 빌드합니다. |
[표 1. 속성]

{#FieldReadConfigAndroidAPI__table_rrr_12w_wpb}

## FieldReadConfiguration - FieldReadConfiguration(includeFields: Collection\<String\> = listOf(), vararg 옵션: FieldReadConfiguration.Options) {#ariaid-title2}

연결된 ServiceNow 테이블에서 반환 응답에 포함할 필드를 정의합니다.
{#FldReadConf-FieldReadConfig_S_O__table_mlz_4ps_4pb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| include필드 | 컬렉션\<문자열\> | 응답에서 반환할 쉼표로 구분된 필드 목록입니다. 목록이 비어 있으면 모든 필드가 반환됩니다. |
| vararg 옵션 | FieldReadConfiguration.Options | 옵션입니다. 반환할 필드 정보의 유형을 정의하는 0개 이상의 옵션 배열입니다. 가능한 값: * ACTUAL_VALUES: 응답에 필드의 실제 값을 포함합니다. * DISPLAY_VALUES: 응답에 필드의 표시 값을 포함합니다. * EXCLUDE_REFERENCE_LINK: 참조 필드에 대한 테이블 API 링크를 제외합니다. |
[표 2. 매개변수]

{#FldReadConf-FieldReadConfig_S_O__table_mlz_4ps_4pb}  
다음 코드 예제에서는 이 함수를 호출하는 방법을 보여 줍니다.

    val readConfiguration = FieldReadConfiguration(
      includeFields = listOf("sys_id", "sys_created_on", "short_description"),
      options = arrayOf(FieldReadConfiguration.Options.DISPLAY_VALUES)
    )
    val fetchConfiguration = FetchConfiguration(
      filter = Filter("active=true"),
      readConfiguration = readConfiguration
    )
    val response = nowTableService.records("incident", fetchConfiguration).execute()
    handleResponse(response)