Realizar una petición de búsqueda

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

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

• Versión 1 (v1): la estructura de los datos del portal devueltos se basa en la configuración de vista (vista Formulario o Tabla) de la presentación especificada.

  • Vista Formulario: devuelve todos los registros relacionados.

  • Vista Tabla: devuelve el primer registro relacionado.

    Nota  Al cambiar la configuración de vista, se modifica la estructura de datos del portal para el valor devuelto.

• Versión 2 (v2): la estructura de los datos del portal devueltos se basa en la vista Formulario.

• Última versión (vLatest): el comportamiento se basa en la última versión de la API.

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

nombre-presentación: la presentación que se utilizará como contexto de la petición de búsqueda.

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.

Una consulta en formato JSON que especifica los campos y los criterios de búsqueda. Puede utilizar parámetros opcionales para especificar las solicitudes de omisión (omit), el orden de clasificación (sort), el registro inicial (offset), el número de registros (limit) y los portales (portal) para limitar el número de registros relacionados que se devuelven. Los parámetros offset, limit y sort funcionan en los registros que se encuentran en la tabla de la presentación y no en los registros del portal relacionados. Para limitar el número de registros y filas que se muestran en un conjunto relacionado, especifique el parámetro offset.nombre-portal y limit.nombre-portal.

Por ejemplo:

{
  "query":[
    {"Group": "=Cirujano"},
    {"Lugar de trabajo" : "Madrid", "omit" : "true"}],
  "sort":[
    {"fieldName": "Lugar de trabajo","sortOrder": "ascend"},
    {"fieldName": "Nombre", "sortOrder": "ascend"}
  ]
}

Ejemplo con desplazamiento, límite y portales:

{
  "query":[
    {"Group": "=Cirujano"},
    {"Lugar de trabajo" : "Madrid", "omit" : "true"}],
  "portal": ["Portal1","Portal2"],
  "limit": "10",
  "offset": "1",
  "offset.Portal1": "1",
  "limit.Portal1": "5",
  "layout.response": "Doctores"
}

Otros parámetros opcionales del cuerpo de la solicitud:

• layout.response - Devuelve los datos de respuesta en el contexto de una presentación diferente. La presentación especificada debe ser para la misma tabla base que el diseño actual. Si se especifica una presentación de una tabla base diferente, pueden producirse resultados inesperados.

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