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 Forms是功能強大的企業級平台,而檔案服務只是AEM Forms的其中一項功能。 如需功能的完整清單,請參閱AEM Forms簡介。
AEM Forms附加元件套件是部署至AEM的應用程式。 一般而言,您只需要一個AEM例項(製作或發佈)即可執行AEM Forms檔案服務。 建議運行以下拓撲以運行AEM Forms文檔服務。 有關拓撲的詳細資訊,請參閱AEM Forms的架構和部署拓撲。
雖然AEM Forms可讓您從單一伺服器設定和執行所有功能,但您應執行容量規劃、負載平衡,以及針對生產環境中的特定功能設定專用伺服器。 例如,針對使用PDF產生器服務每天轉換數千頁和多個最適化表單來擷取資料的環境,為PDF產生器服務和最適化表單功能設定個別的AEM Forms伺服器。 它有助於提供最佳效能,並可獨立擴展伺服器。
開始安裝和設定AEM Forms檔案服務之前,請確定:
硬體和軟體基礎架構已就緒。 有關支援的硬體和軟體的詳細清單,請參見技術要求。
AEM例項的安裝路徑不包含空格。
AEM例項已啟動並執行。 在AEM術語中,「例項」是在製作或發佈模式中,於伺服器上執行的AEM復本。 一般而言,您只需要一個AEM例項(製作或發佈)即可執行AEM Forms檔案服務:
滿足記憶體要求。 AEM Forms附加元件套件需要:
已安裝PDF產生器在Microsoft Windows和Linux上執行轉換所需的用戶端軟體:
如果使用基於UNIX的作業系統,請從相應作業系統的安裝介質安裝以下軟體包:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(僅限PDF產生器)安裝32位元版本的libcurl、libcrypto和libssl程式庫,並建立下列符號連結。符號連結指向相應庫的最新版本:
(僅限PDF產生器) PDF產生器服務支援WebKit和PhantomJS路由,將HTML檔案轉換為PDF檔案。若要啟用PhantomJS路由的轉換,請安裝下列64位元程式庫。 通常,已安裝這些程式庫。 如果缺少任何程式庫,請手動安裝:
安裝前設定區段中列出的設定僅適用於PDF產生器服務。 如果您未設定PDF產生器服務,可略過安裝前設定區段。
如果您打算使用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設定環境變數。 環境變數應包含用於啟動相應應用程式的執行檔的絕對路徑,例如,下表列出了一些應用程式的環境變數:
應用程式 |
環境變數 |
範例 |
JDK(64位) |
JAVA_HOME |
C:\Program Files\Java\jdk1.8.0_74 |
JDK(32位) |
JAVA_HOME_32 |
C:\Program Files (x86)\Java\jdk1.8.0_74 |
Adobe Acrobat |
Acrobat_PATH |
C:\Program Files (x86)\Adobe\Acrobat 2015\Acrobat\Acrobat.exe |
記事本 |
記事本路徑 |
C:\WINDOWS\notepad.exe |
OpenOffice |
OpenOffice_PATH |
C:\Program Files (x86)\OpenOffice.org4 |
所有環境變數和個別路徑都區分大小寫。
JAVA_HOME、JAVA_HOME_32和Acrobat_PATH(僅限Windows)是必要的環境變數。
環境變數OpenOffice_PATH設定為安裝資料夾,而不是執行檔的路徑。
請勿為Microsoft Office應用程式(如Word、PowerPoint、Excel和Project)或AutoCAD設定環境變數。 如果這些應用程式安裝在伺服器上,則生成PDF服務會自動啟動這些應用程式。
在基於UNIX的平台上,將OpenOffice安裝為/root。 如果OpenOffice未作為根目錄安裝,PDF生成器服務將無法將OpenOffice文檔轉換為PDF文檔。 如果您需要以非根用戶身份安裝並運行OpenOffice,則為非根用戶提供sudo權限。
如果在基於UNIX的平台上使用OpenOffice,請運行以下命令以設定路徑變數:
export OpenOffice_PATH=/opt/openoffice.org4
執行以下步驟來配置IBM SSL套接字提供程式:
建立java.security檔案的副本。 檔案的預設位置為[WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security
。
開啟複製的java.security檔案以進行編輯。
更改預設的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
若要啟用AEM Forms伺服器以使用更新的java.security檔案,請在啟動AEM Forms伺服器時,新增下列java引數:
-Djava.security.properties= [path of newly created Java.security file].
如果運行的是Microsoft Windows Server,請配置Ink and Sharttring服務。 需要此服務才能開啟使用Microsoft Office的連結功能的Microsoft PowerPoint檔案:
更改Microsoft Office信任中心設定,使PDF生成器服務能夠轉換使用舊版Microsoft Office建立的檔案。
開啟Microsoft Office應用程式。 例如Microsoft Word。 導覽至檔案> 選項。 「選項」對話框隨即出現。
按一下信任中心,然後按一下信任中心設定。
在信任中心設定中,按一下檔案塊設定。
在File Type清單中,取消選擇Open ,以確定PDF生成器服務應允許轉換為PDF文檔的檔案類型。
用於啟動應用程式伺服器的用戶帳戶需要替換進程級令牌權限。 本地系統帳戶預設具有替換進程級別令牌權限。 對於與本地管理員組的用戶一起運行的伺服器,必須明確授予該權限。 執行以下步驟授予權限:
您可以讓非管理員使用者使用PDF產生器服務。 通常,只有具有管理權限的用戶才能使用該服務:
要訪問系統配置實用程式,請轉至開始>運行,然後輸入MSCONFIG。
按一下工具頁簽,向下滾動並選擇更改UAC設定。 按一下Launch在新窗口中運行命令。
將滑桿調整到「永不通知」級別。 完成後,關閉命令窗口並關閉「系統配置」窗口。
驗證UAC的註冊表設定是否設定為0(零)。 執行下列步驟以驗證:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\
. 確保將EnableLUA的值設定為0(零)。重新啟動電腦。
在Windows Server上使用PDF生成器服務將文檔轉換為PDF時,Windows Server偶爾會報告執行檔遇到問題,需要關閉。 不過,它不會影響PDF轉換,因為它會在背景繼續進行。
為避免收到錯誤,您可以停用Windows錯誤報告。 有關禁用錯誤報告的詳細資訊,請參閱https://technet.microsoft.com/en-us/library/cc754364.aspx。
PDF產生器服務提供WebKit、WebCapture和PhantomJS路由或方法,將HTML檔案轉換為PDF檔案。 在Windows上,要啟用WebKit和Acrobat WebCapture路由的轉換,請將Unicode字型複製到%windir%\fonts目錄。
每當您將新字型安裝至字型資料夾時,請重新啟動AEM Forms執行個體。
在UNIX平台上,PDF產生器服務支援WebKit和PhantomJS路由,將HTML檔案轉換為PDF檔案。 若要啟用HTML轉換為PDF,請執行下列組態,適用於您偏好的轉換路徑:
根據您的系統,將Unicode字型複製到以下任何目錄:
AEM Forms附加元件套件是部署至AEM的應用程式。 此套件包含AEM Forms檔案服務和其他AEM Forms功能。 執行下列步驟以安裝套件:
開啟 Software Distribution。您需要 Adobe ID 才能登入 Software Distribution。
點一下頁首功能表中的 Adobe Experience Manager。
在Filters部分:
點選適用於您作業系統的套件名稱,選取「接受EULA條款」,然後點選「下載」。
開啟套件管理器,然後按一下「上傳套件」即可上傳套件。
選擇包,然後按一下Install。
您也可以透過AEM Forms發行文章中列出的直接連結下載套件。
安裝套件後,系統會提示您重新啟動AEM執行個體。 不要立即停止伺服器。 停止AEM Forms伺服器之前,請等待ServiceEvent REGISTERED和ServiceEvent UNEGRESTED消息停止顯示在.log檔 [AEM-Installation-Directory]/crx-quickstart/logs/error
案中,並且日誌穩定。
停止AEM例項。 導覽至[AEM安裝目錄]\crx-quickstart\conf\ folder 。 開啟sling.properties檔案以進行編輯。
如果您使用[AEM installation directory]\crx-quickstart\bin\start.bat
啟動AEM例項,請編輯位於[AEM_root]\crx-quickstart\
的sling.properties。
將下列屬性新增至sling.properties檔案:
sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*
(僅限AIX)將下列屬性新增至sling.properties檔案:
sling.bootdelegation.xerces=org.apache.xerces.*
儲存並關閉檔案。
以管理員身分登入AEM Configuration Manager。
找到並開啟CQ-DAM-Handler-Gibson字型管理器服務。 指定「系統字型」、「Adobe伺服器字型」和「客戶字型」目錄的路徑。 按一下「儲存」。
非Adobe方提供的字型的使用權受此類方向您提供的這些字型的許可協定管轄,而使用Adobe軟體的許可不涵蓋這些字型。 Adobe建議您在將非Adobe字型與Adobe軟體搭配使用之前,尤其是在伺服器環境中使用字型時,先檢閱並確保符合所有適用的非Adobe授權合約。
在字型資料夾中安裝新字型時,請重新啟動AEM Forms執行個體。
執行PDF產生器服務需要本機使用者帳戶。 有關建立本地用戶的步驟,請參閱在Windows🔗中建立用戶帳戶或在基於UNIX的平台中建立用戶帳戶。
開啟「AEM Forms PDF生成器配置」頁。
在用戶帳戶頁簽中,提供本地用戶帳戶的憑據,然後按一下提交。 如果Microsoft Windows提示,請允許訪問該用戶。 成功新增後,已設定的使用者會顯示在使用者帳戶標籤的您的使用者帳戶區段下。
在AEM Configuration Manager中,找到並開啟Jacorb ORB Provider服務。
將以下內容添加到Custom Properties.name欄位中,然後按一下Save。 它將掛起的答復超時(也稱為CORBA客戶端超時)設定為600秒。
jacorb.connection.client.pending_reply_timeout=600000
登入AEM製作例項,並導覽至Adobe Experience Manager > 工具 > Forms > 設定PDF產生器。 預設URL為http://localhost:4502/libs/fd/pdfg/config/ui.html。
開啟一般配置頁簽,並修改以下欄位的值以用於您的環境:
欄位 | 說明 | 預設值 |
伺服器轉換逾時 | PDFG轉換在伺服器轉換逾時中定義的秒數內保持作用中 | 270秒 |
PDFG 清理掃描秒數 | 執行轉換後操作所需的秒數。 |
3600秒 |
工作逾期秒數 | 允許PDF產生器服務執行轉換的持續時間。 確保「作業過期秒數」的值大於「PDFG清理掃描秒數」值。 | 7200秒 |
在Microsoft Windows上,PDF產生器服務使用Adobe Acrobat將支援的檔案格式轉換為PDF檔案。 執行下列步驟來為PDF產生器服務設定Adobe Acrobat:
開啟Acrobat並選取Edit> Preferences> Updater。 在檢查更新中,取消選擇自動安裝更新,然後按一下確定。 關閉Acrobat。
按兩下系統上的PDF文檔。 Acrobat首次啟動時,登入、歡迎畫面和EULA的對話方塊會隨即顯示。 為所有設定為使用PDF產生器的使用者關閉這些對話方塊。
執行PDF產生器公用程式批次檔案,為PDF產生器服務設定Acrobat:
開啟AEM Package Manager,然後從套件管理器下載adobe-aemfd-pdfg-common-pkg-[version].zip
檔案。
將下載的.zip檔案解壓縮。 以管理權限開啟命令提示符。
導覽至[extracted-zip-file]\jcr_root\etc\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\scripts
目錄。 運行以下批處理檔案:
Acrobat_for_PDFG_Configuration.bat
Acrobat已設定為透過PDF產生器服務執行。
執行系統整備工具(SRT)以驗證Acrobat安裝。 此工具會檢查電腦是否已正確設定以執行PDF產生器轉換,並在指定路徑產生報表:
開啟命令提示符。 導覽至[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
目錄。
導航到 [Path_of_reports_folder]
. 開啟SystemReadinessTool.html檔案。 驗證報表並修正上述問題。
PDF產生器服務提供多個路由,可將HTML檔案轉換為PDF檔案:Webkit、Acrobat WebCapture(僅限Windows)和PhantomJS。 Adobe建議使用PhantomJS路由,因為它具有處理動態內容的功能,並且對32位庫、32位JDK沒有依賴性,或者不需要額外的字型。 此外,PhantomJS路由不需要sudo或根存取權即可執行轉換。
HTML轉換為PDF的預設主要路由為Webkit。 要更改轉換路線,請執行以下操作:
在AEM製作例項上,導覽至工具> Forms> 設定PDF產生器。
在一般配置頁簽中,從HTML轉換為PDF的主要路由下拉式清單中選擇首選的轉換路由。
使用「信任儲存管理」,您可以導入、編輯和刪除您在伺服器上信任的證書,以驗證數字簽名和證書驗證。 您可以匯入和匯出任何數量的憑證。 匯入憑證後,您可以編輯信任設定和信任存放區類型。 執行以下步驟來初始化信任儲存:
DocAssurance服務可將使用權應用於PDF文檔。 若要對PDF檔案套用使用權限,請設定憑證。
設定憑證之前,請確定您有:
證書檔案(.pfx)。
憑證隨附的私密金鑰密碼。
私人金鑰別名. 您可以執行Java keytool命令來查看私鑰別名:
keytool -list -v -keystore [keystore-file] -storetype pkcs12
密鑰庫檔案密碼。 如果您使用的是Adobe的Reader擴充功能憑證,金鑰存放區檔案密碼一律與私密金鑰密碼相同。
執行下列步驟來設定憑證:
以管理員身分登入AEM Author例項。 前往工具 > 安全性 > 使用者。
按一下使用者帳戶的name欄位。 將開啟「編輯用戶設定」頁。 在AEM製作例項上,憑證位於KeyStore中。 如果您之前尚未建立KeyStore,請按一下建立KeyStore並為KeyStore設定新密碼。 如果伺服器已包含KeyStore,請跳過此步驟。 如果您使用的是Adobe的Reader擴充功能憑證,金鑰存放區檔案密碼一律與私密金鑰密碼相同。
在編輯用戶設定頁面上,選擇KeyStore頁簽。 展開從密鑰儲存檔案添加私鑰選項並提供別名。 別名用於執行Reader擴展操作。
要上載證書檔案,請按一下選擇密鑰儲存檔案並上載<filename>.pfx檔案。
將與證書關聯的密鑰儲存密碼、私鑰密碼和私鑰別名添加到相應欄位。 按一下Submit。
在生產環境中,將評估憑證取代為生產憑證。 在更新過期或評估憑據之前,請確保刪除舊的Reader擴展憑據。
按一下編輯用戶設定頁面上的保存並關閉。
若要對PDF檔案使用AES 256加密,請取得並安裝Java加密擴充功能(JCE)無限強度管轄權原則檔案。 替換jre/lib/security資料夾中的local_policy.jar和US_export_policy.jar檔案。 例如,如果您使用Sun JDK,請將下載的檔案複製到[JAVA_HOME]/jre/lib/security
資料夾。
組合器服務依賴於Reader擴展服務、簽名服務、Forms服務和輸出服務。 執行下列步驟以驗證所需的服務是否已啟動並正在運行:
https://'[server]:[port]'/system/console/bundles
。服務名稱 | 組合包名稱 |
---|---|
簽名服務 | adobe-aemfd簽名 |
Reader 延伸模組服務 | com.adobe.aemfd.adobe-aemfd-readerextensions |
表單服務 | com.adobe.livecycle.adobe-lc-forms-bedrock-connector |
輸出服務 | com.adobe.livecycle.adobe-lc-forms-bedrock-connector |
如果壓縮的輸入檔案包含檔案名稱中包含雙位元組字元的HTML檔案,則HTML轉換為PDF會失敗。 為避免此問題,在命名HTML檔案時,請勿使用雙位元組字元。
在基於UNIX的作業系統上,執行以下操作以查找任何缺少的庫:
導航到 [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/
.
執行下列命令,列出PhantomJS轉換HTML至PDF所需的所有程式庫。
ldd phantomjs
運行以下命令以列出缺少的庫。
ldd phantomjs | grep not
手動安裝遺失的程式庫。
您有正常運作的AEM Forms檔案服務環境。 您可以通過以下方式使用文檔服務: