文件AEM表單自動轉換指南

設定Automated forms conversion服務(AFCS) about-this-help

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 初學者
  • 中繼
  • 管理員
  • 開發人員
  • 使用者

本說明說明AEM管理員如何設定Automated forms conversion服務(AFCS)，以自動將其PDF forms轉換為最適化表單。 此說明適用於貴組織的IT和AEM管理員。 所提供的資訊是基於任何閱讀本「說明」的人員都熟悉以下技術的假設：

  • 安裝、設定和管理Adobe Experience Manager和AEM套件，

  • 使用Linux®和Microsoft® Windows®作業系統，

  • 設定SMTP郵件伺服器

上線 onboarding

AEM 6.4 Forms和AEM 6.5 Forms內部部署定期客戶和Adobe管理服務企業客戶可免費使用該服務。 您可以聯絡Adobe銷售團隊或您的Adobe代表，要求存取該服務。 AEM Formsas a Cloud Service客戶也可以免費使用此服務並預先啟用該服務。

Adobe 為您的組織啟用存取權，並向您指定的組織管理員提供所需的權限。管理員可以向貴組織的AEM Forms開發人員（使用者）授予存取權，以便連線到該服務。

先決條件 prerequisites

您需要下列專案才能使用Automated forms conversion服務(AFCS)：

  • 已為貴組織啟用Automated forms conversion服務(AFCS)
  • 具有轉換服務之管理員許可權的Adobe ID帳戶
  • 已開始運作的AEM 6.4、AEM 6.5或AEM Formsas a Cloud Service製作執行個體，其中包含最新AEM Service Pack或最新更新。
  • 屬於表單 — 使用者群組的AEM使用者(在您的AEM執行個體上)

設定環境 setuptheservice

在使用服務之前，請準備您的AEM編寫執行個體以連線到Adobe Cloud上執行的服務。 按照列出的順序執行以下步驟，準備執行個體以供服務使用：

  1. 下載並安裝AEM 6.4、AEM 6.5或內建AEM Formsas a Cloud Service
  2. 下載並安裝最新的AEM Service Pack
  3. 下載並安裝最新的AEM Forms附加元件套件
  4. （選擇性） 下載並安裝最新的聯結器封裝
  5. 建立自訂主題和範本

下載並安裝AEM 6.4、AEM 6.5或內建AEM Formsas a Cloud Service aemquickstart

automated forms conversion服務(AFCS)會在AEM編寫執行個體上執行。 您需要AEM 6.4、AEM 6.5或AEM Formsas a Cloud Service才能設定AEM編寫執行個體。

(僅適用於AEM 6.4和AEM 6.5)下載並安裝AEM最新Service Pack servicepack

下載並安裝最新的AEM Service Pack。 如需詳細指示，請參閱或AEM 6.4 Service Pack發行說明或AEM 6.5 Service Pack發行說明。

(僅適用於AEM 6.4和AEM 6.5)下載並安裝AEM Forms附加元件套件 downloadaemformsaddon

AEM執行個體包含基本表單功能。 轉換服務需要AEM Forms的完整功能。 下載並安裝AEM Forms附加元件套件，以使用AEM Forms的所有功能。 需要套件才能設定並執行轉換服務。 如需詳細指示，請參閱安裝及設定資料擷取功能。

NOTE
安裝附加套件後，請務必執行必要的安裝後組態。

建立自訂主題和範本 referencepackage

如果您在生產模式 （nosamplecontent執行模式）中啟動AEM 6.4或AEM 6.5，則不會安裝參考套件。 參考套件包含範例主題和範本。 automated forms conversion服務(AFCS)需要至少一個主題和一個範本，才能將PDF表單轉換為最適化表單。 建立您自己的自訂主題和範本，並指向服務組態，以在使用服務之前使用自訂範本和主題。

您也可以在作者執行個體上下載並安裝AEM Forms參考Assets套件。 它會建立一些參考主題和範本。

設定服務 configure-the-service

