Suchen

/fmi/data/version/databases/datenbankname/layouts/layoutname/_find

version – die angeforderte FileMaker Data API-Version, kann v1, v2 oder vLatest sein

• version 1 (v1) - die Struktur für zurückgegebene Ausschnittdaten basiert auf der Ansichtseinstellung (Formularansicht oder Tabellenansicht) des angegebenen Layouts.

  • Formularansicht – gibt alle Bezugsdatensätze zurück

  • Tabellenansicht – gibt den ersten Bezugsdatensatz zurück

    Hinweis  Durch die Änderung der Ansichtseinstellung wird die Ausschnittdatenstruktur für den zurückgegebenen Wert geändert.

• version 2 (v2) – die Struktur für zurückgegebene Ausschnittdaten basiert auf der Formularansicht.

• letzte Version (vLatest) – das Verhalten basiert auf der letzten Version des API.

datenbankname – der Name der bereitgestellten Datenbank

layoutname – das Layout, das als Kontext für die Suchabfrage verwendet werden soll

Content-Type: application/json

Authorization: session-token des Inhabers, wobei session-token den eindeutigen Wert des X-FM-Data-Access-Token für die Datenbanksitzung darstellt

Eine Abfrage in JSON-Format, die Felder und Suchkriterien angibt. Sie können optionale Parameter verwenden, um Ausschlussabfragen (omit), die Sortierfolge (sort), den Startdatensatz (offset), die Anzahl der Datensätze (limit) und Ausschnitte (portal) anzugeben, um die Anzahl der zurückgegebenen zugehörigen Datensätze zu begrenzen. Die Parameter offset, limit und sort wirken auf Datensätze, die sich in der Tabelle des Layouts befinden, und nicht auf Bezugsausschnitts-Datensätze. Um die Anzahl der Datensätze und der anzuzeigenden Zeilen in einer Bezugsmenge zu begrenzen, geben Sie die Parameter offset.ausschnittname und limit.ausschnittname an.

Beispiel:

{
  "query":[
    {"Group": "=Chirurg"},
    {"Ort" : "NY", "omit" : "true"}
],
  "sort":[
    {"fieldName": "Ort","sortOrder": "ascend"},
    {"fieldName": "Vorname", "sortOrder": "ascend"}
 ]
}

Beispiel mit Versatz, Limit und Ausschnitten:

{
  "query":[
    {"Group": "=Chirurg"},
    {"Ort" : "NY", "omit" : "true"}
],
  "portal": ["Ausschnitt1","Ausschnitt2"],
  "limit": "10",
  "offset": "1",
  "offset.Ausschnitt1": "1",
  "limit.Ausschnitt1": "5",
  "layout.response": "Ärzte"
}

Weitere optionale Abfragetext-Parameter:

• layout.response – Gibt die Antwortdaten im Kontext eines anderen Layouts zurück. Das angegebene Layout sollte für dieselbe Basistabelle gelten wie das aktuelle Layout. Die Angabe eines Layouts für eine andere Basistabelle kann zu unerwarteten Ergebnissen führen.

• dateformats – Gibt das Format von Datums- und Zeitstempelfeldern an. Der Wert ist 0 für US-Formate, 1 für die Formate des Dateisystems oder 2 für ISO 8601-Formate. Wenn nicht angegeben, ist der Standardwert 0.

• script.prerequest, script.presort, script – Führt FileMaker-Scripts als Teil der Anforderung aus. Siehe Ausführen eines Scripts mit einer anderen Anforderung.