文档AEM 6.5用户指南

安装和配置文档服务 installing-and-configuring-document-services

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined
  • undefined
  • undefined

AEM Forms提供一套OSGi服务来完成不同的文档级别操作，例如，创建、汇编、分发和存档PDF文档，添加数字签名以限制对文档的访问，以及对条形码Forms进行解码的服务。 这些服务包含在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)。 有关详细信息，请参阅转换PDF服务。

  • 条码Forms服务： ​允许您从条码的电子图像中提取数据。 该服务接受包括一个或多个条形码作为输入的TIFF和PDF文件，并提取条形码数据。 有关详细信息，请参阅条码式Forms服务。

  • DocAssurance服务： ​使您能够加密和解密文档，使用其他使用权限扩展Adobe Reader的功能，以及向文档添加数字签名。 文档保证服务包含三个服务：签名、加密和读取器扩展。 有关详细信息，请参阅DocAssurance服务。

  • 加密服务： ​允许您加密和解密文档。 文档加密后，其内容将变得不可读。 授权用户可以解密文档以获取对其内容的访问权限。 有关详细信息，请参阅加密服务。

  • Forms服务： ​允许您创建交互式数据捕获客户端应用程序，这些应用程序验证、处理、转换并交付通常在Forms Designer中创建的表单。 Forms服务会呈现您为PDF文档而开发的任何表单设计。 有关详细信息，请参阅Forms服务。

  • 输出服务： ​允许您创建不同格式的文档，包括PDF、激光打印机格式和标签打印机格式。 激光打印机格式包括PostScript和打印机控制语言(PCL)。 有关详细信息，请参阅输出服务。

  • PDF Generator服务： PDF Generator服务提供API以将本机文件格式转换为PDF。 它还会将PDF转换为其他文件格式并优化PDF文档的大小。 有关详细信息，请参阅PDF Generator服务。

  • Reader扩展服务： ​通过扩展具有附加使用权限的Adobe Reader的功能，使您的组织可以轻松共享交互式PDF文档。 该服务激活在使用Adobe Reader打开PDF文档时不可用的功能，例如向文档添加注释、填写表单和保存文档。 有关详细信息，请参阅Reader扩展服务。

  • 签名服务： ​允许您在AEM服务器上处理数字签名和文档。 例如，签名服务通常用于以下情况：

    • AEM服务器在将表单发送给用户以使用Acrobat或Adobe Reader打开它之前对表单进行认证。
    • AEM服务器使用Acrobat或Adobe Reader验证添加到表单的签名。
    • AEM服务器代表公共公证人签署表单。

    签名服务访问存储在信任存储中的证书和凭据。 有关详细信息，请参阅签名服务。

AEM Forms是一个功能强大的企业级平台，而文档服务只是AEM Forms的功能之一。 有关功能的完整列表，请参阅AEM Forms简介。

部署拓扑 deployment-topology

AEM Forms附加组件包是部署在AEM上的应用程序。 通常，您只需要一个AEM实例（创作或发布）即可运行AEM Forms文档服务。 建议通过以下拓扑来运行AEM Forms文档服务。 有关拓扑的详细信息，请参阅AEM Forms的架构和部署拓扑。

AEM Forms的架构和部署拓扑

NOTE
虽然AEM Forms允许您从一台服务器设置和运行所有功能，但您应该进行容量规划、负载平衡，并为生产环境中的特定功能设置专用服务器。 例如，对于使用PDF Generator服务每天转换数千页以及使用多个自适应表单捕获数据的环境，请为PDF Generator服务和自适应表单功能设置单独的AEM Forms服务器。 它有助于提供最佳性能并扩展相互独立的服务器。

系统要求 system-requirements

在开始安装和配置AEM Forms文档服务之前，请确保：

  • 硬件和软件基础架构已准备就绪。 有关支持的硬件和软件的详细列表，请参阅技术要求。

  • AEM实例的安装路径不包含空格。

  • AEM实例已启动并正在运行。 在AEM术语中，“实例”是在创作或发布模式下在服务器上运行的AEM的副本。 通常，您只需要一个AEM实例（创作或发布）即可运行AEM Forms文档服务：

    • 作者：用于创建、上载和编辑内容以及管理网站的AEM实例。 内容准备好上线后，即会复制到发布实例。
    • Publish：通过Internet或内部网络向公众提供已发布内容的AEM实例。

  • 满足内存要求。 AEM Forms附加组件包需要：

    • 用于基于Microsoft® Windows的安装的15 GB临时空间。
    • 用于基于UNIX的安装的6 GB临时空间。

  • 已安装在Microsoft®Windows和Linux®上执行PDF生成器转换所需的客户端软件：

