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


---

# 필터 클래스 - Android

# 필터 클래스 - Android {#ariaid-title1}

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

필터 클래스는 REST 엔드포인트 쿼리의 반환 결과에 반환할 데이터를 정의하는 필터를 구성하는 기능을 제공합니다.  
{#FilterAndroidAPI__table_vx2_klw_5pb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| queryItems | 맵\<문자열, 문자열\> | 필터를 나타내는 쿼리 항목의 컬렉션입니다. |
[표 1. 속성]

{#FilterAndroidAPI__table_vx2_klw_5pb}

## 필터 - 필터(조건: 목록\<조건\>, 키워드: 문자열? = null, sortBy: 목록\<정렬\>? = null) {#ariaid-title2}

특정 키워드와 조건을 기반으로 필터를 작성하며, 함께 OR 또는 AND로 지정할 수 있습니다.
{#Filter-Filter_cond_A_S_A__table_yzp_jz2_4qb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 조건 | 목록\<조건\> | 쿼리에 추가할 단순 또는 복합 조건입니다. 가능한 조건: * BooleanSimpleCondition: 부울 기록 필드에 사용할 수 있는 조건입니다. * DateSimpleTimeCondition: 날짜-시간 기록 필드에 사용할 수 있는 조건입니다. * EmailSimpleCondition: 이메일 필드에 사용할 수 있는 조건입니다. * IntegerChoiceSimpleCondition: 정수 선택 필드에 사용할 수 있는 조건입니다. * NumericSimpleCondition: 다양한 숫자 필드에 사용할 수 있는 조건입니다. * ReferenceSimpleCondition: 참조 기록 필드에 사용할 수 있는 조건 연산자입니다. * StringChoiceSimpleCondition: 문자열을 포함하는 선택 기록 필드에 사용할 수 있는 조건 연산자입니다. * StringSimpleCondition: 문자열 기록 필드에 사용할 수 있는 조건 연산자입니다. * CompoundCondition: ConditionUtils.CompoundOperator 커넥터를 사용하여 SimpleConditions를 복합 조건으로 그룹화할 수 있습니다. {#Filter-Filter_cond_A_S_A__ul_hx1_yf5_tqb} |
| 키워드 | 문자열 | 옵션입니다. 검색할 특정 단어 또는 구입니다. 기본값: nil - 특정 단어 검색 없음. |
| sortBy | 목록\<정렬\> | 옵션입니다. 반환된 기록을 정렬할 기록 필드 이름 및 관련 정렬 순서 상수의 목록입니다. 예: `val sortBy = listOf("zipcode", ORDER_DESC)` 여러 정렬 필드를 포함하는 경우 각 후속 필드는 이전 필드의 추가 정렬입니다. 유효한 정렬 값: * ORDER_ASC: 오름차순 정렬 * ORDER_DESC: 내림차순 정렬 {#Filter-Filter_cond_A_S_A__ul_nws_tcf_4qb} 기본값: ORDER_ASC |
[표 2. 매개변수]

{#Filter-Filter_cond_A_S_A__table_yzp_jz2_4qb} {#Filter-Filter_cond_A_S_A__table_zzp_jz2_4qb__entry__2}

| 유형 | 설명 |
|-|-|
| 안 함 |   |
[표 3. 반환]

{#Filter-Filter_cond_A_S_A__table_zzp_jz2_4qb}  
<br />

    // Where the record is active 

    val condition1 = BooleanSimpleCondition.conditionIs("active", true) 

    // AND the date value of the SLA due field is on "today" or any date after today. 

    val condition2 = DateSimpleTimeCondition.atOrAfter("sla_due", 0, ConditionUtils.DateTimeValueOperator.daysAgoStart) 

    val filter = Filter(conditions = listOf(condition1, condition2))  

## 필터 - Filter(criteriaList: List\<Criteria\>, sortBy: List\<Sort\>? = null) {#ariaid-title3}

함께 "또는"로 결합된 하나 이상의 필터 기준에 따라 필터를 생성합니다.
{#Filter-Filter_criteria_A_A__table_ebq_fbz_nqb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 기준 목록 | 목록\<기준\> | `OR` 커넥터로 그룹화하기 위한 최상위 기준 조건입니다. |
| sortBy | 목록\<정렬\> | 옵션입니다. 반환된 기록을 정렬할 기록 필드 이름 및 관련 정렬 순서 상수의 목록입니다. 예: `val sortBy = listOf("zipcode", ORDER_DESC)` 여러 정렬 필드를 포함하는 경우 각 후속 필드는 이전 필드의 추가 정렬입니다. 유효한 정렬 값: * ORDER_ASC: 오름차순 정렬 * ORDER_DESC: 내림차순 정렬 {#Filter-Filter_criteria_A_A__ul_nws_tcf_4qb} 기본값: ORDER_ASC |
[표 4. 매개변수]

{#Filter-Filter_criteria_A_A__table_ebq_fbz_nqb} {#Filter-Filter_criteria_A_A__table_fbq_fbz_nqb__entry__2}

| 유형 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 반환]

{#Filter-Filter_criteria_A_A__table_fbq_fbz_nqb}  
<br />

    val activeIncidents = BooleanSimpleCondition.conditionIs("active", true)
    val assignedToEmpty = StringSimpleCondition.isEmpty("assigned_to")
    val assignedToAbel = StringSimpleCondition.conditionIs("assigned_to", "Abel Tuter")
    val assignedToAbelOrEmpty = CompoundCondition(ConditionUtils.CompoundOperator.OR, listOf(assignedToEmpty, assignedToAbel))
    val needToReassign = Criteria().addConditions(listOf(activeIncidents, assignedToAbelOrEmpty))
    val highEscelations = StringSimpleCondition.conditionIs("escalation", "2")
    val overdueEscelations = StringSimpleCondition.conditionIs("escalation", "3")
    val highOrOverdueEscelations = CompoundCondition(ConditionUtils.CompoundOperator.OR, listOf(highEscelations, overdueEscelations))
    val needToHandleEscalation = Criteria().addCondition(highOrOverdueEscelations)
    val myPrioritiesForTodayFilter = Filter(listOf(needToReassign, needToHandleEscalation))