Definisci i sinonimi

È normale che un'organizzazione abbia una terminologia unica o più modi per fare riferimento a un concetto o a un'entità. Devi definire i sinonimi per stabilire la equivalenza dei termini in modo da aiutare gli utenti a trovare gli elementi durante la ricerca.

I sinonimi vengono definiti indicizzando gli elementi con lo schema _dictionaryEntry ben noto.

Gli elementi di tipo _dictionaryEntry possono avere le seguenti proprietà:

Proprietà Tipo Descrizione Obbligatorio?
_term string Il termine da definire. I valori consigliati sono parole o frasi senza trattini e senza punteggiatura. Obbligatorio
_synonym string (repeated) Termini alternativi da includere nelle query corrispondenti alla stringa definita in _term. Obbligatorio
_onlyApplicableForAttachedSearchApplications boolean Consente di raggruppare i sinonimi per origine dati e applicazione di ricerca. Per ulteriori informazioni, vedi Definire sinonimi specifici per l'origine dati. Facoltativo

Quando un utente include il valore della proprietà _term in una query, la query effettiva diventa "termine OPPURE sinonimi". Ad esempio, se il termine "scifi" è definito con il sinonimo "science fiction", una query contenente la parola "scifi" corrisponde agli elementi contenenti "scifi" o "science fiction.".

I sinonimi non vengono applicati in modo bidirezionale. Se la query è invece per "science fiction," Cloud Search non applica alcun sinonimo alla query. La query corrisponde solo agli elementi contenenti "science fiction." Gli elementi contenenti "scifi" vengono omessi.

Per rendere entrambi i termini intercambiabili, definiscili separatamente:

Termine Sinonimi
scifi science fiction
science fiction scifi

Durante l'elaborazione delle query, l'accavallamento e altri segni di punteggiatura vengono rimossi prima di applicare i sinonimi. La query dell'utente "sci-fi" corrisponde a _term "sci fi." Per creare sinonimi per i termini che possono essere separati da trattini dagli utenti, normalizza prima _term in modo da utilizzare spazi anziché trattini.

Continuando con l'esempio, le seguenti definizioni corrispondono alle query degli utenti che trattano "sci-fi," "sci fi," "scifi," e "science fiction" come intercambiabili:

Termine Sinonimi
scifi science fiction, sci fi
sci fi science fiction, scifi
science fiction scifi, sci fi

Per impostazione predefinita, i sinonimi in qualsiasi origine dati vengono applicati a un intero dominio. Nello specifico, i sinonimi vengono applicati alle applicazioni di ricerca per tutte le ricerche, indipendentemente dall'origine dati. Se vuoi sinonimi specifici per l'origine dati, consulta Definire sinonimi specifici per l'origine dati.

Definire sinonimi globali utilizzando l'SDK Cloud Search

Puoi utilizzare l'SDK Content Connector per definire i termini e i relativi sinonimi. Per istruzioni su come creare un connettore, consulta Creare un connettore di contenuti.

Lo snippet seguente illustra la creazione di un RepositoryDoc che rappresenta il termine e il sinonimo in base a un record del file CSV:

DictionaryConnector.java
/**
 * Creates a document for indexing.
 *
 * For this connector sample, the created document is domain public
 *  searchable. The content is a simple text string.
 *
 * @param record The current CSV record to convert
 * @return the fully formed document ready for indexing
 */
private ApiOperation buildDocument(CSVRecord record) {
  // Extract term and synonyms from record
  String term = record.get(0);
  List<String> synonyms = StreamSupport.stream(record.spliterator(), false)
      .skip(1) // Skip term
      .collect(Collectors.toList());

  Multimap<String, Object> structuredData = ArrayListMultimap.create();
  structuredData.put("_term", term);
  structuredData.putAll("_synonym", synonyms);

  if (Configuration.getBoolean("dictionary.attachedToSearchApp", false).get()) {
    structuredData.put("_onlyApplicableForAttachedSearchApplications", true);
  }

  String itemName = String.format("dictionary/%s", term);

  // Using the SDK item builder class to create the item
  Item item =
      IndexingItemBuilder.fromConfiguration(itemName)
          .setItemType(IndexingItemBuilder.ItemType.CONTENT_ITEM)
          .setObjectType("_dictionaryEntry")
          .setValues(structuredData)
          .setAcl(DOMAIN_PUBLIC_ACL)
          .build();

  // Create the fully formed document
  return new RepositoryDoc.Builder()
      .setItem(item)
      .build();
}

Tieni presente quanto segue quando definisci i sinonimi:

  • Le voci dei sinonimi devono essere pubbliche per il dominio. Nell'esempio precedente, questo viene ottenuto impostando l'ACL su DOMAIN_PUBLIC_ACL.
  • Le seguenti proprietà non devono essere definite per il file di configurazione perché sostituiscono l'impostazione pubblica del dominio nel codice:
    • defaultAcl.mode=FALLBACK
    • defaultAcl.public=true

Definire i sinonimi specifici dell'applicazione di ricerca

Per impostazione predefinita, i sinonimi vengono applicati a tutte le origini dati di tutte le applicazioni di ricerca.

Tuttavia, supponiamo che la tua organizzazione abbia team di ingegneria e vendite separati e che tu voglia fornire a ciascun team un'esperienza di ricerca diversa, inclusi i sinonimi specifici per ruolo. In questo caso, puoi creare un'applicazione di ricerca con un'origine dati e sinonimi specifici per l'ingegneria e un'altra applicazione di ricerca con un'origine dati e sinonimi specifici per le vendite. Per raggiungere questo obiettivo, indicizza ogni sinonimo in un'origine dati specifica utilizzando _onlyApplicableForAttachedSearchApplications=true. Questa impostazione limita i sinonimi in modo che vengano applicati solo alle applicazioni di ricerca che includono un'origine dati specifica.

Ad esempio, l'aggiunta della seguente riga di codice all'esempio di codice precedente garantisce che i sinonimi indicizzati siano specifici dell'origine dati:

structuredData.put("_onlyApplicableForAttachedSearchApplications", true);