NOTE
  • 在Microsoft® Windows上，PDF Generator支持将HTML文件转换为PDF文档的WebKit、Acrobat WebCapture和WebToPDF转换途径。
  • 在基于UNIX的操作系统上，PDF Generator支持WebKit和WebToPDF转换路径以将HTML文件转换为PDF文档。

基于UNIX的操作系统的额外要求 extrarequirements

如果使用的是基于UNIX的操作系统，请从相应操作系统的安装介质安装以下32位软件包：

  • 外派人员
  • libxcb
  • 自由类型
  • 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和WebToPDF路由以将HTML文件转换为PDF文档。 要启用WebToPDF路由的转换，请安装下面列出的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

安装前配置 preinstallationconfigurations

预安装配置部分中列出的配置仅适用于PDF Generator服务。 如果未配置PDF Generator服务，则可以跳过安装前配置部分。

安装Adobe Acrobat和第三方应用程序 install-adobe-acrobat-and-third-party-applications

如果您要使用PDF Generator服务将本机文件格式(如Microsoft® Word、Microsoft®Excel、Microsoft®PowerPoint、OpenOffice、WordPerfect X7和Adobe Acrobat)转换为PDF文档，请确保在AEM Forms Server上安装了这些应用程序。

NOTE
  • 如果您的AEM Forms服务器处于脱机或安全环境，并且Internet无法激活Adobe Acrobat，请参阅脱机激活以获取有关激活此类Adobe Acrobat实例的说明。
  • Adobe Acrobat、Microsoft®Word、Excel和Powerpoint仅适用于Microsoft®Windows。 如果使用的是基于UNIX的操作系统，请安装OpenOffice以将RTF文件和支持的Microsoft® Office文件转换为PDF文档。
  • 关闭所有配置为使用PDF Generator服务的用户安装Adobe Acrobat和第三方软件后显示的对话框。
  • 至少启动一次所有已安装的软件。 关闭所有配置为使用PDF Generator服务的用户的对话框。
  • 检查Adobe Acrobat序列号到期日期并设置更新许可证的日期，或根据到期日期迁移序列号。

安装Acrobat后，打开Microsoft® Word。 在​ Acrobat ​选项卡上，单击​ 创建PDF，并将计算机上可用的.doc或.docx文件转换为PDF文档。 如果转换成功，AEM Forms将可以将Acrobat与PDF Generator服务结合使用。

设置环境变量 setup-environment-variables

为64位Java开发工具包、第三方应用程序和Adobe Acrobat设置环境变量。 环境变量应包含用于启动相应应用程序的可执行文件的绝对路径，例如，下表列出了一些应用程序的环境变量：

应用程序
环境变量
示例
JDK（64位）
JAVA_HOME
C:\Program Files\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路径
C:\Program Files (x86)\OpenOffice.org4
NOTE

  • 所有环境变量和相应的路径都区分大小写。

  • JAVA_HOME和Acrobat_PATH（仅限Windows）是强制环境变量。

  • 环境变量OpenOffice_PATH设置为安装文件夹，而不是设置为可执行文件的路径。

  • 请勿为Microsoft® Office应用程序（如Word、PowerPoint、Excel和Project）或AutoCAD设置环境变量。 如果这些应用程序安装在服务器上，则生成PDF服务会自动启动这些应用程序。

  • 在基于UNIX的平台上，将OpenOffice安装为/root。 如果OpenOffice未安装为root，则PDF Generator服务无法将OpenOffice文档转换为PDF文档。 如果需要以非根用户身份安装和运行OpenOffice，请向非根用户提供sudo权限。

  • 如果在基于UNIX的平台上使用OpenOffice，请运行以下命令来设置路径变量：

    export OpenOffice_PATH=/opt/openoffice.org4

(仅适用于IBM® WebSphere®)配置IBM® SSL套接字提供程序 only-for-ibm-websphere-configure-ibm-ssl-socket-provider

