安裝和配置文檔服務

AEM Forms提供一組OSGi服務，以完成不同的檔案層級作業，例如建立、組合、分發和封存PDF檔案、新增數位簽章以限制檔案存取，以及解碼條碼表單等服務。 這些服務包含在AEM Forms附加套件中。 這些服務統稱為檔案服務。 可用的檔案服務及其主要功能清單如下：

• 匯編服務： 可讓您合併、重新排列和增強PDF和XDP檔案，並取得PDF檔案的相關資訊。此外，它還可協助將PDF檔案轉換及驗證為PDF/A標準、將PDF forms、XML表單和PDF forms轉換為PDF/A-1b、PDF/A-2b和PDFA/A-3b。 有關詳細資訊，請參見Assembler Service。

• ConvertPDF服務： 可讓您將PDF檔案轉換為PostScript或影像檔案（JPEG、JPEG 2000、PNG和TIFF）。如需詳細資訊，請參閱ConvertPDF Service。

• 條形碼Forms服務： 可讓您從條形碼的電子影像擷取資料。該服務接受包含一個或多個條形碼的TIFF和PDF檔案作為輸入，並提取條形碼資料。 如需詳細資訊，請參閱BarcodedForms服務。

• DocAssurance服務：可 讓您加密和解密檔案、以額外的使用權限擴充Adobe Reader的功能，以及在檔案中新增數位簽章。Doc Assurance服務包含三項服務：簽名、加密和Reader擴充功能。 有關詳細資訊，請參閱DocAssurance Service。

• 加密服務： 可讓您加密和解密檔案。當文檔加密時，其內容將變得不可讀。 授權用戶可以解密文檔以獲得對其內容的訪問。 如需詳細資訊，請參閱加密服務。

• Forms服務： 可讓您建立互動式資料擷取用戶端應用程式，以驗證、處理、轉換並傳遞通常在Forms設計人員中建立的表單。Forms服務會轉譯您開發為PDF檔案的任何表格設計。 如需詳細資訊，請參閱Forms服務。

• 輸出服務： 可讓您建立不同格式的檔案，包括PDF、雷射印表機格式和標籤印表機格式。雷射打印機格式為PostScript和打印機控制語言(PCL)。 如需詳細資訊，請參閱輸出服務。

• PDF Generator服務：PDF Generator服務提供API，可將原生檔案格式轉換為PDF。此外，它還可將PDF轉換為其他檔案格式，並最佳化PDF檔案的大小。 如需詳細資訊，請參閱PDF Generator Service。

• Reader延伸服務： 讓貴組織透過擴充Adobe Reader的功能及額外的使用權，輕鬆分享互動式PDF檔案。本服務會啟動在使用Adobe Reader開啟PDF檔案時無法使用的功能，例如在檔案中新增註解、填寫表單以及儲存檔案。 如需詳細資訊，請參閱Reader分機服務。

• 簽名服務： 可讓您在伺服器上處理數位簽章和AEM檔案。例如，簽名服務通常用於下列情況：

  • 伺服AEM器會在傳送表單給使用者以使用Acrobat或Adobe Reader開啟之前，先進行認證。
  • 伺服AEM器會使用Acrobat或Adobe Reader驗證已新增至表單的簽名。
  • 伺AEM服器代表公證員簽署表格。

  簽名服務訪問儲存在信任儲存中的證書和證書。 如需詳細資訊，請參閱簽名服務。

AEM Forms是一個強大的企業級平台，檔案服務只是AEM Forms的一項功能。 有關功能的完整清單，請參見AEM Forms簡介。

部署拓撲

AEM Forms附加套件是部署在上的應用程AEM式。 一般而言，您只需要一個執AEM行例項（作者或發佈）即可執行AEM Forms檔案服務。 建議使用下列拓撲來運行AEM Forms文檔服務。 有關拓撲的詳細資訊，請參見AEM Forms的體系結構和部署拓撲。

系統要求

在開始安裝和配置AEM Forms文檔服務之前，請確保：

