Creare un record

Per creare un record, utilizzare un metodo POST HTTP con endpoint API records specificando il nome del database e il formato.

Metodo HTTP

POST

URL

/fmi/data/versione/databases/nome-database/layouts/nome-formato/records

versione – la versione di FileMaker Data API richiesta può utilizzare la v1, v2 o vLatest

nome-database – nome del database ospitato

nome-formato – nome del formato da utilizzare come contesto per creare il record

Intestazione HTTP

Content-Type: application/json

Authorization: token-sessione di connessione, dove token-sessione è il valore X-FM-Data-Access-Token univoco per la sessione del database

Parametri

I dati del record in formato JSON contenenti coppie campo-valore che specificano i valori per i campi che si trovano nel formato di destinazione. I dati possono specificare record correlati o portali che si trovano nel formato utilizzando la specifica portalData. Il nome di un portale può essere il nome oggetto visualizzato nella finestra Impostazioni di FileMaker Pro o il nome della tabella correlata.

Ad esempio:

Copia
{
  "fieldData": { 
    "Campo stringa": "valore_1"
    "Campo numero": 99.99
    "campoRipetizione(1)": "valoreCampo",
    "Campo data": "2029/1/20"
  }
  "options" : {
    "entrymode": "script",
    "prohibitmode": "script"
  },
  "dateformats": 2
}

Per creare un record vuoto con valori predefiniti per ogni campo, specificare un oggetto dati vuoto in formato JSON come parametro. Altri parametri opzionali del corpo della richiesta:

Ad esempio:

Copia
{
  "fieldData": { } 
}

Altri parametri opzionali del corpo della richiesta:

  • options - quando si scrivono i dati, queste opzioni controllano:

    • entrymode - ignora se l'opzione di un campo per la convalida dei dati Consenti all’utente di ignorare durante l’immissione dei dati è selezionata e utilizza invece questa opzione. Il valore "script" ignora i requisiti di convalida dei dati di un campo (così chiamato perché gli script ignorano questi requisiti). Il valore "user" (predefinito) rispetta i requisiti di convalida di un campo.

    • prohibitmode - ignora se l'opzione di un campo per l'immissione automatica dei dati Impedisci modifica valore durante immissione dati è selezionata e utilizza invece questa opzione. Il valore "script" ignora i requisiti di immissione automatica dei dati di un campo (così chiamato perché gli script ignorano questi requisiti). Il valore "user" (impostazione predefinita) rispetta i requisiti di immissione automatica dei dati di un campo.

  • dateformats - specifica il formato dei campi Data e Indicatore data e ora. Il valore è 0 per i formati statunitensi, 1 per i formati delle impostazioni locali del file o 2 per i formati ISO 8601. Se non specificato, il valore predefinito è 0.

  • script.prerequest, script.presort, script - esegue gli script FileMaker come parte della richiesta. Vedere Esecuzione di uno script con un'altra richiesta.

Risposta

L'ID del record creato e una matrice di messaggi con un codice di errore 0.

Ad esempio:

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

Vedere Risposte di errore.

Note 

  • Quando si creano i record utilizzando FileMaker Data API, la verifica dei campi viene applicata per impostazione predefinita (a meno che non sia sostituita dall'opzione entrymode di cui sopra). Se la verifica dei campi viene applicata e i dati non superano la verifica, viene visualizzato un messaggio di errore e il record non viene creato.