执行以下步骤来配置IBM® SSL套接字提供程序：

  1. 创建java.security文件的副本。 文件的默认位置为[WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security。

  2. 打开复制的java.security文件进行编辑。

  3. 将默认SSL套接字工厂更改为使用JSSE2工厂，而不是默认的IBM® WebSphere®工厂：

    默认内容：

    code language-shell 
    #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

    修改的内容：

    code language-shell 
    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® Office配置文件块设置 configure-the-file-block-settings-for-microsoft-office

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

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

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

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

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

（仅限Windows）授予Replace a process level token权限 grant-the-replace-a-process-level-token-privilege

用于启动应用服务器的用户帐户需要​ 替换进程级令牌 ​权限。 默认情况下，本地系统帐户具有​ 替换进程级令牌 ​权限。 对于使用Local Administrators组的用户运行的服务器，必须明确授予权限。 执行以下步骤可授予权限：

  1. 打开Microsoft® Windows的组策略编辑器。 若要打开组策略编辑器，请单击​ 开始，在“开始搜索”框中键入​ gpedit.msc，然后单击​ 组策略编辑器。
  2. 导航到​ 本地计算机策略 > 计算机配置 > Windows设置 > 安全设置 > 本地策略 > 用户权限分配，并编辑​ 替换进程级别令牌 ​策略并包含Administrators组。
  3. 将用户添加到“替换进程级令牌”条目。
NOTE
如上所示，如果AEM服务器是以LocalSystem帐户(LSA)下的服务方式运行的，则不必向用户显式分配此权限。

（仅限Windows）为非管理员启用PDF Generator服务 enable-the-pdf-generator-service-for-non-administrators

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

  1. 创建环境变量PDFG_NON_ADMIN_ENABLED。
  2. 将环境变量的值设置为TRUE。
  3. 重新启动AEM Forms实例。
NOTE
建议使用“Ctrl + C”命令重新启动SDK。 使用替代方法（例如，停止Java进程）重新启动AEM SDK可能会导致AEM开发环境不一致。

（仅限Windows）禁用用户帐户控制(UAC) disable-user-account-control-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）禁用错误报告服务 disable-error-reporting-service

使用Windows Server上的PDF服务将文档转换为PDF Generator时，Windows Server偶尔会报告可执行文件遇到问题且必须关闭。 但是，它不会影响PDF转换，因为它会在后台继续。

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

（仅限Windows）配置HTML到PDF的转换 configure-html-to-pdf-conversion

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

NOTE
每当您将新字体安装到fonts文件夹时，请重新启动AEM Forms实例。

（仅限基于UNIX的平台）用于HTML到PDF转换的额外配置 extra-configurations-for-html-to-pdf-conversion

在基于UNIX的平台上，PDF Generator服务支持WebKit和WebToPDF路由将HTML文件转换为PDF文档。 要启用HTML到PDF的转换，请执行以下适用于您的首选转换路由的配置：

（仅限基于UNIX的平台）启用对Unicode字体的支持（仅限WebKit） enable-support-for-unicode-fonts-webkit-only

根据您的系统将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™)
NOTE
  • 在Red Hat® Enterprise Linux® 6.x及更高版本上，Courier字体不可用。 要安装courier字体，请下载font-ibm-type1-1.0.3.zip存档。 在/usr/share/fonts处提取存档。 创建从/usr/share/X11/fonts到/usr/share/fonts的符号链接。
  • 从Html2PdfSvc/bin和/usr/share/fonts目录中删除所有.lst字体缓存文件。
  • 确保目录/usr/lib/X11/fonts和/usr/share/fonts存在。 如果目录不存在，则使用ln命令创建从/usr/share/X11/fonts到/usr/lib/X11/fonts的符号链接，以及从/usr/share/fonts到/usr/share/X11/fonts的另一个符号链接。 另外，请确保在/usr/lib/X11/fonts中提供courier字体。
  • 确保/usr/share/fonts或/usr/share/X11/fonts目录中的所有字体（Unicode和非Unicode）均可用。
  • 以非root用户身份运行PDF Generator服务时，向非root用户提供对所有字体目录的读写访问权限。
  • 每当您将新字体安装到fonts文件夹时，请重新启动AEM Forms实例。

安装AEM Forms附加组件包 install-aem-forms-add-on-package

AEM Forms附加组件包是部署在AEM上的应用程序。 该资源包中包含AEM Forms Document Services及其他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 UNREGISTERED消息停止出现在[AEM-Installation-Directory]/crx-quickstart/logs/error.log文件中并且日志稳定。

Post安装配置 post-installation-configurations

