Enviar solicitudes independientes en un lote

Envíe hasta 25 solicitudes de FHIR independientes en un paquete de lotes R4 o R6 Ballot 4.

Use un lote para enviar varias solicitudes independientes juntas, como una búsqueda de paciente y una búsqueda de observación. En lugar de realizar una llamada HTTP independiente para cada solicitud, la aplicación realiza una llamada y recibe los resultados juntos.

Cada solicitud tiene su propio resultado, lo que facilita ver qué solicitudes se han realizado correctamente y cuáles requieren atención. Utilice un lote sólo cuando ninguna solicitud necesite el resultado de otra solicitud en el mismo lote.

Para conocer las definiciones estándar de procesamiento por lotes, consulte las HL7 FHIR R4 batch and transaction rules y la entrada de lote en el glosario HL7 FHIR R6 Ballot 4. DDFS admite solicitudes por lotes; los paquetes de transacciones siguen sin estar soportados.

Seleccione el punto final versionado

Compruebe que CapabilityStatement del servidor desplegado anuncia la interacción batch en el nivel del sistema. Envíe una POST a la URL base de FHIR para la versión seleccionada, sin un tipo de recurso o sufijo /Bundle:

POST /api/fhir/r4
POST /api/fhir/r6-ballot4
Content-Type: application/fhir+json
Accept: application/fhir+json
Authorization: Bearer <access-token>

Utilice los recursos admitidos por esa versión de FHIR. El token debe autorizar cada interacción de recurso solicitada, al igual que para una solicitud independiente. Consulte Autenticación y ámbitos.

Crear la solicitud

Defina resourceType en Bundle y type en batch. Cada entrada necesita una request.method en mayúscula y una request.url relativa a la URL base de FHIR seleccionada. Los métodos admitidos son GET, POST, PUT y DELETE para las interacciones admitidas. Incluya entry.resource cuando la interacción necesite un cuerpo de recurso.

Este ejemplo de solo lectura funciona con cualquier punto final versionado. Realiza dos búsquedas independientes:

{
  "resourceType": "Bundle",
  "type": "batch",
  "entry": [
    {"request": {"method": "GET", "url": "Patient?_count=1"}},
    {"request": {"method": "GET", "url": "Observation?_count=1"}}
  ]
}

Para la creación, sustitución y restauración de PUT, utilice el tipo de recurso y el ID lógico en la URL de entrada e incluya el mismo ID y tipo de recurso en su cuerpo. Se aplican los mismos permisos y reglas de respuesta que para una PUT directa.

Inspeccionar cada resultado de entrada

Un lote procesado correctamente devuelve HTTP 200 con un valor Bundle cuyo tipo es batch-response. Las entradas se procesan en orden de solicitud y las entradas de respuesta corresponden a entradas de solicitud en ese orden. El estado HTTP externo no significa que todas las entradas se hayan realizado correctamente.

Inspeccione cada entry.response.status. Una entrada también puede incluir response.location, response.etag, response.lastModified y un resultado de error o recurso devuelto, según corresponda a su interacción. Por ejemplo, se pueden devolver dos búsquedas sin coincidencias:

{
  "resourceType": "Bundle",
  "type": "batch-response",
  "entry": [
    {
      "resource": {"resourceType": "Bundle", "type": "searchset"},
      "response": {"status": "200 OK"}
    },
    {
      "resource": {"resourceType": "Bundle", "type": "searchset"},
      "response": {"status": "200 OK"}
    }
  ]
}

Una entrada puede fallar mientras las entradas no relacionadas se realizan correctamente. Revise el estado HTTP y OperationOutcome de la entrada con fallos. Una entrada con fallos no revierte las escrituras correctas de otras entradas. Consulte OperationOutcome Errors.

Límites y comportamiento no admitido

  • Un lote contiene como máximo 25 entradas. Se rechaza un lote más grande con HTTP 400; divida el trabajo en lotes más pequeños.
  • Las entradas deben ser independientes. No dependa de la respuesta de otra entrada ni haga referencia a un recurso creado por otra entrada en el mismo lote.
  • Los paquetes de transacciones y el rollback de transacciones no están soportados.
  • Los campos de solicitud de entrada condicional, incluidos ifMatch, ifNoneMatch, ifModifiedSince y ifNoneExist, no están soportados. Utilice una PUT directa cuando necesite protección de la versión If-Match.
  • Utilice direcciones URL de entrada relativas para la misma versión de FHIR. No envíe URL de servicio absolutas ni solicitudes por lotes anidadas.