發行說明 | Adobe Experience Manager Guides 4.0.x
免責宣告：
Adobe Experience Manager Guides先前是以Adobe Experience Manager 的 XML Documentation為品牌。 請注意，檔案中的某些參考資料可能仍會參考先前的品牌，但仍適用於目前的產品。
此發行說明涵蓋Adobe Experience Manager Guides 4.0.x版（稍後稱為AEM Guides）的升級指示、新功能和增強功能。
4.0.3 |發行說明
相容性矩陣
本節列出AEM Guides 4.0.3版支援之軟體應用程式的相容性矩陣。
Adobe Experience Manager
- 6.5版Service Pack 12、10、11或9
如需詳細資訊，請參閱《安裝與組態指南》中的 技術需求 一節。
FrameMaker和FrameMaker Publishing Server
從FMPS 2020.2版開始，就支援XML Documentation解決方案中建立的基準線和條件。
氧氣聯結器
已修正的問題
以下列出各種區域中修正的錯誤：
- 氧氣在AEM中回覆檔案版本後，會簽出不正確版本的主題。 (9661)
- 還原檔案版本時，Assets UI中顯示錯誤的時間戳記差異。 (9662)
- 檔案會在還原成任何版本時自動簽出。 (9663)
- 如果語言代碼被提為fr-fr或en-us，則翻譯內容會損毀。 (9665)
- 在非UUID版本中，當目標語言程式碼包含5個字元（如fr_ca）時，核准的翻譯不會整合至目標語言。 (9666)
- 完成翻譯並啟用建立新版本後，影像的目標版本會顯示為jcr:root。 (9668)
- 使用基線完成翻譯時，會傳送錯誤的影像版本以供翻譯。 (9669)
4.0.2 |發行說明
相容性矩陣
本節列出AEM Guides 4.0.2版支援之軟體應用程式的相容性矩陣。
Adobe Experience Manager
- 6.5版Service Pack 12、10、11或9
如需詳細資訊，請參閱《安裝與組態指南》中的 技術需求 一節。
FrameMaker和FrameMaker Publishing Server
從FMPS 2020.2版開始，就支援XML Documentation解決方案中建立的基準線和條件。
氧氣聯結器
已修正的問題
以下列出各種區域中修正的錯誤：
- 在新建立的稽核檔案中，插入或刪除文字的位置不正確。 (9454)
- 在4.0.1升級之後，版本1.0在某些情況下不會列在 版本記錄 面板下。 (9441)
- 未針對1.0版下的目前版本顯示標籤和註解，在某些情況下未列在 版本記錄 面板下。 (9440)
- 在編輯器中開啟某些內容檔案時，編輯器會凍結。 (9433)
- 在存放庫面板中搜尋，在搜尋大型內容檔案時，topicref瀏覽對話方塊會凍結。 (9432)
- 從Web編輯器儲存一個檔案時，會為檔案建立兩個版本。 (9428)
- 無法在topicref中插入非DITA和Ditaval資產。 (9363)
- 編輯器在載入含有大量索引鍵的地圖預覽時擱置。 (9332)
- 使用FM update 4進行製作時，在來源檔案中移動資產時參照會中斷。 (9177)
已知問題
- 如果設定 為上傳的檔案建立新版本 開啟，則會在某些情況下間歇選擇 全部儲存 時建立新版本。
- 在Chrome瀏覽器上，資料夾設定檔底下的「刪除使用者」功能不會斷斷續續地運作。 因應措施：重新整理Chrome瀏覽器。
4.0.1 |發行說明
相容性矩陣
本節列出XML Documentation解決方案4.0.1版支援之軟體應用程式的相容性矩陣。
Adobe Experience Manager
- 6.5版Service Pack 12、11或10
- Java： 11
FrameMaker和FrameMaker Publishing Server
從FMPS 2020.2版開始，就支援XML Documentation解決方案中建立的基準線和條件。
氧氣聯結器
已修正的問題
以下列出各種區域中修正的錯誤：
- 新增/移除重複主題參照時，對映的參照樹會損毀。 (8922)
- 版本歷程記錄的 目前 版本區段中存在多個問題。 (8909)
- 使用 全選 並將多媒體檔案或DITA內容移至其他資料夾時，參照中斷。 (8897)
- 在Web編輯器中，插入交叉參照 > 檔案參照 > 搜尋檔案 > 篩選器 > 變更搜尋路徑對話方塊出現多個UI問題。 (8889)
- 在地圖編輯器(8983)上搜尋 topicref 和 ditavalref 的問題。
- 當您輸入時進行搜尋，會在「存放庫」檢視中造成不必要的搜尋請求。 (8982)
- 無法刪除資料夾設定檔中的管理員使用者。 (8926)
- 參考使用註腳不會捲動至AEM網站輸出中的註腳區段。 (9061)
- 無法將更新的文章發佈至Salesforce。 (9008)
- 並排檢視中的反白位置不正確。 (9009)
- 無法在DITA主題上拖放條件。 (9031)
- 無法在資料夾設定檔中覆寫css_layout.css。 (9032)
- 上傳後檢視資產時收到例外狀況。 (9068)
- 在XML編輯器中允許的自訂特殊字元無法正常運作。 (9075)
- 在翻譯工作流程中，系統會為已翻譯資產建立其他版本。 (9107)
- 以其他主題中的影像 conref 作為主題進行基準發佈，該影像不會顯示在輸出中。 (9172)
- 使用下載地圖API時，不會清除臨時目錄，以防下載失敗。 (9176)
- 水準對齊方式不適用於4.0版的表格。 (9207)
- glossref的索引鍵屬性未顯示，因此無法透過插入參照插入縮寫表單。 (9213)
- 建立 keydef 只允許在4.0中選擇連結。 (9214)
- 插入Key Definition/keyref功能在4.0中的行為與3.8.10不同。 (9215)
- 修正3.8.6至3.8.10版中出現的Web Editor問題。 (9219)
- 在索引標籤的標題中使用任何關鍵字時會發生問題。 (9317)
- Source檢視針對非條件屬性顯示多個錯誤。 (9278)
- 選取路徑的瀏覽對話方塊中出現問題。 (9289)
4.0 |發行說明
相容性矩陣
本節列出XML Documentation解決方案4.0版支援之軟體應用程式的相容性矩陣。
Adobe Experience Manager
- 6.5版Service Pack 11、10或9
FrameMaker和FrameMaker Publishing Server
從FMPS 2020.2版開始，就支援XML Documentation解決方案中建立的基準線和條件。
氧氣聯結器
新功能和增強功能
文章式發佈
在4.0版中，我們引進了整合在網頁編輯器中的文章式發佈功能。 您可以使用以文章為基礎的發佈功能，以增量方式產生一或多個主題的輸出，或將您的內容發佈到知識庫平台。
此功能可讓使用者以累加方式建置DITA map，並在準備好時發佈主題。 發佈地圖後，請使用文章式發佈功能，僅對更新的文章實現增量發佈。
除了AEM之外，您也可以使用此獨特功能，將文章發佈至任何知識庫入口網站，例如Salesforce。 此功能也隨附OOTB內容範本（以AEM核心元件為基礎），讓您建立技術內容的知識型存放庫。 此範本的優點在於其可完全自訂，以符合您的組織需求，並且可支援企業內部網路入口網站等使用案例。
這種按需文章發佈功能不僅可讓您完全控制內容發佈，還可縮短發布更新內容的整體時間。
如需詳細資訊，請參閱使用手冊中的 從網頁編輯器 發行文章式內容。
已改良的網頁編輯器
網頁編輯器中引進了許多增強功能和新功能：
-
將核心架構從Coral型UI變更為頻譜型UI。 這可提供非常標準化和直覺式的UI。
-
右側面板中引入了新的「檔案屬性」功能。 您可以檢查使用中檔案的屬性。 此資訊分為兩個區段：
-
一般：包含一般檔案詳細資訊，例如，檔案名稱、UUID、中繼資料標籤、語言、建立日期、取出狀態以及檔案狀態。
-
參考：包含傳入和傳出的參考。
-
-
網頁編輯器中也新增了主旨配置的支援。 您現在可以使用「主題配置」面板來建立和使用主題配置。 除了主旨配置之外，您現在可以使用自己的公司中繼資料和分類法。
-
此版本已引入新的辭彙表熱點工具，以大量管理辭彙表。 使用此工具，您可以針對選取的地圖或開啟的主題，快速將文字轉換為字彙表，並將字彙表轉換為辭彙。
-
在可重複使用的內容面板中新增重新整理功能，可讓您快速重新整理參考檔案中的可重複使用內容。
-
新的檔案更新指示器會顯示您目前的檔案（工作復本）是否與儲存的版本同步。
-
加強「存放庫面板」和檔案瀏覽對話方塊中的搜尋篩選器，以提供更多可進一步自訂的篩選選項。
-
您現在可以從網頁編輯器上傳.docx檔案。
-
使用者偏好設定現在會儲存在使用者設定檔中，而非瀏覽器的Cookie中。 這可協助使用者保留其在各瀏覽器或使用者工作階段中的偏好設定。
新增翻譯儀表板
網頁編輯器中引進了新的翻譯控制面板，其功能如下：
- 排序、搜尋和篩選主題清單。
- 依參照型別篩選內容 — 直接或間接參照。
- 輕鬆導覽，在起始翻譯請求時尋找現有專案。
- 引入多語言翻譯機制，以避免在針對多種語言啟動翻譯請求時為每個語言建立多個專案。
- 引入隱藏地圖儀表板中翻譯索引標籤的設定。 依預設，它是可見的。 您可以選擇使用地圖儀表板或網頁編輯器來翻譯內容。
增強型發佈
發佈程式中現在提供下列增強功能：
-
透過FrameMaker Publishing Server產生的PDF現在支援基準和條件預設集。
-
作者現在可以將地圖和主題層級中繼資料傳遞至DITA-OT發佈。 當自訂PDF範本設計為使用檔案中繼資料屬性（如標籤、作者、檔案狀態等）時，這項功能會很有幫助。
-
在configMgr中已新增設定，以在AEM網站輸出產生中使用 刪除並建立 選項時，允許使用者保留或刪除正在刪除的主題版本。
改善檔案處理
在AEM Assets中處理檔案時，現在可以看到下列改善專案：
-
引入新的檔案上傳體驗和選擇衝突解決策略的新對話方塊。
-
可建立已上傳檔案的新版本，並防止覆寫已簽出的檔案。
-
現在您可以直接從「版本記錄」檢視中檢視影像預覽。 此外，對於DITA和非DITA檔案，「版本記錄」會個別顯示目前的版本資訊。
新的報告匯出功能
報告對於識別內容的健康情況非常有用。 XML Documentation解決方案提供各種報表，讓您控制內容。 現在，您不僅可以檢視報表，還可以將報表資料匯出為CSV檔案，以便檢視並與更廣大的團隊分享。 報表資料可讓您快速瀏覽任何中斷的連結或遺失的影像。
改善氧氣DAM重新整理體驗
當您從Oxyor中的AEM伺服器重新整理檔案時，如果您在目前的Oxyor工作階段中有未儲存的檔案，系統會顯示警告訊息。 您可以選擇取消重新整理作業以儲存任何未儲存的檔案。 若沒有此功能，使用者會遺失其檔案中的任何未儲存資訊。
其他功能增強功能
- 根據AEM的最佳實務，應用程式資料現已從/content/fmdita、/etc/fmdita/及/content/dxml/移轉至更新的位置。
- 已重新引入DAM資產更新工作流程，提供更好的處理和最佳化效能，以與XML後處理工作流程一起執行。
- XML Documentation API套件現在可在公開存取的Maven存放庫中取得。
- 您現在可以在/apps/projects/templates路徑下建立新的Dita專案範本。
- 現在從您的資料夾設定檔下載預設的ui_config.json檔案。 這可用於在升級時合併現有ui_config.json檔案中的自訂變更。
已修正的問題
以下列出各種區域中修正的錯誤：
網頁編輯器
- conref即使未破損，也會以紅色顯示。 (8239)
- 在DITAVAL編輯器中選取 新增所有屬性 時，不會自動填入條件屬性的值。 (8234)
- 作者無法使用相對路徑在主題中插入影像。 (8112)
- 在表格儲存格中新增的Ph conref會以紅色顯示。 (8083)
- 若是以UUID為基礎的系統，當移動檢閱中的檔案時，檢閱任務中的連結不會更新。 (8080)
- 網頁編輯器無法正確轉譯縮放屬性設定為75%或更高的影像。 (8073)
- GIF影像會在網頁編輯器中呈現為靜態影像。 (8024)
- 註釋元素中的conkeyref不會顯示在Web編輯器預覽或輸出中。 (8006)
- 在編輯器中不會解析本身為conref的元素的xref。 (7933)
- 含有索引鍵的標題在編輯器預覽和存放庫面板中無法正確呈現。 (7909)
- 含有特殊字元的程式碼片段無法正確儲存。 (7908)
- 即使發生JS驗證問題，仍會將POST要求傳送至伺服器。 (7989)
- 在格式化MathML方程式後儲存主題會導致錯誤。 (7954)
- 在編輯器中無法正確轉譯™的keydef，且AEM網站輸出包含重複的TM符號。 (7859)
- 拖放程式碼片段無法依照DTD運作。 (7758)
- HTML略過圖形的自訂已定義尺寸。 (7718)
- 移動來源檔案時，conrefred屬性不會更新。 (7698)
- 使用參考主題型別檔案會導致幾個UI問題。 (7656)
- 當作者在對應中新增ditavalref時，DITAVAL檔案不會顯示。 (7594)
- 將outputclass屬性新增到
<tgroup>元素時，在每一個空白<entry>元素中找到未預期的空間。 (7532) - Source按鈕無法用於透過地圖儀表板開啟的主題。 (7465)
- 美化列印會插入空白行與空格，在FrameMaker或Oxygon中開啟檔案時即可看到這些行與空格。 (7408)
- 任何主題中具有href="/"的地圖都不會發佈在AEM網站上(7405)
- 根對映包含大量索引鍵時，在編輯器中發現效能問題。 (7400)
- 含有自訂範本之對應的檔案狀態不會從其對應的狀態設定檔繼承。 (7359)
<tm>元素未正確呈現為區塊元素。 (7286)- 建立新範本時，編輯器範本面板中會顯示重複的範本。 (5814)
- ui_config中為影像定義用於設定其他屬性的範本不適用於拖放情況。 (5713)
- menucascade中uicontrol的預設外觀不正確。 (5483)
- 主題/地圖的自訂範本不會在UI中顯示新名稱。 它會將名稱顯示為「Topic」/「Map」，而非顯示設定的名稱(4958)
氧氣聯結器
- 上層資料夾中含有特殊字元的檔案，在Oxyor中載入時會發生錯誤。 (8054)
- 新建立的檔案在Oxyor中開啟時會擲回「找不到GUID」錯誤。 (7856)
- 使用「在氧中編輯」從AEM中籤出檔案後，簽入選項會停用。 (7471)
檢閱
- 從AEM收件匣重新指派稽核任務時，受指派人無法檢視與任務相關聯的裝載。 (8003)
- 如果檔案名稱有空格，則「稽核任務」頁面不會顯示（多媒體）檔案的內容。 (8111)
地圖儀表板
- 在地圖控制面板的主題或報告標籤的主題標題中無法看到conref內容。 (8263)
- AEM Sites輸出 |更新DITA主題標題時，產生的網站頁面的jcr:title未更新。 (8131)
- 下載MAP不會下載主題內使用的視訊檔案。 (8070)
- 如果bookmap在不同的資料夾中有2個同名主題，則平面階層的AEM bookmap下載會失敗。 如果有名稱相同但大小寫不同的檔案，則會視為重複的檔案。 (8058)
- 透過下載bookmap API使用物件標籤時，不會下載媒體檔案。 (8057)
- 如果任何主題的conref檔案的標題以conref開頭，則「報告」標籤中會顯示不正確的報告。 (4698)
發佈
- 選取「啟用版本設定」時，PDF建立首次失敗。 (8053, 8294)
- 如果是非UUID內容，AEM網站輸出中不會顯示conref影像。 (7907)
- AEM網站輸出中的’tm；標籤後會自動新增空白字元。 (7964)
- 無法在AEM網站輸出中檢視YouTube影片。 (7401)
- 使用者按一下瀏覽地圖控制面板基線標籤中的所有主題後，參照內容的標籤篩選失敗。 (7388)
- 含有屬性值SM或reg之元素
<tm>的發佈主題在產生的輸出中顯示不正確。 (7239) - 使用影像進行基準線發佈時，不會在發佈的輸出中挑選影像的最新版本。 (7231)
- 「基準線」標籤中會顯示可關聯的參考主題。 (5424)
- 標題中包含conkeyref之主題的增量發佈無法如預期運作。 (4474)
- 即使已勾選該設定，頁面標題也不會用於產生輸出URL。 (8257)
- 基準線發佈，挑選目前版本的影像，而非凍結節點。 如果影像的檔案名稱中有空格或特殊字元，也會顯示此訊息。 (8274, 8322)
- DITA map的增量發佈失敗，其型別主旨配置具有mapref。 (8218)
AEM Assets
- 對Assets UI中設定的大量內容執行選擇/刪除時發現效能問題。 (8238)
- 如果將DITA述詞新增至搜尋篩選器，儲存的搜尋功能（智慧型集合）會中斷。 (8048)
- 將影像回覆成較舊版本無法運作。 (DXML-7903)
- 沒有刪除許可權的作者也可看到刪除選項。 (7322)
- Assets編輯器的CCMS覆蓋會中斷刪除選項的呈現。 (8093)
內容匯入
- HTML至DITA轉換 |含有空白’td’專案之’tr’的表格會在輸出中產生其他列。 (8132)
- HTML至DITA轉換 | HTML有一個表格包含多個主體，但發生例外狀況時失敗。 (7940)
- HTML至DITA轉換 |如果來源HTML有註解，則會傳回錯誤。 (7937)
- 匯入DITA 1.3 DITA檔案會導致某些href轉換成格式錯誤的連結。 (8019)
其他
- 在「版本記錄」檢視中，影像縮圖遺失或損毀。 (7948, 8008)
- zipMapWithDependents API在內容中有錯誤參考時不會提供相關資訊。 (7521)
- 對於UUID客戶，預設設定值對於少數設定已變更，例如用於識別UUID檔案的規則運算式、使用頁面標題來產生輸出等等。 (8301, 8305)
升級指示 upgrade-instructions
您可以輕鬆地將您目前的AEM Guides版本升級至4.0.3版。 在繼續升級至AEM Guides 4.0.3版之前，您必須先考量下列幾點：
- 如果您是使用4.0.2版，則可以直接升級至4.0.3版。 您必須先升級至4.0.2版才能升級至4.0.3。
- 如果您是使用4.0版，則可以直接升級至4.0.2版。
- 如果您是使用4.0.1版，則必須解除安裝該版本。
- 如果您是使用3.8.5版，則必須先升級至4.0版，才能升級至4.0.2版。
- 如果您使用的版本早於3.8.5，請參閱產品特定安裝指南中的升級一節。
如需詳細資訊，請參閱升級指示。