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


---

# FetchConfiguration 구조체 - iOS

# FetchConfiguration 구조체 - iOS {#ariaid-title1}

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

FetchConfiguration 구조는 인스턴스에서 ServiceNow 기록을 가져오기 위한 구성을 정의하는 기능을 제공합니다.  
{#FetchConfigiOSStructure__table_vx2_klw_5pb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 필터 | [필터](https://servicenow-prod.fluidtopics.net/qt6NnTTsMN_CpXyTGIoRfw#FilteriOSStructure "필터 구조는 REST 엔드포인트 쿼리의 반환 결과에 반환할 데이터를 정의하는 필터를 구성하는 기능을 제공합니다.") | 옵션입니다. 반환 결과에 적용할 쿼리입니다. 예를 들어, "손상됨"이라는 단어가 포함된 짧은 설명이 있는 활성 기록만 반환하려면 `active=true^` 쿼리를 전달합니다short_descriptionLIKEbroken 기본값: nil - 필터가 적용되지 않았으며 모든 기록이 반환됩니다(시스템 또는 테이블 제한이 적용됨). |
| 제한 | 정수 | 옵션입니다. 페이지/응답당 반환할 기록 수입니다. 기본값: nil - 반환된 모든 기록(시스템 또는 테이블 제한이 적용됨) |
| readConfiguration | [필드읽기 구성](https://servicenow-prod.fluidtopics.net/fdyDRGcdt9sMLHrovx8hbw#FieldReadConfigurationiOSStruct "FieldReadConfiguration 구조를 사용하면 인스턴스 테이블에서 ServiceNow 가져올 필드와 형식을 구성할 수 있습니다.") | 옵션입니다. 응답에 반환되는 필드의 구성입니다. 기본값: nil - 모든 필드가 반환됩니다. |
[표 1. 속성]

{#FetchConfigiOSStructure__table_vx2_klw_5pb}

## FetchConfiguration - init(filter: 필터? = nil, limit: Int? = nil, readConfiguration: FieldReadConfiguration? = nil) {#ariaid-title2}

REST 엔드포인트를 통해 인스턴스에서 ServiceNow 데이터를 가져올 때 반환할 기록 및 해당 기록 내의 연결된 필드에 대한 기준을 정의합니다.
{#FetConfigiOS-init_S_I_O__table_pgj_tg2_vpb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 필터 | [필터](https://servicenow-prod.fluidtopics.net/qt6NnTTsMN_CpXyTGIoRfw#FilteriOSStructure "필터 구조는 REST 엔드포인트 쿼리의 반환 결과에 반환할 데이터를 정의하는 필터를 구성하는 기능을 제공합니다.") | 옵션입니다. 반환 결과에 적용할 쿼리입니다. 예를 들어, "손상됨"이라는 단어가 포함된 짧은 설명이 있는 활성 기록만 반환하려면 `active=true^` 쿼리를 전달합니다short_descriptionLIKEbroken 기본값: nil - 필터가 적용되지 않았으며 모든 기록이 반환됩니다(시스템 또는 테이블 제한이 적용됨). |
| 제한 | 정수 | 옵션입니다. 페이지/응답당 반환할 기록 수입니다. 기본값: nil - 반환된 모든 기록(시스템 또는 테이블 제한이 적용됨) |
| readConfiguration | [필드읽기 구성](https://servicenow-prod.fluidtopics.net/fdyDRGcdt9sMLHrovx8hbw#FieldReadConfigurationiOSStruct "FieldReadConfiguration 구조를 사용하면 인스턴스 테이블에서 ServiceNow 가져올 필드와 형식을 구성할 수 있습니다.") | 옵션입니다. 응답에 반환되는 필드의 구성입니다. 기본값: nil - 모든 필드가 반환됩니다. |
[표 2. 매개변수]

{#FetConfigiOS-init_S_I_O__table_pgj_tg2_vpb} {#FetConfigiOS-init_S_I_O__table_qgj_tg2_vpb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 3. 반환]

{#FetConfigiOS-init_S_I_O__table_qgj_tg2_vpb}  
테이블 API에서 가져올 데이터를 구성하는 방법을 보여줍니다.

    /// The configuration for what to fetch from the Table API.
    lazy var fetchConfiguration: FetchConfiguration = {
      let includeFields = [
        // Case details
        "number",
        "short_description",
        "priority",
        "state",
        "opened_at",
        
        // Account details
        "account.name",
        "account.number",
        "contact.name",
        "contact.email",
        "contact_type",

        // Assignment
        "assignment_group.name",
        "assigned_to.name"
      ]
      let readConfiguration = FieldReadConfiguration(includeFields: includeFields, options: .actualValues)
      let filter = Filter(criteria: [], sortBy: [.desc("number")], queryCategory: nil)
      return FetchConfiguration(filter: filter, limit: 10, readConfiguration: readConfiguration)
    }()