Search Essentials

概覽

搜尋功能是AEM Communities的必備功能。 除了AEM平台搜尋功能外，AEM Communities還提供UGC搜尋API，以搜尋使用者產生的內容(UGC)。 UGC在輸入時具有唯一屬性，並與其他AEM內容和使用者資料分開儲存。

對於「社群」，通常搜尋的兩項功能為：

• 社群成員張貼的內容

  • 使用AEM Communities的UGC搜尋API。

• 使用者和使用者群組（使用者資料）

  • 使用AEM平台搜尋功能。

說明檔案的本節內容對於建立建立或管理UGC的自訂元件的開發人員而言十分有用。

安全性和卷影節點

對於自訂元件，必須使用SocialResourceUtilities方法。 建立和搜索UGC的實用程式方法將建立所需的卷影節點，並確保成員具有正確的請求權限。

未通過SRP實用程式管理的是與協調相關的屬性。

有關用於訪問UGC和ACL卷影節點的實用方法的資訊，請參見SRP和UGC Essentials。

UGC搜尋API

UGC公共儲存由多種儲存資源提供器(SRP)之一提供，每個儲存資源提供器可能具有不同的本地查詢語言。 因此，無論選擇何種SRP，自訂代碼都應使用UGC API套件(com.adobe.cq.social.ugc.api)中的方法，這些方法將調用適合於所選SRP的查詢語言。

ASRP搜索

對於ASRP,UGC會儲存在Adobe雲端。 雖然UGC在CRX中不可見，但moderation可從作者和發佈環境使用。 使用UGC搜索API對ASRP的作用與對其他SRP的作用相同。

目前不存在用於管理ASRP搜索的工具。

建立可搜尋的自訂屬性時，必須符合命名要求。

MSRP搜尋

對於MSRP,UGC儲存在配置為使用Solr進行搜索的MongoDB中。 UGC在CRX中不會顯示，但moderation可從作者和發佈環境使用。

關於MSRP和Solr:

• AEM平台的內嵌Solr不會用於MSRP。
• 如果將遠端Solr用於AEM平台，則可能會與MSRP共用，但他們應使用不同的系列。
• Solr可設定為標準搜尋或多語言搜尋(MLS)。
• 有關配置詳細資訊，請參見Solr Configuration for MSRP。

自訂搜尋功能應使用UGC搜尋API。

建立可搜尋的自訂屬性時，必須符合命名要求。

JSRP搜索

對於JSRP,UGC會儲存在Oak中，且僅會顯示在輸入AEM作者的儲存庫或發佈例項中。

由於UGC通常是在發佈環境中輸入的，對於多發佈者生產系統，因此必須配置發佈叢集，而非發佈叢集，以便所有發佈者都能看到輸入的內容。

對於JSRP，在發佈環境中輸入的UGC在作者環境中將不可見。 因此，所有協調工作都會在發佈環境中進行。

自訂搜尋功能應使用UGC搜尋API。

Oak索引

雖然Oak索引不會自動為AEM平台搜尋建立，但是從AEM 6.2開始，已為AEM Communities新增這些索引，以改善效能並在呈現UGC搜尋結果時提供分頁支援。

如果自訂屬性正在使用中且搜尋速度緩慢，則需要為自訂屬性建立其他索引，以提高其效能。 若要維持可移植性，在建立可搜尋的自訂屬性時，請遵循命名需求。

要修改現有索引或建立自定義索引，請參閱Oak Queries and Indexing。

Oak Index Manager可從ACS AEM Commons取得。 它提供：

• 現有索引的視圖。
• 啟動重新索引的能力。

若要在CRXDE Lite中檢視現有的Oak索引，位置為：

• /oak:index/socialLucene

索引搜索屬性

預設搜索屬性

以下是用於各種「社群」功能的一些可搜尋屬性：

自訂屬性的命名

添加自定義屬性時，為了使這些屬性對使用UGC搜索API建立的排序和搜索可見，需要​**​為屬性名稱添加尾碼。

尾碼用於使用架構的查詢語言：

• 它會將屬性識別為可搜尋。
• 它識別資料類型。

Solr是使用架構的查詢語言的示例。

附註:

• Textis a token化字串， ** Stringis not.使用​Text​進行模糊搜尋（更類似此）。

• 對於多值類型，請在尾碼中添加「s」，例如：

  • viewDate_dt:單一日期屬性
  • viewDates_dts:dates屬性清單

濾鏡

包含注釋系統的元件支援將過濾器參數添加到其端點。

AND和OR邏輯的篩選語法如下所示（在進行URL編碼前顯示）:

• 若要指定OR，請使用一個具有逗號分隔值的篩選參數：

  • filter=name eq 'Jennifer',name eq 'Jen'

• 要指定AND，請使用多個篩選參數：

  • filter = name eq 'Jackson'&filter=message eq 'testing'

Search元件的預設實作會使用此語法，如Community Components指南中開啟「搜尋結果」頁面的URL所示。 若要實驗，請瀏覽至http://localhost:4503/content/community-components/en/search.html。

篩選運算子有：

URL必須參照Communities元件（資源），而非放置元件的頁面：

• 正確：論壇元件
  • /content/community-components/en/forum/jcr:content/content/forum.social.json
• 錯誤：論壇頁面
  • /content/community-components/en/forum.social.json

SRP工具

Adobe Marketing Cloud GitHub專案包含：

AEM Communities SRP工具

此儲存庫包含用於管理SRP中資料的工具。

目前，有一個Servlet可以從任何SRP中刪除所有UGC。

例如，若要刪除ASRP中的所有UGC:

curl -X POST http://localhost:4502/services/social/srp/cleanup?path=/content/usergenerated/asi/cloud -uadmin:admin

疑難排解

Solr查詢

若要協助疑難排解Solr查詢的問題，請啟用

com.adobe.cq.social.srp.impl.SocialSolrConnector。

實際的Solr查詢會顯示在偵錯記錄中編碼的URL:

對索爾的查詢是：sort=timestamp+desc&bl=en&pl=en&start=0&rows=10 &q=%2Btitle_t:(hello)+%2Bprovider_id:\/content/usergenerated/asi/mongo/content/+%2Bresource_type_s:&df=provider_id&trf=verbatim&fq={!cost%3D100}report_suite:mongo

q參數的值是查詢。 一旦解碼URL編碼，查詢就可以傳遞至Solr Admin Query工具，以進一步除錯。

相關資源

• 社群內容儲存 -討論UGC公用商店的可用SRP選擇。
• 儲存資源提供方概述 -簡介和儲存庫使用概述。
• 使用SRP -編碼准則存取UGC。
• SocialUtils重構 -取代SocialUtils之SRP的公用程式方法。
• 搜尋和搜尋結果元件 -將UGC搜尋功能新增至範本。