Crear un registro

Para crear un registro, utilice un método HTTP POST con el punto de conexión de API records y especifique el nombre de la base de datos y la presentación.

Método HTTP

POST

URL

/fmi/data/versión/databases/nombre-base-de-datos/layouts/nombre-presentación/records

versión: la versión de FileMaker Data API solicitada puede utilizar v1, v2 o vLatest.

nombre-base-de-datos: el nombre de la base de datos alojada.

nombre-presentación: el nombre de la presentación que se utilizará como contexto para la creación del registro.

Encabezado HTTP

Content-Type: application/json

Authorization: Bearer token-sesión, donde token-sesión es el valor exclusivo de X-FM-Data-Access-Token para la sesión de la base de datos.

Parámetros

Registre datos en formato JSON que contengan pares de campo y valor que especifiquen valores para los campos incluidos en la presentación de destino. Los datos pueden especificar registros relacionados o portales que se encuentran en la presentación mediante la especificación portalData. Un nombre de portal puede ser el nombre del objeto que se muestra en el Inspector de FileMaker Pro o el nombre de la tabla relacionada.

Por ejemplo:

Copiar
{
  "fieldData": { 
    "campo de cadena": "value_1"
    "Campo numérico": 99.99
    "repetitionField(1)": "fieldValue",
    "Campo de fecha": "20/1/2029"
  }
  "opciones" : {
    "entrymode": "guión",
    "prohibitmode": "guión"
  },
  "dateformats": 2
}

Para crear un registro vacío con valores predeterminados para cada campo, especifique un objeto de datos vacío en formato JSON como parámetro. Otros parámetros opcionales del cuerpo de la solicitud:

Por ejemplo:

Copiar
{
  "fieldData": { } 
}

Otros parámetros opcionales del cuerpo de la solicitud:

  • opciones - Al escribir datos, estas opciones controlan:

    • entrymode - Ignora si la opción Permitir al usuario anular durante la introducción de datos de un campo para la validación de datos está seleccionada y utiliza esta opción en su lugar. El valor "guión" ignora los requisitos de validación de datos de un campo (se llama así porque los guiones ignoran estos requisitos). El valor "usuario" (predeterminado) sigue los requisitos de validación de un campo.

    • prohibitmode - Ignora si la opción Prohibir la modificación del valor durante la introducción de datos de un campo para la introducción automática de datos está seleccionada y utiliza esta opción en su lugar. El valor "guión" ignora los requisitos de introducción automática de datos de un campo (así llamado porque los guiones ignoran estos requisitos). El valor "usuario" (predeterminado) sigue los requisitos de entrada automática de datos de un campo.

  • dateformats - Especifica el formato de los campos de fecha y de fecha y hora. El valor es 0 para los formatos de EE.  U., 1 para los formatos de la configuración regional del archivo o 2 para los formatos ISO 8601. Si no se especifica, el valor predeterminado es 0.

  • script.prerequest, script.presort, script - Ejecuta guiones de FileMaker como parte de la solicitud. Consulte Ejecutar un guión con otra petición.

Respuesta

El ID del registro que se ha creado y una matriz de mensajes que muestran el código de error 0.

Por ejemplo:

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

Consulte Respuestas de error.

Notas 

  • Cuando cree registros mediante FileMaker Data API, la validación de campo se aplica de forma predeterminada (a menos que la anule la opción entrymode anterior). Si la validación de campos se aplica y los datos no superan la validación, recibirá un mensaje de error y no se creará el registro.