設定AEM Assets UI搜尋 id192SC800MY4
依預設,AEM不會識別DITA內容,因此不會提供任何機制來搜尋其存放庫中的DITA內容。 此外,也沒有OOTB功能可根據其UUID搜尋內容。 AEM Guides可讓您在AEM存放庫中新增DITA內容搜尋和UUID型搜尋功能。
要設定DITA內容搜尋,必須執行下列工作:
除了新增搜尋功能外,您也可以設定不應納入搜尋的資料夾。 如需詳細資訊,請參閱從搜尋結果中排除暫存檔。
在Assets UI中新增DITA元素搜尋元件 id192SF0F50HS
執行以下動作,在AEM Assets UI中新增DITA內容搜尋元件:
-
以管理員身分登入Adobe Experience Manager。
-
按一下頂端的 Adobe Experience Manager 連結,然後選擇 工具。
-
從工具清單中選取「一般」,然後按一下「搜尋Forms」圖磚。
-
在 搜尋Forms 清單中,選取 Assets管理搜尋邊欄。
-
按一下 編輯。
-
在 選取述詞 索引標籤中,捲動至清單結尾。
-
將 DITA元素述詞 拖放到搜尋表單中的必要位置。
-
按一下 完成 以儲存變更。
當您存取Assets UI中的篩選器選項時,將會取得DITA元素搜尋篩選選項。
在Assets UI中新增UUID型搜尋元件 id2034F04K05Z
執行以下步驟,在AEM Assets UI中新增UUID型搜尋元件:
-
以管理員身分登入Adobe Experience Manager。
-
按一下頂端的 Adobe Experience Manager 連結,然後選擇 工具。
-
從工具清單中選取「一般」,然後按一下「搜尋Forms」圖磚。
-
在 搜尋Forms 清單中,選取 Assets管理搜尋邊欄。
-
按一下 編輯。
-
在 選取述詞 索引標籤中,選擇 屬性述詞,並將其拖放到搜尋表單中的必要位置。
-
在 設定 標籤中,提供新加入之 屬性述詞 元件的下列詳細資料:
- 欄位標籤: UUID
- 屬性名稱: jcr:content/fmUuid
-
按一下 完成 以儲存變更。
當您存取Assets UI中的「篩選器」選項時,您將會取得以UIS為基礎的搜尋篩選選項。
提供許可權給使用者 id192SF0G0RUI
作者與發佈者必須獲得明確許可權,才能從Assets UI存取搜尋功能。 如果您不授予這些許可權,您的使用者將無法根據其元素/屬性值或UUID搜尋DITA內容。
執行下列步驟以提供對DITA搜尋功能的存取:
-
存取使用者和群組許可權頁面。
-
搜尋您要授予存取權的使用者群組或個別使用者。 例如,若要將存取權授與作者群組中的所有使用者,請在 篩選查詢 欄位中輸入作者,然後按 Enter。
-
選取 作者 群組。
-
在右窗格中,選取 許可權 標籤。
-
導覽至下列資料夾位置:
/conf/global/settings/dam/search
-
授與搜尋資料夾的 讀取 許可權。
-
按一下「儲存」。
選取的使用者或使用者群組現在可以存取Assets UI中的搜尋DITA內容功能。
在搜尋中新增自訂元素或屬性 id192SF0G10YK
為了讓DITA搜尋能夠運作,需要對DITA內容進行某些預先處理。 此預先處理步驟會從個別DITA map和主題中擷取選擇性內容,以便索引化內容以加快搜尋速度。 此程式在內部稱為 序列化。 DITA檔案的序列化會在內容上傳期間發生,也可以隨選執行。 它使用組態檔案來決定每個DITA檔案中應該索引多少內容。 序列化檔案的預設位置為:
/libs/fmdita/config/serializationconfig.xml
預設搜尋組態可讓您搜尋DITA prolog
元素內的所有元素和屬性。 如果您要根據其他元素或屬性進行搜尋,則需要設定搜尋序列化檔案。
prolog
元素內使用預設搜尋組態,則可以略過此程式。此檔案包含兩個主要區段 — 屬性集和規則集。 規則集區段的片段如下所示:
<ruleset filetypes="xml dita"><!-- Element rules --><rule xpath="//[contains(@class, 'topic/topic')]/[contains(@class, 'topic/prolog')]//*[not(*)]" text="yes" attributeset="all-attrs" /><!-- Attribute rules --><rule xpath="//[contains(@class, 'topic/topic')]/[contains(@class, 'topic/prolog')]///@[local-name() != 'class']" /></ruleset>
在規則集段落中,您可以指定:
-
擷取元素的規則
-
用於擷取屬性的規則
規則包含下列專案:
xpath
: 這是從DITA檔案擷取元素或屬性的XPath查詢。 元素規則的預設設定會擷取所有prolog
元素。 而且,屬性規則的預設設定會擷取prolog
元素的所有屬性。 您可以指定XPath查詢來序列化您要搜尋的元素或屬性。
XPath查詢包含檔案型別的類別名稱。 topic/topic
類別用於主題型別DITA檔案。 如果要為其他DITA檔案建立規則,則必須使用下列類別名稱:
文字
: 如果要搜尋指定元素內的文字,請指定yes值。 如果您指定no as值,則只會序列化元素內的屬性。 您要在屬性集區段中搜尋的屬性必須指定。
屬性集
: 指定您要與此規則關聯的屬性集ID。 all-attrs值是一個特殊的大小寫,表示此規則的所有屬性都必須序列化。
屬性集包含您要在DITA內容中搜尋的屬性清單。 屬性集包含下列專案:
id
: 屬性集的唯一識別碼。 這個ID是在規則集的屬性集引數中指定的。
屬性
: 您要搜尋的屬性清單。 對於每個屬性,您都需要在attribute
元素中建立個別專案。
執行以下步驟,在搜尋序列化檔案中新增自訂DITA元素或屬性:
-
使用封裝管理員來下載/libs/fmdita/config/serializationconfig.xml檔案。
-
在
apps
節點內建立config
資料夾的覆蓋節點。 -
導覽至
apps
節點中可用的組態檔:/apps/fmdita/config/serializationconfig.xml
-
新增必要的元素或屬性規則集。
-
提交變更並執行Cloud Manager (CI/CD)管道以部署設定變更。
新的序列化資訊會儲存並啟動以供搜尋。 不過,您必須從現有DITA內容中擷取中繼資料,才能供搜尋。
從現有內容擷取中繼資料 id192SF0GA0HT
在預設搜尋序列化檔案中進行任何變更後,您必須啟用 com.adobe.fmdita.config.ConfigManager 套件組合中的「DITA中繼資料擷取」選項,然後執行工作流程以擷取中繼資料。 這會從現有DITA檔案中擷取所需的中繼資料,然後可讓您搜尋相同的中繼資料。
如果您在更新序列化檔案之後建立新檔案或編輯任何檔案,則會自動從此類檔案中擷取中繼資料。 只有在AEM儲存庫中已經存在的檔案才需要解壓縮中繼資料的程式。
從現有DITA檔案擷取中繼資料涉及兩個工作:
- 在configMgr中啟用中繼資料擷取選項
- 執行中繼資料擷取工作流程
使用組態覆寫中提供的指示來建立組態檔。 在設定檔案中,提供下列(property)詳細資訊,以設定中繼資料擷取選項:
com.adobe.fmdita.config.ConfigManager
dita.serialization
預設值:
false
執行以下步驟以執行中繼資料擷取工作流程:
-
以管理員身分登入Adobe Experience Manager。
-
按一下頂端的 Adobe Experience Manager 連結,然後選擇 工具。
-
從工具清單中選取 參考線,然後按一下 DITA中繼資料擷取 圖磚。
-
如果您要從單一檔案及其相依性擷取中繼資料,請按一下 選取檔案 連結,並瀏覽檔案。
-
如果您要從資料夾內的多個檔案擷取中繼資料,請按一下 選取資料夾(s) 連結,瀏覽並選取所需的資料夾。 按一下 新增 按鈕,將資料夾新增至序列化工作清單。
note note NOTE 您可以選取多個資料夾並將其新增至序列化任務。 -
按一下 開始。
-
在[確認中繼資料擷取]對話方塊中,按一下[確定]。
從搜尋結果中排除暫存檔 id197AHI0035Z
依預設,會在整個AEM存放庫上執行搜尋。 可能有您想從搜尋中排除的一些位置。 例如,當您啟動內容翻譯工作流程時,未核准的檔案會保留在暫時的資料夾位置。 執行搜尋時,搜尋結果中也會傳回此暫存位置的檔案。
為了防止AEM Guides搜尋暫存翻譯資料夾位置,您需要在排除清單中新增暫存資料夾位置。
執行以下步驟,從搜尋中排除暫存翻譯資料夾:
-
在自訂damAssetLucene索引中新增以下屬性:
table 0-row-3 1-row-3 屬性名稱 類型 值 excludedPaths String[] 將下列值新增至此屬性: /content/dam/projects/translation\_output
-
導覽至下列位置提供的lucene節點:
/oak:index/lucene
-
在lucene節點中新增以下屬性:
table 0-row-3 1-row-3 屬性名稱 類型 值 excludedPaths String[] 將下列值新增至此屬性: /content/dam/projects/translation\_output