Evidenziazione dei risultati di ricerca in Amazon CloudSearch

Amazon CloudSearch può restituire estratti con i risultati di ricerca per mostrare la posizione in cui si trovano i termini di ricerca in un determinato campo o 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 configure indexing options.

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 estratti come HTML, i caratteri non alfanumerici vengono inseriti in una sequenza di escape 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 racchiudendole tra tag di enfatizzazione HTML, <em>term</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>'}.