フィルター構造 - iOS

フィルター構造は、REST エンドポイントクエリーの戻り値で返すデータを定義するフィルターを構成する機能を提供します。

フィルター - init(criteria criteriaList: [Criteria], sortBy: [Sort]? = nil, queryCategory: String? = nil)

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

表 : 1. パラメーター

名前	タイプ	Description (説明)
条件	アレイ	OR コネクタでグループ化するトップレベルの基準条件。
sortBy	文字列	オプション。戻り結果のソート順。 可能な値： asc:昇順 desc: 逆送信 デフォルト:asc
クエリカテゴリ	文字列	オプション。クエリカテゴリの名前。 デフォルト：なし

表 : 2. 返される内容

タイプ	説明
なし

次の例では、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)

指定されたすべての条件 (AND の組み合わせ) に基づいてフィルターを作成します

表 : 3. パラメーター

名前	タイプ	Description (説明)
条件	クエリオファリング	AND コネクタでグループ化する条件。 可能な値： ブール dateTime メール 整数選択 numeric reference 文字列 文字列選択
種類	文字列	オプション。戻り結果のソート順。 可能な値： asc:昇順 desc: 逆送信 デフォルト:asc

表 : 4. 返される内容

タイプ	説明
なし

次のコード例は、この関数を呼び出す方法を示しています。

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

指定されたエンコードクエリを使用してフィルターを作成します。

表 : 5. パラメーター

名前	タイプ	説明
クエリ	文字列	エンコードされたクエリ テーブルから返されるレコードをフィルタリングするために使用するエンコードされたクエリ。
クエリカテゴリ	文字列	オプション。クエリに使用するクエリカテゴリの名前。

表 : 6. 返される内容

タイプ	説明
なし

次のコード例は、この関数を呼び出す方法を示しています。

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

フィルター - init(keywords: String? = nil, conditions: [Condition], sortBy: [Sort]? = nil)

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

表 : 7. パラメーター

名前	タイプ	Description (説明)
キーワード	文字列	オプション。検索する特定の単語またはフレーズ。 デフォルト:nil:特定の単語を検索しません。
条件	文字列	AND コネクタでグループ化する条件。 可能な値： ブール dateTime メール 整数選択 numeric reference 文字列 文字列選択
sortBy	文字列	オプション。戻り結果のソート順。 可能な値： asc:昇順 desc: 逆送信 デフォルト:asc

表 : 8. 返される内容

タイプ	説明
なし

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