• 硬體和軟體基礎架構已就緒。 有關支援的硬體和軟體的詳細清單，請參見技術要求。

• 實例的安AEM裝路徑不包含空格。

• 實AEM例已啟動並運行。 在術AEM語中，「例項」是在作者或發AEM布模式下在伺服器上執行的副本。 一般而言，您只需要一個執AEM行例項（作者或發佈）即可執行AEM Forms檔案服務：

  • 作者:用於AEM建立、上傳和編輯內容以及管理網站的例項。內容一旦準備好上線，就會複製到發佈實例。
  • 發佈:透過AEM網際網路或內部網路為公眾提供發佈內容的例項。

• 符合記憶體需求。 AEM Forms附加套件需要：

  • 15 GB的臨時空間，用於基於Microsoft Windows的安裝。
  • 6 GB的臨時空間，用於基於UNIX的安裝。

• PDF產生器在Microsoft Windows和Linux上執行轉換所需的用戶端軟體已安裝：

  • Microsoft Windows:安裝 Microsoft Office或 Apache OpenOffice
  • Linux:安裝 Apache OpenOffice

基於UNIX的作業系統的額外要求

如果使用基於UNIX的作業系統，請從相應作業系統的安裝介質安裝以下軟體包：

• (僅限PDF產生器)安裝32位元版本的libcurl、libcrypto和libssl程式庫，並建立下列symlinks。symlinks指向各個庫的最新版本：

  • /usr/lib/libcurl.so
  • /usr/lib/libcrypto.so
  • /usr/lib/libssl.so

• （僅限PDF Generator） PDF Generator服務支援WebKit和PhantomJS路由，將HTML檔案轉換為PDF檔案。若要啟用PhantomJS路由轉換，請安裝下列64位元程式庫。 通常，這些庫已安裝。 如果缺少任何庫，請手動安裝：

  • linux-gate.so.1
  • libz.so.1
  • libfontconfig.so.1
  • libfreetype.so.6
  • libdl.so.2
  • librt.so.1
  • libpthread.so.0
  • libstdc++.so.6
  • libm.so.6
  • libgcc_s.so.1
  • libc.so.6
  • ld-linux.so.2
  • libexpat.so.1

預安裝配置

安裝前設定區段中所列的設定僅適用於PDF Generator服務。 如果您未設定PDF Generator服務，則可略過安裝前設定區段。

安裝Adobe Acrobat和第三方應用程式

如果您要使用PDF Generator服務將Microsoft Word、Microsoft Excel、Microsoft PowerPoint、OpenOffice、WordPerfect X7和Adobe Acrobat等原生檔案格式轉換為PDF檔案，請確定這些應用程式已安裝在AEM Forms伺服器上。

安裝Acrobat後，請開啟Microsoft Word。 在​Acrobat​標籤上，按一下「建立PDF」，並將電腦上的。doc或。docx檔案轉換為PDF檔案。 ​​如果轉換成功，AEM Forms已準備好將Acrobat與PDF產生器服務搭配使用。

設定環境變數

為32位元和64位元Java開發套件、協力廠商應用程式和Adobe Acrobat設定環境變數。 環境變數應包含用於啟動相應應用程式的執行檔的絕對路徑，例如，下表列出了一些應用程式的環境變數：

（僅適用於IBM WebSphere）配置IBM SSL套接字提供程式

執行以下步驟以配置IBM SSL套接字提供程式：

