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


---

# 필터 구조 - iOS

# 필터 구조 - iOS {#ariaid-title1}

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

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

## 필터 - init(criteria criteriaList: \[Criteria\], sortBy: \[Sort\]? = nil, queryCategory: String? = nil) {#ariaid-title2}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 기준 | 배열 | `OR` 커넥터로 그룹화하기 위한 최상위 기준 조건입니다. |
| sortBy | 문자열 | 옵션입니다. 반환 결과의 정렬 순서입니다. 가능한 값: * 오름차순: 오름차순 * 설명: 발송 취소 기본값: asc |
| queryCategory | 문자열 | 옵션입니다. 쿼리 범주의 이름입니다. 기본값: 없음 |
[표 1. 매개변수]

{#filter-init_A_A_S__table_w5t_myg_kqb} {#filter-init_A_A_S__table_x5t_myg_kqb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 2. 반환]

{#filter-init_A_A_S__table_x5t_myg_kqb}  
다음 예제에서는 세 가지 개별 기준을 생성하고 전달될 때 이러한 기준 중 하나라도 충족되면 반환 결과에 기록이 다시 전달되는 과정을 보여줍니다.

    // All of criteria1 conditions must be met
    let criteria1 = Criteria(conditions: ...)

    // OR all of criteria2 conditions must be met
    let criteria2 = Criteria(conditions: ...)

    // OR all of criteria3 conditions must be met
    let criteria3 = Criteria(conditions: ...)

    let filter = Filter(criterias: [criteria1, criteria2, criteria3])

## 필터 - init(conditions: \[QueryProviding\], sorts: \[Sort\]? = nil) {#ariaid-title3}

지정된 모든 조건을 기준으로 필터를 생성합니다(및, 함께).
{#filter-init_A_S__table_w15_nch_kqb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 조건 | QueryProviding | `AND` 커넥터로 그룹화하는 조건입니다. 가능한 값: * 부울 * 날짜/시간 * 이메일 * 정수 선택 * 숫자 * 참조 * 문자열 * 문자열 선택 {#filter-init_A_S__ul_sqz_5cc_3yb} |
| 정렬 | 문자열 | 옵션입니다. 반환 결과의 정렬 순서입니다. 가능한 값: * 오름차순: 오름차순 * 설명: 발송 취소 기본값: asc |
[표 3. 매개변수]

{#filter-init_A_S__table_w15_nch_kqb} {#filter-init_A_S__table_x15_nch_kqb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 4. 반환]

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

    // Where the record is active
    let condition1 = Condition.boolean(field: "active", .is(true))

    // AND the date value of the SLA due field is on "today" or any date after today.
    let condition2 = Condition.dateTime(field: "sla_due", .atOrAfter(0, .daysAgoStart))

    let filter = Filter(conditions: [condition1, condition2])

## 필터 - init(query: String, queryCategory: String? = nil) {#ariaid-title4}

지정된 인코딩된 쿼리를 사용하여 필터를 작성합니다.
{#filter-init_S_S__table_jtk_5xg_kqb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 쿼리 | 문자열 | [인코딩된 쿼리](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) 테이블에서 반환할 기록을 필터링하는 데 사용할 [인코딩된 쿼리](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)입니다. |
| queryCategory | 문자열 | 옵션입니다. 쿼리에 사용할 쿼리 범주의 이름입니다. |
[표 5. 매개변수]

{#filter-init_S_S__table_jtk_5xg_kqb} {#filter-init_S_S__table_ktk_5xg_kqb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 6. 반환]

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

    let query = "active=true^short_descriptionLIKEbroken"
    let filter = Filter(query: query)

## 필터 - init(키워드: 문자열? = nil, 조건: \[조건\], sortBy: \[정렬\]? = nil) {#ariaid-title5}

함께 사용되는 특정 키워드와 조건을 기반으로 필터를 생성합니다.
{#filter-init_S_S_S__table_ltk_k1h_kqb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 키워드 | 문자열 | 옵션입니다. 검색할 특정 단어 또는 구입니다. 기본값: nil - 특정 단어 검색 없음. |
| 조건 | 문자열 | `AND` 커넥터로 그룹화하는 조건입니다. 가능한 값: * 부울 * 날짜/시간 * 이메일 * 정수 선택 * 숫자 * 참조 * 문자열 * 문자열 선택 |
| sortBy | 문자열 | 옵션입니다. 반환 결과의 정렬 순서입니다. 가능한 값: * 오름차순: 오름차순 * 설명: 발송 취소 기본값: asc |
[표 7. 매개변수]

{#filter-init_S_S_S__table_ltk_k1h_kqb} {#filter-init_S_S_S__table_mtk_k1h_kqb__entry__2}

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

{#filter-init_S_S_S__table_mtk_k1h_kqb}  
<br />

    // Keyword that must be found in the record
    let searchTerm = "..."

    // AND the specified condition must be met
    let condition1 = Condition.email(field: "state", .changesFrom("4"))

    let filter = Filter(keywords: searchTerm, condition: condition1)