为RSA/BouncyCastle库配置引导委派 configure-boot-delegation-for-rsa-bouncycastle-libraries

  1. 停止AEM实例。 导航到[AEM安装目录]\crx-quickstart\conf\文件夹。 打开sling.properties文件进行编辑。

    如果您使用[AEM installation directory]\crx-quickstart\bin\start.bat启动AEM实例，请编辑位于[AEM_root]\crx-quickstart\的sling.properties。

  2. 将以下属性添加到sling.properties文件：

    code language-shell 
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*

  3. (仅限AIX®)将以下属性添加到sling.properties文件：

    code language-shell 
    sling.bootdelegation.xerces=org.apache.xerces.*

  4. 保存并关闭该文件。

配置字体管理器服务 configuring-the-font-manager-service

  1. 以管理员身份登录到AEM Configuration Manager。

  2. 找到并打开​ CQ-DAM-Handler-Gibson字体管理器 ​服务。 指定System Fonts、System Server Fonts和Customer Fonts目录的Adobe。 单击​ 保存。

    note note
    NOTE
    您使用Adobe以外的各方提供的字体的权利受这些各方提供给您的这些字体的许可协议管辖，并且不在您使用Adobe软件的许可范围内。 Adobe建议在将非Adobe字体用于Adobe软件之前，特别是有关在服务器环境中使用字体时，查看并确保遵守所有适用的非Adobe许可协议。
    在将新字体安装到fonts文件夹时，请重新启动AEM Forms实例。

配置本地用户帐户以运行PDF Generator服务 configure-a-local-user-account-to-run-the-pdf-generator-service

需要本地用户帐户才能运行PDF Generator服务。 有关创建本地用户的步骤，请参阅在Windows中创建用户帐户，或在基于UNIX的平台上创建用户帐户。

  1. 打开AEM Forms PDF Generator配置页。

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

配置超时设置 configure-the-time-out-settings

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

    将以下内容添加到​ Custom Properties.name ​字段，然后单击​ 保存。 它将挂起回复超时（也称为CORBA客户端超时）设置为600秒。

    jacorb.connection.client.pending_reply_timeout=600000

  2. 登录到AEM创作实例并导航到​ Adobe Experience Manager > 工具 > Forms > 配置PDF Generator。 默认URL为http://localhost:4502/libs/fd/pdfg/config/ui.html。

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

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

（仅限Windows）为PDF Generator服务配置Acrobat configure-acrobat-for-the-pdf-generator-service

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

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

  2. 双击系统上的PDF文档。 当Acrobat首次启动时，将显示登录、欢迎屏幕和EULA对话框。 为所有配置为使用PDF Generator的用户关闭这些对话框。

  3. 运行PDF Generator实用程序批处理文件，为PDF Generator服务配置Acrobat：

    1. 打开AEM包管理器并从包管理器下载adobe-aemfd-pdfg-common-pkg-[version].zip文件。

    2. 解压缩下载的.zip文件。 使用管理权限打开命令提示符。

    3. 导航到[extracted-zip-file]\jcr_root\etc\packages\day\cq60\fd\adobe-aemds-common-pkg-[version]\jcr_root\etc\packages\day\cq60\fd\

    4. 解压缩adobe-aemfd-pdfg-common-pkg-[version]。

    5. 导航到[downloaded-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]目录。 运行以下批处理文件：

      Acrobat_for_PDFG_Configuration.bat

      Acrobat配置为与PDF Generator服务一起运行。

  4. 运行系统就绪工具(SRT)以验证Acrobat安装。

（仅限Windows）配置HTML到PDF转换的主路由 configure-primary-route-for-html-to-pdf-conversion-windows-only

PDF Generator服务提供将HTML文件转换为PDF文档的多种途径：Webkit、Acrobat WebCapture（仅限Windows）和WebToPDF。 Adobe建议使用WebToPDF路由，因为它能够处理动态内容，并且不依赖于32位库或不需要额外字体。 此外，WebToPDF路由不需要sudo或root访问权限即可运行转换。

HTML到PDF转换的默认主要路由为Webkit。 要更改转换路线，请执行以下操作：

  1. 在AEM创作实例上，导航到​ 工具> Forms> 配置PDF Generator。

  2. 在​ 常规配置 ​选项卡中，从​ HTML到PDF转换的主要路由 ​下拉列表中选择首选的转换路由。

初始化全局信任存储区 intialize-global-trust-store

