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`
<a name="reference-fhir-operations-document"></a>

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

## Usage
<a name="document-usage"></a>

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
<a name="document-parameters"></a>

HealthLake suporta o seguinte parâmetro FHIR: `$document`


| Parâmetro | Tipo | Obrigatório | Padrão | Description | 
| --- | --- | --- | --- | --- | 
| persist | booliano | Não | false | Booleano indicando se o servidor deve armazenar o pacote de documentos gerado | 

## Exemplos
<a name="document-examples"></a>

**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 name="document-behavior"></a>

A `$document` operação:

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

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

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

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

1. 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
   ```

1. 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 name="document-error-handling"></a>

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](https://www.hl7.org/fhir/R4/composition-operation-document.html). `$document`