設定自動表單轉換服務

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

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

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

• 配置SMTP郵件伺服器

入門

AEM 6.4 Forms 與 AEM 6.5 Forms 內部部署定期客戶和 Adobe Managed Service 企業客戶可以免費使用該服務。您可以聯絡 Adobe Sales 團隊或您的 Adobe 代表，請求存取該服務。

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

必備條件

您需要下列項目才能使用Automated Forms Conversion Service:

• 您的組織已啟用自動化表單轉換服務
• 具有轉換服務之管理員權限的Adobe ID帳戶
• 使用最新AEM Service Pack啟動並執行AEM 6.4或AEM 6.5作者實例
• AEM使用者（在您的AEM例項上）是表單使用者群組的成員

設定環境

在使用服務之前，請準備您的AEM作者實例以連線至在Adobe Cloud上執行的服務。 在列出的序列中執行以下步驟，為服務準備實例：

1. 下載並安裝AEM 6.4或AEM 6.5
2. 下載並安裝最新的AEM Service Pack
3. 下載並安裝最新的AEM Forms附加元件套件
4. （可選）下載並安裝最新的連接器軟體包
5. 建立自訂主題和範本

下載並安裝AEM 6.4或AEM 6.5

自動化表單轉換服務會在AEM作者實例上執行。 您需要AEM 6.4或AEM 6.5才能設定AEM作者例項。 如果您沒有啟動並執行AEM，請從下列位置下載：

• 如果您是現有的AEM客戶，請從Adobe授權網站下載AEM 6.4或AEM 6.5。

• 如果您是Adobe合作夥伴，請使用Adobe合作夥伴培訓計畫來申請AEM 6.4或AEM 6.5。

下載AEM後，如需設定AEM作者例項的指示，請參閱部署與維護。

下載並安裝AEM最新的Service Pack

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

下載並安裝AEM Forms附加元件套件

AEM例項包含基本表單功能。 轉換服務需要AEM Forms的完整功能。 下載並安裝AEM Forms附加套件，以運用AEM Forms的所有功能。 需要軟體包才能設定並運行轉換服務。 有關詳細說明，請參閱安裝和配置資料捕獲功能。

（可選）下載和安裝連接器軟體包

