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的功能,并为文档添加数字签名。文档保障服务包含三项服务:签名、加密和读者扩展。 有关详细信息,请参阅DocAssurance Service。
加密服务: 允许您加密和解密文档。文档加密后,其内容将变得不可读。 授权用户可以解密文档以获得对其内容的访问。 有关详细信息,请参阅Encryption 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 Forms是一个强大的企业级平台,文档服务只是AEM Forms的一项能力。 有关功能的完整列表,请参见AEM Forms简介。
AEM Forms加载项包是部署到AEM上的应用程序。 通常,您只需一个AEM实例(作者或发布)即可运行AEM Forms文档服务。 建议使用以下拓扑来运行AEM Forms文档服务。 有关拓扑的详细信息,请参阅AEM Forms的架构和部署拓扑。
尽管AEM Forms允许您从单台服务器设置和运行所有功能,但您应该执行容量规划、负载平衡,并为生产环境中的特定功能设置专用服务器。 例如,对于使用PDF Generator服务环境每天转换数千页和多个自适应表单以捕获数据,请为PDF Generator服务和自适应表单功能设置单独的AEM Forms服务器。 它有助于提供最佳性能并独立扩展服务器。
开始安装和配置AEM Forms文档服务之前,请确保:
硬件和软件基础架构已到位。 有关受支持硬件和软件的详细列表,请参见技术要求。
AEM实例的安装路径不包含空格。
AEM实例已启动且正在运行。 在AEM术语中,“实例”是在创作或发布模式下在服务器上运行的AEM的副本。 通常,您只需一个AEM实例(作者或发布)即可运行AEM Forms文档服务:
满足内存要求。 AEM Forms附加包要求:
安装了PDF生成器在Microsoft Windows和Linux上执行转换所需的客户端软件:
如果您使用基于UNIX的操作系统,请从相应操作系统的安装介质安装以下软件包:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(仅限PDF Generator)安装libcurl、libcrypto和libssl库的32位版本并创建以下符号链接。符号链接指向各个库的最新版本:
(仅限PDF Generator)PDF Generator 服务支持WebKit和PhantomJS路由,以将HTML文件转换为PDF文档。要启用PhantomJS路由的转换,请安装下面列出的64位库。 通常,已安装这些库。 如果缺少任何库,请手动安装它:
安装前配置部分中列出的配置仅适用于PDF Generator服务。 如果您未配置PDF Generator服务,可跳过安装前配置部分。
如果您要使用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 Generator服务结合使用。
为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 |
记事本 |
Notepad_PATH |
C:\WINDOWS\notepad.exe |
OpenOffice |
OpenOffice_PATH |
C:\Program Files (x86)\OpenOffice.org4 |
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 Sharting服务。 需要该服务才能打开使用Microsoft Office的输墨功能的Microsoft PowerPoint文件:
更改Microsoft Office信任中心设置,使PDF Generator服务能够转换使用旧版Microsoft Office创建的文件。
打开Microsoft Office应用程序。 例如,Microsoft Word。 导航到文件> 选项。 将出现选项对话框。
单击信任中心,然后单击信任中心设置。
在信任中心设置中,单击文件块设置。
在文件类型列表中,取消选择打开以获取PDF Generator服务应允许转换为PDF文档的文件类型。
用于开始应用程序服务器的用户帐户需要替换进程级别令牌权限。 默认情况下,本地系统帐户具有替换进程级别令牌权限。 对于与本地管理员组的用户一起运行的服务器,必须明确授予该权限。 请执行以下步骤以授予权限:
您可以允许非管理员用户使用PDF Generator服务。 通常,只有具有管理权限的用户才能使用服务:
要访问系统配置实用程序,请转至开始>运行,然后输入MSCONFIG。
单击工具选项卡并向下滚动并选择更改UAC设置。 单击启动以在新窗口中运行命令。
将滑块调整到“从不通知”级别。 完成后,关闭命令窗口并关闭“System Configuration(系统配置)”窗口。
验证UAC的注册表设置是否设置为0(零)。 请执行以下步骤验证:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\
. 确保将EnableLUA的值设置为0(零)。重新启动计算机。
在Windows服务器上使用PDF Generator服务将文档转换为PDF时,Windows Server偶尔会报告可执行文件遇到问题,需要关闭。 但是,它不会影响PDF转换,因为它在后台继续。
为避免收到错误,您可以禁用Windows错误报告。 有关禁用错误报告的详细信息,请参阅https://technet.microsoft.com/en-us/library/cc754364.aspx。
PDF Generator服务提供WebKit、WebCapture和PhantomJS路由或方法,将HTML文件转换为PDF文档。 在Windows上,要启用WebKit和AcrobatWebCapture路由的转换,请将Unicode字体复制到%windir%\fonts目录。
只要将新字体安装到字体文件夹,请重新启动AEM Forms实例。
在基于UNIX的平台上,PDF Generator服务支持WebKit和PhantomJS路由,以将HTML文件转换为PDF文档。 要启用HTML到PDF的转换,请执行适用于首选转换路由的以下配置:
根据您的系统,将Unicode字体复制到以下任意目录:
AEM Forms加载项包是部署到AEM上的应用程序。 这一一揽子计划包含AEM Forms文档服务和其他AEM Forms能力。 请执行以下步骤来安装包:
打开软件分发。 您需要Adobe ID才能登录软件分发。
点按标题菜单中的Adobe Experience Manager。
在过滤器部分中:
点按适用于您的操作系统的程序包名称,选择接受EULA条款,然后点按下载。
打开包管理器并单击上传包以上传包。
选择软件包,然后单击安装。
您还可以通过AEM Forms版本文章中列出的直接链接下载软件包。
安装包后,系统会提示您重新启动AEM实例。 不要立即停止服务器。 在停止AEM Forms服务器之前,请等到ServiceEvent REGISTERED和ServiceEvent UNREGISTERED消息停止显示在。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.*
(仅限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 Generator服务需要本地用户帐户。 有关创建本地用户的步骤,请参阅在Windows或在基于UNIX的平台中创建用户帐户。
在用户帐户选项卡中,提供本地用户帐户的凭据,然后单击提交。 如果Microsoft Windows提示,允许访问用户。 成功添加后,配置的用户将显示在用户帐户选项卡的用户帐户部分下。
在AEM配置管理器中,找到并打开Jacorb ORB提供程序服务。
在自定义属性名称字段中添加以下内容,然后单击保存。 它将挂起的回复超时(也称为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 Generator服务运行转换的持续时间。 确保作业过期秒数的值大于PDFG清除扫描秒数值。 | 7200秒 |
在Microsoft Windows上,PDF Generator服务使用Adobe Acrobat将支持的文件格式转换为PDF文档。 请执行以下步骤为PDF Generator服务配置Adobe Acrobat:
打开Acrobat并选择编辑>首选项> 更新程序。 在检查更新中,取消选择自动安装更新,然后单击确定。 关闭Acrobat。
多次-单击系统上的PDF文档。 当Acrobat首次开始时,将显示登录、欢迎屏幕和EULA对话框。 为配置为使用PDF生成器的所有用户关闭这些对话框。
运行PDF Generator实用程序批处理文件,为PDF Generator服务配置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 Generator服务一起运行。
运行系统就绪性工具(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 Generator服务提供多条路由将HTML文件转换为PDF文档:Webkit、AcrobatWebCapture(仅限Windows)和PhantomJS。 Adobe建议使用PhantomJS路由,因为它能够处理动态内容,并且不依赖32位库、32位JDK,或不需要任何额外字体。 此外,PhantomJS路由不需要sudo或root访问权限即可运行转换。
HTML到PDF转换的默认主要路由是Webkit。 要更改转换路线:
在AEM作者实例上,导航到工具Forms> 配置PDF生成器。
在常规配置选项卡中,从HTML到PDF转换的主路由下拉菜单中选择首选转换路由。
使用信任存储管理,您可以导入、编辑和删除您信任的证书,以验证数字签名和证书身份验证。 您可以导入和导出任意数量的证书。 导入证书后,您可以编辑信任设置和信任存储类型。 请执行以下步骤以初始化信任存储:
DocAssurance服务可将使用权限应用于PDF文档。 要对PDF文档应用使用权限,请配置证书。
在设置证书之前,请确保您具有:
证书文件(.pfx)。
随证书提供的私钥密码。
私钥别名. 您可以执行Java keytool命令来视图私钥别名:
keytool -list -v -keystore [keystore-file] -storetype pkcs12
密钥库文件密码。 如果您使用Adobe的Reader扩展证书,则Keystore文件密码始终与私钥密码相同。
请执行以下步骤配置证书:
以管理员身份登录到AEM作者实例。 转到工具 > 安全 > 用户。
单击用户帐户的name字段。 将打开编辑用户设置页。 在AEM作者实例中,证书驻留在KeyStore中。 如果您之前尚未创建KeyStore,请单击创建KeyStore并为KeyStore设置新密码。 如果服务器已包含KeyStore,请跳过此步骤。 如果您使用Adobe的Reader扩展证书,则Keystore文件密码始终与私钥密码相同。
在编辑用户设置页面上,选择KeyStore选项卡。 展开从密钥存储文件添加私钥选项并提供别名。 别名用于执行Reader扩展操作。
要上传证书文件,请单击选择密钥存储文件并上传<filename>.pfx文件。
将与证书关联的密钥存储密码、私钥密码和私钥别名添加到相应字段。 单击提交。
在生产环境中,将您的评估凭据替换为生产凭据。 请确保在更新过期或评估凭据之前删除旧的Reader扩展凭据。
单击编辑用户设置页面上的保存并关闭。
要对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服务和输出服务。 请执行以下步骤以验证所需的服务是否已启动并正在运行:
https://'[server]:[port]'/system/console/bundles
。服务名称 | 包名称 |
---|---|
签名服务 | adobe-aemfd-signatures |
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文档服务环境。 您可以通过以下方式使用文档服务: