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

# Evidenziazione dei risultati di ricerca su Amazon CloudSearch
<a name="highlighting"></a>

Amazon CloudSearch può restituire degli estratti con i risultati della ricerca per mostrare dove si trovano i termini di ricerca all'interno di un determinato campo di un documento corrispondente. Ad esempio, nel seguente estratto i termini della ricerca *luke skywalker* vengono evidenziati all'interno del campo `plot`:

```
highlights": {
    "plot": "After the rebels have been brutally overpowered by the Empire on
    their newly established base, *Luke* *Skywalker* takes advanced Jedi 
    training with Master Yoda, while his friends are pursued by Darth Vader 
    as part of his plan to capture *Luke*."
}
```

Se ricerchi una locuzione, i documenti corrispondenti devono contenerla. Tuttavia, quando recuperi le evidenziazioni, i termini nella locuzione vengono evidenziati singolarmente. Se ricerchi la locuzione `"Luke Skywalker"` e recuperi le evidenziazioni del campo `plot` come mostrato nell'esempio precedente, il termine `Luke` viene evidenziato anche se non è seguito da `Skywalker`. Le evidenziazioni vengono restituite per i primi 10 KB di dati in un campo. Se il campo contiene più di 10 KB di dati e i termini di ricerca appaiono oltre tale limite, non vengono evidenziati.

Puoi ottenere le evidenziazioni per qualsiasi campo evidenziabile specificando il parametro `highlight.FIELD` nella tua richiesta di ricerca. Ad esempio, per ottenere le evidenziazioni del campo `plot` mostrato, devi specificare quanto segue:

```
search?q=star wars&highlight.plot={}
```

Per ulteriori informazioni su come abilitare un campo a restituire le evidenziazioni, consultare [Configurazione dei campi dell'indice](configuring-index-fields.md).

Puoi controllare il numero di occorrenze evidenziate dei termini di ricerca all'interno di un estratto, il modo in cui devono essere evidenziate e se l'estratto deve essere restituito come testo normale o come HTML. Quando Amazon CloudSearch restituisce degli estratti come HTML, i caratteri non alfanumerici vengono eliminati con la codifica delle entità HTML. Questo metodo ha lo scopo di ridurre al minimo i rischi associati all'integrazione di contenuti HTML non attendibili, poiché è possibile che originariamente il campo fosse popolato con contenuti generati dagli utenti. 

Puoi specificare le opzioni delle evidenziazioni come oggetto JSON. Se l'oggetto JSON è vuoto`highlight.FIELD={}`, Amazon CloudSearch evidenzia tutte le occorrenze dei termini di ricerca racchiudendoli in tag di enfasi HTML, <em>*termine*</em> e gli estratti vengono restituiti come HTML. 
+ Per specificare se l'estratto deve essere restituito come `text` o `html`, utilizza l'opzione `format`, ad esempio `highlight.plot={format:'text'}`.
+ Per specificare il numero massimo di occorrenze dei termini di ricerca che vuoi evidenziare, utilizza l'opzione `max_phrases`, ad esempio `highlight.plot={max_phrases:3}`. Il valore predefinito è 1, il valore massimo è 5.
+ Per specificare la stringa da anteporre a ciascun termine evidenziato, utilizza l'opzione `pre_tag`, ad esempio `highlight.plot={pre_tag:'<strong>', post_tag:'</strong>'}`.
+ Per specificare la stringa da aggiungere dopo ciascun termine evidenziato, utilizza l'opzione `post_tag`, ad esempio `highlight.plot={pre_tag:'<strong>', post_tag:'</strong>'}`.