使用信任存储区管理，您可以导入、编辑和删除信任在服务器上的证书，以验证数字签名和证书身份验证。 您可以导入和导出任意数量的证书。 导入证书后，可以编辑信任设置和信任存储类型。 执行以下步骤以初始化信任存储：

  1. 以管理员身份登录到AEM Forms实例。
  2. 转到​ 工具 > 安全性 > 信任存储区。
  3. 单击​ 创建TrustStore。 设置密码并选择​ 保存。

为Reader扩展和加密服务设置证书 set-up-certificates-for-reader-extension-and-encryption-service

DocAssurance服务可以对PDF文档应用使用权限。 要对PDF文档应用使用权限，请配置证书。

在设置证书之前，请确保您拥有：

  • 证书文件(.pfx)。

  • 证书附带的私钥密码。

  • 私钥别名。 您可以执行Java keytool命令以查看私钥别名：
    keytool -list -v -keystore [keystore-file] -storetype pkcs12

  • Keystore文件密码。 如果您使用Adobe的Reader扩展证书，则Keystore文件密码始终与Private Key密码相同。

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

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

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

  3. 在​ 编辑用户设置 ​页面上，选择​ KeyStore ​选项卡。 展开​ 从密钥库文件添加私钥 ​选项并提供别名。 别名用于执行Reader扩展操作。

  4. 要上传证书文件，请单击​ 选择密钥存储文件 ​并上传<filename>.pfx文件。

    将与证书关联的​ 密钥存储密码、私钥密码 ​和​ 私钥别名 ​添加到相应的字段中。 单击​ “提交”。

    note note
    NOTE
    在生产环境中，将评估凭据替换为生产凭据。 在更新已过期或评估凭据之前，请确保删除旧的Reader扩展凭据。

  5. 在​ 编辑用户设置 ​页面上单击​ 保存并关闭。

启用AES-256 enable-aes

