---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

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) 所要時間：4分

フィルター構造では、REST エンドポイントクエリの戻り結果で返すデータを定義するフィルターを構成できます。

## フィルター:init(criteria criteriaList: \[Criteria\], sortBy: \[Sort\]? = nil, queryCategory: String? = nil) {#ariaid-title2}

OR で結合された 1 つ以上のフィルター基準に基づいてフィルターを作成します。
{#filter-init_A_A_S__table_w5t_myg_kqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| クライテリア | アレイ | `OR` コネクタでグループ化するトップレベルの基準条件。 |
| sortBy | 文字列 | オプション。返される結果のソート順。 可能な値： * asc:昇順 * desc:送信 デフォルト: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}  
次の例は、3 つの個別の基準を作成し、渡されたときにそれらの基準のいずれかが満たされると、レコードが返される結果に戻されることを示しています。

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

指定されたすべての条件に基づいてフィルターを作成します (ANDを一緒に使用)
{#filter-init_A_S__table_w15_nch_kqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 条件 | クエリ提供 | `AND` コネクタでグループ化する条件。 可能な値： * ブーリアン * 日時 * メール * 整数の選択肢 * 数値 * 参照 * 文字列 * 文字列選択 {#filter-init_A_S__ul_sqz_5cc_3yb} |
| ソート | 文字列 | オプション。返される結果のソート順。 可能な値： * asc:昇順 * desc:送信 デフォルト: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}

| 名前 | タイプ | 説明 |
|-|-|-|
| query | 文字列 | [エンコードクエリ](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(キーワード: String?= nil, conditions: \[Condition\], sortBy: \[Sort\]?= nil) {#ariaid-title5}

AND で結合された特定のキーワードと条件に基づいてフィルターを作成します。
{#filter-init_S_S_S__table_ltk_k1h_kqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| キーワード | 文字列 | オプション。検索する特定の単語またはフレーズ。 デフォルト:nil - 特定の単語検索はありません。 |
| 条件 | 文字列 | `AND` コネクタでグループ化する条件。 可能な値： * ブーリアン * 日時 * メール * 整数の選択肢 * 数値 * 参照 * 文字列 * 文字列選択 |
| sortBy | 文字列 | オプション。返される結果のソート順。 可能な値： * asc:昇順 * desc:送信 デフォルト: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)