Filterstruktur – iOS

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer
  • Die Filterstruktur bietet die Möglichkeit, Filter zu konfigurieren, die die Daten definieren, die in den Rückgabeergebnissen einer REST-Endpunktabfrage zurückgegeben werden sollen.

    Filter – init(criteria criticalList: [Criteria], sortBy: [Sort]? = nil, queryCategory: String? = nil)

    Erstellt einen Filter basierend auf einem oder mehreren Filterkriterien, die ODER-verknüpft sind.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Kriterien Array Kriterienbedingungen der obersten Ebene, die mit OR -Connectors gruppiert werden sollen.
    sortBy Zeichenfolge Optional. Sortierreihenfolge der zurückgegebenen Ergebnisse.
    Mögliche Werte:
    • asc: Aufsteigend
    • desc: Desenden

    Standard: asc

    queryCategory Zeichenfolge Optional. Name der Abfragekategorie.

    Standard: Keine

    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt die Erstellung von drei separaten Kriterien. Wenn eines dieser Kriterien erfüllt ist, wird der Datensatz in den Rückgabeergebnissen zurückgegeben.

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

    Filter – init(conditions: [Query Provisioning], sorts: [Sort]? = nil)

    Erstellt einen Filter basierend auf allen angegebenen Bedingungen (UND-Verknüpfung)

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Regeln QueryBereitstellung Bedingungen, die mit einem AND -Connector gruppiert werden sollen.
    Mögliche Werte:
    • boolean
    • dateTime
    • E-Mail
    • IntegerChoice
    • numerisch
    • Referenz
    • Zeichenfolge
    • stringChoice
    Sortiert Zeichenfolge Optional. Sortierreihenfolge der zurückgegebenen Ergebnisse.
    Mögliche Werte:
    • asc: Aufsteigend
    • desc: Desenden

    Standard: asc

    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

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

    Filter – init(query: String, queryCategory: String? = nil)

    Erstellt einen Filter anhand einer angegebenen codierten Abfrage.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    query Zeichenfolge Codierte AbfrageCodierte Abfrage, die zum Filtern der aus der Tabelle zurückzugebenden Datensätze verwendet werden soll.
    queryCategory Zeichenfolge Optional. Name der Abfragekategorie, die für die Abfrage verwendet werden soll.
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

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

    Filter – init(keywords: String? = nil, Bedingungen: [Condition], sortBy: [Sort]? = nil)

    Erstellt einen Filter basierend auf bestimmten Stichwörtern und Bedingungen, die UND-verknüpft sind.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Stichwörter Zeichenfolge Optional. Ein bestimmtes Wort oder ein bestimmter Ausdruck, nach dem gesucht werden soll.

    Standard: nil – Keine spezifische Wortsuche.

    Regeln Zeichenfolge Bedingungen, die mit einem AND -Connector gruppiert werden sollen.
    Mögliche Werte:
    • boolean
    • dateTime
    • E-Mail
    • IntegerChoice
    • numerisch
    • Referenz
    • Zeichenfolge
    • stringChoice
    sortBy Zeichenfolge Optional. Sortierreihenfolge der zurückgegebenen Ergebnisse.
    Mögliche Werte:
    • asc: Aufsteigend
    • desc: Desenden

    Standard: asc

    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Keine

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