移轉 AEM Forms 資產和文件

移轉公用程式會將適用性Forms資產、雲端組態和通信管理資產，從舊版中使用的格式轉換為AEM 6.4 Forms中使用的格式。 當您執行移轉公用程式時，會移轉下列項目：

  • 最適化表單的自訂元件
  • 適用性表單和通信管理範本
  • 雲配置
  • 通信管理和最適化表單資產
注意

如果升級不當，若是通信管理資產，您可以在每次匯入資產時執行移轉。 若是通信管理移轉，您必須安裝Forms相容性套件。

遷移方法

您可以從AEM Forms 6.3或6.2 升級至AEM Forms 6.4的最新版本，或執行全新安裝。 根據您是升級了以前的安裝還是執行了最新安裝，您需要執行以下操作之一：

就地升級

如果您執行就地升級，升級的執行個體已擁有資產和檔案。 不過，在使用資產和文檔之前，您需要安裝AEMFD相容性包（包括通信管理相容性包）

然後，您需要透過執行移轉公用程式來更新資產和檔案。

如果安裝不到位

如果安裝過程不當（最新），則您必須先安裝AEMFD相容性套件（包括通信管理相容性套件），才能使用資產和檔案。

然後，您需要在新設定上匯入資產套件（zip或cmp），然後透過執行移轉公用程式來更新資產和檔案。 由於向後相容性相關的更改，crx-repository中一些資料夾的位置被更改。 手動從先前的設定將相依性（自訂程式庫和資產）匯出並匯入至全新環境。

請先閱讀，再繼續移轉

對於通信管理資產：

  • 針對從上一個平台匯入的資產，會新增屬性：fd:version=1.0。
  • 自AEM 6.1 Forms起，無法立即使用註解。 先前新增的註解可在資產中使用，但不會自動顯示在介面上。 您需要自訂AEM Forms使用者介面中的extendedProperties屬性，才能顯示註解。
  • 在部分舊版(例如LiveCycleES4)中，文字是使用Flex RichTextEditor編輯，但自AEM 6.1 Forms起，便使用HTML編輯器。 由於字型的呈現和外觀，字型大小和字型邊距可能與「作者」使用者介面中的舊版不同。 不過，轉譯後的字母看起來一樣。
  • 文字模組中的清單已有所改善，現在呈現的方式也有所不同。 可能有視覺上的差異。 建議您呈現並查看文字模組中使用清單的信函。
  • 由於影像內容模組會轉換為DAM資產，且配置和片段會在移轉期間新增至表單，因此這些模組的「更新者」屬性會變更為管理員。
  • 資產的版本記錄不會移轉，且在移轉後無法使用。 移轉後會維護後續的版本記錄。
  • 自AEM 6.1 Forms以來，「準備發佈」狀態已遭取代，因此「準備發佈」狀態中的所有資產都會變更為「已修改」狀態。
  • 由於使用者介面已在AEM Forms 6.3中更新，因此執行自訂的步驟也不同。 如果您要從6.3之前的版本移轉，則需要重做自訂。
  • 版面片段從/content/apps/cm/layouts/fragmentlayouts/1001移至/content/apps/cm/modules/fragmentlayouts。 資產中的資料字典參考會顯示資料字典的路徑，而非其名稱。
  • 需要重新調整文本模組中用於對齊的任何tab空格。 如需詳細資訊，請參閱通信管理 — 使用索引標籤間距來排列文字。
  • 資產撰寫器設定對通信管理設定的變更。
  • 資產會移至資料夾下，且名稱如「現有文字」和「現有清單」。

使用移轉公用程式

運行遷移實用程式

在對資產進行任何變更或建立資產之前，請執行移轉公用程式。 建議您在進行任何變更或建立資產後，不要執行公用程式。 請確定在移轉程式執行期間，通信管理或適用性Forms Assets使用者介面未開啟。