繼續設定服務並將本機執行個體與Adobe Cloud上執行的服務連線之前，請先瞭解連線至服務所需的角色和許可權。 此服務使用兩種不同型別的角色：管理員和開發人員：

  • 管理員：管理員負責管理其組織的Adobe軟體與服務。 管理員可將存取權授與其組織中的開發人員，以連線至在Adobe雲端上執行的Automated forms conversion服務(AFCS)。 為組織布建管理員時，管理員會收到標題為​ ’You now have administrator rights to manage Adobe software and services for your organization’ ​的電子郵件。 如果您是系統管理員，請檢查信箱中是否有先前提及標題的電子郵件，並繼續授與組織開發人員的存取權。

管理員存取權授與電子郵件

  • 開發人員：開發人員將本機AEM Forms作者執行個體連線至Adobe雲端上執行的Automated forms conversion服務(AFCS)。 當管理員授予開發人員連線Automated forms conversion服務(AFCS)的許可權時，會向開發人員傳送一封電子郵件，標題為「您現在擁有管理組織AdobeAPI整合的開發者存取權」 。 如果您是開發人員，請檢查信箱中是否有包含先前提及標題的電子郵件，然後繼續前往將您的本機AEM執行個體連線至Adobe雲端上的Automated forms conversion服務。

開發人員存取權授與電子郵件

(僅適用於AEM 6.4和AEM 6.5的管理員)授予組織開發人員存取權 adduseranddevs

在Adobe為您的組織啟用存取許可權並向管理員提供所需許可權後，管理員可以登入Admin Console（下面的詳細說明）、建立設定檔，並將開發人員新增到設定檔。 開發人員可以將AEM Forms的本機執行個體連線至Adobe Cloud上的Automated forms conversion服務(AFCS)。

開發人員是您指定執行轉換服務的組織成員。 只有已新增至AdobeAutomated forms conversion服務(AFCS)設定檔的開發人員才有權使用Automated forms conversion服務(AFCS)。 執行以下步驟來建立設定檔並新增開發人員。 至少需要一個設定檔，才能將必要的存取權授予組織的開發人員：

  1. 登入Admin Console。 使用布建管理員的​ Adobe ID ​使用Automated forms conversion服務(AFCS)登入。 請勿登入任何其他ID或Federated ID。

  2. 按一下​ Automated Forms Conversion ​選項。

  3. 在​ Products ​索引標籤中按一下​ New Profile。

  4. 指定設定檔的​ Name、Display Name ​和​ Description。 按一下 Done。設定檔已建立。

    指定新設定檔的詳細資料。

  5. 將開發人員新增至設定檔。 若要新增開發人員：

    1. 在Admin Console中，瀏覽至「概觀」標籤。
    2. 按一下所需產品卡上的​ Assign Developers。
    3. 輸入開發人員電子郵件地址，以及名字和姓氏（可選）。
    4. 選取產品設定檔。 點選​ Save。

對所有使用者重複上述步驟。 如需新增開發人員的詳細資訊，請參閱管理開發人員。

管理員將開發人員新增到Adobe I/O設定檔後，開發人員會透過電子郵件收到通知。 收到電子郵件後，開發人員可以繼續進行將本機AEM Forms執行個體與Adobe Cloud上的Automated forms conversion服務連線。

（僅供開發人員使用）將您的本機AEM Forms執行個體連結至Adobe Cloud上的Automated forms conversion服務(AFCS) connectafcadobeio

管理員提供開發人員存取權後，您就可以將本機AEM Forms執行個體連線至Adobe Cloud上執行的Automated forms conversion服務(AFCS)。 以所列順序執行以下步驟，將您的AEM Forms執行個體連線到服務：

設定電子郵件通知 configureemailnotification

automated forms conversion服務(AFCS)使用Day CQ郵件服務來傳送電子郵件通知。 這些電子郵件通知包含成功或失敗轉換的相關資訊。 如果您選擇不接收通知，請略過這些步驟。 執行以下步驟來設定Day CQ Mail Service：

  • 若為AEM 6.4 Forms或AEM 6.5 Forms：

    1. 前往http://localhost:4502/system/console/configMgr的AEM設定管理員

    2. 開啟Day CQ Mail Service設定。 指定​ SMTP server host name、SMTP server port ​和​ From address ​欄位的值。 按一下「Save」。

      您可以連絡您的電子郵件服務提供者或IT管理員，取得有關SMTP伺服器主機名稱和連線埠的資訊。 您可以在「寄件者」欄位中使用任何有效的電子郵件地址。 例如，notification@example.com或donotreply@example.com。

    3. 開啟​ Day CQ Link Externalizer ​設定。 在​ Domains ​欄位中，指定本機、作者和發佈執行個體的實際主機名稱或IP位址和連線埠號碼。 按一下「Save」。

  • 對於AEM Formsas a Cloud Service，記錄支援票證以啟用電子郵件服務。