要对PDF文件使用AES 256加密，请获取并安装Java Cryptography Extension (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

（仅限Windows）为Microsoft®项目配置注册表项 configure-registry-entry-for-microsoft-project

在您的计算机上安装AEM Forms加载项和Microsoft®项目后，请在64位位置注册Microsoft®项目的条目。 它有助于执行从Project到PDFG的转换测试。 下面是概述注册表输入过程的步骤：

  1. 打开Microsoft® Windows注册表编辑器(regedit)，要打开注册表编辑器，请转到“开始”>“运行”，键入regedit，然后单击“确定”。
  2. 导航到Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\Acrobat PDFMaker\<version>\Office\SupportedApp，创建新的​ 二进制值 ​注册表并将其重命名为​ 项目。
  3. 将已创建的二进制注册表的数据值修改为01，然后单击“确定”。
  4. 关闭注册表项。

已知问题和疑难解答 known-issues-and-troubleshooting

  • 如果压缩的输入文件包含文件名中包含双字节字符的HTML文件，则PDF转换HTML将失败。 要避免出现此问题，在命名HTML文件时请勿使用双字节字符。

  • 在基于UNIX的操作系统上，执行以下操作以查找任何缺少的库：

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

  2. 运行以下命令以列出WebToPDF需要用于HTML到PDF转换的所有库。

    ldd phantomjs

    运行以下命令列出缺少的库。

    ldd phantomjs | grep not

  3. 手动安装缺少的库。

系统就绪工具(SRT) SRT

系统就绪工具检查计算机是否正确配置为运行PDF Generator转换。 该工具在指定的路径处生成报告。 要运行该工具，请执行以下操作：

  1. 打开命令提示符。 导航到 [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools 文件夹。

  2. 从命令提示符运行以下命令：

    java -jar forms-srt-[version].jar [Path_of_reports_folder] en

    该命令会生成报告并创建srt_config.yaml文件。 可以使用它为SRT工具配置选项。 为SRT工具配置选项是可选的。

    note note
    NOTE
    • 如果系统就绪工具报告pdfgen.api文件在Acrobat插件文件夹中不可用，则将pdfgen.api文件从[extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]\plugins\x86_win32目录复制到[Acrobat_root]\Acrobat\plug_ins目录。

  3. 导航到[Path_of_reports_folder]。 打开SystemReadinessTool.html文件。 验证报告并修复上述问题。

配置SRT工具的选项 srt-configuration

可以使用srt_config.yaml文件为SRT工具配置各种设置。 文件的格式为：

   # =================================================================
   # SRT Configuration
   # =================================================================
   #Note - follow correct format to avoid parsing failures
   #for example, <param name>:<space><param value>
   #locale: (mandatory field)Locale to be used for SRT. Supported locales [en/fr/de/ja].
   locale: en

   #aemTempDir: AEM Temp direcotry
   aemTempDir:

   #users: provide PDFG converting users list
   #users:
   # - user1
   # - user2
   users:

   #profile: select profile to run specific checks. Choose from [LCM], more will be added soon
   profile:

   #outputDir: directory where output files will be saved
   outputDir:
  • 区域设置： ​它是必需的参数。 它支持英语(en)、德语(de)、法语(fr)和日语(ja)。 默认值为en。 这对OSGi上的AEM Forms上运行的PDF Generator服务没有影响。
  • aemTempDir： ​它是一个可选参数。 它指定Adobe Experience Manager的临时存储位置。
  • 用户： ​它是一个可选参数。 您可以指定一个用户来检查该用户是否具有运行PDF Generator所需的目录所需的权限和读/写访问权限。 如果未指定用户，则会跳过特定于用户的检查，并在报表中显示为失败。
  • outputDir： ​指定保存SRT报告的位置。 缺省位置是SRT工具的当前工作目录。

疑难解答

如果在修复SRT工具报告的所有问题后仍遇到问题，请执行以下检查：

在执行以下检查之前，请确保系统就绪工具未报告任何错误。

Adobe Acrobat
OpenOffice

Microsoft® Windows

  • 请确保已安装32位支持的Microsoft Office版本，并取消所有应用程序的打开对话框。

  • 确保在PDF Generator配置UI中添加了PDF用户。

  • 确保PDF Generator用户是管理员组的成员，并且已为该用户设置了替换进程级别令牌权限。

  • 确保已在PDF GeneratorUI中配置用户，并执行以下操作：

    1. 使用PDF Generator用户登录Microsoft® Windows。
    2. 打开Microsoft® Office或OpenOffice应用程序并取消所有对话框。
    3. 将AdobePDF设置为默认打印机。
    4. 将Acrobat设置为PDF文件的默认程序。
    5. 在Microsoft Office应用程序中使用选项“文件”>“打印”和“Acrobat”功能区执行手动转换，并取消所有对话框。
    6. 结束与转换相关的所有进程，如winword.exe、powerpoint.exe和excel.exe。
    7. 重新启动AEM Forms服务器。

Linux®

  • 安装支持的OpenOffice版本。 AEM Forms支持32位和64位版本。 安装后，打开所有OpenOffice应用程序，取消所有对话框窗口，然后关闭应用程序。 重新打开应用程序，并确保打开OpenOffice应用程序时不会显示任何对话框。

  • 在控制台或dt （设备树）配置文件中，创建环境变量OpenOffice_PATH并将其设置为指向已设置的OpenOffice安装。

  • 如果安装OpenOffice时出现问题，请确保OpenOffice安装所需的32位库可用。

HTML到PDF的转换问题
  • 确保在Fonts配置UI中添加了PDF Generator目录。

Linux和Solaris（WebToPDF转换路由）

  • 确保对于基于Webkit的HTMLToPDF转换可用32位库(libicudata.so.42)，对于基于WebToPDF的HTMLToPDF转换可用64位（libicudata.so.42库）。

  • 运行以下命令列出WebToPDF缺少的库：

    code language-none 
    ldd phantomjs | grep not

Linux®和Solaris™ （WebKit转换路由）

  • 确保目录/usr/lib/X11/fonts和/usr/share/fonts存在。 如果目录不存在，请创建从/usr/share/X11/fonts到/usr/lib/X11/fonts的符号链接以及从/usr/share/fonts到/usr/share/X11/fonts的另一个符号链接。

    code language-none 
    ln -s /usr/share/fonts /usr/share/X11/fonts

ln -s /usr/share/X11/fonts /usr/lib/X11/fonts

  • 确保在usr/share/fonts下复制IBM字体。

  • 确保计算机上有幽灵漏洞修复glibc。 使用默认包管理器更新到最新版本的glibc。 它包括Ghost漏洞修复。

  • 确保在系统上安装了32位lib curl、libcrypto和libssl库的最新版本。 同时创建指向各个库的最新版本（32位）的符号链接/usr/lib/libcurl.so (或libcurl.a (对于AIX®)、/usr/lib/libcrypto.so (或libcrypto.a (对于AIX®)和/usr/lib/libssl.so (或libssl.a (对于AIX®))。

  • 对IBM® SSL套接字提供程序执行以下步骤：

    1. 将java.security文件从<WAS_Installed_JAVA>\jre\lib\security复制到AEM Forms服务器上的任何位置。 默认位置为“默认位置”= <WAS_Installed>\Appserver\java_[version]\jre\lib\security。

    2. 在复制的位置编辑java.security文件，并使用JSSE2工厂更改默认的SSL套接字工厂(使用JSSE2工厂而非WebSphere®)。

      更改以下默认JSSE套接字工厂：

      code language-none 
      #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

      替换为

      code language-none 
      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
无法添加PDF Generator(PDFG)用户
  • 确保在Windows上安装了Microsoft® Visual C++ 2012 x86和Microsoft® Visual C++ 2013 x86 （32位）可再发行软件包。
自动化测试失败

  • 对于Microsoft® Office和OpenOffice，请手动执行至少一次转换（作为每个用户），以确保在转换期间不会弹出任何对话框。 如果出现任何对话框，则将其关闭。 在自动转换期间不应显示此类对话框。

  • 在OSGi环境上的AEM Forms上运行自动化之前，请确保测试包已安装并处于活动状态。

多个用户转换失败

  • 验证服务器日志，以检查特定用户的转换是否失败。（进程资源管理器可以帮助您检查不同用户的运行进程）

  • 确保为PDF Generator配置的用户具有本地管理员权限。

  • 确保PDF Generator用户对LC temp和PDFG temp用户具有读、写和执行权限。

  • 对于Microsoft® Office和OpenOffice，请手动执行至少一次转换（作为每个用户），以确保在转换期间不会弹出任何对话框。 如果出现任何对话框，则将其关闭。 在自动转换期间不应显示此类对话框。

  • 执行示例转换。

AEM Forms Server上安装的Adobe Acrobat的许可证已过期

  • 如果您已有Adobe Acrobat的许可证并且已过期，请下载最新版本的Adobe Application Manager，并迁移您的序列号。 在迁移序列号之前。

    • 使用以下命令生成prov.xml，并使用prov.xml文件重新存储现有安装，而不使用迁移序列号编号文章中提供的命令。

      code language-none 
      &grave;&grave;

adobe_prtk —tool=VolumeSerialize —generate —serial=&lt;serialnum> [—leid=&lt;LEID>] [—regsuppress=ss] [—eulasuppress] [—locales=xx_XX格式或ALL>格式的有限区域设置列表] [—provfile=&lt;到prov.xml的绝对路径>]

&grave;

    • 卷序列化包（使用prov.xml文件和新序列重新序列化现有安装）：以管理员身份从PRTK安装文件夹运行以下命令，以在客户端计算机上序列化和激活已部署的包：

      code language-none 
      &grave;&grave;
adobe_prtk —tool=VolumeSerialize —provfile=C:\prov.xml -stream

&grave;&grave;

  • 对于大规模安装，请使用AcrobatCustomization Wizard删除Reader和Acrobat的早期版本。 自定义安装程序并将其部署到组织中的所有计算机。

AEM Forms Server处于脱机或安全环境，并且Internet无法激活Acrobat。
  • 您可在首次启动Adobe产品后7天内联机完成联机激活和注册，或使用支持Internet的设备以及产品的序列号完成此过程。 有关详细说明，请参阅脱机激活。
无法在Windows Server上将Word或Excel文件转换为PDF

当用户尝试在Microsoft Windows Server上将Word或Excel文件转换为PDF时，遇到以下错误：

来自主转换器的错误消息：
ALC-PDG-015-003 — 系统无法打开输入文件。 再次提交文件或联系系统管理员。

若要解决此问题，请参阅无法将Word或Excel文件转换为Windows Server上的PDF。

无法在Windows Server 2019上将Excel文件转换为PDF

在Microsoft Windows Server 2019上将Microsoft Excel 2019转换为PDF时，必须确保以下各项：

  • 使用PDF Generator服务时，Windows计算机不应与AEM服务器（Windows RDP会话）有任何活动的远程连接。

  • 默认打印机必须设置为Adobe PDF。

    note note
    NOTE
    • 对于Apple macOS和Ubuntu操作系统，您无需配置上述设置。
无法将XPS文件转换为PDF
要解决此问题，请在Windows🔗上创建特定于功能的注册表项。

后续步骤 next-steps

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2