Abrufen eines einzelnen Datensatzes

Format 1: /fmi/data/version/databases/datenbankname/layouts/layoutname/records/datensatzid

Format 2: /fmi/data/version/databases/datenbankname/layouts/layoutname/records/datensatzid?portal=["ausschnittname-n", ...] &_offset.ausschnittname=startdatensatz &_limit.ausschnittname=anzahl-datensätze

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 – der Name des Layouts, das als Kontext für das Abrufen des Datensatzes dienen soll

datensatzid – die DatensatzID des Datensatzes, der abgerufen werden soll

Für Ausschnitte:

• Der portal-Teil der URL ist optional. Wenn portal (Ausschnitt) ausgelassen wird und das Layout Ausschnitte enthält, gibt der Aufruf zugehörige Datensätze aus allen Ausschnitten im Layout zurück. Um also eine bessere Leistung bei Layouts mit Ausschnitten zu erzielen, verwenden Sie portal, um nur die Ausschnitte anzugeben, aus denen Sie zugehörige Datensätze abrufen möchten.

• Es werden nur die zugehörigen Datensätze zurückgegeben, die in einem Ausschnitt angezeigt werden können. Im Dialogfeld „Ausschnitteinstellung“ in FileMaker Pro können diese Optionen beeinflussen, welche Datensätze zurückgegeben werden können:

  • Vertikales Scrollen zulassen – Wenn diese Option ausgewählt ist, werden alle Datensätze zurückgegeben, die in den sichtbaren Bereich gescrollt werden können. Wenn die Auswahl aufgehoben wird, wird nur die Anzahl der Datensätze zwischen Anfangszeile und Anzahl der Zeilen (die ohne Scrollen sichtbar sind) zurückgegeben.

  • Ausschnittdatensätze filtern – Wenn diese Option ausgewählt ist, werden nur die gefilterten Datensätze zurückgegeben.

• ausschnittname-n ist ein Ausschnitt, der Bezugsdatensätze enthält. Ein Ausschnittname kann entweder der im Inspektor in FileMaker Pro angegebene Objektname oder der Name der Bezugstabelle sein. Sie können mehrere Ausschnittnamen angeben.

• Für _offset.ausschnittname-n ist der startdatensatz die Nummer des ersten Ausschnittdatensatzes im Bereich der Bezugsdatensätze. Wenn nicht angegeben, ist der Standardwert 1.

• Für _limit.ausschnittname-n gibt anzahl-datensätze die maximale Anzahl an Bezugsdatensätzen an, die zurückgegeben werden dürfen. Wenn nicht angegeben, ist der Standardwert 50.

Weitere optionale URL-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.

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