當您首次運行遷移實用程式時，將使用以下路徑和名稱建立日誌：\[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log。 此記錄會持續更新通信管理和適用性Forms移轉資訊，例如資產移動。

注意

執行移轉公用程式之前，請確定您已備份crx存放庫。

  1. 在瀏覽器工作階段中，以管理員身分登入AEM製作例項。

  2. 在瀏覽器中開啟下列URL:

    https://[hostname]:[port]/[context_path]/libs/fd/foundation/gui/content/migration.html

    瀏覽器顯示四個選項：

    • AEM Forms 資產移轉
    • 適用性Forms自訂元件移轉
    • 適用性Forms範本移轉
    • AEM 表單雲端組態移轉

  3. 執行下列操作以執行遷移：

    • 若要移轉​assets，請點選「AEM Forms Assets Migration」，然後在下一個畫面中，點選「開始移轉」。 下列項目會移轉：

      • 適用性表單
      • 檔案片段
      • 主題
      • 字母
      • 資料字典
    注意

    在資產移轉期間，您可能會發現警告訊息，例如「為……找到衝突」。 這些訊息表示無法移轉適用性表單中某些元件的規則。 例如，如果元件的事件同時具有規則和指令碼，如果規則發生在任何指令碼之後，則不會遷移元件的任何規則。 不過，這類規則可透過在最適化表單編寫中開啟規則編輯器來移轉。

    這些元件可在適用性Forms編輯器的規則編輯器中開啟，以便移轉。

    • 若要在自訂元件中移轉規則和指令碼（若從6.3升級則非必要），請點選「適用性Forms自訂元件移轉」，在下一個畫面中，點選「開始移轉」。 下列項目會移轉：

      • 使用規則編輯器（6.1 FP1和更新版本）建立的規則和指令碼
      • 在6.1及舊版UI中使用「指令碼」索引標籤建立的指令碼

    • 若要移轉範本（若從6.3升級則非必要），請點選「適用性Forms範本移轉」，然後在下一個畫面中點選「開始移轉」。 下列項目會移轉：

      • 舊範本 — 使用AEM 6.1 Forms或更舊版本，在/apps下建立的最適化表單範本。 這包括範本元件中定義的指令碼。
      • 新範本 — 使用/conf底下的範本編輯器建立的最適化表單範本。 這包括移轉使用規則編輯器建立的規則和指令碼。

    • 若要移轉最適化表單自訂元件，請點選​適用性Forms自訂元件移轉，然後在「自訂元件移轉」頁面中，點選​開始移轉。 下列項目會移轉：

      • 為適用性Forms撰寫的自訂元件
      • 元件覆蓋（如果有）。

    • 若要移轉最適化表單範本，請點選​適用性Forms範本移轉，然後在「自訂元件移轉」頁面中，點選​開始移轉。 下列項目會移轉：

      • 使用AEM範本編輯器在/apps或/conf下建立的最適化表單範本。

    • 移轉AEM Forms雲端設定服務，以運用新的內容感知雲端服務範例，包括觸控式啟用的UI（在/conf底下）。 移轉AEM Forms雲端設定服務時，/etc中的雲端服務會移至/conf。 如果您沒有任何依賴舊版路徑(/etc?lang=zh-Hant)的雲端服務自訂項目，建議您在升級至6.4後立即執行移轉公用程式，並使用雲端設定觸控式UI進行任何後續工作。 如果您有任何現有雲端服務自訂項目，請在升級的設定中繼續使用傳統UI，直到自訂項目更新為與已移轉的路徑(/conf?lang=zh-Hant)一致，然後執行移轉公用程式。

    若要移轉​AEM Forms雲端服務，請點選AEM Forms雲端設定移轉（雲端設定移轉獨立於AEMFD相容性套件），點選AEM Forms雲端設定移轉，然後在「設定移轉」頁面上，點選​開始移轉:

    • 表單資料模型雲端服務

      • 源路徑：/etc/cloudservices/fdm
      • 目標路徑：/conf/global/settings/cloudconfigs/fdm

    • Recaptcha

      • 源路徑：/etc/cloudservices/recaptcha
      • 目標路徑：/conf/global/settings/cloudconfigs/recaptcha

    • Adobe Sign

      • 源路徑：/etc/cloudservices/echosign
      • 目標路徑：/conf/global/settings/cloudconfigs/echosign

    • Typekit雲端服務

      • 源路徑：/etc/cloudservices/typekit
      • 目標路徑：/conf/global/settings/cloudconfigs/typekit

    移轉程式進行時，瀏覽器視窗會顯示下列項目：

    • 更新資產時：已成功更新資產。
    • 移轉完成後：已完成資產的移轉。

    執行時，移轉公用程式會執行下列動作：

    • 將標籤新增至資產:新增「通信管理：移轉資產」/「適用性Forms :移轉的資產」。移轉的資產，讓使用者能識別移轉的資產。 當您執行移轉公用程式時，系統中的所有現有資產都會標示為已移轉。
    • 產生標籤:先前系統中顯示的類別和子類別會建立為標籤，然後這些標籤會與AEM中的相關通信管理資產建立關聯。例如，信函模板的「類別」（「索賠」）和「子類別」（「索賠」）將生成為標籤。
    • 將版面和版面片段移動至AEM 6.4 Forms使用者介面:如果您從6.2升級至6.4，版面範本和版面片段會在AEM Forms 6.4使用者介面區段中以表單形式新增。
    注意

    如果您從6.2升級至6.4，若是通信管理，UI中可能會顯示包含您資產的新資料夾。 您可能需要檢查這些資料夾，以找出您的資產。

  4. 遷移實用程式完成運行後，繼續執行持家任務。

運行遷移實用程式後的內部管理任務

運行遷移實用程式後，請處理以下內部管理任務：

  1. 請確定XFA版本的配置和片段配置是3.3或更新版本。 如果您使用舊版的版面和片段版面，則轉譯信函時可能會發生問題。 若要將舊版XFA更新至最新版本，請完成下列步驟：

    1. 從Forms使用者介面 下載XFA的zip檔案。
    2. 解壓縮檔案。
    3. 在最新的Designer中開啟XFA檔案並儲存。 XFA的版本會更新為最新版本。
    4. 在Forms使用者介面中上傳XFA。

  2. 移轉前先發佈於先前系統的所有資產。 移轉公用程式只會更新製作執行個體上的資產，以及更新發佈執行個體上需要發佈資產的資產。

  3. 在AEM Forms 6.4中，表單使用者群組的某些權限已變更。 如果您希望任何使用者能夠上傳包含指令碼的XDP和適用性Forms，或使用程式碼編輯器，則需將其新增至表單功能使用者群組。 同樣地，範本作者無法再使用規則編輯器中的程式碼編輯器。 為使用者能夠使用程式碼編輯器，請將其新增至af-template-script-writers群組。 有關向組添加用戶的說明，請參閱管理用戶和組。

本頁內容