安裝和配置文檔服務

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。 有關詳細資訊，請參閱組合器服務。

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

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

• DocAssurance服務： 可讓您加密和解密檔案、以其他使用權限擴充Adobe Reader的功能，以及將數位簽名新增至檔案。Doc Assurance服務包含三項服務：簽名、加密和讀取器擴展。 有關詳細資訊，請參閱DocAssurance服務。

• 加密服務： 可讓您加密及解密檔案。文檔被加密後，其內容將變得不可讀。 授權用戶可以解密該文檔以獲得對其內容的訪問。 有關詳細資訊，請參閱加密服務。

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

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

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

• 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程式庫，並建立下列符號連結。符號連結指向相應庫的最新版本：

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

• （僅限PDF產生器） PDF產生器服務支援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產生器服務。 如果您未設定PDF產生器服務，可略過安裝前設定區段。

安裝Adobe Acrobat和協力廠商應用程式

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

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

設定環境變數

為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 Sharttring服務。 需要此服務才能開啟使用Microsoft Office的連結功能的Microsoft PowerPoint檔案：

1. 開啟「伺服器管理器」。 按一下「快速啟動」托盤上的​「伺服器管理器」​表徵圖。
2. 按一下​Features​功能表中的​新增功能。 選中​Ink and Shartting Services​複選框。
3. 選 擇「Features」對話框，並選 擇「Ink and Sharting Services」。按一下​安裝​並安裝該服務。

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

更改Microsoft Office信任中心設定，使PDF生成器服務能夠轉換使用舊版Microsoft Office建立的檔案。

1. 開啟Microsoft Office應用程式。 例如Microsoft Word。 導覽至​檔案> 選項。 「選項」對話框隨即出現。

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

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

4. 在​File Type​清單中，取消選擇​Open ，以確定PDF生成器服務應允許轉換為PDF文檔的檔案類型。

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

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

1. 開啟Microsoft Windows的組策略編輯器。 要開啟組策略編輯器，請按一下「開始搜索」框中的​開始，鍵入​gpedit.msc，然後按一下​組策略編輯器。
2. 導航到​本地電腦策略 > 電腦配置 > Windows設定 > 安全設定 > 本地策略 > 用戶權限分配​並編輯​替換進程級別​策略，並包括管理員。
3. 將使用者新增至取代處理層級代號項目。

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

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

1. 建立環境變數PDFG_NON_ADMIN_ENABLED。
2. 將環境變數的值設為TRUE。
3. 重新啟動AEM Forms執行個體。

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

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

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

3. 將滑桿調整到「永不通知」級別。 完成後，關閉命令窗口並關閉「系統配置」窗口。

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

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

5. 重新啟動電腦。

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

在Windows Server上使用PDF生成器服務將文檔轉換為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和Acrobat WebCapture路由的轉換，請將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 UNEGRESTED消息停止顯示在.log檔 [AEM-Installation-Directory]/crx-quickstart/logs/error案中，並且日誌穩定。

安裝後配置

為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產生器服務

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

1. 開啟「AEM Forms PDF生成器配置」頁。

2. 在​用戶帳戶​頁簽中，提供本地用戶帳戶的憑據，然後按一下​提交。 如果Microsoft Windows提示，請允許訪問該用戶。 成功新增後，已設定的使用者會顯示在​使用者帳戶​標籤的​您的使用者帳戶​區段下。

配置超時設定

1. 在AEM Configuration Manager中，找到並開啟​Jacorb ORB Provider​服務。

   將以下內容添加到​Custom Properties.name​欄位中，然後按一下​Save。 它將掛起的答復超時（也稱為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。

   開啟​一般配置​頁簽，並修改以下欄位的值以用於您的環境：

（僅限Windows）為PDF產生器服務設定Acrobat

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

1. 開啟Acrobat並選取​Edit> Preferences> Updater。 在檢查更新中，取消選擇​自動安裝更新，然後按一下​確定。 關閉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、Acrobat WebCapture（僅限Windows）和PhantomJS。 Adobe建議使用PhantomJS路由，因為它具有處理動態內容的功能，並且對32位庫、32位JDK沒有依賴性，或者不需要額外的字型。 此外，PhantomJS路由不需要sudo或根存取權即可執行轉換。

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

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

2. 在​一般配置​頁簽中，從​HTML轉換為PDF的主要路由下拉式清單中選擇首選的轉換路由。

初始化全局信任儲存

使用「信任儲存管理」，您可以導入、編輯和刪除您在伺服器上信任的證書，以驗證數字簽名和證書驗證。 您可以匯入和匯出任何數量的憑證。 匯入憑證後，您可以編輯信任設定和信任存放區類型。 執行以下步驟來初始化信任儲存：

1. 以管理員身分登入AEM Forms執行個體。
2. 前往​工具 > 安全 > 信任儲存。
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製作例項上，憑證位於KeyStore中。 如果您之前尚未建立KeyStore，請按一下​建立KeyStore​並為KeyStore設定新密碼。 如果伺服器已包含KeyStore，請跳過此步驟。 如果您使用的是Adobe的Reader擴充功能憑證，金鑰存放區檔案密碼一律與私密金鑰密碼相同。

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

4. 要上載證書檔案，請按一下​選擇密鑰儲存檔案​並上載<filename>.pfx檔案。

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

   注意

   在生產環境中，將評估憑證取代為生產憑證。 在更新過期或評估憑據之前，請確保刪除舊的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資料夾。

組合器服務依賴於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