設定自動表單轉換服務

此說明說明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的所有功能。 需要軟體包才能設定並運行轉換服務。 如需詳細指示,請參 閱安裝和設定資料擷取功能。

注意

確保在安裝附加軟體包後執行強制安裝後配置。

(可選)下載和安裝連接器套件

此連接器套件可讓您提早存取 Auto-detect邏輯區段功能 ,以及AFC-2020.03.1版中提供的增強功能。如果您不需要AFC-2020.03.1中提供的功能和改進,請勿安裝軟體包。 您可以 從AEM Package Share下載連接器套件

建立自訂主題和範本

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

設定服務

在您繼續設定服務並連線您的本機實例與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整合。 如果您是開發人員,請檢查郵箱中是否有前述標題的電子郵件,然後繼續 Connect your local AEM instance to Automated Forms Conversion service on Adobe Cloud。

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

(僅限管理員)授與貴組織開發人員的存取權

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

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

  1. 登入管 理控制台。 使用 已布建的管理員 (Adobe ID),以使用Automated Forms Conversion服務登入。 請勿使用任何其他ID或Federated ID登入。

  2. 按一下選 Automated Forms Conversion 項。

  3. 按一 New Profile 下標籤 Products 中。

  4. 指定 NameDisplay Name​和 Description 描述檔。 按一下 Done. 會建立描述檔。

    指定新描述檔的詳細資訊。

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

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

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

一旦管理員將開發人員新增至Adobe I/O設定檔,開發人員就會收到電子郵件通知。 在收到電子郵件後,開發人員可以繼 續在Adobe Cloud上連接本機AEM Forms例項與Automated Forms Conversion服務

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

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

設定電子郵件通知

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

  1. 前往AEM設定管理員,網址為 http://localhost:4502/system/console/configMgr

  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使用者設定檔中指定電子郵件地址。 請確定使用者是表單使用者群 組的成員 。 電子郵件會傳送至執行轉換之使用者的電子郵件地址。 要指定用戶的電子郵件地址並將用戶添加到表單用戶組,請執行以下操作:

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

  2. 選取指定來執行轉換服務並點選的使用者 Properties。 此時將開啟「編輯用戶設定」頁。

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

  4. 點選「群 」標籤。 在選取的群組標籤中,輸入並選取 表單使用者群組 。 點選「 儲存並關閉」。 使用者現在是表單使用者群組的成員。

取得公開憑證

公開憑證可讓您在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訊息。



Configure the cloud service

建立雲端服務設定,將您的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. 在頁面 Advanced 的標籤中, Create Automated Forms Conversion Configuration 指定下列欄位的值:

    欄位 說明
    產生記錄文件 選擇為轉換的表單自動生成記錄文檔的選項。 此選項僅適用於XFA型表單(XDP和PDF表單)。 當您啟用此選項時,在提交表格後,您可讓客戶以列印或檔案格式記錄他們在表格中填入的資訊,以供日後參考。 這稱為記錄檔案。
    啟動 Analytics 選取選項,以在所有轉換的表格上啟用Adobe Analytics。 在使用選項之前,請確定您的AEM Forms例項已啟用Adobe Analytics。
    • 當來源是副檔名為。XDP的XFA型表格時,輸出DOR會保留XFA版面配置,否則轉換服務會使用現成可用的範本,為其他XFA型表格產生DOR。
    • 提交XFA表單時,表單的提交資料會儲存為XML元素或屬性。 For example, <Amount currency="USD"> 10.00 </Amount>. 貨幣會儲存為屬性和貨幣金額,而10.00會儲存為元素。 自適應表單的提交資料沒有屬性,只有元素。 因此,當基於XFA的表單被轉換為自適應表單時,自適應表單提交資料包含每個此類屬性的元素。 例如,
       {
          "Type": "Principal",
    
          "Amount": "10.00",
    
          "currency": "USD"
       }
    
  5. 點選 Create。 雲端設定此時已建立。您的AEM Forms實例已準備好開始將舊式表單轉換為最適化表單。

本頁內容