FetchConfiguration 구조 - iOS

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기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. 반환
    유형 설명
    없음

    Table 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)
    }()