Es común que una organización tenga terminología única o varias maneras de referirse a un concepto o a un objeto. Debes definir sinónimos para establecer la equivalencia de términos a fin de ayudar a los usuarios a encontrar elementos en una búsqueda.
Los sinónimos se definen mediante elementos de indexación con el esquema conocido de _dictionaryEntry
.
Los elementos de tipo _dictionaryEntry
pueden tener las siguientes propiedades:
Propiedad | Tipo | Descripción | ¿Obligatorio? |
---|---|---|---|
_term |
string | El término que se desea definir. Los valores recomendados son palabras sin guiones o frases sin puntuación. | Obligatorio |
_synonym |
string (repeated) | Los términos alternativos que se incluirán en las consultas y que coinciden con la string definida en _term . |
Obligatorio |
_onlyApplicableForAttachedSearchApplications |
boolean | Te permite agrupar sinónimos por fuente de datos y aplicación de búsqueda. Para obtener más información, consulta Define sinónimos específicos de la fuente de datos. | Opcional |
Cuando un usuario incluye el valor de la propiedad _term
en una consulta, la consulta efectiva se convierte en "términos O sinónimos". Por ejemplo, si se define el término "scifi" con el sinónimo "science fiction", una consulta que contenga la palabra "scifi" coincidirá con elementos que contengan "scifi" o "science fiction.".
Los sinónimos no se aplican de manera bidireccional. Si la consulta es para "science fiction,", Cloud Search no aplica ningún sinónimo a la consulta. La consulta solo coincide con los elementos que contienen "science fiction.". Se omiten los elementos que contienen "scifi".
Para que ambos términos sean intercambiables, define cada uno por separado:
Período | Sinónimos |
---|---|
scifi | science fiction |
science fiction | scifi |
Durante el procesamiento de la consulta, la separación silábica y otros tipos de puntuación se quitan antes de aplicar los sinónimos. La consulta del usuario "sci-fi" coincide con la "sci fi." de _term
. Si quieres crear sinónimos para los términos que los usuarios separaron con guion, primero debes normalizar el _term
y usar espacios en blanco en lugar de guiones.
Para continuar con el ejemplo, las siguientes definiciones que coinciden con las consultas del usuario tratan a "sci-fi," "sci fi," "scifi," y "science fiction" como intercambiables:
Período | Sinónimos |
---|---|
scifi | science fiction, sci fi |
sci fi | science fiction, scifi |
science fiction | scifi, sci fi |
De forma predeterminada, los sinónimos de cualquier fuente de datos se aplican en todo un dominio. Específicamente, los sinónimos se aplican en las aplicaciones de búsqueda para todas las búsquedas, independientemente de la fuente de datos. Si quieres sinónimos específicos de la fuente de datos, consulta Define sinónimos específicos de la fuente de datos.
Define sinónimos globales con el SDK de Cloud Search
Puedes usar el conector de contenido de SDK para definir los términos y sus sinónimos. Consulta Crea un conector de contenido a fin de obtener instrucciones para compilar un conector.
En el siguiente fragmento, se ilustra la compilación de una RepositoryDoc
que representa el término y el sinónimo según un registro de archivo CSV:
Ten en cuenta lo siguiente cuando definas sinónimos:
- Las entradas de sinónimos tienen que ser de dominio público. En el ejemplo anterior, eso se logra mediante la configuración de la LCA en
DOMAIN_PUBLIC_ACL
. - Las siguientes propiedades no deben definirse para el archivo de configuración porque anulan la configuración pública del dominio en tu código:
defaultAcl.mode=FALLBACK
defaultAcl.public=true
Define sinónimos específicos de la aplicación de búsqueda
De forma predeterminada, los sinónimos se aplican a todas las fuentes de datos en todas las aplicaciones de búsqueda.
Sin embargo, supongamos que tu organización tiene equipos de ingeniería y ventas separados, y deseas proporcionar a cada equipo una experiencia de búsqueda diferente, incluidos sinónimos específicos de la función del trabajo. En este caso, podrías crear una aplicación de búsqueda con sinónimos y una fuente de datos de ingeniería específica, y otra aplicación de búsqueda con sinónimos y una fuente de datos específica de ventas. Para lograr este objetivo, indexa cada sinónimo en una fuente de datos específica con _onlyApplicableForAttachedSearchApplications=true
. Esta configuración limita los sinónimos, de modo que solo se aplican a las aplicaciones de búsqueda que incluyen una fuente de datos específica.
Por ejemplo, agregar la siguiente línea de código a la muestra de código anterior garantiza que los sinónimos indexados sean específicos de la fuente de datos:
structuredData.put("_onlyApplicableForAttachedSearchApplications", true);