1. 建立java.security檔案的副本。 檔案的預設位置為[WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security。

2. 開啟複製的java.security檔案以進行編輯。

3. 變更預設的SSL通訊端工廠，使用JSSE2工廠，而非預設的IBM WebSphere工廠：

   預設內容：

   #ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
   #ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
   #WebSphere socket factories (in cryptosf.jar)
   ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
   ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
   

   修改的內容：

   ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
   ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
   
   #WebSphere socket factories (in cryptosf.jar)
   #ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
   #ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
   

4. 要使AEM Forms伺服器能夠使用更新的java.security檔案，在啟動AEM Forms伺服器時，添加以下java參數：

   -Djava.security.properties= [path of newly created Java.security file].

（僅限Windows）配置安裝墨水和手寫服務

如果您正在運行Microsoft Windows Server，請配置Ink and Shartting服務。 需要該服務才能開啟使用Microsoft Office的輸墨功能的Microsoft PowerPoint檔案：

1. 開啟「伺服器管理器」。 按一下「Quick Launch（快速啟動）」托盤上的「Server Manager（伺服器管理器）」]表徵圖。[
2. 按一下​功能​菜單中的​添加功能。 選中「墨水和手寫服務」複選框。
3. 選擇「 功能」對話框，並 選擇「油墨和筆跡 服務」。按一下​安裝​並安裝服務。

（僅限Windows）配置Microsoft Office的檔案塊設定

變更Microsoft Office信任中心設定，讓PDF Generator服務可轉換使用舊版Microsoft Office建立的檔案。

1. 開啟Microsoft Office應用程式。 例如，Microsoft Word。 導覽至​File> Options。 將出現選項對話框。

2. 按一下​信任中心 ，然後按一下​信任中心設定。

3. 在​信任中心設定​中，按一下​檔案塊設定。

4. 在​檔案類型​清單中，針對PDF產生器服務應允許轉換為PDF檔案的檔案類型，取消選取​Open。

（僅限Windows）授予「取代進程級別令牌」權限

用於啟動應用程式伺服器的用戶帳戶要求​替換進程級別Token​權限。 本地系統帳戶預設具有​替換進程級別Token​權限。 對於與「本地管理員」組用戶一起運行的伺服器，必須明確授予該權限。 執行以下步驟授予權限：

1. 開啟Microsoft Windows的群組原則編輯器。 要開啟組策略編輯器，請按一下「開始搜索」框中的​「開始」，鍵入​gpedit.msc ，然後按一下「組策略編輯器」]。[
2. 導覽至「本機電腦政策 > 電腦設定 > Windows設定 > 安全設定 > 本機政策 > 使用者權限分配​並編輯​取代處理層級Token​原則並包含「管理員」群組。
3. 將使用者新增至「取代處理層級Token」項目。

（僅限Windows）為非管理員啟用PDF產生器服務

您可以讓非管理員使用者使用PDF產生器服務。 通常，只有具有管理權限的用戶才能使用服務：

1. 建立環境變數PDFG_NON_ADMIN_ENABLED。
2. 將環境變數的值設定為TRUE。
3. 重新啟動AEM Forms實例。

（僅限Windows）禁用用戶帳戶控制(UAC)

1. 要訪問系統配置實用程式，請轉至​開始>運行，然後輸入​MSCONFIG。

2. 按一下「工具」頁籤並向下滾動並選擇「更改UAC設定​]」。[​按一下​Launch​在新窗口中運行命令。

3. 將滑桿調整至「永不通知」層級。 完成後，關閉命令窗口並關閉「System Configuration（系統配置）」窗口。

4. 驗證UAC的註冊表設定是否設定為0（零）。 請執行下列步驟來驗證：

   1. Microsoft建議您在修改註冊表之前備份該註冊表。 有關詳細步驟，請參見如何備份和恢復Windows中的註冊表。
   2. 開啟Microsoft Windows註冊表編輯器。 要開啟註冊表編輯器，請轉至「開始」>「運行」，鍵入regedit，然後按一下「確定」。
   3. 導航到 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\. 確保EnableLUA的值設定為0（零）。
   4. 確保​EnableLUA​的值設定為0（零）。 如果值不是0，請將值變更為0。 關閉登錄編輯程式。

5. 重新啟動電腦。

（僅限Windows）禁用錯誤報告服務

在Windows Server上使用PDF Generator服務將檔案轉換為PDF時，Windows Server偶爾會報告執行檔遇到問題，需要關閉。 但是，當PDF繼續在背景時，它不會影響其轉換。

為避免收到錯誤，您可以禁用Windows錯誤報告。 有關禁用錯誤報告的詳細資訊，請參閱https://technet.microsoft.com/en-us/library/cc754364.aspx。

（僅限Windows）設定HTML至PDF轉換

PDF產生器服務提供WebKit、WebCapture和PhantomJS路由或方法，將HTML檔案轉換為PDF檔案。 在Windows上，若要啟用WebKit和AcrobatWebCapture路由轉換，請將Unicode字型複製到%windir%\fonts目錄。

（僅限UNIX平台）HTML至PDF轉換的額外設定

在UNIX平台上，PDF產生器服務支援WebKit和PhantomJS路由，將HTML檔案轉換為PDF檔案。 若要啟用HTML至PDF轉換，請執行下列適用於您偏好轉換路由的設定：

（僅限UNIX平台）啟用對Unicode字型的支援（僅限WebKit）

將Unicode字型複製至下列適合您系統的任何目錄：

• /usr/lib/X11/fonts/TrueType
• /usr/share/fonts/default/TrueType
• /usr/X11R6/lib/X11/fonts/ttf
• /usr/X11R6/lib/X11/fonts/truetype
• /usr/X11R6/lib/X11/fonts/TrueType
• /usr/X11R6/lib/X11/fonts/TTF
• /usr/openwin/lib/X11/fonts/TrueType(Solaris)

安裝AEM Forms附加軟體包

AEM Forms附加套件是部署在上的應用程AEM式。 此套件包含AEM Forms檔案服務和其他AEM Forms功能。 執行以下步驟以安裝軟體包：

1. 開啟 Software Distribution。您需要 Adobe ID 才能登入 Software Distribution。

2. 點一下頁首功能表中的 Adobe Experience Manager。

3. 在​Filters​區段中：

   1. 從​Solution​下拉式清單中選擇​Forms。
   2. 選擇包的版本和類型。 您也可以使用​搜尋下載​選項來篩選結果。

4. 點選適用於您作業系統的套件名稱，選取「接受EULA條款」，然後點選「下載」。

5. 開啟套件管理器，然後按一下​「上傳套件」​即可上傳套件。

6. 選擇軟體包並按一下​Install。

   您也可以透過AEM Forms版本文章中所列的直接連結下載套件。

7. 安裝軟體包後，系統會提示您重新啟動AEM實例。 不要立即停止伺服器。 在停止AEM Forms伺服器之前，請等待ServiceEvent REGISTERED和ServiceEvent UNREGISTERED消息停止顯示在 [AEM-Installation-Directory]/crx-quickstart/logs/error.log檔案中，並且日誌是穩定的。

安裝後配置

為RSA/BuncyCastle庫配置引導委派

1. 停止實AEM例。 導航至[安AEM裝目錄]\crx-quickstart\conf\ folder。 開啟sling.properties檔案以進行編輯。

   如果您使用[AEM installation directory]\crx-quickstart\bin\start.bat來啟動例項，請編AEM輯位於[AEM_root]\crx-quickstart\的sling.properties。

2. 將下列屬性新增至sling.properties檔案：

   sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
   sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*
   

3. （僅限AIX）將下列屬性新增至sling.properties檔案：

   sling.bootdelegation.xerces=org.apache.xerces.*
   

4. 儲存並關閉檔案。

配置字型管理器服務

1. 以管理員身份登AEM錄到 Configuration Manager。

2. 找到並開啟​CQ-DAM-Handler-Gibson字型管理器​服務。 指定「系統字型」、「Adobe伺服器字型」和「客戶字型」目錄的路徑。 按一下「儲存」。

   注意

   非Adobe方提供之字型之使用權受該等方提供予您之授權合約之約束，且您使用Adobe軟體之授權不涵蓋該權利。 Adobe建議您在將非Adobe字型與Adobe軟體搭配使用之前，先檢閱並確保符合所有適用的非Adobe授權合約，尤其是在伺服器環境中使用字型。
   當您將新字型安裝到字型資料夾時，請重新啟動AEM Forms例項。

設定本機使用者帳戶以執行PDF Generator服務

執行PDF產生器服務需要本機使用者帳戶。 有關建立本地用戶的步驟，請參閱在Windows或在基於UNIX的平台中建立用戶帳戶。

1. 開啟AEM FormsPDF產生器設定頁面。

2. 在​User Accounts​標籤中，提供本地用戶帳戶的憑據，然後按一下​Submit。 如果Microsoft Windows出現提示，請允許用戶訪問。 成功添加後，配置的用戶將顯示在​「用戶帳戶」頁籤的​[!UICONTROL 「您的用戶帳戶」]​部分下。

配置超時設定

1. 在配AEM置管理器中，找到並開啟​Jacorb ORB Provider​服務。

   將下列內容新增至​自訂屬性名稱​欄位，然後按一下「儲存​]」。[​它將待處理的回復超時（也稱為CORBA客戶端超時）設定為600秒。

   jacorb.connection.client.pending_reply_timeout=600000

2. 登入作AEM者例項並導覽至「Adobe Experience Manager > 工具 > Forms > 設定PDF產生器」。 預設URL為http://localhost:4502/libs/fd/pdfg/config/ui.html。

   開啟​General Configuration​頁籤，並修改以下欄位的值以用於您的環境：

（僅限Windows）為PDF Generator服務配置Acrobat

在Microsoft Windows上，PDF產生器服務使用Adobe Acrobat將支援的檔案格式轉換為PDF檔案。 執行下列步驟，為PDF Generator服務設定Adobe Acrobat:

1. 開啟Acrobat並選擇​編輯>首選項​更新程式。 在檢查更新中，取消選擇「自動安裝更新​」，然後按一下「確定」。​​​關上Acrobat。

2. 連按兩下系統上的PDF檔案。 當Acrobat首次啟動時，會出現登入、歡迎畫面和EULA的對話方塊。 針對所有已設定為使用PDF產生器的使用者，關閉這些對話方塊。

3. 執行PDF產生器公用程式批次檔案，為PDF產生器服務設定Acrobat:

   1. 開啟AEM Package Manager ，然後從包管理器下載adobe-aemfd-pdfg-common-pkg-[version].zip檔案。

   2. 解壓縮下載的。zip檔案。 開啟具有管理權限的命令提示符。

   3. 導覽至[extracted-zip-file]\jcr_root\etc\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\scripts目錄。 運行以下批處理檔案：

      Acrobat_for_PDFG_Configuration.bat

      Acrobat已設定為搭配PDF產生器服務執行。

4. 運行系統就緒性工具(SRT)以驗證Acrobat安裝。 此工具會檢查機器是否已正確設定為執行PDF產生器轉換，並在指定路徑產生報表：

   1. 開啟命令提示符。 導覽至[extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\etc\fd\ pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\srt資料夾。 從命令提示符運行以下命令：

      cscript SystemReadinessTool.vbs [Path_of_reports_folder] en

      注意

      如果「系統準備工具」報告acrobat外掛程式檔案夾中沒有pdfgen.api檔案，請將pdfgen.api檔案從[extracted-adobe-aemfd-pdfg-common-pkg]\plugins\x86_win32目錄複製到[Acrobat_root]\Acrobat\plug_ins目錄。

   2. 導航到 [Path_of_reports_folder]. 開啟SystemReadinessTool.html檔案。 驗證報告並修正上述問題。

（僅限Windows）設定HTML至PDF轉換的主要路由

PDF產生器服務提供多種路由，以將HTML檔案轉換為PDF檔案：Webkit、AcrobatWebCapture（僅限Windows）和PhantomJS。 Adobe建議使用PhantomJS路由，因為它可處理動態內容，而且不依賴32位元程式庫、32位元JDK，或不需要額外的字型。 此外，PhantomJS路由不需要sudo或root存取權來執行轉換。

HTML轉換至PDF的預設主要路由是Webkit。 要更改轉換路由，請執行以下操作：

1. 在作AEM者例項上，導覽至「工具> Forms> 設定PDF產生器」。

2. 在​一般設定​標籤中，從​HTML的主要轉換路由​下拉式清單中選取偏好的轉換路由。

初始化全局信任儲存

使用信任商店管理，您可以匯入、編輯和刪除您信任伺服器的憑證，以驗證數位簽章和憑證驗證。 您可以匯入和匯出任意數量的憑證。 在匯入憑證後，您可以編輯信任設定和信任商店類型。 執行以下步驟以初始化信任儲存：

1. 以管理員身份登錄AEM Forms實例。
2. 前往​Tools > Security > Trust Store。
3. 按一下​建立TrustStore。 設定密碼並點選​Save。

為Reader擴展和加密服務設定證書

DocAssurance服務可以對PDF檔案套用使用權。 若要套用PDF檔案的使用權，請設定憑證。

設定憑證之前，請確定您有：

• 憑證檔案(.pfx)。

• 憑證隨附的私密金鑰密碼。

• 私人金鑰別名. 您可以執行Java keytool命令來查看私鑰別名：
  keytool -list -v -keystore [keystore-file] -storetype pkcs12

• 密鑰庫檔案密碼。 如果您使用Adobe的Reader擴展證書，密鑰庫檔案密碼始終與私鑰密碼相同。

請執行下列步驟來設定憑證：

1. 以管理員身分登入AEM Author例項。 前往「工具 > 安全性 > 使用者」。

2. 按一下使用者帳戶的​name​欄位。 將開啟​編輯用戶設定​頁。 在AEM Author例項中，憑證位於KeyStore中。 如果您尚未以前建立KeyStore，請按一下「建立KeyStore」]，並為KeyStore設定新密碼。[​如果伺服器已包含KeyStore，請略過此步驟。 如果您使用Adobe的Reader擴展證書，密鑰庫檔案密碼始終與私鑰密碼相同。

3. 在​編輯用戶設定​頁面上，選擇​KeyStore​頁籤。 展開​從密鑰儲存檔案​添加私密密鑰選項並提供別名。 別名用於執行Reader擴展操作。

4. 若要上傳憑證檔案，請按一下「選取金鑰存放區檔案​]」，然後上傳<filename>.pfx檔案。[

   將與證書相關聯的​密鑰儲存密碼、私鑰密碼​和​私鑰別名​添加到相應欄位。 按一下​提交。

   注意

   在生產環境中，以生產認證取代您的評估認證。 在更新過期或評估憑證之前，請確定您已刪除舊的Reader擴展憑證。

5. 按一下​編輯用戶設定​頁面上的​保存並關閉。

啟用AES-256

若要針對PDF檔案使用AES 256加密，請取得並安裝Java加密擴充功能(JCE)「無限制強度管轄區」原則檔案。 在jre/lib/security資料夾中取代local_policy.jar和US_export_policy.jar檔案。 例如，如果您使用Sun JDK，請將下載的檔案複製到[JAVA_HOME]/jre/lib/security資料夾。

Assembler服務依賴於Reader擴展服務、簽名服務、Forms服務和輸出服務。 執行以下步驟以驗證所需的服務是否已啟動並正在運行：

1. 以管理員身分登入URL https://'[server]:[port]'/system/console/bundles。
2. 搜索以下服務並確保服務已啟動並正在運行：

已知問題和疑難排解

• 如果壓縮的輸入檔案包含檔案名稱中具有雙位元組字元的HTML檔案，則HTML轉換為PDF會失敗。 為避免此問題，命名HTML檔案時請勿使用雙位元組字元。

• 在基於UNIX的作業系統上，請執行以下操作以查找任何缺少的庫：

1. 導航到 [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/.

2. 執行下列命令，列出PhantomJS轉換HTML至PDF所需的所有程式庫。

   ldd phantomjs

   運行以下命令以列出缺少的庫。

   ldd phantomjs | grep not

3. 手動安裝缺少的庫。

後續步驟

您擁有運作中的AEM Forms檔案服務環境。 您可透過下列方式使用檔案服務：

• OSGi表單導向工作流程
• Watched 資料夾
• 檔案服務API