Abfrage-Option $filter

Verwenden Sie die Abfrage-Option $filter, um die Datensätze zu filtern. Der mit $filter angegebene Ausdruck wird für jeden Datensatz in der Sammlung ausgewertet und nur Objekte, bei denen der Ausdruck mit „wahr“ ausgewertet wird, werden in die Antwort aufgenommen.

OData unterstützt eine Menge integrierter Operatoren und Funktionen, die innerhalb von $filter-Operationen verwendet werden. Weitere Informationen über verfügbare Operatoren und integrierte Funktionen finden Sie unter OData 4.01 Protocol (Englisch).

Komponente Beschreibung

HTTP-Methode

GET

URL

https://host/fmi/odata/version/datenbankname/tabellenname?$filter=(ausdruck)

host – FileMaker Cloud- oder FileMaker Server-Hostname

version – die OData-Version, immer v4

datenbankname – der Name der bereitgestellten Datenbank

tabellenname – der Name der Tabelle

ausdruck – Kriterien für jeden Datensatz, die festlegen, ob der Datensatz im Ergebnis enthalten ist

Beispiel: /fmi/odata/v4/KontaktMgmt/Kontakte?$filter=Titel eq 'Manager' or startswith(Titel,'Admin')

Die Anforderung oben verwendet die GET-Methode und die System-Abfrage-Option $filter, um Datensätze zurückzugeben, die Kontakte mit dem Titel „Manager“ oder „Admin“ enthalten.

FileMaker-Informationen

  • Eine Liste der nicht unterstützten integrierten kanonischen Funktionen und Operatoren finden Sie unter Nicht unterstützte OData-Funktionen.

  • Datums-, Zeit- und Zeitstempelformate entsprechen ISO 8601. Der Zeitzonenversatz ist relativ zu der Zeitzone des Servers.

  • Umschließen Sie Feldnamen, die Sonderzeichen wie Leerzeichen oder Unterstriche enthalten, in doppelten Anführungszeichen.