Erstellen eines Datensatzes

Um einen Datensatz zu erstellen, verwenden Sie eine HTTP POST-Methode mit dem API-Endpunkt records, der Datenbankname und Layout angibt.

HTTP-Methode

POST

URL

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

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

datenbankname – der Name der bereitgestellten Datenbank

layoutname – der Name des Layouts, das als Kontext für die Erstellung des Datensatzes dienen soll

HTTP-Header

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

Parameter

Datensatzdaten in JSON-Format mit Feld-Wert-Paaren, die Werte für Felder angeben, die sich im Ziellayout befinden. Die Daten können mithilfe von portalData Bezugsdatensätze oder Ausschnitte angeben, die sich in dem Layout befinden. Ein Ausschnittname kann entweder der im Inspektor in FileMaker Pro angegebene Objektname oder der Name der Bezugstabelle sein.

Beispiel:

Kopieren
{
  "fieldData": { 
    "Zeichenfeld": "wert_1"
    "Zahlenfeld": 99.99
    "wiederholungFeld(1)": "feldWert",
    "Datumsfeld": "2029/1/20"
  }
  "options" : {
    "entrymode": "script",
    "prohibitmode": "script"
  },
  "dateformats": 2
}

Um einen leeren Datensatz mit Standardwerten für jedes Feld zu erstellen, geben Sie ein leeres Datenobjekt im JSON-Format als Parameter an. Weitere optionale Parameter für den Abfragetext:

Beispiel:

Kopieren
{
  "fieldData": { } 
}

Weitere optionale Abfragetext-Parameter:

  • options – Beim Schreiben von Daten steuern diese Optionen Folgendes:

    • entrymode – Ignoriert, ob die Option Benutzer darf Überprüfung bei Dateneingabe umgehen für die Datenüberprüfung für ein Feld ausgewählt ist, und verwendet stattdessen diese Option. Der Wert „script“ ignoriert die Datenüberprüfungsanforderungen eines Feldes (so genannt, weil Scripts diese Anforderungen ignorieren). Der Wert „user“ (Standard) folgt den Überprüfungsanforderungen eines Feldes.

    • prohibitmode – Ignoriert, ob die Option Keine Veränderung des Werts bei der Dateneingabe für die automatische Dateneingabe ausgewählt ist, und verwendet stattdessen diese Option. Der Wert „script“ ignoriert die Anforderungen eines Feldes bezüglich der automatischen Dateneingabe (so genannt, weil Scripts diese Anforderungen ignorieren). Der Wert „user“ (Standard) folgt den Anforderungen eines Feldes bezüglich der automatische Dateneingabe.

  • 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.

Antwort

Die DatensatzID des Datensatzes, der erstellt wurde, und ein Meldungsarray, das nur den Fehlercode 0 zeigt.

Beispiel:

Kopieren
{
    "response": { 
        "recordId":"147"
        "modId":"0"
    },
    "messages": [ 
        {
            "code": "0",
            "message":"OK"
        }
    ]
}

Siehe Fehlerantworten.

Hinweise 

  • Wenn Sie Datensätze mit der FileMaker Data API erstellen, ist die Feldüberprüfung standardmäßig aktiviert (es sei denn, sie wird durch die Option entrymode oben außer Kraft gesetzt). Wenn die Feldüberprüfung erzwungen wird und die Daten die Überprüfung nicht bestehen, erhalten Sie eine Fehlermeldung und der Datensatz wird nicht erstellt.