設定自動錶單轉換服務(AFCS) about-this-help
本文說明AEM管理員如何設定自動錶單轉換服務(AFCS),以自動將其PDF forms轉換為最適化Forms。 本文適用於貴組織的IT和AEM管理員。 所提供的資訊假設任何閱讀本文的人都熟悉以下技術:
-
安裝、設定和管理Adobe Experience Manager和AEM套件,
-
使用Linux®和Microsoft® Windows®作業系統,
-
設定SMTP郵件伺服器
=======
上線 onboarding
AEM 6.5 Forms和AEM 6.5 LTS Forms內部部署定期客戶和Adobe代管服務企業客戶可免費使用該服務。 您可以聯絡Adobe銷售團隊或您的Adobe代表,要求存取該服務。 AEM Forms as a Cloud Service客戶也可以免費使用這項服務並預先啟用它。
Adobe 為您的組織啟用存取權,並向您指定的組織管理員提供所需的權限。管理員可以向貴組織的AEM Forms開發人員(使用者)授予存取權,以便連線到該服務。
先決條件 prerequisites
您需要下列專案才能使用自動錶單轉換服務(AFCS):
- 您的組織已啟用自動錶單轉換服務(AFCS)
- 具有轉換服務之管理員許可權的Adobe ID帳戶
- 已開始運作的AEM 6.5、AEM 6.5 LTS或AEM Forms as a Cloud Service製作執行個體,其中包含最新AEM Service Pack或最新更新。
- 身為表單使用者群組成員的AEM使用者(在您的AEM執行個體上)
設定環境 setuptheservice
在使用服務之前,請準備您的AEM作者執行個體以連線到Adobe Cloud上執行的服務。 按照列出的順序執行以下步驟,準備執行個體以供服務使用:
- 下載並安裝AEM 6.5、AEM 6.5 LTS或內建AEM Forms as a Cloud Service
- (僅適用於AEM 6.5和AEM 6.5 LTS) 下載並安裝最新的AEM Service Pack
- (僅適用於AEM 6.5和AEM 6.5 LTS) 下載並安裝最新的AEM Forms附加元件套件
- (選擇性) 下載並安裝最新的聯結器封裝
- 建立自訂主題和範本(AEM 6.5 / 6.5 LTS)或使用預設值(Cloud Service)
下載並安裝AEM 6.5、AEM 6.5 LTS或內建AEM Forms as a Cloud Service aemquickstart
自動錶單轉換服務(AFCS)會在AEM作者執行個體上執行。 您需要AEM 6.5、AEM 6.5 LTS或AEM Forms as a Cloud Service才能設定AEM編寫執行個體。
-
如果您尚未啟動並執行AEM 6.5或AEM 6.5 LTS,請從以下位置下載。 下載AEM之後,如需設定AEM作者執行個體的指示,請參閱部署和維護:
-
如果您是AEM現有客戶,請從AEM授權網站下載Adobe 6.5或AEM 6.5 LTS。
-
如果您是Adobe合作夥伴,請使用Adobe合作夥伴訓練計畫要求AEM 6.5或AEM 6.5 LTS。
-
-
如果您使用AEM Forms as a Cloud Service,請參閱上線AEM Forms as a Cloud Service和設定本機開發環境。
(僅適用於AEM 6.5和AEM 6.5 LTS)下載並安裝AEM最新Service Pack servicepack
下載並安裝最新的AEM Service Pack。 如需詳細指示,請參閱AEM 6.5 Service Pack發行說明。
(僅適用於AEM 6.5和AEM 6.5 LTS)下載並安裝AEM Forms附加元件套件 downloadaemformsaddon
AEM執行個體包含基本表單功能。 轉換服務需要AEM Forms的完整功能。 下載並安裝AEM Forms附加元件套件,以使用AEM Forms的所有功能。 需要套件才能設定並執行轉換服務。 如需詳細指示,請參閱安裝及設定資料擷取功能。
建立自訂主題和範本 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)。
執行以下步驟來建立設定檔並新增開發人員。 至少需要一個設定檔,才能將必要的存取權授予組織的開發人員:
-
登入Admin Console。 使用布建管理員的 Adobe ID 以使用自動錶單轉換服務(AFCS)登入。
-
按一下 Automated Forms Conversion 選項。
-
在 New Profile 索引標籤中按一下Products。
-
指定設定檔的Name、Display Name和Description。 按一下 Done。例如,將設定檔建立為AFC_Flamingo_Test_Dev。
-
將開發人員新增至設定檔。 若要新增開發人員:
- 在Admin Console中,導覽至「概觀」標籤。
- 按一下所需產品卡上的Assign Developers。
- 輸入開發人員電子郵件地址,以及名字和姓氏(可選)。
- 選取產品設定檔。 按一下Save。
對所有使用者重複上述步驟。 如需新增開發人員的詳細資訊,請參閱管理開發人員。
管理員將開發人員新增到Adobe I/O設定檔後,開發人員會透過電子郵件(如果已設定)收到通知。
新增使用者至表單 — 使用者群組 adduserstousergroup
在指定用來執行服務的AEM使用者之設定檔中,指定電子郵件地址。 確定使用者是 forms-users 群組的成員。 會將電子郵件傳送至執行轉換之使用者的電子郵件地址。 若要指定使用者的電子郵件地址,並將使用者新增至表單使用者群組:
-
以AEM管理員身分登入您的AEM Forms作者執行個體。 使用您的本機AEM憑證登入。
-
按一下Adobe Experience Manager > Tools > Security > Users。
-
選取指定要執行轉換服務的使用者,然後按一下Properties。 編輯使用者設定頁面隨即開啟。
-
在 Email 欄位中指定電子郵件地址,然後按一下Save。 成功完成或轉換失敗時,會將電子郵件傳送至指定的電子郵件地址。
-
按一下「群組」標籤。 在[選取群組]索引標籤中,輸入並選取 表單 — 使用者 群組。
-
按一下儲存並關閉。 使用者現在是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
1.在Adobe Developer Console上設定服務API
若要使用自動錶單轉換服務(AFCS),請建立專案,並將自動Forms設定服務 API新增至Adobe Developer Console上的專案。 整合會產生API金鑰、使用者端密碼、技術帳戶ID、範圍與組織ID。
若要在Adobe Developer Console上設定自動錶單轉換服務API,請執行以下步驟:
-
登入https://developer.adobe.com/console 。 使用您的管理員已布建以登入Adobe I/O主控台的Adobe ID開發人員帳戶來登入。
-
從右上角選取您的組織。 如果您不清楚自己的組織為何,請聯絡您的管理員。
-
按一下 Create new project。隨即顯示開始使用新專案的畫面。
-
按一下 Add API。隨即顯示畫面,列出已為您的帳戶啟用的所有API。
-
選取 Automated Forms Conversion service 並按一下Next。 隨即顯示設定API的畫面。
-
選取 OAuth伺服器對伺服器 驗證方法。
-
指定 Credential Name 並按一下Next。
-
選取產品設定檔。 例如,選取設定檔作為AFC_Flamingo_Test_Dev。
-
按一下「Save configured API」。
note note NOTE 選取在您組織的開發人員授與存取權時建立的設定檔。 如果您不知道要選取的設定檔,請聯絡管理員。 -
按一下 OAuth Server-to-Server 以檢視API金鑰、使用者端密碼,以及將您的AEM執行個體連線至自動錶單轉換服務(AFCS)所需的其他資訊。
頁面上的資訊會用於建立IMS設定,如在AEM作者執行個體上建立IMS技術設定區段中所述。
2.建立Adobe IMS設定
登入您的作者執行個體以建立Adobe IMS設定。 使用 OAuth認證詳細資料 來擷取API金鑰、使用者端密碼、技術帳戶ID、範圍以及組織ID。
-
登入您的AEM Forms作者執行個體。 導覽至Tools > Security > Adobe IMS Configurations。
-
按一下「Create」。
-
Adobe IMS Technical Account Configuration頁面隨即顯示。
-
在 Automated Forms Conversion Service 雲端解決方案中選取。
-
指定下列專案:
-
標題:指定標題。
-
從在Adobe Developer Console上設定服務API區段擷取下列專案:
- 使用者端識別碼:複製並貼上API金鑰(使用者端識別碼)。
- 使用者端密碼:複製並貼上使用者端密碼。
- 領域:複製並貼上領域。
- 組織ID:複製並貼上技術帳戶ID。
-
-
按一下 Save。Adobe IMS設定已建立。
note caution CAUTION 僅建立一個IMS設定。 請勿建立多個IMS設定。 -
選取 Adobe IMS設定 並按一下Check Health。 對話方塊隨即顯示。
檢查對話方塊出現。
-
按一下「Check」。
成功連線時,已成功擷取 Token 訊息就會顯示。
-
按一下關閉。
3.建立自動化表單轉換設定
建立自動錶單轉換設定,將您的AEM執行個體連線到轉換服務。 它也可讓您指定轉換的範本、主題和表單片段。 您可以為每組表單分別建立多個雲端服務設定。
例如,您可以針對銷售部門表單設定不同的組態,而針對客戶支援表單設定不同的組態。 執行以下步驟來建立雲端服務設定:
-
在您的AEM Forms執行個體上,按一下Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration。
-
選取 Global 資料夾並按一下Create。
建立自動錶單轉換組態的頁面已顯示。 設定是在 全域 資料夾中建立。 您也可以在現有的不同資料夾中建立設定,或為您的設定建立資料夾。
-
在 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上自動錶單轉換服務(AFCS)的URL。 使用 https://aemformsconversion.adobe.io/URL。範本 要套用至轉換表單的預設範本。 在開始轉換之前,您一律可以指定不同的範本。 範本包含最適化表單的基本結構和初始內容。 您可以從提供的現成範本中選擇範本。 您也可以建立自訂範本。 主題 要套用至轉換表單的預設主題。 在開始轉換之前,您可以隨時指定不同的主題。 您可以按一下圖示,選擇隨開即用的主題。 您也可以建立自訂主題。 現有片段 現有片段的位置(如果有)。 自訂中繼模型 自訂中繼模型的.schema.json檔案路徑。 您可以建立英文、法文、德文、西班牙文、義大利文和葡萄牙文的個別中繼模型。 -
在 Advanced 頁面的 Create Automated Forms Conversion Configuration 標籤中,指定下列欄位的值:
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" } -
按一下 Create。雲端設定此時已建立。您的AEM Forms執行個體已準備好開始將舊版表單轉換為最適化Forms。