該連接器軟體包提供對自動檢測邏輯部分功能和在AFC-2020.03.1版中提供的改進的早期訪問。如果您不需要AFC-2020.03.1中提供的功能和改進，請勿安裝軟體包。 您可以從AEM Package Share](https://www.adobeaemcloud.com/content/marketplace/marketplaceProxy.html?packagePath=/content/companies/public/adobe/packages/cq650/featurepack/AFCS-Connector-2020.03.1)下載連接器套件。[

建立自訂主題和範本

如果您在生產模式(nosamplecontent runmode)中啟動AEM，則不會安裝參考套件。 參考套件包含範例主題和範本。 自動化表單轉換服務至少需要一個主題和一個範本，才能將PDF表單轉換為最適化表單。 建立您自己的自訂主題和範本，並指向service configuration使用服務前，使用自訂範本和主題。

設定服務

在您繼續設定服務並連線您的本機實例與Adobe Cloud上執行的服務之前，請先瞭解連線至服務所需的角色和權限。 本服務使用兩種不同的角色類型：管理員和開發人員：

• 管理員:管理員負責管理組織的Adobe軟體和服務。管理員授與組織內開發人員的存取權，以便連線至在Adobe Cloud上執行的自動化表單轉換服務。 為組織布建管理員時，管理員會收到標題為​’You now have administrator rights to manage Adobe software and services for your organization’​的電子郵件。 如果您是管理員，請檢查郵箱中是否有前述標題的電子郵件，然後繼續授予您組織的開發人員的存取權。

• 開發人員:開發人員會將本機AEM Forms作者例項連結至Adobe Cloud上執行的Automated Forms Conversion服務。當管理員授與開發人員連線至自動表單轉換服務的權限時，您現在可以存取標題為「您」的電子郵件會傳送給開發人員，以管理您組織的Adobe API整合。 如果您是開發人員，請檢查郵箱中是否有前述標題的電子郵件，然後前往將您的本機AEM例項連接至Adobe Cloud上的Automated Forms Conversion服務。

（僅限管理員）授與您組織之開發人員的存取權

在Adobe啟用您組織的存取權並提供管理員必要的權限後，管理員可以登入Admin Console（詳細說明如下）、建立描述檔，以及將開發人員新增至描述檔。 開發人員可將AEM Forms的本機執行個體連接至Adobe Cloud上的Automated Forms Conversion服務。

開發人員是指定用來執行轉換服務的組織成員。 只有新增至Adobe Automated Forms Conversion服務設定檔的開發人員才有權使用Automated Forms Conversion服務。 執行下列步驟以建立描述檔並新增開發人員至描述檔。 至少需要一個描述檔才能授予貴組織開發人員必要的存取權：

1. 登入管理控制台。 使用已布建之管理員的​Adobe ID，以使用自動表單轉換服務登入。 請勿使用任何其他ID或Federated ID登入。

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

3. 按一下​Products​頁籤中的​New Profile。

4. 為配置檔案指定​Name、Display Name​和​Description。 按一下 Done. 會建立描述檔。

   

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

   1. 在管理控制台中，導覽至「概述」標籤。
   2. 按一下所需產品卡上的​Assign Developers。
   3. 輸入開發人員的電子郵件地址，或者輸入名字和姓氏。
   4. 選擇產品設定檔。 點選​Save。

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

一旦管理員將開發人員新增至Adobe I/O設定檔，開發人員就會收到電子郵件通知。 在收到電子郵件後，開發人員可繼續連線本機AEM Forms例項與Adobe Cloud上的「自動表單轉換」服務。

（僅限開發人員）將您本機的AEM Forms例項連接至Adobe Cloud上的Automated Forms Conversion服務

在管理員提供您開發人員存取權後，您可以將本機AEM Forms例項連接至Adobe Cloud上執行的Automated Forms轉換服務。 在所列順序中執行下列步驟，將您的AEM Forms例項連接至服務：

• 設定電子郵件通知
• 新增使用者至表單使用者群組
• 取得公開憑證
• 在Adobe Developer Console上設定服務API
• 設定雲端服務

設定電子郵件通知

Automated Forms Conversion服務使用Day CQ郵件服務來傳送電子郵件通知。 這些電子郵件通知包含有關成功或失敗轉換的資訊。 如果您選擇不接收通知，請跳過這些步驟。 執行以下步驟來配置Day CQ Mail服務：

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

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

   有關SMTP伺服器的主機名和埠的資訊，請與電子郵件服務提供商或IT管理員聯繫。 您可以在from欄位中使用任何有效的電子郵件地址。 例如，notification@example.com或donotreply@example.com。

3. 開啟​Day CQ Link Externalizer​配置。 在​Domains​欄位中，指定本機、作者和發佈例項的實際主機名稱或IP位址和埠號。 按一下 Save.

將用戶添加到表單用戶組

在指定用來執行服務的AEM使用者設定檔中指定電子郵件地址。 確保用戶是forms user組的成員。 電子郵件會傳送至執行轉換之使用者的電子郵件地址。 要指定用戶的電子郵件地址並將用戶添加到表單用戶組，請執行以下操作：

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

2. 選擇指定用於運行轉換服務的用戶，然後點選​Properties。 此時將開啟「編輯用戶設定」頁。

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

4. 點選​群組​標籤。 在「選擇組」頁籤中，鍵入並選擇​forms-users​組。 點選​儲存並關閉。 使用者現在是表單使用者群組的成員。

取得公共憑證

公開憑證可讓您在Adobe I/O上驗證您的個人檔案。

1. 登入您的AEM Forms作者實例。 導航到 Tools> Security > Adobe IMS Configurations. 點選​Create。 此時將顯示​Adobe IMS Technical Account Configuration​頁。

   

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

3. 選中​Create new certificate​複選框並指定別名。 別名的作用是對話方塊的名稱。點選​Create certificate。 對話方塊隨即顯示。按一下 OK. 將建立證書。

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

5. 指定下列項目：

   • 標題：指定標題。
   • 授權伺服器：https://ims-na1.adobelogin.com\

   現在將其他欄位留空（稍後將提供）。 保持頁面開啟。

在Adobe Devloper Console上設定服務API

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

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

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服務。 頁面上的資訊可用來在本機電腦上建立IMS設定。

8. 在您的本機例項上開啟「IMS設定」頁面。 在取得公開憑證這一節的結尾，您已保持此頁面開啟。

   

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

   注意

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

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

    注意

    僅建立一個IMS設定。 請勿建立多個IMS組態。

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

    

    
    
    

設定雲端服務

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

1. 在您的AEM Forms例項中，點選​Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration。

2. 點選​Global​資料夾並點選​Create。 此時將顯示用於建立自動表單轉換配置的頁。 配置在「全局」資料夾中建立。 您也可以在已存在的不同資料夾中建立配置，或為配置建立新資料夾。

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

   欄位	說明
   標題	設定的唯一標題。 標題會顯示在用於開始轉換的UI中。
   名稱	配置的唯一名稱。 配置將以指定的名稱保存在CRX-Repository中。 名稱可以與標題相同。
   縮圖位置	配置的縮略圖位置。
   服務 URL	Adobe Cloud上自動化表單轉換服務的URL。 使用https://aemformsconversion.adobe.io/ URL。
   範本	要套用至轉換表單的預設範本。 開始轉換前，您隨時可以指定不同的範本。 範本包含最適化表單的基本結構和初始內容。 您可以從現成可用的範本中選擇範本。 您也可以建立自訂範本。
   主題	套用至轉換表單的預設主題。 開始轉換之前，您隨時可以指定不同的主題。 您可以按一下圖示，選擇現成可用的主題。 您也可以建立自訂主題。
   現有片段	現有片段的位置（如果有）。
   自訂元模型	自訂中繼模型的。schema.json檔案路徑。

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

   欄位	說明
   產生記錄文件	選擇為轉換的表單自動生成記錄文檔的選項。 此選項僅適用於XFA型表單（XDP和PDF表單）。 當您啟用此選項時，在提交表格後，您可讓客戶以列印或檔案格式記錄他們在表格中填入的資訊，以供日後參考。 這稱為記錄檔案。
   啟動 Analytics	選取選項，以在所有轉換的表格上啟用Adobe Analytics。 在使用選項之前，請確定您的AEM Forms例項已啟用Adobe Analytics。

   • 當來源是副檔名為。XDP的XFA型表格時，輸出DOR會保留XFA版面配置，否則轉換服務會使用現成可用的範本，為其他XFA型表格產生DOR。
   • 提交XFA表單時，表單的提交資料會儲存為XML元素或屬性。 例如，<Amount currency="USD"> 10.00 </Amount>。 貨幣會儲存為屬性和貨幣金額，而10.00會儲存為元素。 自適應表單的提交資料沒有屬性，只有元素。 因此，當基於XFA的表單被轉換為自適應表單時，自適應表單提交資料包含每個此類屬性的元素。 例如，

      {
         "Type": "Principal",
   
         "Amount": "10.00",
   
         "currency": "USD"
      }
   

5. 點選​Create。 雲端設定此時已建立。您的AEM Forms實例已準備好開始將舊式表單轉換為最適化表單。