新增使用者至表單 — 使用者群組 adduserstousergroup

在指定用來執行服務的AEM使用者之設定檔中指定電子郵件地址。 確定使用者是表單使用者群組的成員。 會將電子郵件傳送至執行轉換之使用者的電子郵件地址。 若要指定使用者的電子郵件地址，並將使用者新增至表單使用者群組：

  1. 以AEM管理員身分登入您的AEM Forms作者執行個體。 使用您的本機AEM憑證登入。 請勿使用Adobe ID登入。 點選​ Adobe Experience Manager > Tools > Security > Users。

  2. 選取指定要執行轉換服務的使用者，然後點選​ Properties。 「編輯使用者設定」頁面隨即開啟。

  3. 在​ Email ​欄位中指定電子郵件地址，然後點選​ Save。 成功完成或轉換失敗時，會將電子郵件傳送至指定的電子郵件地址。

  4. 點選「群組」標籤。 在[選取群組]索引標籤中，輸入並選取​ 表單 — 使用者 ​群組。 點選​ 儲存並關閉。 使用者現在是forms-users群組的成員。

(僅適用於AEM 6.4和AEM 6.5)取得公開憑證 obtainpubliccertificates

公開憑證可讓您在Adobe I/O時驗證設定檔。

  1. 登入您的AEM Forms作者執行個體。 導覽至​ Tools > Security > Adobe IMS Configurations。 點選 Create。Adobe IMS Technical Account Configuration ​頁面隨即顯示。

    Adobe IMS技術帳戶設定頁面

  2. 在雲端解決方案中選取​ Automated Forms Conversion Service。

  3. 選取​ Create new certificate ​核取方塊並指定別名。 別名的作用是對話方塊的名稱。 點選 Create certificate。對話方塊隨即顯示。按一下 OK。憑證已建立。

  4. 點選​ Download Public Key ​並將​ AEM-Adobe-IMS.crt ​憑證檔案儲存在電腦上。 憑證檔案用於在Adobe Developer Console上設定服務API。 點選​ Next。

  5. 指定下列專案：

    其他欄位暫時保留空白（稍後提供）。 保持頁面開啟。

(僅適用於AEM 6.4和AEM 6.5)在Adobe Developer Console上設定服務API createintegration

若要使用Automated forms conversion服務(AFCS)，請建立專案，並將Automated Forms Configuration Service API新增至Adobe Developer Console上的專案。 整合會產生API金鑰、使用者端密碼、裝載(JWT)。

  1. 登入https://console.adobe.io/。 使用您的管理員已布建的登入Adobe I/O控制檯的Adobe ID開發人員帳戶來登入。

  2. 從右上角選取您的組織。 如果您不清楚自己的組織為何，請聯絡您的管理員。

  3. 點選 Create new project。隨即顯示開始使用新專案的畫面。 點選 Add API。隨即顯示畫面，列出已為您的帳戶啟用的所有API。

  4. 選取​ Automated Forms Conversion service ​並點選​ Next。 隨即顯示設定API的畫面。

  5. 選取Upload your public key選項，上傳在取得公開憑證區段中下載的AEM-Adobe-IMS.crt檔案，然後點選​ Next。 「建立新的服務帳戶(JWT)認證」選項就會出現。 點選​ Next。

  6. 選取產品設定檔並點選​ Save configured API。 選取在授與您組織開發人員的存取權時建立的設定檔。 如果您不知道要選取的設定檔，請聯絡管理員。

  7. 點選​ Service Account (JWT) ​以檢視API金鑰、使用者端密碼，以及將本機AEM執行個體連線至Automated forms conversion服務(AFCS)所需的其他資訊。 頁面上的資訊會用於在本機電腦上建立IMS設定。

  8. 在本機執行個體上開啟IMS設定頁面。 在取得公開憑證這一節的結尾，您已保持此頁面開啟。

    指定標題、API金鑰、使用者端密碼和承載

  9. 在Adobe IMS技術頁面上，指定API金鑰和使用者端密碼。 使用Adobe Developer主控台頁面的服務帳戶(JWT)上指定的值。

    note note
    NOTE
    對於裝載，請使用Adobe Developer Console「服務帳戶(JWT)」頁面的「產生JWT」標籤中提供的程式碼。

  10. 點選 Save。IMS設定已建立。

    note caution
    CAUTION
    僅建立一個IMS設定。 請勿建立多個IMS設定。

  11. 選取IMS設定並點選​ Check Health。 對話方塊隨即顯示。 點選 Check。成功連線時，已成功擷取 Token 訊息就會顯示。

    成功連線時，已成功擷取Token訊息就會顯示。

