Abrufen eines einzelnen Datensatzes

Um einen Datensatz abzurufen, verwenden Sie eine HTTP GET-Methode mit API-Endpunkt records, der Datenbankname, Layout und DatensatzID angibt. Sie können zudem Ausschnittinformationen angeben, um die Anzahl der zurückgegebenen Bezugsdatensätze zu begrenzen.

HTTP-Methode

GET

URL

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.

HTTP-Header

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

Die Datensatzdaten in JSON-Format und ein Meldungsarray, das den Fehlercode 0 zeigt.

Beispiel:

Kopieren 
{
  "response": {
    "data": [
      {
        "fieldData": {
          ...
        },
        "portalData" : {
          "portalObject": [
            {
              ...
            }
          ]
        },
        "recordId" : "147",
        "modId" : "0"
      }
    ]
  },
  "messages": [
    {
      "code": "0",
      "message": "OK"
    }
  ]
}

Siehe Fehlerantworten.

Beispiel

Beispielabfrage:

Kopieren 
curl --request GET \
  --url https://ServerDomain/fmi/data/vLatest/databases/DatabaseName/layouts/LayoutName/records/324 \
  --header 'Authorization: Bearer c4d2e429122e9cdeda19bb23c55cd2a8f282c3cc50c60943a110'

Beispielantwort:

Kopieren 
{
  "response": {
    "data": [
      {
        "recordId": "324",
        "modId": "0",
        "fieldData": {
          "String Field": "value_1"
        },
        "portalData": {
          "portalObject": [
            {
              "PortalTable::String Field": "value_1"
            }
          ]
        }
      }
    ]
  },
  "messages": [
    {
      "code": "0",
      "message": "OK"
    }
  ]
}