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" 
  } 
}

Nota   Per creare un record vuoto con valori predefiniti per ciascun campo, specificare un oggetto dati vuoto in formato JSON come parametro.

Ad esempio:

Copia 
{"fieldData": 
  { 
  } 
}
È possibile eseguire script FileMaker come parte di questa richiesta includendo i parametri script.prerequest, script.presort e script nel corpo della richiesta. Vedere Esecuzione di script FileMaker.
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 record con FileMaker Data API, la verifica dei campi è imposta. Se i dati non superano la verifica dei campi, viene visualizzato un messaggio di errore e il record non viene creato.