安装和配置文档服务

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服务器在将表单发送给用户以使用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实例。内容准备就绪后，即会复制到发布实例。
  • 发布:通过Internet或内部网络向公众提供已发布内容的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的操作系统，请从相应操作系统的安装介质安装以下软件包：

expat	libxcb	freetype	libXau
libSM	zlib	libICE	libuuid
glibc	libXext	nss-softokn-freebl	fontconfig
libX11	libXrender	libXrandr	libXinerama

• (仅限PDF Generator)安装libcurl、libcrypto和libssl库的32位版本并创建以下符号链接。符号链接指向各个库的最新版本：

  • /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 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

（仅用于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 Sharting服务。 需要该服务才能打开使用Microsoft Office的输墨功能的Microsoft PowerPoint文件：

1. 打开服务器管理器。 单击快速启动托盘上的​服务器管理器​图标。
2. 单击​功能​菜单中的​添加功能。 选中​墨水和手写服务​复选框。
3. 选择“ 功能”对话框， 并选择“油墨和笔 迹服务”。单击​安装​并安装服务。

（仅限Windows）为Microsoft Office配置文件块设置

更改Microsoft Office信任中心设置，使PDF Generator服务能够转换使用旧版Microsoft Office创建的文件。

1. 打开Microsoft Office应用程序。 例如，Microsoft Word。 导航到​文件> 选项。 将出现选项对话框。

2. 单击​信任中心，然后单击​信任中心设置。

3. 在​信任中心设置​中，单击​文件块设置。

4. 在​文件类型​列表中，取消选择​打开​以获取PDF Generator服务应允许转换为PDF文档的文件类型。

（仅限Windows）授予替换进程级别令牌权限

用于开始应用程序服务器的用户帐户需要​替换进程级别令牌​权限。 默认情况下，本地系统帐户具有​替换进程级别令牌​权限。 对于与本地管理员组的用户一起运行的服务器，必须明确授予该权限。 请执行以下步骤以授予权限：

1. 打开Microsoft Windows的组策略编辑器。 要打开组策略编辑器，请单击“开始搜索”框中的​开始，键入​gpedit.msc，然后单击​组策略编辑器。
2. 导航到​本地计算机策略 > 计算机配置 > Windows设置 > 安全设置 本地策略 > 用户权限分配​并编辑​替换进程级别令牌​策略并包括管理员组。
3. 将用户添加到替换进程级别令牌条目。

（仅限Windows）为非管理员启用PDF Generator服务

您可以允许非管理员用户使用PDF Generator服务。 通常，只有具有管理权限的用户才能使用服务：

1. 创建环境变量PDFG_NON_ADMIN_ENABLED。
2. 将环境变量的值设置为TRUE。
3. 重新启动AEM Forms实例。

（仅限Windows）禁用用户帐户控制(UAC)

1. 要访问系统配置实用程序，请转至​开始>运行，然后输入​MSCONFIG。

2. 单击​工具​选项卡并向下滚动并选择​更改UAC设置。 单击​启动​以在新窗口中运行命令。

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服务器上使用PDF Generator服务将文档转换为PDF时，Windows Server偶尔会报告可执行文件遇到问题，需要关闭。 但是，它不会影响PDF转换，因为它在后台继续。

为避免收到错误，您可以禁用Windows错误报告。 有关禁用错误报告的详细信息，请参阅https://technet.microsoft.com/en-us/library/cc754364.aspx。

（仅限Windows）配置HTML到PDF的转换

PDF Generator服务提供WebKit、WebCapture和PhantomJS路由或方法，将HTML文件转换为PDF文档。 在Windows上，要启用WebKit和AcrobatWebCapture路由的转换，请将Unicode字体复制到%windir%\fonts目录。

（仅限基于UNIX的平台）HTML到PDF转换的额外配置

在基于UNIX的平台上，PDF Generator服务支持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. 打开软件分发。 您需要Adobe ID才能登录软件分发。

2. 点按标题菜单中的​Adobe Experience Manager。

3. 在​过滤器​部分中：

   1. 从​解决方案​下拉列表中选择​Forms。
   2. 选择包的版本和类型。 您还可以使用​搜索下载​选项筛选结果。

