安裝和配置文檔服務

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

1. 開啟「伺服器管理器」。 按一下 伺服器管理員 表徵圖。
2. 按一下 新增功能 在 功能 功能表。 選取 墨跡和手寫服務 框。
3. 選擇功能 對話框 墨跡和手寫服務 已選取。 按一下 安裝 且已安裝服務。

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

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

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

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

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

4. 在 檔案類型 清單，取消選擇 開啟 對於檔案類型，應允許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. 在 篩選器 小節：

   1. 選擇 Forms 從 解決方案 下拉式清單。
   2. 選取套件的版本和類型。 您也可以使用 搜尋下載 選項來篩選結果。

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

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

6. 選取套件，然後按一下 安裝.

   您也可以透過 AEM Forms版本 文章。

7. 安裝套件後，系統會提示您重新啟動AEM執行個體。 不要立即停止伺服器。 停止AEM Forms伺服器之前，請等到ServiceEvent REGISTERED和ServiceEvent UNECROVERD訊息停止出現在 [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\.

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 FormsPDF產生器設定 頁面。

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

配置超時設定

1. 在 AEM configuration manager，找到並開啟 Jacorb ORB提供程式 服務。

   將下列項目新增至 自訂屬性.name 欄位，按一下 儲存. 它將掛起的答復超時（也稱為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並選取 編輯> 偏好設定> 更新程式. 在檢查更新中，取消選擇 自動安裝更新，然後按一下 確定. 關閉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

      注意

      如果「系統整備工具」報告pdfgen.api檔案不在acrobat外掛程式資料夾中，則從 [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. 設定密碼並點選 儲存.

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

DocAssurance服務可以將使用權應用於PDF文檔。 要將使用權應用於PDF文檔，請配置證書。

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

• 證書檔案(.pfx)。

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

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

• 密鑰庫檔案密碼。 如果您使用的是Adobe的Reader擴充功能憑證，金鑰存放區檔案密碼一律與私密金鑰密碼相同。

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

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

2. 按一下 名稱 使用者帳戶的欄位。 此 編輯使用者設定 頁面開啟。 在AEM製作例項上，憑證位於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 檔案夾。

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

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

已知問題和疑難排解

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

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

1. 導覽至 [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/。

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

   ldd phantomjs

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

   ldd phantomjs | grep not

3. 手動安裝遺失的程式庫。

後續步驟

您有正常運作的AEM Forms檔案服務環境。 您可以通過以下方式使用文檔服務：

• OSGi上以表單為中心的工作流程
• Watched 資料夾
• 檔案服務API

Business.Adobe.com 資源

Automated Onboarding Personalized Experiences Embedded Charts Web Content Management Digital Rights Management Digital Signage