設定Cloud Service configure-the-cloud-service

建立Cloud Service設定，以將您的AEM執行個體連線到轉換服務。 它也可讓您指定轉換的範本、主題和表單片段。 您可以為每組表單分別建立多個雲端服務設定。 例如，您可以針對銷售部門表單設定不同的組態，而針對客戶支援表單設定不同的組態。 執行以下步驟來建立雲端服務設定：

  1. 在您的AEM Forms執行個體上，點選「Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration」。

  2. 點選​ Global ​資料夾，然後點選​ Create。 將會顯示建立Automated forms conversion組態的頁面。 設定會建立於全域資料夾中。 您也可以在現有的不同資料夾中建立設定，或為您的設定建立資料夾。

  3. 在​ Create Automated Forms Conversion Configuration ​頁面上，指定下列欄位的值並點選​ Next。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
    欄位 說明
    標題 設定的唯一標題。 標題會顯示在用來開始轉換的UI中。
    名稱 設定的唯一名稱。 設定會以指定名稱儲存在CRX存放庫中。 名稱可與標題相同。
    縮圖位置 設定的縮圖位置。
    服務 URL Adobe Cloud上Automated forms conversion服務(AFCS)的URL。 使用https://aemformsconversion.adobe.io/ URL。
    範本 要套用至轉換表單的預設範本。 在開始轉換之前，您一律可以指定不同的範本。 範本包含最適化表單的基本結構和初始內容。 您可以從提供的現成範本中選擇範本。 您也可以建立自訂範本。
    主題 要套用至轉換表單的預設主題。 在開始轉換之前，您可以隨時指定不同的主題。 您可以按一下圖示，選擇隨開即用的主題。 您也可以建立自訂主題。
    現有片段 現有片段的位置（如果有）。
    自訂中繼模型 自訂中繼模型的.schema.json檔案路徑。 您可以建立英文、法文、德文、西班牙文、義大利文和葡萄牙文的個別中繼模型。

  4. 在​ Create Automated Forms Conversion Configuration ​頁面的​ Advanced ​標籤中，指定下列欄位的值：

    table 0-row-2 1-row-2 2-row-2
    欄位 說明
    產生記錄文件 選取選項，以針對轉換的表單自動產生記錄檔案。 此選項僅適用於XFA型表單(XDP和PDF forms)。 當您啟用選項時，在提交表單後，您可以允許客戶以列印或檔案格式來記錄他們在表單中填寫的資訊，以供日後參考。 這稱為記錄檔案。
    啟動 Analytics (僅適用於AEM 6.4和AEM 6.5)選取選項，以在所有轉換的表單上啟用Adobe Analytics。 使用選項之前，請確定您的AEM Forms執行個體已啟用Adobe Analytics 。
    • 當來源是副檔名為.XDP的XFA型表單時，輸出DOR會保留XFA配置，否則轉換服務會使用現成的範本為其他XFA型表單產生DOR。
    • 提交XFA表單時，表單的提交資料會儲存為XML元素或屬性。 例如 <Amount currency="USD"> 10.00 </Amount>。貨幣會儲存為屬性和貨幣金額，10.00會儲存為元素。 最適化表單的提交資料沒有屬性，只有元素。 因此，當以XFA為基礎的表單轉換為最適化表單時，最適化表單提交資料會包含每個這類屬性的元素。 例如，
    code language-css 
       {
      "Type": "Principal",

      "Amount": "10.00",

      "currency": "USD"
   }

  5. 點選 Create。雲端設定此時已建立。您的AEM Forms執行個體已準備好開始將舊版表單轉換為最適化表單。

recommendation-more-help
c40c2ccf-3d1b-4b47-b158-c4646051b46c