升級Adobe Experience Manager Guides id224MBE0M0XA

只有在升級步驟成功時才安裝4.0版。

從Adobe軟體發佈入口網站下載4.0版套件：

• 如果您使用UUID版本的軟體，請搜尋「適用於AEM 6.5的XML Documentation解決方案的4.0 UUID版本」。
• 如果您使用非UUID版本的軟體，請搜尋「適用於AEM 6.5的XML Documentation解決方案的4.0非UUID版本」。
  使用CRX Package Manager將套件上傳到現有的AEM伺服器執行個體並進行安裝。

安裝套件後清除瀏覽器快取。

如果在AEM Author例項上設定Dispatcher，請執行以下步驟：

• 請確定下列專案已在Dispatcher規則中處理：
• URL模式/home/users/*/preferences已加入白名單。
• 不會快取URL模式/libs/cq/security/userinfo.json 。

清除Dispatcher快取\（以清除任何clientlibs快取\）。

從Adobe軟體發佈入口網站下載4.2版本的套件。

安裝4.2版本的套件。

完成套件安裝後，請等候記錄中的下列訊息：

Completed the post deployment setup script

上述訊息表示安裝的所有步驟均已完成。

如果您遇到以下任何錯誤首碼，請向您的客戶成功團隊報告：

• 部署後安裝指令碼發生錯誤
• 移植翻譯MAP時發生例外狀況
• 無法將屬性的轉譯對應從v1連線至v2

升級氧氣聯結器外掛程式，隨版本4.2發行\（如有需要\）。

安裝套件後清除瀏覽器快取。

繼續升級自訂，如下一節所述。

DAM更新資產工作流程\（後續處理變更\）：

開啟URL：

http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

選取​ DAM更新資產工作流程。

按一下​ 編輯。

如果​ DXML後續程式啟動器 ​元件存在，請確定自訂已同步。

如果​ DXML後續處理啟動器 ​元件不存在，請執行下列步驟以插入它：

按一下「插入元件」(負責Experience Manager Guides後續處理，作為程式的最後一個步驟)。

使用下列詳細資料設定​ 處理序步驟：

一般標籤

標題： DXML後續程式發起人

描述： DXML後續處理啟動器步驟將觸發已修改/建立的資產的DXML後續處理的Sling工作

處理標籤

• 從​ 程式 ​下拉式清單中選取​ DXML程式後啟動器

• 選取​ 處理常式進階

• 選取​ 完成

完成變更後，請按一下右上角的​ 同步。 您將會收到成功通知。

驗證​ DAM更新資產工作流程 ​後，請檢查對應的啟動器設定。 若要這麼做，請前往AEM Workflow介面並開啟啟動器。

http://localhost:4502/libs/cq/workflow/content/console.html

尋找下列兩個啟動器\（若有需要\）並進行變更\（應該為作用中\），其對應至​ DAM更新資產工作流程：

已針對​ DAM更新資產工作流程 ​建立「節點」的啟動器 — 對於條件"jcr:content/jcr:mimeType!=video"，「萬用字元」值應為：

/content/dam(/((?!/subassets|/translation_output).)*/)renditions/original

• 'excludeList'應該有"event-user-data:changedByWorkflowProcess"。
• 已針對​ DAM更新資產工作流程 — （適用於條件"jcr:content/jcr:mimeType!=video"）修改​ 節點 ​的啟動器，
• 「萬用字元」值應為：

/content/dam(/((?!/subassets|/translation_output).)*/)renditions/original

• 'excludeList'應該有"event-user-data:changedByWorkflowProcess"。

升級完成後，請確定所有自訂/覆蓋圖均已驗證並更新，以符合新的應用程式程式碼。 以下提供一些範例：

• 從/libs/fmditor/libsis覆寫的任何元件都應與新的產品程式碼進行比較，且更新應在/apps下方的覆寫檔案中完成。
• 產品中使用的任何clientlib類別都應檢閱是否有變更。 任何覆寫的設定\（範例如下\）都應與最新的設定進行比較，以取得最新的功能：
• elementmapping.xml
• ui_config.json\（可能已在資料夾設定檔中設定\）
• 已修改com.adobe.fmdita.config.ConfigManager
• 檢查是否有任何自訂程式碼使用任何舊路徑\（如移轉對應區段中所述\） — 應更新為新路徑，讓自訂功能也能如預期運作。

閱讀最新版本中的任何新設定\（請參閱發行說明\），檢視是否有任何功能受到影響，然後採取適當的動作。 例如使用4.0版中引進的「改善檔案和版本處理」，您需要為此啟用設定。

