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:
-
Usa o recurso de composição especificado como base para o documento
-
Identifica e recupera todos os recursos diretamente referenciados pela Composição
-
Empacota a composição e todos os recursos referenciados em um pacote do tipo “documento”
-
Armazena o pacote de documentos gerado no armazenamento de dados quando o parâmetro persist é definido como verdadeiro
-
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:
-
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id -
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:
$documentoperaçã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