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

# Recupero dei dettagli concettuali con `$lookup`
<a name="reference-fhir-operations-lookup"></a>

AWS HealthLake ora supporta l'`$lookup`operazione per CodeSystem le risorse, consentendoti di recuperare dettagli su un concetto specifico in un sistema di codice fornendo informazioni identificative come il codice. Questa operazione è particolarmente utile quando è necessario:
+ Recuperare informazioni dettagliate su codici medici specifici
+ Convalida i significati e le proprietà dei codici
+ Accedi alle definizioni e alle relazioni dei concetti
+ Supporta il processo decisionale clinico con dati terminologici accurati

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

L'`$lookup`operazione può essere richiamata sulle CodeSystem risorse utilizzando i metodi GET e POST:

**Operazioni supportate**  


```
GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=73211009&version=20230901
POST [base]/CodeSystem/$lookup
```

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

HealthLake supporta un sottoinsieme di parametri FHIR R4: `$lookup`


| Parametro | Tipo | Campo obbligatorio | Description | 
| --- | --- | --- | --- | 
| code | code | Sì | Il codice concettuale che stai cercando (ad esempio, «71620000" in SNOMED CT) | 
| system | uri | Sì | [L'URL canonico del sistema di codici (ad esempio, "http://snomed.info/sct «)](http://snomed.info/sct) | 
| version | stringa | No | Versione specifica del sistema di codice | 

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

**Richiesta GET**  


```
GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
```

**Richiesta POST**  


```
POST [base]/CodeSystem/$lookup
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "71620000"
    },
    {
      "name": "version",
      "valueString": "2023-09"
    }
  ]
}
```

**Risposta di esempio**  
L'operazione restituisce una risorsa Parameters contenente i dettagli del concetto:

```
{
    "resourceType": "Parameters",
    "parameter": [{
            "name": "name",
            "valueString": "SNOMED CT Fractures"
        },
        {
            "name": "version",
            "valueString": "2023-09"
        },
        {
            "name": "display",
            "valueString": "Fracture of femur"
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263225007"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of neck of femur"
                }
            ]
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263227004"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of shaft of femur"
                }
            ]
        }
    ]
}
```

## Parametri di risposta
<a name="lookup-response-parameters"></a>

La risposta include i seguenti parametri, se disponibili:


| Parametro | Tipo | Description | 
| --- | --- | --- | 
| name | stringa | Nome del sistema di codici | 
| version | stringa | Versione del sistema di codici | 
| display | stringa | Visualizza il nome del concetto | 
| designation | BackboneElement | Rappresentazioni aggiuntive per questo concetto. | 
| property | BackboneElement | Proprietà aggiuntive del concetto (definizione, relazioni, ecc.) | 

## Comportamento
<a name="lookup-behavior"></a>

L'`$lookup`operazione:

1. Convalida i parametri richiesti (`code`e`system`)

1. Cerca il concetto all'interno del sistema di codice specificato memorizzato nel datastore

1. Restituisce informazioni dettagliate sul concetto, tra cui nome visualizzato, designazioni e proprietà.

1. Supporta ricerche specifiche per versione quando viene fornito il parametro `version`

1. Funziona solo su sistemi di codice archiviati in modo esplicito nel datastore HealthLake 

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

L'operazione gestisce le seguenti condizioni di errore:
+ 400 Bad Request: `$lookup` operazione non valida (richiesta non conforme o parametri obbligatori mancanti)
+ 404 Not Found: Sistema di codice non trovato o codice non trovato nel sistema di codice specificato

## Avvertenze
<a name="lookup-caveats"></a>

In questa versione, non sono supportati:
+ `$lookup`operazione mediante chiamata a server terminologici esterni
+ `$lookup`operazione su CodeSystems gestita da HealthLake ma non archiviata in modo esplicito nel datastore

Per ulteriori informazioni sulle specifiche `$lookup` operative, consultate la documentazione di [FHIR](https://www.hl7.org/fhir/R4/codesystem-operation-lookup.html) R4. CodeSystem `$lookup`