Operação FHIR R4 para $davinci-data-export HealthLake - AWS HealthLake
Recursos principaisPonto final da operaçãoParâmetros da solicitaçãoExemplo de solicitaçãoRelações de recursosGestão de JobOutput FormatTratamento de errosSegurança e autorizaçãoPráticas recomendadasLimitações

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Operação FHIR R4 para $davinci-data-export HealthLake

A $davinci-data-export operação é uma operação assíncrona do FHIR que permite a exportação dos dados da Lista de Atribuição de Membros de. AWS HealthLake Essa operação é uma versão especializada da $export operação padrão do FHIR, projetada especificamente para atender aos requisitos do Guia de Implementação da Lista de Atribuição de DaVinci Membros (ATR).

Recursos principais

  • Processamento assíncrono: segue o padrão de solicitação assíncrona FHIR

  • Exportação em nível de grupo: exporta dados para membros em uma lista de atribuição específica (Grupo)

  • Tratamento especializado de recursos: concentra-se em recursos relacionados à atribuição

  • Filtragem flexível: suporta a filtragem por pacientes, tipos de recursos e intervalos de tempo

  • Saída NDJSON: fornece dados no formato JSON delimitado por nova linha

Ponto final da operação

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

Parâmetros da solicitação

Parâmetro Cardinalidade Description
paciente 0.. * Membros específicos cujos dados devem ser exportados. Quando omitidos, todos os membros do Grupo são exportados
_tipo 0,1 Lista delimitada por vírgula dos tipos de recursos FHIR a serem exportados
_desde 0,1 Inclua somente recursos atualizados após essa data/hora
Tipo de exportação 0,1 Tipo de exportação a ser executada (padrão: hl7.fhir.us.davinci-atr)

Tipos de recursos compatíveis

Ao usar o _type parâmetro, somente os seguintes tipos de recursos são suportados:

  • Group (Grupo)

  • Paciente

  • Cobertura

  • RelatedPerson

  • Praticante

  • PractitionerRole

  • Organização

  • Local

Exemplo de solicitação

Iniciando um Export Job

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"
    }
  }
}

Resposta da amostra

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

Relações de recursos

A operação exporta recursos com base em seus relacionamentos na Lista de atribuição de membros:

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

Fontes de recursos

Recurso Localização da fonte Description
Paciente grupo.membro.entidade Os pacientes que são membros da lista de atribuição
Cobertura group.member.extension: referência de cobertura Cobertura que resultou na adesão do paciente
Organização group.member.extension: AttributedProvider Organizações às quais os pacientes são atribuídos
Praticante group.member.extension: AttributedProvider Médicos individuais, pacientes são atribuídos a:
PractitionerRole group.member.extension: AttributedProvider Funções profissionais às quais os pacientes são atribuídos
RelatedPerson Cobertura. Assinante Assinantes da cobertura
Local PractitionerRole.localização Locais associados às funções dos profissionais
Group (Grupo) Ponto final de entrada A lista de atribuições em si

Gestão de Job

Verifique o status do trabalho

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

Cancelar trabalho

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

Ciclo de vida da tarefa

  • SUBMITTED- Job foi recebido e colocado na fila

  • IN_PROGRESS- O trabalho está sendo processado ativamente

  • COMPLETED- Job concluído com sucesso, arquivos disponíveis para download

  • FAILED- Job encontrou um erro

Output Format

  • Formato de arquivo: NDJSON (JSON delimitado por nova linha)

  • Organização de arquivos: arquivos separados para cada tipo de recurso

  • Extensão do arquivo: .ndjson

  • Localização: bucket e caminho do S3 especificados

Tratamento de erros

A operação retorna HTTP 400 Bad Request com uma OperationOutcome das seguintes condições:

Erros de autorização

  • Permissões inválidas ou insuficientes para acesso aos dados

  • Problemas de acesso ao bucket do S3

  • Problemas de acesso à chave KMS

Erros de validação de parâmetros

  • patientparâmetro não formatado como "Patient/id,Patient/id,...”

  • Referências de pacientes inválidas ou pacientes que não fazem parte do Grupo

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

  • _typeparâmetro contendo tipos de recursos não suportados

  • _typeparâmetros ausentes dos tipos mínimos necessários (grupo, paciente, cobertura) para o tipo de exportação de hl7.fhir.us.davinci-atr

Erros de validação de recursos

  • O recurso de grupo solicitado não existe

  • O grupo tem uma lista de membros vazia

  • Os membros do grupo não fazem referência a recursos válidos para pacientes

Segurança e autorização

  • Os mecanismos de autorização padrão do FHIR se aplicam

  • Os clientes devem ter permissões de leitura apropriadas para o Grupo e os recursos relacionados

  • Permissões de gravação no bucket do S3 necessárias para o local de saída

  • Permissões de chave KMS necessárias se a criptografia for especificada

Práticas recomendadas

  • Seleção do tipo de recurso: solicite somente os tipos de recursos necessários para minimizar o tamanho da exportação e o tempo de processamento

  • Filtragem baseada em tempo: use o _since parâmetro para exportações incrementais

  • Filtragem de pacientes: use o patient parâmetro quando precisar apenas de dados para membros específicos

  • Monitoramento de trabalhos: verifique regularmente o status do trabalho para grandes exportações

  • Tratamento de erros: implemente a lógica de repetição adequada para trabalhos com falha

Limitações

  • Máximo de 512 pacientes pode ser especificado no parâmetro patient

  • A exportação é limitada somente às operações em nível de grupo

  • Só é compatível com o conjunto predefinido de tipos de recursos relacionados à atribuição

  • A saída está sempre no formato NDJSON