配置Automated forms conversion服務(AFCS) about-this-help

本文介紹管理AEM員如何配置Automated forms conversion服務(AFCS),以自動將其PDF forms轉換到Adaptive Nigus。 本文針對您組織的AEMIT和管理員。 所提供的資訊假定任何閱讀本文的人都熟悉以下技術:

  • 安裝、配置和管理Adobe Experience Manager和AEM包,

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

  • 配置SMTP郵件伺服器
    ======

上線 onboarding

該服務可免費向6AEM.5Forms和6.5 LTSForms現AEM場定期客戶和Adobe管理服務企業客戶提供。 您可以聯繫Adobe銷售團隊或Adobe代表以請求訪問該服務。 該服務還面向AEM Formsas a Cloud Service客戶免費預啟用。

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

先決條件 prerequisites

您需要以下人員才能使用Automated forms conversion服務(AFCS):

  • Automated forms conversion服務(AFCS)已為您的組織啟用
  • 具有轉換服務管理員權限的Adobe ID帳戶
  • 具有最新AEMService Pack或最新更新的正在運AEM行的6.5、6.5 LTS或AEM Formsas a Cloud Service作者實AEM例。
  • 屬於AEMforms-user組AEM的用戶(在實例上)

設定環境 setuptheservice

使用服務之前,請準AEM備您的作者實例以連接到在Adobe雲上運行的服務。 按列出的順序執行以下步驟,為服務準備實例:

下載並安裝AEM6.5或AEM6.5 LTS或板載AEM Formsas a Cloud Service aemquickstart

Automated forms conversion服務(AFCS)在作者實AEM例上運行。 您需AEM要6.5、AEM6.5 LTS或AEM Formsas a Cloud Service來設AEM置作者實例。

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

下載並安裝最新AEM的Service Pack。 有關詳細說明,請參AEM閱6.5 Service Pack發行說明

(AEM僅適用於6.5AEM和6.5 LTS)下載和安裝AEM Forms附加軟體包 downloadaemformsaddon

實AEM例包含基本表單功能。 轉換服務需要AEM Forms的全部功能。 下載並安裝AEM Forms附加軟體包以利用AEM Forms的所有功能。 需要套件才能設定並執行轉換服務。 如需詳細指示,請參閱安裝及設定資料擷取功能。

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

建立自訂主題和範本 referencepackage

AEM Forms as a Cloud Service:​您可以使用現成的範本,或建立自訂範本,並將服務組態指向它們。

(僅適用於AEM 6.5和AEM 6.5 LTS)​自動錶單轉換服務(AFCS)需要至少一個主題和一個範本,才能將PDF表單轉換為最適化表單。 若要使用以核心元件為基礎的範本和主題,您必須啟用最適化表單核心元件;此處會記錄相關指示。 如果您在生產模式 (nosamplecontent執行模式)下啟動AEM 6.5或AEM 6.5 LTS,則不會安裝參考套件。 建立您自己的自訂主題和範本,或在您的作者執行個體上下載並安裝AEM Forms參考Assets套件以取得參考主題和範本。 然後指向服務組態,在使用服務之前使用範本和佈景主題。

設定存取權和許可權

在您繼續設定服務並連線您的執行個體與Adobe Cloud上執行的服務之前,請瞭解連線到服務所需的角色和許可權。 此服務使用兩種不同型別的角色:管理員和開發人員:

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

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

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

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

授予組織開發人員存取權

在Adobe為您的組織啟用存取權並提供所需的許可權給管理員後,管理員可以登入Admin Console (下面的詳細說明)、建立設定檔,並將開發人員新增到設定檔。 開發人員可以將AEM Forms的例項連線至Adobe Cloud上的自動錶單轉換服務(AFCS)。

開發人員是您指定執行轉換服務的組織成員。 只有已新增至Adobe自動化表單轉換服務(AFCS)設定檔的開發人員,才有權使用自動化表單轉換服務(AFCS)。
執行以下步驟來建立設定檔並新增開發人員。 至少需要一個設定檔,才能將必要的存取權授予組織的開發人員:

  1. 登入Admin Console。 使用布建管理員的​ Adobe ID ​以使用自動錶單轉換服務(AFCS)登入。

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

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

  4. 指定設定檔的​NameDisplay Name​和​Description。 按一下 Done。 例如,將設定檔建立為​AFC_Flamingo_Test_Dev

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

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

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

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

管理員將開發人員新增到Adobe I/O設定檔後,開發人員會透過電子郵件(如果已設定)收到通知。

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

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

  1. 以AEM管理員身分登入您的AEM Forms作者執行個體。 使用您的本機AEM憑證登入。

  2. 按一下​Adobe Experience Manager > Tools > Security > Users

  3. 選取指定要執行轉換服務的使用者,然後按一下​Properties編輯使用者設定​頁面隨即開啟。

  4. 在​ Email ​欄位中指定電子郵件地址,然後按一下​Save。 成功完成或轉換失敗時,會將電子郵件傳送至指定的電子郵件地址。

    指定電子郵件

  5. 按一下「群組」標籤。 在[選取群組]索引標籤中,輸入並選取​ 表單 — 使用者 ​群組。

  6. 按一下「儲存並關閉」。 使用者現在是forms-users群組的成員。

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

新增使用者群組

將您的AEM Forms執行個體連線至Adobe Cloud上的自動錶單轉換服務(AFCS)

管理員為您提供開發人員存取權後,您就可以將您的AEM Forms執行個體連線至Adobe Cloud上執行的自動錶單轉換服務(AFCS)。
執行以下步驟,將AEM Forms執行個體連線至自動錶單轉換服務:

