Créer un enregistrement

Pour créer un enregistrement, utilisez une méthode HTTP POST avec le point de terminaison API records en indiquant le nom de la base de données et le modèle.

Méthode HTTP

POST

URL

/fmi/data/version/databases/nom-base/layouts/nom-modèle/records

version : la version FileMaker Data API demandée peut utiliser v1, v2 ou vLatest

nom-base : nom de la base de données hébergée.

nom-modèle : le nom du modèle servant de contexte à la création de l'enregistrement

En-tête HTTP

Content-Type: application/json

Authorization : Bearer jeton-session, où jeton-session est la valeur X-FM-Data-Access-Token unique de la session de base de données

Paramètres

Données d'enregistrement au format JSON contenant des paires rubrique/valeur qui indiquent les valeurs des rubriques dans le modèle cible. À l'aide de la spécification portalData, ces données peuvent spécifier des tables externes ou des enregistrements liés se trouvant dans le modèle. Un nom de table externe peut être le nom de l'objet tel qu'indiqué dans l'Inspecteur de FileMaker Pro ou le nom de la table liée.

Par exemple :

Copier
{
  "fieldData": { 
    "String Field": "valeur_1"
    "Number Field": 99.99
    "repetitionField(1)": "valeurRubrique",
    "Date Field": "2029/1/20"
  }
  "options" : {
    "entrymode": "script",
    "prohibitmode": "script"
  },
  "dateformats": 2
}

Pour créer un enregistrement vide avec des valeurs par défaut pour chaque rubrique, spécifiez un objet de données vide au format JSON comme paramètre. Autres paramètres de corps de requête facultatifs :

Par exemple :

Copier
{
  "fieldData": { } 
}

Autres paramètres de corps de requête facultatifs :

  • options - Lors de l'écriture de données, ces options contrôlent :

    • entrymode - Ignore si l'option Autoriser les modifications utilisateur d'une rubrique pour la validation des données est sélectionnée, et utilise cette option à la place. La valeur « script » ignore les exigences de validation des données d'une rubrique (ainsi nommée car les scripts ignorent ces exigences). La valeur « user » (par défaut) suit les exigences de validation d'une rubrique.

    • prohibitmode - Ignore si l'option Entrées auto. non modifiables lors de la saisie d'une rubrique pour la saisie automatique des données est sélectionnée, et utilise cette option à la place. La valeur « script » ignore les exigences de saisie automatique de données d'une rubrique (ainsi nommée car les scripts ignorent ces exigences). La valeur « user » (par défaut) suit les exigences de saisie automatique des données d'une rubrique.

  • dateformats - Spécifie le format des rubriques de date et d'horodatage. La valeur est 0 pour les formats américains, 1 pour les formats des paramètres régionaux du fichier ou 2 pour les formats ISO 8601. Si elle n'est pas définie, la valeur par défaut est 0.

  • script.prerequest, script.presort, script - Exécute des scripts FileMaker dans le cadre de la requête. Consultez la section Exécuter un script avec une autre requête.

Réponse

L'identifiant de l'enregistrement créé et un tableau de messages indiquant un code d'erreur de 0.

Par exemple :

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

Consultez la section Codes d'erreur.

Remarques 

  • Lorsque vous créez des enregistrements à l'aide de FileMaker Data API, la validation des rubriques est appliquée par défaut (sauf si elle est remplacée par l'option entrymode ci-dessus). Si la validation de la rubrique est appliquée et que les données ne sont pas validées, vous recevrez un message d'erreur et l'enregistrement ne sera pas créé.