4. 点按适用于您的操作系统的程序包名称，选择​接受EULA条款，然后点按​下载。

5. 打开包管理器并单击​上传包​以上传包。

6. 选择软件包，然后单击​安装。

   您还可以通过AEM Forms版本文章中列出的直接链接下载软件包。

7. 安装包后，系统会提示您重新启动AEM实例。 不要立即停止服务器。 在停止AEM Forms服务器之前，请等到ServiceEvent REGISTERED和ServiceEvent UNREGISTERED消息停止显示在。log文 [AEM-Installation-Directory]/crx-quickstart/logs/error件中并且日志是稳定的。

安装后配置

为RSA/BouncyCastle库配置引导委派

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.*
   

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 Generator服务需要本地用户帐户。 有关创建本地用户的步骤，请参阅在Windows或在基于UNIX的平台中创建用户帐户。

1. 打开AEM FormsPDF Generator配置页。

2. 在​用户帐户​选项卡中，提供本地用户帐户的凭据，然后单击​提交。 如果Microsoft Windows提示，允许访问用户。 成功添加后，配置的用户将显示在​用户帐户​选项卡的​用户帐户​部分下。

配置超时设置

1. 在AEM配置管理器中，找到并打开​Jacorb ORB提供程序​服务。

   在​自定义属性名称​字段中添加以下内容，然后单击​保存。 它将挂起的回复超时（也称为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。

   打开​常规配置​选项卡，并修改以下字段的值以用于您的环境:

字段	描述	默认值
服务器转换超时	PDFG转换在服务器转换超时中定义的秒数内保持活动状态	270秒
PDFG 清理扫描秒数	执行转换后操作所需的秒数。	3600秒
作业盗取秒数	允许PDF Generator服务运行转换的持续时间。 确保作业过期秒数的值大于PDFG清除扫描秒数值。	7200秒

（仅限Windows）为PDF Generator服务配置Acrobat

在Microsoft Windows上，PDF Generator服务使用Adobe Acrobat将支持的文件格式转换为PDF文档。 请执行以下步骤为PDF Generator服务配置Adobe Acrobat:

1. 打开Acrobat并选择​编辑>首选项> 更新程序。 在检查更新中，取消选择​自动安装更新，然后单击​确定。 关闭Acrobat。

2. 多次-单击系统上的PDF文档。 当Acrobat首次开始时，将显示登录、欢迎屏幕和EULA对话框。 为配置为使用PDF生成器的所有用户关闭这些对话框。

3. 运行PDF Generator实用程序批处理文件，为PDF Generator服务配置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 Generator服务一起运行。

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 Generator服务提供多条路由将HTML文件转换为PDF文档:Webkit、AcrobatWebCapture（仅限Windows）和PhantomJS。 Adobe建议使用PhantomJS路由，因为它能够处理动态内容，并且不依赖32位库、32位JDK，或不需要任何额外字体。 此外，PhantomJS路由不需要sudo或root访问权限即可运行转换。

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扩展证书，则Keystore文件密码始终与私钥密码相同。

请执行以下步骤配置证书：

1. 以管理员身份登录到AEM作者实例。 转到​工具 > 安全 > 用户。

2. 单击用户帐户的​name​字段。 将打开​编辑用户设置​页。 在AEM作者实例中，证书驻留在KeyStore中。 如果您之前尚未创建KeyStore，请单击​创建KeyStore​并为KeyStore设置新密码。 如果服务器已包含KeyStore，请跳过此步骤。 如果您使用Adobe的Reader扩展证书，则Keystore文件密码始终与私钥密码相同。

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. 搜索以下服务，确保服务已启动并正在运行：

服务名称	包名称
签名服务	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的操作系统上，执行以下操作以查找任何缺少的库：

1. 导航至 [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/.

2. 运行以下命令以列表PhantomJS需要HTML到PDF转换的所有库。

   ldd phantomjs

   运行以下命令以列表缺失的库。

   ldd phantomjs | grep not

3. 手动安装缺少的库。

后续步骤

你有一个AEM Forms文档服务环境。 您可以通过以下方式使用文档服务：

• 在OSGi上以表单为中心的工作流
• 观察文件夹
• 文档服务API