Gestionar un recurso FHIR a través de su ciclo de vida
Cree, lea, actualice, lea una versión anterior y suprima lógicamente un recurso de FHIR de DDFS.
Este escenario sigue a un paciente a través de las interacciones estándar de creación, lectura, actualización, lectura con versiones (vread) y eliminación de FHIR. Las solicitudes utilizan la superficie de API de FHIR R4 (4.0.1). Utilice el mismo patrón de interacción en la superficie de la boleta FHIR R64 (6.0.0-ballot4) solo cuando su declaración de capacidad desplegada anuncia el recurso y la interacción.
Un DELETE estándar realiza una supresión lógica. La eliminación permanente es un flujo de trabajo administrativo independiente y no forma parte del proceso CRUD ordinario.
Requisitos
- Llame a
GET /api/fhir/r4/metadatay confirme que el paciente anunciacreate,read,update,vreadydelete. - Utilice un token de acceso de OAuth con los permisos necesarios para cada interacción.
- Use un valor de identificador único para que el recurso de ejemplo se pueda distinguir de otros recursos del paciente.
- Conservar el ID lógico y los ID de versión devueltos por el servicio. Los ejemplos utilizan marcadores de posición
{rid}y{vid}.
Flujo de trabajo
| Escalón | Interacción | Resultado |
|---|---|---|
| 1 | Crear | El servicio asigna un ID lógico y una versión inicial. |
| 2 | Lectura | El servicio devuelve la versión actual. |
| 3 | Actualizar | El servicio crea una nueva versión del mismo recurso lógico. |
| 4 | Versión leída | El servicio devuelve la versión histórica solicitada. |
| 5 | Suprimir | El servicio suprime lógicamente el recurso sin borrar permanentemente su historial almacenado. |
Ejemplos
1. Creación del paciente
La cabecera Prefer: return=representation solicita el recurso de respuesta porque este ejemplo consume el cuerpo de respuesta.
POST /api/fhir/r4/Patient
Accept: application/fhir+json
Content-Type: application/fhir+json
Prefer: return=representation
{
"resourceType": "Patient",
"identifier": [
{
"system": "urn:example:patient-identifier",
"value": "{unique-id}"
}
],
"active": true,
"name": [
{
"use": "official",
"family": "Test",
"given": ["Lifecycle"]
}
],
"gender": "unknown",
"birthDate": "1970-01-01"
}
Respuesta de ejemplo:
201 Created
ETag: W/"1"
Location: /api/fhir/r4/Patient/{rid}/_history/{vid}
Content-Type: application/fhir+json
{
"resourceType": "Patient",
"id": "{rid}",
"meta": {
"versionId": "1",
"lastUpdated": "{timestamp}"
},
"identifier": [
{
"system": "urn:example:patient-identifier",
"value": "{unique-id}"
}
],
"active": true,
"name": [
{
"use": "official",
"family": "Test",
"given": ["Lifecycle"]
}
],
"gender": "unknown",
"birthDate": "1970-01-01"
}
Guarde {rid} de la id asignada y guarde el ID de versión inicial de meta.versionId, ETag o la versión Location.
2. Leer la versión actual
GET /api/fhir/r4/Patient/{rid}
Accept: application/fhir+json
Ejemplo de respuesta:
200 OK
ETag: W/"1"
Content-Type: application/fhir+json
{
"resourceType": "Patient",
"id": "{rid}",
"meta": {"versionId": "1", "lastUpdated": "{timestamp}"},
"active": true,
"birthDate": "1970-01-01"
}
3. Actualizar el paciente
Envíe el recurso de sustitución completo con el ID lógico tanto en la ruta de solicitud como en el cuerpo. En este ejemplo, se cambia active y se conservan los demás datos.
Para evitar sobrescribir una actualización simultánea, envíe ETag desde la última lectura como If-Match. Los puntos finales PUT del recurso en FHIR R4 y FHIR R6 6.0.0-ballot4 lo soportan cuando CapabilityStatement del recurso anuncia versioned-update.
Una versión coincidente permite la actualización. Una versión obsoleta o desconocida devuelve 412 Precondition Failed con OperationOutcome y no realiza ningún cambio. Lea el recurso actual, concilie los cambios y vuelva a intentarlo con su nuevo ETag. No vuelva a intentarlo ciegamente con la misma versión obsoleta.
If-Match es opcional. Sin ella, la actualización es incondicional; un meta.versionId en el cuerpo de la solicitud no protege contra la pérdida de actualizaciones. Las etiquetas entre comillas, como "1" y las etiquetas débiles, como W/"1", comparan exactamente el valor de versión. Una lista separada por comas se ejecuta correctamente si alguna versión coincide; * comprueba la existencia sin proteger una versión específica. Las cabeceras con formato incorrecto devuelven 400 Bad Request.
PUT /api/fhir/r4/Patient/{rid}
Accept: application/fhir+json
Content-Type: application/fhir+json
Prefer: return=representation
If-Match: W/"1"
{
"resourceType": "Patient",
"id": "{rid}",
"identifier": [
{
"system": "urn:example:patient-identifier",
"value": "{unique-id}"
}
],
"active": false,
"name": [
{
"use": "official",
"family": "Test",
"given": ["Lifecycle"]
}
],
"gender": "unknown",
"birthDate": "1970-01-01"
}
Respuesta de ejemplo:
200 OK
ETag: W/"2"
Content-Type: application/fhir+json
{
"resourceType": "Patient",
"id": "{rid}",
"meta": {"versionId": "2", "lastUpdated": "{timestamp}"},
"active": false,
"birthDate": "1970-01-01"
}
4. Leer la versión anterior
Utilice el ID de versión inicial guardado después de la creación. Una lectura versionada recupera esa versión histórica; no devuelve la versión actual.
GET /api/fhir/r4/Patient/{rid}/_history/{vid}
Accept: application/fhir+json
Ejemplo de respuesta para la versión inicial:
200 OK
ETag: W/"1"
Content-Type: application/fhir+json
{
"resourceType": "Patient",
"id": "{rid}",
"meta": {"versionId": "1", "lastUpdated": "{timestamp}"},
"active": true,
"birthDate": "1970-01-01"
}
5. Eliminación lógica del paciente
DELETE /api/fhir/r4/Patient/{rid} realiza una supresión lógica. Una solicitud correcta no devuelve ningún cuerpo de respuesta.
DELETE /api/fhir/r4/Patient/{rid}
Accept: application/fhir+json
204 No Content
Después de la eliminación, no siga utilizando el recurso como registro activo. Manejar una lectura posterior según el estado de FHIR y OperationOutcome devuelto por el servicio.
La supresión permanente es un flujo de trabajo administrativo independiente
Una supresión lógica es distinta de las dos operaciones de supresión permanente:
POST /api/fhir/r4/Patient/{rid}/$hardDeleteelimina permanentemente un paciente eliminado lógicamente.POST /api/fhir/r4/Patient/$purgeDeletedelimina permanentemente los recursos de paciente elegibles eliminados lógicamente seleccionados por las entradas de la operación.
Ambas operaciones son irreversibles y requieren autorización adicional. Confirme que el recurso es elegible y revise Permanently Delete FHIR Resources antes de utilizar cualquiera de las operaciones.
Definición de estructura de FHIR
Definición del paciente: http://hl7.org/fhir/StructureDefinition/Patient.
Páginas de recursos: Paciente (R6) y Paciente (R4).
Páginas de dispositivos: Device (R6) y Device (R4).
Códigos de Estado
| Código | Significado |
|---|---|
| 200 | Una lectura, actualización o lectura con versiones finalizó correctamente y devolvió el recurso. |
| 201 | El recurso ha sido creado correctamente. |
| 204 | El recurso se ha suprimido de forma lógica correctamente y la respuesta no tiene cuerpo. |