Questo articolo illustra come risolvere i problemi con il backend di Search relativo alle regole di query.

Assicurati di seguire l'articolo di assistenza Come iniziare il debug dei problemi del backend di Search per i passaggi generali di risoluzione dei problemi. Una volta risolto il problema, puoi saltare i passaggi rimanenti.

 

Passaggi generali per la risoluzione dei problemi

A un livello elevato, dovrai confrontare la configurazione della regola di query con quanto restituito dall'algoritmo (mostrato nel registro di ricerca).

1. Apri la configurazione della regola di query:
   1. Vai a Search > [[Experience Name]] > Regole query.
   2. Verifica i criteri e le azioni configurati.
2. Apri il registro di ricerca per la query per la quale sta riscontrando problemi, oppure:
   1. Accedi a Ricerca > [[Experience Name]] > Ricerca di prova oppure a una sottoscheda Configurazione. Esegui una ricerca di prova e seleziona Debug Query dal menu a discesa.
   2. Se ha già eseguito la ricerca in un link di gestione temporanea o di produzione, vai a Ricerca > [[Experience Name]] > Registri di ricerca e fai clic sul registro di ricerca pertinente. Utilizza la barra di ricerca o i filtri per trovare più facilmente il registro di ricerca corretto oppure esegui nuovamente la ricerca per visualizzarlo in cima.
3. Verifica se la regola di query è stata applicata controllando se viene mostrata nella casella dei fattori di ricerca del registro di ricerca.
4. Se la regola di query non è mostrata nel registro di ricerca, ricontrolla i criteri della regola di query nella configurazione e conferma se la ricerca eseguita soddisfa tali criteri.
   • Se i criteri utilizzano regex, verifica il modello regex specificato con uno strumento di debug.
   • Se i criteri utilizzano il contesto o l'URL della pagina di riferimento, verifica se è stato selezionato per la ricerca. In tal caso, sarebbero elencati nell'attributo Parametri di query nella casella dei fattori di ricerca.
   • Se i criteri utilizzano chiavi verticali o tipi di ricerca, controlla che il tipo di utente che effettua la ricerca sia corretto nei metadati di ricerca. Inoltre, verifica attentamente che le chiavi verticali non siano cambiate.
5. Se la regola di query è presente (i criteri sono soddisfatti), ma il verticale o l'entità che ci si aspetta di vedere non sono nel set di risultati (o non ottieni risultati), verifica che i risultati attesi si intersechino con l'azione della regola di query.
   • Se fai riferimento al nome API di un campo o di un tipo di entità, alla chiave verticale o all'ID di un'entità, assicurati che corrisponda esattamente e che non sia stato modificato.
   • Verifica che le azioni siano configurate correttamente per corrispondere a ciò che desideri che accada. Ad esempio, se stai potenziando delle entità, le entità sono elencate nell'ordine in cui desideri che vengano restituite?

 

Le regole per le query non funzionano con i sinonimi

Le regole per le query sono progettate per avere la precedenza su tutto in Search, poiché sono elementi di logica hardcoded destinati a sovrascrivere in modo condizionato la configurazione esistente. Pertanto, non funzioneranno con i sinonimi.

Per esempio, se il criterio della tua regola è searchTermExactlyMatches "scarpe" e hai creato un sinonimo unidirezionale dove "scarpe da ginnastica" —> "scarpe", la regola non si attiverà se viene cercato "scarpe da ginnastica". Per ovviare a questo problema, dovresti utilizzare criteri di regola più ampi, ad esempio searchTermContains "scarpe" o "scarpe da ginnastica", oppure creare una regola per ciascun sinonimo.