FieldReadConfiguration 구조 - iOS

FieldReadConfiguration 구조를 사용하면 인스턴스 테이블에서 ServiceNow 가져올 필드와 형식을 구성할 수 있습니다.

표 1. 속성

이름	유형	설명
포함 필드	배열	반환 결과에 다시 전달할 필드의 목록입니다.
옵션	배열	반환할 필드 유형의 목록입니다. 가능한 값: actualValues: 참조된 기록의 sys_ids 포함하여 각 필드에 실제로 저장된 값을 반환합니다. 날짜를 사용하여 코드 가능 모델에서 날짜를 디코딩해야 하는 경우 이 설정을 사용합니다. description: 매개변수에 대한 설명을 리턴합니다. displayValues: 선택한 필드에 대한 표시 값표시 값(사용 가능한 경우)을 반환합니다. 예를 들어, 일반적으로 사용자 이름에는 사용자 기록에 대한 참조 링크(sys_id)가 포함됩니다. 표시 값을 요청하면 연결된 필드에 저장된 sys_id 대신 사용자의 이름이 반환됩니다. 주: 인스턴스가 반환하는 ServiceNow 표시 값은 인증된 사용자의 사용자 프로파일 구성에 따라 형식이 지정되고 국제화됩니다. 이는 장치의 장치 언어 및 로캘 설정과 다를 수 있습니다. excludeReferenceLink: 테이블 내에서 참조 링크로 정의된 데이터를 반환하지 않습니다. rawValue: 매개 변수의 원시 값을 반환합니다.

FieldReadConfiguration init(includeFields: [FieldName] = [], 옵션: 옵션 = [])

테이블의 기록 ServiceNow 내에 있는 필드가 REST 엔드포인트 호출의 반환 결과에 다시 전달되도록 구성합니다.

표 2. 매개변수

이름	유형	설명
포함 필드	배열	반환 결과에 다시 전달할 필드의 목록입니다.
옵션	배열	반환할 필드 유형의 목록입니다. 가능한 값: actualValues: 참조된 기록의 sys_ids 포함하여 각 필드에 실제로 저장된 값을 반환합니다. 날짜를 사용하여 코드 가능 모델에서 날짜를 디코딩해야 하는 경우 이 설정을 사용합니다. description: 매개변수에 대한 설명을 리턴합니다. displayValues: 선택한 필드에 대한 표시 값표시 값(사용 가능한 경우)을 반환합니다. 예를 들어, 일반적으로 사용자 이름에는 사용자 기록에 대한 참조 링크(sys_id)가 포함됩니다. 표시 값을 요청하면 연결된 필드에 저장된 sys_id 대신 사용자의 이름이 반환됩니다. 주: 인스턴스가 반환하는 ServiceNow 표시 값은 인증된 사용자의 사용자 프로파일 구성에 따라 형식이 지정되고 국제화됩니다. 이는 장치의 장치 언어 및 로캘 설정과 다를 수 있습니다. excludeReferenceLink: 테이블 내에서 참조 링크로 정의된 데이터를 반환하지 않습니다. rawValue: 매개 변수의 원시 값을 반환합니다.

표 3. 반환

유형	설명
없음

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

/// 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("opened_at")], queryCategory: nil)
  return FetchConfiguration(filter: filter, limit: 10, readConfiguration: readConfiguration)
}()