​1. 在Adobe Developer Console上設定服務API

​2. 建立Adobe IMS設定

​3. 建立自動表單轉換設定

​1. 在Adobe Developer Console上設定服務API

若要使用自動錶單轉換服務(AFCS),請建立專案,並將​自動Forms設定服務 API新增至Adobe Developer Console上的專案。 整合會產生API金鑰、使用者端密碼、技術帳戶ID、範圍與組織ID。
若要在Adobe Developer Console上設定自動錶單轉換服務API,請執行以下步驟:

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

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

  3. 按一下 Create new project。 將顯示一個螢幕,以便開始新項目。

    新建API項目

  4. 按一下 Add API。 此時將顯示一個螢幕,其中列出了為您的帳戶啟用的所有API。
    添加API

  5. 選擇​ Automated Forms Conversion service ​並按一下​Next。 將顯示一個用於配置API的螢幕。
    選擇AFCS API

  6. 選擇​ OAuth伺服器到伺服器 ​身份驗證方法。

  7. 指定​ Credential Name ​並按一下​Next
    指定憑據名稱

  8. 選擇​產品配置檔案。 例如,選擇一個配置檔案作為​AFC_Flamingo_Test_Dev

  9. 按一下「Save configured API」。
    選擇配置檔案

    note note
    NOTE
    選擇在授予您組織的開發人員訪問權限時建立的配置檔案。 如果您不知道要選擇的配置檔案,請與管理員聯繫。
  10. 按一下​ OAuth Server-to-Server ​查看將實例連接到Automated forms conversion服務(AFCS)所需的API密鑰、客戶端AEM密鑰和其他資訊。
    選擇誓言憑據

    頁面上的資訊用於建立IMS配置,如在作者實例上建立IMS技AEM術配置部分所述。

    OAuth憑據詳細資訊

​2. 建立Adobe IMS配置

登錄到作者實例以建立Adobe IMS配置。 使用​ OAuth憑據詳細資訊 ​檢索API密鑰、客戶端密鑰、技術帳戶ID、作用域和組織ID。

  1. 登錄到您的AEM Forms作者實例。 導航到​Tools> Security > Adobe IMS Configurations

  2. 按一下「Create」。

    建立IMSAdobe配置

  3. 將顯示​ Adobe IMS Technical Account Configuration ​頁。

    「Adobe IMS技術帳戶配置」頁

  4. 在​ 雲解決方案 ​中選擇​Automated Forms Conversion Service

  5. 指定以下內容:

  6. 按一下 Save。 建立Adobe IMS配置。

    note caution
    CAUTION
    僅建立一個IMS配置。 不要建立多個IMS配置。
  7. 選擇​Adobe IMS配置,然後按一下​Check Health。 對話方塊隨即顯示。
    Chcek運行狀況

    出現​ 檢查 ​對話框。

  8. 按一下「Check」。

    Chcek運行狀況

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

    連接成功時,將顯示成功檢索的令牌消息。

  9. 按一下​關閉

​3. 建立自動表單轉換設定

建立Automated forms conversion配置,將實AEM例連接到轉換服務。 它還允許您指定轉換的模板、主題和表單片段。 您可以為每組表單建立多個單獨的雲服務配置。
例如,您可以為銷售部門表單單獨配置,而為客戶支援表單單獨配置。 執行以下步驟來建立雲端服務設定:

  1. 在您的AEM Forms執行個體上,按一下​Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration

  2. 選取​ Global ​資料夾並按一下​Create
    建立自動錶單轉換組態​的頁面已顯示。 設定是在​ 全域 ​資料夾中建立。 您也可以在現有的不同資料夾中建立設定,或為您的設定建立資料夾。
    選取全域資料夾

  3. 在​ Create Automated Forms Conversion Configuration ​頁面上,指定下列欄位的值並按一下​Next

    AFCS組態

    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上自動錶單轉換服務(AFCS)的URL。 使用https://aemformsconversion.adobe.io/ URL。
    範本 要套用至轉換表單的預設範本。 在開始轉換之前,您一律可以指定不同的範本。 範本包含最適化表單的基本結構和初始內容。 您可以從提供的現成範本中選擇範本。 您也可以建立自訂範本。
    主題 要套用至轉換表單的預設主題。 在開始轉換之前,您可以隨時指定不同的主題。 您可以按一下圖示,選擇隨開即用的主題。 您也可以建立自訂主題。
    現有片段 現有片段的位置(如果有)。
    自訂中繼模型 自訂中繼模型的.schema.json檔案路徑。 您可以建立英文、法文、德文、西班牙文、義大利文和葡萄牙文的個別中繼模型。
  4. 在​ Create Automated Forms Conversion Configuration ​頁面的​ Advanced ​標籤中,指定下列欄位的值:
    AFCS組態

    table 0-row-2 1-row-2 2-row-2
    欄位 說明
    產生記錄文件 選取選項,以針對轉換的表單自動產生記錄檔案。 此選項僅適用於XFA型表單(XDP和PDF forms)。 當您啟用選項時,在提交表單後,您可以允許客戶以列印或檔案格式來記錄他們在表單中填寫的資訊,以供日後參考。 這稱為記錄檔案。
    啟動 Analytics (僅適用於AEM 6.5和AEM 6.5 LTS)選取選項,以在所有轉換的表單上啟用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執行個體已準備好開始將舊版表單轉換為最適化Forms。

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