在damAssetLucene Oak索引中，將布林值屬性indexNodeName新增為節點中的true。
/oak:index/damAssetLucene/indexRules/dam:Asset

在節點底下新增名稱為excert的新節點。

/oak:index/damAssetLucene/indexRules/dam:Asset/properties
並在節點中設定下列屬性：

name - rep:excerpt
propertyIndex - {Boolean}true
notNullCheckEnabled - {Boolean}true

damAssetLucene的結構應該類似於：

<damAssetLucene compatVersion="{Long}2" async="async, nrt" jcr:primaryType="oak:QueryIndexDefinition" evaluatePathRestrictions="{Boolean}true" type="lucene">
<indexRules jcr:primaryType="nt:unstructured">
  <dam:Asset indexNodeName="{Boolean}true" jcr:primaryType="nt:unstructured">
    <properties jcr:primaryType="nt:unstructured">
      <excerpt name="rep:excerpt" propertyIndex="{Boolean}true" jcr:primaryType="nt:unstructured" notNullCheckEnabled="{Boolean}true"/>
    </properties>
    </dam:Asset>
  </indexRules>
</damAssetLucene>

（以及其他現有節點和屬性）

重新索引damAssetLucene索引(透過將重新索引旗標設定為true，在
並等待它重新false （這表示重新索引已完成）。 請注意，視索引大小而定，這可能需要幾個小時。

執行先前的步驟，再次執行索引指令碼。

從Adobe軟體發佈入口網站下載4.2.1版本的套件。

安裝4.2.1版本的套件。

您可以選擇點選觸發器，以啟動翻譯對應升級工作。 如需詳細資訊，請參閱透過Servlet啟用指令碼的觸發程式。

完成套件安裝後，請等候記錄中的下列訊息：

Completed the post deployment setup script

上述訊息表示安裝的所有步驟均已完成。

如果您遇到以下任何錯誤首碼，請向您的客戶成功團隊報告：

• 部署後安裝指令碼發生錯誤
• 移植翻譯MAP時發生例外狀況
• 無法將屬性的轉譯對應從v1連線至v2

升級氧氣聯結器外掛程式，隨版本4.2發行\（如有需要\）。

安裝套件後清除瀏覽器快取。

繼續升級自訂，如下一節所述。

DAM更新資產工作流程\（後續處理變更\）：

開啟URL：

http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

選取​ DAM更新資產工作流程。

按一下​ 編輯。

如果​ DXML後續程式啟動器 ​元件存在，請確定自訂已同步。

如果​ DXML後續處理啟動器 ​元件不存在，請執行下列步驟以插入它：

按一下「插入元件」(負責Experience Manager Guides後續處理，作為程式的最後一個步驟)。

使用下列詳細資料設定​ 處理序步驟：

一般標籤

標題： DXML後續程式發起人

描述： DXML後續處理啟動器步驟將觸發已修改/建立的資產的DXML後續處理的Sling工作

處理標籤

• 從​ 程式 ​下拉式清單中選取​ DXML程式後啟動器

• 選取​ 處理常式進階

• 選取​ 完成

完成變更後，請按一下右上角的​ 同步。 您將會收到成功通知。

驗證​ DAM更新資產工作流程 ​後，請檢查對應的啟動器設定。 若要這麼做，請前往AEM Workflow介面並開啟啟動器。

http://localhost:4502/libs/cq/workflow/content/console.html

尋找下列兩個啟動器\（若有需要\）並進行變更\（應該為作用中\），其對應至​ DAM更新資產工作流程：

已針對​ DAM更新資產工作流程 ​建立「節點」的啟動器 — 對於條件"jcr:content/jcr:mimeType!=video"，「萬用字元」值應為：

/content/dam(/((?!/subassets|/translation_output).)*/)renditions/original

• 'excludeList'應該有"event-user-data:changedByWorkflowProcess"。
• 針對​ DAM更新資產工作流程 — ​的「節點已修改」的啟動器（條件「jcr:content/jcr:mimeType!=video」），「萬用字元」值應為：

/content/dam(/((?!/subassets|/translation_output).)*/)renditions/original

• excludeList應該有"event-user-data:changedByWorkflowProcess"。

升級完成後，請確定所有自訂/覆蓋圖均已驗證並更新，以符合新的應用程式程式碼。 以下提供一些範例：

• 從/libs/fmditor/libsis覆寫的任何元件都應與新的產品程式碼進行比較，且更新應在/apps下方的覆寫檔案中完成。
• 產品中使用的任何clientlib類別都應檢閱是否有變更。 任何覆寫的設定\（範例如下\）都應與最新的設定進行比較，以取得最新的功能：
• elementmapping.xml
• ui_config.json\（可能已在資料夾設定檔中設定\）
• 已修改com.adobe.fmdita.config.ConfigManager
• 檢查是否有任何自訂程式碼使用任何舊路徑\（如移轉對應區段中所述\） — 應更新為新路徑，讓自訂功能也能如預期運作。

閱讀最新版本中的任何新設定\（請參閱發行說明\），檢視是否有任何功能受到影響，然後採取適當的動作。 例如使用4.0版中引進的「改善檔案和版本處理」，您需要為此啟用設定。

（選擇性）如果系統中有超過100,000個dita檔案，請將org.apache.jackrabbit.oak.query.QueryEngineSettingsService下的queryLimitReads更新為較大的值（任何大於現有資產數的值，例如200,000），然後重新部署。

執行下列API以對所有檔案執行後續處理：

如果您在步驟1中變更了queryLimitReads的值，請恢復為預設值或先前的現有值。

從Adobe軟體發佈入口網站下載4.3.1版本的套件。

安裝4.3.1版本的套件。

您可以選擇點選觸發器，以啟動翻譯對應升級工作。 如需詳細資訊，請參閱透過Servlet啟用指令碼的觸發程式。

完成套件安裝後，請等候記錄中的下列訊息：

Completed the post deployment setup script

上述訊息表示安裝的所有步驟均已完成。

如果您遇到以下任何錯誤首碼，請向您的客戶成功團隊報告：

• 部署後安裝指令碼發生錯誤
• 移植翻譯MAP時發生例外狀況
• 無法將屬性的轉譯對應從v1連線至v2

升級氧氣聯結器外掛程式，隨版本4.2發行\（如有需要\）。

安裝套件後清除瀏覽器快取。

繼續升級自訂，如下一節所述。

DAM更新資產工作流程\（後續處理變更\）：

開啟URL：

http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

選取​ DAM更新資產工作流程。

按一下​ 編輯。

如果​ DXML後續程式啟動器 ​元件存在，請確定自訂已同步。

如果​ DXML後續處理啟動器 ​元件不存在，請執行下列步驟以插入它：

按一下「插入元件」(負責Experience Manager Guides後續處理，作為程式的最後一個步驟)。

使用下列詳細資料設定​ 處理序步驟：

一般標籤

標題： DXML後續程式發起人

描述： DXML後續處理啟動器步驟將觸發已修改/建立的資產的DXML後續處理的Sling工作

處理標籤

• 從​ 程式 ​下拉式清單中選取​ DXML程式後啟動器

• 選取​ 處理常式進階

• 選取​ 完成

完成變更後，請按一下右上角的​ 同步。 您將會收到成功通知。

驗證​ DAM更新資產工作流程 ​後，請檢查對應的啟動器設定。 若要這麼做，請前往AEM Workflow介面並開啟啟動器。

http://localhost:4502/libs/cq/workflow/content/console.html

尋找下列兩個啟動器\（若有需要\）並進行變更\（應該為作用中\），其對應至​ DAM更新資產工作流程：

已針對​ DAM更新資產工作流程 ​建立「節點」的啟動器 — 對於條件"jcr:content/jcr:mimeType!=video"，「萬用字元」值應為：

/content/dam(/((?!/subassets|/translation_output).)*/)renditions/original

• 'excludeList'應該有"event-user-data:changedByWorkflowProcess"。
• 針對​ DAM更新資產工作流程 — ​的「節點已修改」的啟動器（條件「jcr:content/jcr:mimeType!=video」），「萬用字元」值應為：

/content/dam(/((?!/subassets|/translation_output).)*/)renditions/original

• excludeList應該有"event-user-data:changedByWorkflowProcess"。

升級完成後，請確定所有自訂/覆蓋圖均已驗證並更新，以符合新的應用程式程式碼。 以下提供一些範例：

• 從/libs/fmditor/libsis覆寫的任何元件都應與新的產品程式碼進行比較，且更新應在/apps下方的覆寫檔案中完成。
• 產品中使用的任何clientlib類別都應檢閱是否有變更。 任何覆寫的設定\（範例如下\）都應與最新的設定進行比較，以取得最新的功能：
• elementmapping.xml
• ui_config.json\（可能已在資料夾設定檔中設定\）
• 已修改com.adobe.fmdita.config.ConfigManager

（選擇性）如果系統中有超過100,000個dita檔案，請將org.apache.jackrabbit.oak.query.QueryEngineSettingsService下的queryLimitReads更新為較大的值（任何大於現有資產數的值，例如200,000），然後重新部署。

執行下列API以對所有檔案執行後續處理：

如果您在步驟1中變更了queryLimitReads的值，請恢復為預設值或先前的現有值。

從Adobe軟體發佈入口網站下載4.3.1.5版本的套件。

安裝4.3.1.5版本的套件。

請等候安裝程式順利完成。

繼續升級自訂，如下一節所述。

升級完成後，請確定所有自訂/覆蓋圖均已驗證並更新，以符合新的應用程式程式碼。 以下提供一些範例：

• 任何從/libs/fmdita或 /libs覆寫的元件都應與新的產品程式碼進行比較，且更新應在/apps下的覆寫檔案中完成。
• 產品中使用的任何clientlib類別都應檢閱是否有變更。 任何覆寫的設定\（範例如下\）都應與最新的設定進行比較，以取得最新的功能：
• elementmapping.xml
• ui\_config.json\ （可能已在資料夾設定檔中設定\）
• 已修改com.adobe.fmdita.config.ConfigManager

從Adobe軟體發佈入口網站下載4.4.0版本的套件。

安裝4.4.0版本的套件。

您可以選擇點選觸發器，以啟動翻譯對應升級工作。 如需詳細資訊，請參閱透過Servlet啟用指令碼的觸發程式。

完成套件安裝後，請等候記錄中的下列訊息：

Completed the post deployment setup script

上述訊息表示安裝的所有步驟均已完成。

如果您遇到以下任何錯誤首碼，請向您的客戶成功團隊報告：

• 部署後安裝指令碼發生錯誤
• 移植翻譯MAP時發生例外狀況
• 無法將屬性的轉譯對應從v1連線至v2

升級氧氣聯結器外掛程式4.4.0版\（如有需要\）。

安裝套件後清除瀏覽器快取。

繼續升級自訂，如下一節所述。

DAM更新資產工作流程\（後續處理變更\）：

開啟URL：

http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

選取​ DAM更新資產工作流程。

按一下​ 編輯。

如果​ DXML後續程式啟動器 ​元件存在，請確定自訂已同步。

如果​ DXML後續處理啟動器 ​元件不存在，請執行下列步驟以插入它：

按一下「插入元件」(負責Experience Manager Guides後續處理，作為程式的最後一個步驟)。

使用下列詳細資料設定​ 處理序步驟：

一般標籤

標題： DXML後續程式發起人

描述： DXML後續處理啟動器步驟將觸發已修改/建立的資產的DXML後續處理的Sling工作

處理標籤

• 從​ 程式 ​下拉式清單中選取​ DXML程式後啟動器

• 選取​ 處理常式進階

• 選取​ 完成

完成變更後，請按一下右上角的​ 同步。 您將會收到成功通知。

驗證​ DAM更新資產工作流程 ​後，請檢查對應的啟動器設定。 若要這麼做，請前往AEM Workflow介面並開啟啟動器。

http://localhost:4502/libs/cq/workflow/content/console.html

尋找下列兩個啟動器\（若有需要\）並進行變更\（應該為作用中\），其對應至​ DAM更新資產工作流程：

已針對​ DAM更新資產工作流程 ​建立「節點」的啟動器 — 對於條件"jcr:content/jcr:mimeType!=video"，「萬用字元」值應為：

/content/dam(/((?!/subassets|/translation_output).)*/)renditions/original

• 'excludeList'應該有"event-user-data:changedByWorkflowProcess"。
• 針對​ DAM更新資產工作流程 — ​的「節點已修改」的啟動器（條件「jcr:content/jcr:mimeType!=video」），「萬用字元」值應為：

/content/dam(/((?!/subassets|/translation_output).)*/)renditions/original

• excludeList應該有"event-user-data:changedByWorkflowProcess"。

升級完成後，請確定所有自訂/覆蓋圖均已驗證並更新，以符合新的應用程式程式碼。 以下提供一些範例：

• 從/libs/fmditor/libsis覆寫的任何元件都應與新的產品程式碼進行比較，且更新應在/apps下方的覆寫檔案中完成。
• 產品中使用的任何clientlib類別都應檢閱是否有變更。 任何覆寫的設定\（範例如下\）都應與最新的設定進行比較，以取得最新的功能：
• elementmapping.xml
• ui_config.json\（可能已在資料夾設定檔中設定\）
• 已修改com.adobe.fmdita.config.ConfigManager

如果您已在damAssetLucene中新增任何自訂，您可能需要再次套用它們。 進行這些變更後，將重新索引設定為true。 這會使用自訂重新索引所有現有節點。 完成後，重新索引標幟將再次設定為false。 視系統中的資產數量而定，這可能需要幾個小時的時間。

（選擇性）如果系統中有超過100,000個dita檔案，請將org.apache.jackrabbit.oak.query.QueryEngineSettingsService下的queryLimitReads更新為較大的值（任何大於現有資產數的值，例如200,000），然後重新部署。

執行下列API以對所有檔案執行後續處理：

如果您在步驟1中變更了queryLimitReads的值，請恢復為預設值或先前的現有值。

從Adobe軟體發佈入口網站下載4.6.0版本的套件。

安裝4.6.0版本的套件。

您可以選擇點選觸發器，以啟動翻譯對應升級工作。 如需詳細資訊，請參閱透過Servlet啟用指令碼的觸發程式。

完成套件安裝後，請等候記錄中的下列訊息：

Completed the post deployment setup script

上述訊息表示安裝的所有步驟均已完成。

如果您遇到以下任何錯誤首碼，請向您的客戶成功團隊報告：

• 部署後安裝指令碼發生錯誤
• 移植翻譯MAP時發生例外狀況
• 無法將屬性的轉譯對應從v1連線至v2

升級氧氣聯結器外掛程式4.6.0版\（如有需要\）。

安裝套件後清除瀏覽器快取。

DAM更新資產工作流程\（後續處理變更\）：

開啟URL：

http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

選取​ DAM更新資產工作流程。

按一下​ 編輯。

如果​ DXML後續程式啟動器 ​元件存在，請確定自訂已同步。

如果​ DXML後續處理啟動器 ​元件不存在，請執行下列步驟以插入它：

按一下「插入元件」(負責Experience Manager Guides後續處理，作為程式的最後一個步驟)。

使用下列詳細資料設定​ 處理序步驟：

一般標籤

標題： DXML後續程式發起人

描述： DXML後續處理啟動器步驟將觸發已修改/建立的資產的DXML後續處理的Sling工作

處理標籤

• 從​ 程式 ​下拉式清單中選取​ DXML程式後啟動器

• 選取​ 處理常式進階

• 選取​ 完成

完成變更後，請按一下右上角的​ 同步。 您將會收到成功通知。

驗證​ DAM更新資產工作流程 ​後，請檢查對應的啟動器設定。 若要這麼做，請前往AEM Workflow介面並開啟啟動器。

http://localhost:4502/libs/cq/workflow/content/console.html

尋找下列兩個啟動器\（若有需要\）並進行變更\（應該為作用中\），其對應至​ DAM更新資產工作流程：

已針對​ DAM更新資產工作流程 ​建立「節點」的啟動器 — 對於條件"jcr:content/jcr:mimeType!=video"，「萬用字元」值應為：

/content/dam(/((?!/subassets|/translation_output).)*/)renditions/original

• 'excludeList'應該有"event-user-data:changedByWorkflowProcess"。
• 針對​ DAM更新資產工作流程 — ​的「節點已修改」的啟動器（條件「jcr:content/jcr:mimeType!=video」），「萬用字元」值應為：

/content/dam(/((?!/subassets|/translation_output).)*/)renditions/original

• excludeList應該有"event-user-data:changedByWorkflowProcess"。

升級完成後，請確定所有自訂/覆蓋圖均已驗證並更新，以符合新的應用程式程式碼。 以下提供一些範例：

• 從/libs/fmditor/libsis覆寫的任何元件都應與新的產品程式碼進行比較，且更新應在/apps下方的覆寫檔案中完成。
• 產品中使用的任何clientlib類別都應檢閱是否有變更。 任何覆寫的設定\（範例如下\）都應與最新的設定進行比較，以取得最新的功能：
• elementmapping.xml
• ui_config.json\（可能已在資料夾設定檔中設定\）
• 已修改com.adobe.fmdita.config.ConfigManager

如果您已在damAssetLucene中新增任何自訂，您可能需要再次套用它們。 進行這些變更後，將重新索引設定為true。 這會使用自訂重新索引所有現有節點。 完成後，重新索引標幟將再次設定為false。 視系統中的資產數量而定，這可能需要幾個小時的時間。

開啟crx/de並導覽至索引路徑： /oak:index/guidesAssetProperties

將重新索引屬性設定為true （預設為false），然後按一下​ 全部儲存。

重新索引完成後，重新索引屬性會再次設定為false，而重新索引計數會增加1。

4. 對其他新增或修改的索引執行相同的步驟： `guidesBulkActivation`、`guidesPeerLinkIndex`和`guidesKonnectTemplateIndex`。