Menentukan sinonim

Organisasi sering kali memiliki terminologi unik atau beberapa cara untuk merujuk pada konsep yang sama. Menentukan sinonim menetapkan kesetaraan istilah, sehingga membantu pengguna menemukan item selama penelusuran.

Catatan: Anda hanya dapat menentukan sinonim kustom untuk sumber data pihak ketiga. Fitur ini tidak didukung untuk sumber data Google Workspace seperti Drive atau Gmail.

Tentukan sinonim dengan mengindeks item menggunakan skema populer _dictionaryEntry.

Item jenis _dictionaryEntry dapat memiliki properti berikut:

Properti	Jenis	Deskripsi	Wajib?
_term	string	Istilah yang akan ditentukan. Nilai yang disarankan adalah kata tanpa tanda penghubung atau frasa tanpa tanda baca.	Wajib
_synonym	string (repeated)	Istilah alternatif yang disertakan dalam kueri yang cocok dengan string yang ditentukan dalam _term.	Wajib
_onlyApplicableForAttachedSearchApplications	boolean	Memungkinkan Anda mengelompokkan sinonim menurut sumber data dan aplikasi penelusuran. Untuk mengetahui informasi lebih lanjut, lihat Menentukan sinonim khusus sumber data.	Opsional

Catatan: Item yang diindeks dengan skema _dictionaryEntry tidak dihitung dalam batas sumber data di aplikasi penelusuran.

Saat pengguna menyertakan nilai _term dalam kueri, kueri efektif menjadi "term OR synonyms". Misalnya, jika Anda menentukan "scifi" dengan sinonim "science fiction", kueri untuk "scifi" akan mencocokkan item yang berisi salah satu istilah tersebut.

Sinonim tidak bersifat dua arah secara default. Kueri untuk "science fiction" hanya cocok dengan frasa persis tersebut kecuali jika Anda juga mendefinisikannya sebagai istilah dengan "scifi" sebagai sinonim. Agar istilah dapat dipertukarkan, tentukan setiap istilah secara terpisah:

Istilah	Sinonim
scifi	science fiction
science fiction	scifi

Pemrosesan kueri menghapus tanda hubung dan tanda baca sebelum menerapkan sinonim. Kueri untuk "sci-fi" cocok dengan istilah "sci fi". Untuk mendukung istilah dengan tanda hubung, normalkan _term untuk menggunakan spasi, bukan tanda hubung.

Contoh yang dapat dipertukarkan:

Istilah	Sinonim
scifi	science fiction, sci fi
sci fi	science fiction, scifi
science fiction	scifi, sci fi

Catatan: Diperlukan waktu hingga 5 jam agar Cloud Search memproses dan menerapkan sinonim baru.

Secara default, sinonim berlaku di seluruh domain dan semua aplikasi penelusuran. Untuk membatasinya, lihat Menentukan sinonim khusus sumber data.

Menentukan sinonim global menggunakan SDK

Gunakan Content Connector SDK untuk menentukan istilah dan sinonim. Lihat Membuat konektor konten untuk mengetahui detailnya.

Cuplikan ini membuat RepositoryDoc dari catatan CSV:

DictionaryConnector.java

Lihat di GitHub

/**
 * 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();
}

Pertimbangan penting:

• Entri sinonim harus bersifat publik domain. Misalnya, Anda dapat menetapkan ACL ke DOMAIN_PUBLIC_ACL.
• Hindari setelan dalam file konfigurasi yang menggantikan setelan ini, seperti defaultAcl.mode=FALLBACK atau defaultAcl.public=true.

Menentukan sinonim spesifik per aplikasi penelusuran

Untuk memberikan sinonim khusus tim (misalnya, untuk tim engineering versus tim penjualan), indeks setiap sinonim dengan _onlyApplicableForAttachedSearchApplications=true. Hal ini membatasi sinonim untuk aplikasi penelusuran yang menyertakan sumber data tertentu.

Contoh:

structuredData.put("_onlyApplicableForAttachedSearchApplications", true);