設定自動表單轉換服務

此說明說明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後,如需設定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. 為配置檔案指定​NameDisplay 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例項連接至服務:

設定電子郵件通知

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

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

  2. 開啟Day CQ Mail Service設定。 指定​SMTP server host nameSMTP 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​頁。

    「Adobe IMS技術帳戶設定」頁面

  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. 指定下列項目:

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

在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設定」頁面。 在取得公開憑證這一節的結尾,您已保持此頁面開啟。

    指定標題、API金鑰、用戶端密碼和裝載

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

    注意

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

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

    注意

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

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

    在成功連線時,會顯示成功擷取的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實例已準備好開始將舊式表單轉換為最適化表單。

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free