機構通常會使用專屬術語或多種方式來指稱某個概念或事物。您應定義同義詞,以建立字詞等同性,協助使用者在搜尋時找到項目。
同義詞的定義是使用 _dictionaryEntry
已知結構定義項目索引。
_dictionaryEntry
類型的項目可具有下列屬性:
屬性 | 類型 | 說明 | 必填與否 |
---|---|---|---|
_term |
string | 要定義的字詞。建議的值為不含連字號的字詞或詞組,且不含標點符號。 | 必填 |
_synonym |
string (repeated) | 在查詢中納入的替代字詞,這些字詞必須與 _term 中定義的字串相符。 |
必填 |
_onlyApplicableForAttachedSearchApplications |
boolean | 可讓您依資料來源和搜尋應用程式將同義字分組。詳情請參閱「定義資料來源專屬同義字」。 | 選用 |
如果使用者在查詢中加入 _term
屬性的值,有效查詢就會變成「字詞或同義字」。舉例來說,如果字詞 "scifi" 是使用同義字 "science fiction" 定義,則包含 "scifi" 字詞的查詢會與包含 "scifi" 或 "science fiction." 的項目相符。
同義字不會雙向套用。如果查詢是針對 "science fiction,",Cloud Search 就不會將任何同義字套用至查詢。查詢只會比對含有 "science fiction." 的項目,含有 "scifi" 的項目會遭到略過。
如要讓兩個字詞可互換,請分別定義每個字詞:
字詞 | 同義詞 |
---|---|
scifi | science fiction |
science fiction | scifi |
在查詢處理期間,系統會先移除連字號和其他標點符號,再套用同義字。使用者查詢 "sci-fi" 與 _term
"sci fi." 相符。如要為使用者可能會加上連字號的字詞建立同義字,請先將 _term
標準化,以空格取代連字號。
接著,以下定義與使用者查詢相符,將 "sci-fi," "sci fi," "scifi," 和 "science fiction" 視為可互換:
字詞 | 同義詞 |
---|---|
scifi | science fiction, sci fi |
sci fi | science fiction, scifi |
science fiction | scifi, sci fi |
根據預設,任何資料來源中的同義字都會套用至整個網域。具體來說,無論資料來源為何,同義字會套用至所有搜尋應用程式。如要使用特定資料來源的同義字,請參閱「定義特定資料來源的同義字」。
使用 Cloud Search SDK 定義全球同義字
您可以使用 Content Connector SDK 定義字詞和同義字。如需建構連接器的操作說明,請參閱「建立內容連接器」。
以下程式碼片段說明如何根據 CSV 檔案記錄建立代表字詞和同義詞的 RepositoryDoc
:
定義同義詞時,請注意下列事項:
- 同義詞項目必須是公開網域。在前述範例中,這是透過將 ACL 設為
DOMAIN_PUBLIC_ACL
來達成。 - 請勿為設定檔定義下列屬性,因為這些屬性會覆寫程式碼中的網域公開設定:
defaultAcl.mode=FALLBACK
defaultAcl.public=true
定義搜尋應用程式專屬的同義字
根據預設,同義字會套用至所有搜尋應用程式中的所有資料來源。
不過,假設貴機構有獨立的工程和銷售團隊,且您想為每個團隊提供不同的搜尋體驗,包括職務角色專屬的近義字。在這種情況下,您可以建立一個搜尋應用程式,其中包含工程專屬資料來源和同義字,以及另一個搜尋應用程式,其中包含銷售專屬資料來源和同義字。如要達成這個目標,請使用 _onlyApplicableForAttachedSearchApplications=true
為特定資料來源中的每個同義字建立索引。這項設定會限制同義字,讓同義字只套用至包含特定資料來源的搜尋應用程式。
舉例來說,將下列程式碼行加入先前的程式碼範例,即可確保索引同義字是特定資料來源:
structuredData.put("_onlyApplicableForAttachedSearchApplications", true);