Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Generazione di documenti clinici con `$document`
<a name="reference-fhir-operations-document"></a>

AWS HealthLake ora supporta il `$document` funzionamento delle risorse di Composizione, consentendovi di generare un documento clinico completo raggruppando la Composizione con tutte le sue risorse di riferimento in un unico pacchetto coeso. Questa operazione è essenziale per le applicazioni sanitarie che devono:
+ Creare documenti clinici standardizzati
+ Scambia le cartelle cliniche complete dei pazienti
+ Archivia una documentazione clinica completa
+ Genera report che includano tutto il contesto pertinente

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

L'`$document`operazione può essere richiamata sulle risorse di composizione utilizzando i metodi GET e POST:

**Operazioni supportate**  


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

## Parametri supportati
<a name="document-parameters"></a>

HealthLake supporta il seguente parametro FHIR`$document`:


| Parametro | Tipo | Obbligatorio | Predefinita | Description | 
| --- | --- | --- | --- | --- | 
| persist | booleano | No | false | Booleano che indica se il server deve archiviare il pacchetto di documenti generato | 

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

**Richiesta GET**  


```
GET [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document?persist=true
```

**Richiesta POST con parametri**  


```
POST [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "persist",
      "valueBoolean": true
    }
  ]
}
```

**Risposta di esempio**  
L'operazione restituisce una risorsa Bundle di tipo «documento» contenente la composizione e tutte le risorse di riferimento:

```
{
  "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>

L'`$document`operazione:

1. Prende la risorsa Composition specificata come base per il documento

1. Identifica e recupera tutte le risorse a cui fa riferimento direttamente la composizione

1. Raggruppa la composizione e tutte le risorse referenziate in un pacchetto di tipo «documento»

1. Memorizza il pacchetto di documenti generato nel datastore quando il parametro persist è impostato su true

1. Identifica e recupera le risorse a cui fa riferimento indirettamente la Composizione per una generazione completa di documenti

L'`$document`operazione attualmente supporta il recupero dei riferimenti alle risorse nel seguente formato:

1. 

   ```
   GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id
   ```

1. Risorsa/ID

I riferimenti alle risorse non supportati all'interno della risorsa Composition verranno filtrati dal documento generato.

## Gestione errori
<a name="document-error-handling"></a>

L'operazione gestisce le seguenti condizioni di errore:
+ 400 Richiesta non valida: `$document` operazione non valida (richiesta non conforme) o se il documento risultante non supera la convalida FHIR a causa di riferimenti filtrati quando persist è impostato su true
+ 404 Not Found: Risorsa di composizione non trovata

Per ulteriori informazioni sulle specifiche `$document` operative, consultate la documentazione sulla [composizione `$document` FHIR R4](https://www.hl7.org/fhir/R4/composition-operation-document.html).