FetchConfiguration 구조 - iOS

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기2분
  • FetchConfiguration 구조는 인스턴스에서 기록을 ServiceNow 가져오기 위한 구성을 정의하는 기능을 제공합니다.

    표 1. 속성
    이름 유형 설명
    필터 필터 옵션입니다. 반환 결과에 적용할 쿼리입니다. 예를 들어 "broken"이라는 단어가 포함된 짧은 설명이 있는 활성 레코드만 반환하려면 active=true^ 쿼리를 전달합니다short_descriptionLIKEbroken

    기본값: nil - 필터가 적용되지 않고 모든 기록이 반환됩니다(모든 시스템 또는 테이블 제한이 허용됩니다.)

    제한 정수 옵션입니다. 페이지당 반환할 기록 수/응답입니다.

    기본값: nil - 반환된 모든 레코드(모든 시스템 또는 테이블 제한이 사용됨)

    readConfiguration FieldReadConfiguration 옵션입니다. 응답에 반환되는 필드의 구성입니다.

    기본값: nil - 모든 필드가 반환됩니다.

    FetchConfiguration - init(filter: Filter? = nil, limit: Int? = nil, readConfiguration: FieldReadConfiguration? = nil)

    REST 엔드포인트를 통해 인스턴스에서 데이터를 ServiceNow 가져올 때 반환할 기록 및 해당 기록 내의 관련 필드에 대한 기준을 정의합니다.

    표 2. 매개변수
    이름 유형 설명
    필터 필터 옵션입니다. 반환 결과에 적용할 쿼리입니다. 예를 들어 "broken"이라는 단어가 포함된 짧은 설명이 있는 활성 레코드만 반환하려면 active=true^ 쿼리를 전달합니다short_descriptionLIKEbroken

    기본값: nil - 필터가 적용되지 않고 모든 기록이 반환됩니다(모든 시스템 또는 테이블 제한이 허용됩니다.)

    제한 정수 옵션입니다. 페이지당 반환할 기록 수/응답입니다.

    기본값: nil - 반환된 모든 레코드(모든 시스템 또는 테이블 제한이 사용됨)

    readConfiguration FieldReadConfiguration 옵션입니다. 응답에 반환되는 필드의 구성입니다.

    기본값: nil - 모든 필드가 반환됩니다.

    표 3. 반환
    유형 설명
    안 함

    테이블 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)
    }()