FieldReadConfiguration 클래스 - Android

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기2분
  • FieldReadConfiguration 클래스는 응답 레코드에서 반환하거나 반환하지 않을 필드를 정의하는 기능을 제공합니다.

    표 1. 속성
    이름 유형 설명
    포함 필드 Collection<String> 응답에 반환할 필드입니다.
    queryItems (쿼리 항목) map<string, string> 읽기 전용입니다. 읽기 구성을 나타내는 쿼리 항목 모음입니다.
    queryParams QueryParams (쿼리 매개변수) 요청 쿼리 매개변수의 이름-값 쌍을 포함하는 반복 가능한 구조입니다. 이러한 매개변수를 사용하여 요청을 빌드합니다.

    FieldReadConfiguration - FieldReadConfiguration(includeFields: Collection<String> = listOf(), vararg 옵션: FieldReadConfiguration.Options)

    연결된 ServiceNow 테이블의 반환 응답에 포함할 필드를 정의합니다.

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

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

    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)