Gerando documentos clínicos com $document - AWS HealthLake

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

Gerando documentos clínicos com $document

AWS HealthLake agora suporta a $document operação de recursos de composição, permitindo gerar um documento clínico completo agrupando a composição com todos os recursos referenciados em um único pacote coeso. Essa operação é essencial para aplicativos de saúde que precisam:

  • Crie documentos clínicos padronizados

  • Troque registros completos de pacientes

  • Armazene documentação clínica abrangente

  • Gere relatórios que incluam todo o contexto relevante

Uso

A $document operação pode ser invocada em recursos de composição usando os métodos GET e POST:

Operações com Suporte

GET/POST [base]/Composition/[id]/$document

Parâmetros compatíveis

HealthLake suporta o seguinte parâmetro FHIR: $document

Parameter Type Obrigatório Padrão Descrição
persist booliano Não false Booleano indicando se o servidor deve armazenar o pacote de documentos gerado

Exemplos

Solicitação GET

GET [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document?persist=true
Solicitação POST com parâmetros

POST [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document Content-Type: application/fhir+json { "resourceType": "Parameters", "parameter": [ { "name": "persist", "valueBoolean": true } ] }
Resposta da amostra

A operação retorna um recurso Bundle do tipo “documento” contendo a composição e todos os recursos referenciados:

{ "resourceType": "Bundle", "id": "180f219f-97a8-486d-99d9-ed631fe4fc57", "type": "document", "identifier": { "system": "urn:ietf:rfc:3986", "value": "urn:uuid:0c3151bd-1cbf-4d64-b04d-cd9187a4c6e0" }, "timestamp": "2024-06-21T15:30:00Z", "entry": [ { "fullUrl": "http://example.org/fhir/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57", "resource": { "resourceType": "Composition", "id": "180f219f-97a8-486d-99d9-ed631fe4fc57", "status": "final", "type": { "coding": [ { "system": "http://loinc.org", "code": "34133-9", "display": "Summary of Episode Note" } ] }, "subject": { "reference": "Patient/example" }, "section": [ { "title": "Allergies", "entry": [ { "reference": "AllergyIntolerance/123" } ] } ] } }, { "fullUrl": "http://example.org/fhir/Patient/example", "resource": { "resourceType": "Patient", "id": "example", "name": [ { "family": "Smith", "given": ["John"] } ] } }, { "fullUrl": "http://example.org/fhir/AllergyIntolerance/123", "resource": { "resourceType": "AllergyIntolerance", "id": "123", "patient": { "reference": "Patient/example" }, "code": { "coding": [ { "system": "http://snomed.info/sct", "code": "418689008", "display": "Allergy to penicillin" } ] } } } ] }

Comportamento

A $document operação:

  1. Usa o recurso de composição especificado como base para o documento

  2. Identifica e recupera todos os recursos diretamente referenciados pela Composição

  3. Empacota a composição e todos os recursos referenciados em um pacote do tipo “documento”

  4. Armazena o pacote de documentos gerado no armazenamento de dados quando o parâmetro persist é definido como verdadeiro

  5. Identifica e recupera recursos referenciados indiretamente pela Composição para geração abrangente de documentos

Atualmente, a $document operação oferece suporte à recuperação de referências de recursos no seguinte formato:

  1. GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id
  2. Recurso/ID

As referências de recursos não suportadas no recurso de composição serão filtradas do documento gerado.

Tratamento de erros

A operação trata das seguintes condições de erro:

  • 400 Solicitação inválida: $document operação inválida (solicitação não conforme) ou se o documento resultante falhar na validação do FHIR devido a referências filtradas quando persistir é definido como verdadeiro

  • 404 Não encontrado: recurso de composição não encontrado

Para obter mais informações sobre a especificação da $document operação, consulte a documentação da composição do FHIR R4. $document