Funcionamiento FHIR R4 $davinci-data-export para HealthLake - AWS HealthLake
Características principales de Punto final de la operaciónParámetros de la solicitudSolicitud de muestraRelaciones de recursosGestión de trabajosOutput Format (Formato de salida)Gestión de erroresSeguridad y autorizaciónPrácticas recomendadasLimitaciones

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Funcionamiento FHIR R4 $davinci-data-export para HealthLake

La $davinci-data-export operación es una operación FHIR asíncrona que permite exportar datos de la lista de atribución de miembros desde. AWS HealthLake Esta operación es una versión especializada de la $export operación estándar de la FHIR, diseñada específicamente para cumplir con los requisitos de la Guía de implementación de la lista de atribución de DaVinci miembros (ATR).

Características principales de

  • Procesamiento asíncrono: sigue el patrón estándar de solicitudes asíncronas del FHIR

  • Exportación a nivel de grupo: exporta los datos de los miembros de una lista de atribución específica (grupo)

  • Manejo de recursos especializado: se centra en los recursos relacionados con la atribución

  • Filtrado flexible: admite el filtrado por pacientes, tipos de recursos e intervalos de tiempo

  • Salida NDJSON: proporciona datos en formato JSON delimitado por líneas nuevas

Punto final de la operación

GET  [base]/Group/[id]/$davinci-data-export
POST [base]/Group/[id]/$davinci-data-export

Parámetros de la solicitud

Parámetro Cardinalidad Description (Descripción)
paciente 0.. * Miembros específicos cuyos datos deben exportarse. Si se omite, se exportan todos los miembros del grupo
_type 0.1.. Lista delimitada por comas de los tipos de recursos del FHIR que se van a exportar
_desde 0.1.. Incluya únicamente los recursos actualizados después de esta fecha/hora
Tipo de exportación 0.1.. Tipo de exportación que se va a realizar (predeterminado: hl7.fhir.us.davinci-atr)

Tipos de recursos admitidos

Cuando se utiliza el parámetro, solo se admiten los siguientes tipos de recursos: _type

  • Group

  • ¿Paciente

  • Cobertura

  • RelatedPerson

  • Práctico

  • PractitionerRole

  • Organización

  • Ubicación

Solicitud de muestra

Inicio de un trabajo de exportación

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage&exportType=hl7.fhir.us.davinci-atr

or

POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage&exportType=hl7.fhir.us.davinci-atr
Content-Type: application/json

{
  "DataAccessRoleArn": "arn:aws:iam::444455556666:role/your-healthlake-service-role",
  "JobName": "attribution-export-job",
  "OutputDataConfig": {
    "S3Configuration": {
      "S3Uri": "s3://your-export-bucket/EXPORT-JOB",
      "KmsKeyId": "arn:aws:kms:region:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab"
    }
  }
}

Respuesta de ejemplo

{
  "datastoreId": "eaee622d8406b41eb86c0f4741201ff9",
  "jobStatus": "SUBMITTED",
  "jobId": "48d7b91dae4a64d00d54b70862f33f61"
}

Relaciones de recursos

La operación exporta los recursos en función de sus relaciones en la lista de atribuciones de miembros:

Group (Attribution List)
├── Patient (Members)
├── Coverage → RelatedPerson (Subscribers)
├── Practitioner (Attributed Providers)
├── PractitionerRole → Location
└── Organization (Attributed Providers)

Fuentes de recursos

Recurso Ubicación de origen Description (Descripción)
Paciente Grupo, miembro, entidad Los pacientes que son miembros de la lista de atribuciones
Cobertura Group.Member.Extension: referencia de cobertura Cobertura que dio como resultado la afiliación de un paciente
Organización Group.Member.Extension: AttributedProvider Organismos a los que se atribuyen los pacientes
Profesional group.member.extension: AttributedProvider Los pacientes de los médicos individuales son atribuidos a
PractitionerRole group.member.extension: AttributedProvider Funciones del médico a las que se atribuyen los pacientes
RelatedPerson Cobertura. Suscriptor Suscriptores de la cobertura
Ubicación PractitionerRole.ubicación Ubicaciones asociadas a las funciones de los profesionales
Group Punto final de entrada La propia lista de atribuciones

Gestión de trabajos

Comprobar el estado del trabajo

GET [base]/export/[job-id]

Cancelar trabajo

DELETE [base]/export/[job-id]

Ciclo de vida del trabajo

  • SUBMITTED- Se ha recibido el trabajo y se ha puesto en cola

  • IN_PROGRESS- Job se está procesando activamente

  • COMPLETED- Job finalizado correctamente, archivos disponibles para descargar

  • FAILED- El trabajo encontró un error

Output Format (Formato de salida)

  • Formato de archivo: NDJSON (JSON delimitado por nueva línea)

  • Organización de archivos: archivos separados para cada tipo de recurso

  • Extensión de archivo: .ndjson

  • Ubicación: depósito y ruta de S3 especificados

Gestión de errores

La operación devuelve una solicitud incorrecta de HTTP 400 con un valor OperationOutcome para las siguientes condiciones:

Errores de autorización

  • Permisos de acceso a los datos no válidos o insuficientes

  • Problemas de acceso al bucket de S3

  • Problemas de acceso a la clave KMS

Errores de validación de parámetros

  • patientel parámetro no tiene el formato "Patient/id,Patient/id,...»

  • Referencias de pacientes no válidas o pacientes que no forman parte del Grupo

  • exportTypevalor distinto de hl7.fhir.us.davinci-atr

  • _typeparámetro que contiene tipos de recursos no admitidos

  • _typeal parámetro le faltan los tipos mínimos requeridos (grupo, paciente, cobertura) para el tipo de exportación de hl7.fhir.us.davinci-atr

Errores de validación de recursos

  • El recurso de grupo solicitado no existe

  • El grupo tiene una lista de miembros vacía

  • Los miembros del grupo no consultan recursos válidos para pacientes

Seguridad y autorización

  • Se aplican los mecanismos de autorización estándar del FHIR

  • Los clientes deben tener los permisos de lectura adecuados para el Grupo y los recursos relacionados

  • Se requieren permisos de escritura en el bucket S3 para la ubicación de salida

  • Se requieren permisos de clave KMS si se especifica el cifrado

Prácticas recomendadas

  • Selección del tipo de recurso: solicite únicamente los tipos de recursos que necesite para minimizar el tamaño de la exportación y el tiempo de procesamiento

  • Filtrado basado en el tiempo: utilice el _since parámetro para exportaciones incrementales

  • Filtrado de pacientes: utilice el patient parámetro cuando solo necesite datos de miembros específicos

  • Supervisión del trabajo: compruebe periódicamente el estado del trabajo para grandes exportaciones

  • Gestión de errores: Implemente la lógica de reintento adecuada para los trabajos fallidos

Limitaciones

  • Se puede especificar un máximo de 512 pacientes en el parámetro patient

  • La exportación se limita únicamente a las operaciones a nivel de grupo

  • Solo admite el conjunto predefinido de tipos de recursos relacionados con la atribución

  • La salida siempre está en formato NDJSON