Il est courant qu'une organisation utilise une terminologie unique ou plusieurs façons de désigner un concept ou une chose. Vous devez définir des synonymes pour établir une équivalence des termes afin d'aider les utilisateurs à trouver des éléments lorsqu'ils effectuent une recherche.
Les synonymes sont définis en indexant des éléments à l'aide d'un schéma courant _dictionaryEntry
.
Les éléments de type _dictionaryEntry
peuvent avoir les propriétés suivantes:
Propriété | Type | Description | Requis ? |
---|---|---|---|
_term |
string | Terme à définir. Les valeurs recommandées sont les mots sans trait d'union ou les expressions sans ponctuation. | Obligatoire |
_synonym |
string (repeated) | Autres termes à inclure dans les requêtes correspondant à la chaîne définie dans _term . |
Obligatoire |
_onlyApplicableForAttachedSearchApplications |
boolean | Permet de regrouper des synonymes par source de données et application de recherche. Pour en savoir plus, consultez Définir des synonymes spécifiques à une source de données. | Facultatif |
Lorsqu'un utilisateur inclut la valeur de la propriété _term
dans une requête, la requête effective devient terme OR synonymes. Par exemple, si le terme "scifi" est défini avec le synonyme "science fiction", une requête contenant le mot "scifi" correspond aux éléments contenant "scifi" ou "science fiction.".
Les synonymes ne sont pas appliqués de manière bidirectionnelle. Si la requête porte sur "science fiction,", Cloud Search n'applique aucun synonyme. La requête ne correspond qu'aux éléments contenant "science fiction.". Les éléments contenant "scifi" sont omis.
Pour que les deux termes soient interchangeables, définissez chaque terme séparément:
Terme | Synonymes |
---|---|
scifi | science fiction |
science fiction | scifi |
Lors du traitement de la requête, les traits d'union et les autres signes de ponctuation sont supprimés avant l'application des synonymes. La requête utilisateur "sci-fi" correspond à la _term
"sci fi.". Pour créer des synonymes pour des termes pouvant être composés par les utilisateurs, normalisez d'abord le _term
pour qu'il utilise des espaces au lieu de traits d'union.
En reprenant l'exemple, les définitions suivantes correspondent aux requêtes utilisateur, car "sci-fi," "sci fi," "scifi," et "science fiction" sont interchangeables:
Terme | Synonymes |
---|---|
scifi | science fiction, sci fi |
sci fi | science fiction, scifi |
science fiction | scifi, sci fi |
Par défaut, les synonymes d'une source de données s'appliquent à l'ensemble du domaine. Plus précisément, les synonymes sont appliqués dans toutes les applications de recherche pour toutes les recherches, quelle que soit la source de données. Si vous souhaitez utiliser des synonymes spécifiques à une source de données, consultez Définir des synonymes spécifiques à une source de données.
Définir des synonymes globaux à l'aide du SDK Cloud Search
Vous pouvez utiliser le SDK Content Connector pour définir des termes et leurs synonymes. Pour savoir comment créer un connecteur, consultez l'article Créer un connecteur de contenu.
L'extrait de code suivant illustre la création d'un objet RepositoryDoc
représentant le terme et le synonyme à partir d'un enregistrement de fichier CSV:
Tenez compte des points suivants lorsque vous définissez des synonymes:
- Les synonymes saisis doivent être publics dans le domaine. Pour ce faire, dans l'exemple précédent, définissez la LCA sur
DOMAIN_PUBLIC_ACL
. - Les propriétés suivantes ne doivent pas être définies pour votre fichier de configuration, car elles remplacent le paramètre public du domaine dans votre code :
defaultAcl.mode=FALLBACK
defaultAcl.public=true
Définir des synonymes spécifiques à une application de recherche
Par défaut, les synonymes sont appliqués à toutes les sources de données de toutes les applications de recherche.
Toutefois, supposons que votre organisation dispose d'équipes d'ingénierie et de ventes distinctes, et que vous souhaitiez fournir à chaque équipe une expérience de recherche différente, avec des synonymes spécifiques à chaque poste. Dans ce cas, vous pouvez créer une application de recherche avec une source de données et des synonymes spécifiques à l'ingénierie, et une autre application de recherche avec une source de données et des synonymes spécifiques aux ventes. Pour ce faire, indexez chaque synonyme dans une source de données spécifique à l'aide de _onlyApplicableForAttachedSearchApplications=true
. Ce paramètre limite les synonymes de sorte qu'ils ne s'appliquent qu'aux applications de recherche qui incluent une source de données spécifique.
Par exemple, l'ajout de la ligne de code suivante à l'exemple de code précédent garantit que les synonymes indexés sont spécifiques à la source de données:
structuredData.put("_onlyApplicableForAttachedSearchApplications", true);