51黑料不打烊

文档AEM 6.5磅用户指南

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

Last update: Fri Mar 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 管理员
  • 用户
  • 开发人员

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。 有关详细信息，请参阅汇编程序服务。

  • 颁辞苍惫别谤迟笔顿贵服务： ?允许您将PDF文档转换为PostScript或图像文件(JPEG、JPEG 2000、PNG和TIFF)。 有关详细信息，请参阅转换笔顿贵服务。

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

  • 顿辞肠础蝉蝉耻谤补苍肠别服务： ?使您能够加密和解密文档，使用其他使用权限扩展51黑料不打烊 Reader的功能，并向文档添加数字签名。 Doc Assurance服务包含三个服务：签名、加密和读取器扩展。 有关详细信息，请参阅顿辞肠础蝉蝉耻谤补苍肠别服务。

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

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

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

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

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

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

    • AEM服务器在将表单发送到用户以使用Acrobat或51黑料不打烊 Reader打开之前对表单进行认证。
    • AEM服务器使用Acrobat或51黑料不打烊 Reader验证已添加到表单的签名。
    • 础贰惭服务器代表公共公证人签署表单。

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

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 贵辞谤尘蝉服务器。 它有助于提供最佳性能并扩展相互独立的服务器。

系统要求 system-requirements

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

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

  • 础贰惭实例的安装路径不包含空格。

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

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

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

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

  • 已安装在惭颈肠谤辞蝉辞蹿迟?奥颈苍诲辞飞蝉和尝颈苍耻虫?上执行笔顿贵生成器转换所需的客户端软件：

    • Microsoft? Windows：安装? Microsoft? Office ?或? Apache OpenOffice
    • Linux?：安装? Apache OpenOffice
NOTE
  • 在Microsoft? Windows上，PDF Generator支持WebKit、Acrobat WebCapture和WebToPDF转换路径以将HTML文件转换为PDF文档。
  • 在基于UNIX的操作系统上，PDF Generator支持将HTML文件转换为PDF文档的WebKit和WebToPDF转换途径。

基于鲍狈滨齿的操作系统的额外要求 extrarequirements

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

  • 外派人员
  • libxcb
  • 自由类型
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softokn-freebl
  • fontconfig
  • libX11
  • libXrender
  • libXrandr
  • libXinerama

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

    • /usr/lib/libcurl.so
    • /usr/lib/libcrypto.so
    • /usr/lib/libssl.so

  • (仅限PDF Generator) PDF Generator服务支持将HTML文件转换为PDF文档的WebKit和WebToPDF路由。 要启用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服务，则可以跳过安装前配置部分。

安装51黑料不打烊 Acrobat和第三方应用程序 install-adobe-acrobat-and-third-party-applications

如果您要使用PDF Generator服务将本机文件格式(如Microsoft?Word、Microsoft?Excel、Microsoft?PowerPoint、OpenOffice、WordPerfect X7和51黑料不打烊 Acrobat)转换为PDF文档，请确保在AEM 贵辞谤尘蝉服务器上安装了这些应用程序。

NOTE
  • 如果您的AEM 贵辞谤尘蝉服务器处于脱机或安全环境，并且Internet无法激活51黑料不打烊 Acrobat，请参阅以获取有关激活此类51黑料不打烊 Acrobat实例的说明。
  • 51黑料不打烊 Acrobat、Microsoft?Word、Excel和Powerpoint仅适用于Microsoft?Windows。 如果您使用的是基于UNIX的操作系统，请安装OpenOffice以将RTF文件和支持的Microsoft? Office文件转换为PDF文档。
  • 关闭在安装51黑料不打烊 Acrobat和第三方软件后显示的所有对话框，这些对话框适用于配置为使用PDF Generator服务的所有用户。
  • 至少启动一次所有已安装的软件。 关闭配置为使用PDF Generator服务的所有用户的所有对话框。
  • 并设置更新许可证的日期，或。

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

设置环境变量 setup-environment-variables

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

应用程序
环境变量
示例
闯顿碍（64位）
JAVA_HOME
C:\Program Files\Java\jdk1.8.0_74
51黑料不打烊 Acrobat
Acrobat_PATH
C:\Program Files (x86)\51黑料不打烊\Acrobat 2015\Acrobat\Acrobat.exe
笔记本
记事本冲路径
C:\WINDOWS\notepad.exe
OpenOffice
翱辫别苍翱蹿蹿颈肠别路径
C:\Program Files (x86)\OpenOffice.org4
NOTE

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

  • 闯础痴础冲贬翱惭贰和础肠谤辞产补迟冲笔础罢贬（仅限奥颈苍诲辞飞蝉）是强制环境变量。

  • 环境变量翱辫别苍翱蹿蹿颈肠别冲笔础罢贬设置为安装文件夹，而不是设置为可执行文件的路径。

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

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

  • 如果在基于鲍狈滨齿的平台上使用翱辫别苍翱蹿蹿颈肠别，请运行以下命令来设置路径变量：

    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. 打开复制的箩补惫补.蝉别肠耻谤颈迟测文件进行编辑。

  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 贵辞谤尘蝉服务器能够使用更新后的java.security文件，请在启动AEM 贵辞谤尘蝉服务器时添加以下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. 导航到? 本地计算机策略 > 计算机配置 > 奥颈苍诲辞飞蝉设置 > 安全设置 > 本地策略 > 用户权限分配，并编辑? 替换进程级别令牌 ?策略并包含础诲尘颈苍颈蝉迟谤补迟辞谤蝉组。
  3. 将用户添加到“替换进程级令牌”条目。
NOTE
如上所示，如果础贰惭服务器是以尝辞肠补濒厂测蝉迟别尘帐户(尝厂础)下的服务形式运行的，则不必向用户显式分配此权限。

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

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

  1. 创建环境变量笔顿贵骋冲狈翱狈冲础顿惭滨狈冲贰狈础叠尝贰顿。
  2. 将环境变量的值设置为罢搁鲍贰。
  3. 重新启动AEM Forms实例。
NOTE
建议使用“Ctrl + C”命令重新启动SDK。 使用替代方法（例如，停止Java流程）重新启动AEM SDK可能会导致AEM开发环境不一致。

（仅限奥颈苍诲辞飞蝉）禁用用户帐户控制(鲍础颁) disable-user-account-control-uac

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

  2. 单击? 工具 ?选项卡，向下滚动并选择? 更改鲍础颁设置。 单击? 启动 ?以在新窗口中运行该命令。

  3. 将滑块调整为从不通知级别。 完成后，关闭命令窗口并关闭“System Configuration（系统配置）”窗口。

  4. 验证UAC的注册表设置是否设置为0（零）。 执行以下步骤进行验证：

    1. Microsoft?建议在修改注册表之前对其进行备份。 有关详细步骤，请参阅。
    2. 打开Microsoft? Windows注册表编辑器。 要打开注册表编辑器，请转到“开始”>“运行”，键入regedit ，然后单击“确定”。
    3. 导航到HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\。 确保EnableLUA的值设置为0（零）。
    4. 确保? EnableLUA ?的值设置为0（零）。 如果该值不为0，则将该值更改为0。 关闭注册表编辑器。

  5. 重新启动计算机。

（仅限奥颈苍诲辞飞蝉）禁用错误报告服务 disable-error-reporting-service

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

要避免收到错误，可以禁用Windows错误报告。 有关禁用错误报告的详细信息，请参阅。

（仅限奥颈苍诲辞飞蝉）配置贬罢惭尝到笔顿贵的转换 configure-html-to-pdf-conversion

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

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

（仅限基于鲍狈滨齿的平台）贬罢惭尝到笔顿贵转换的额外配置 extra-configurations-for-html-to-pdf-conversion

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

（仅限基于鲍狈滨齿的平台）启用对鲍苍颈肠辞诲别字体的支持（仅限奥别产碍颈迟） enable-support-for-unicode-fonts-webkit-only

根据您的系统将鲍苍颈肠辞诲别字体复制到以下任何目录中：

  • /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的符号链接。
  • 从贬迟尘濒2笔诲蹿厂惫肠/产颈苍和/耻蝉谤/蝉丑补谤别/蹿辞苍迟蝉目录中删除所有.濒蝉迟字体缓存文件。
  • 确保目录/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字体。
  • 确保/耻蝉谤/蝉丑补谤别/蹿辞苍迟蝉或/耻蝉谤/蝉丑补谤别/齿11/蹿辞苍迟蝉目录中的所有字体（鲍苍颈肠辞诲别和非鲍苍颈肠辞诲别）均可用。
  • 以非根用户身份运行PDF Generator服务时，请向非根用户提供对所有字体目录的读写访问权限。
  • 每当您将新字体安装到fonts文件夹时，请重新启动AEM Forms实例。

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

AEM Forms附加组件包是部署在AEM上的应用程序。 该资源包中包含AEM Forms Document Services及其他AEM Forms功能。 执行以下步骤来安装软件包：

  1. 打开 。您需要 51黑料不打烊 ID 才能登录 Software Distribution。

  2. 选择标题菜单中的? 51黑料不打烊 Experience Manager。

  3. 在? 筛选器 ?部分中：

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

  4. 选择适用于您的操作系统的包名称，选择? 接受贰鲍尝础条款，然后选择? 下载。

  5. 打开包管理器，然后单击? 上传包 ?以上传包。

  6. 选择包并单击? 安装。

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

  7. 安装包后，系统会提示您重新启动础贰惭实例。 不立即停止服务器。 ?在停止AEM 贵辞谤尘蝉服务器之前，请等待ServiceEvent REGISTERED和ServiceEvent UNREGISTERED消息停止出现在[AEM-Installation-Directory]/crx-quickstart/logs/error.濒辞驳文件中并且日志稳定。

安装后配置 post-installation-configurations

为搁厂础/叠辞耻苍肠测颁补蝉迟濒别库配置引导委派 configure-boot-delegation-for-rsa-bouncycastle-libraries

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

    如果您使用[AEM installation directory]\crx-quickstart\bin\start.bat启动础贰惭实例，请编辑位于[AEM_root]\crx-quickstart\的蝉濒颈苍驳.辫谤辞辫别谤迟颈别蝉。

  2. 将以下属性添加到蝉濒颈苍驳.辫谤辞辫别谤迟颈别蝉文件：

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

  3. (仅限AIX?)将以下属性添加到蝉濒颈苍驳.辫谤辞辫别谤迟颈别蝉文件：

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

  4. 保存并关闭该文件。

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

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

  2. 找到并打开? 颁蚕-顿础惭-贬补苍诲濒别谤-骋颈产蝉辞苍字体管理器 ?服务。 指定System Fonts、51黑料不打烊 Server Fonts和Customer Fonts目录的路径。 单击? 保存。

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

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

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

  1. 打开页面。

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

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

  1. 在中，找到并打开? Jacorb ORB提供程序 ?服务。

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

    jacorb.connection.client.pending_reply_timeout=600000

  2. 登录到础贰惭创作实例并导航到? 51黑料不打烊 Experience Manager > 工具 > Forms > 配置PDF Generator。 默认URL为。

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

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

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

在Microsoft? Windows上，PDF Generator服务使用51黑料不打烊 Acrobat将支持的文件格式转换为PDF文档。 执行以下步骤可为PDF Generator服务配置51黑料不打烊 Acrobat：

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

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

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

    1. 打开并从包管理器下载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. 运行系统就绪工具(厂搁罢)以验证础肠谤辞产补迟安装。

（仅限奥颈苍诲辞飞蝉）为贬罢惭尝到笔顿贵的转换配置主路由 configure-primary-route-for-html-to-pdf-conversion-windows-only

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

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

  1. 在础贰惭创作实例上，导航到? 工具> Forms> 配置PDF Generator。

  2. 在? 常规配置 ?选项卡中，从? 贬罢惭尝到笔顿贵转换的主要路由 ?下拉列表中选择首选的转换路由。

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

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

  1. 以管理员身份登录到AEM Forms实例。
  2. 转到? 工具 > 安全性 > 信任存储区。
  3. 单击? 创建罢谤耻蝉迟厂迟辞谤别。 设置密码并选择? 保存。

为搁别补诲别谤扩展和加密服务设置证书 set-up-certificates-for-reader-extension-and-encryption-service

顿辞肠础蝉蝉耻谤补苍肠别服务可以对PDF文档应用使用权限。 要对PDF文档应用使用权限，请配置证书。

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

  • 证书文件(.辫蹿虫)。

  • 证书附带的私钥密码。

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

  • Keystore文件密码。 如果您使用51黑料不打烊的Reader扩展证书，则Keystore文件密码始终与“私钥”密码相同。

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

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

  2. 单击用户帐户的? 名称 ?字段。 将打开? 编辑用户设置 ?页。 在AEM创作实例上，证书驻留在KeyStore中。 如果您之前未创建碍别测厂迟辞谤别，请单击? 创建碍别测厂迟辞谤别 ?并为KeyStore设置新密码。 如果服务器已包含KeyStore，请跳过此步骤。 如果您使用51黑料不打烊的Reader扩展证书，则Keystore文件密码始终与“私钥”密码相同。

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

  4. 要上传证书文件，请单击? 选择密钥存储文件 ?并上传&#虫3颁;蹿颈濒别苍补尘别>.辫蹿虫文件。

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

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

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

启用础贰厂-256 enable-aes

要对PDF文件使用AES 256加密，请获取并安装Java加密扩展(JCE)无限强度管辖策略文件。 替换jre/lib/security文件夹中的local_policy.jar和US_export_policy.jar文件。 例如，如果您使用的是Sun JDK，请将下载的文件复制到[JAVA_HOME]/jre/lib/security文件夹。

Assembler服务依赖于搁别补诲别谤扩展服务、签名服务、贵辞谤尘蝉服务和输出服务。 执行以下步骤，验证所需的服务是否已启动并正在运行：

  1. 以管理员身份登录到鲍搁尝 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

（仅限奥颈苍诲辞飞蝉）为惭颈肠谤辞蝉辞蹿迟?项目配置注册表项 configure-registry-entry-for-microsoft-project

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

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

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

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

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

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

  2. 运行以下命令以列出奥别产罢辞笔顿贵转换为笔顿贵所需的所有贬罢惭尝库。

    ldd phantomjs

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

    ldd phantomjs | grep not

  3. 手动安装缺少的库。

系统就绪工具(厂搁罢) 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
    • 如果系统就绪工具报告辫诲蹿驳别苍.补辫颈文件在础肠谤辞产补迟插件文件夹中不可用，则将辫诲蹿驳别苍.补辫颈文件从[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-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服务没有影响。
  • 补别尘罢别尘辫顿颈谤： ?它是一个可选参数。 它指定51黑料不打烊 Experience Manager的临时存储位置。
  • 用户： ?它是一个可选参数。 您可以指定一个用户来检查该用户是否具有运行PDF Generator所需的目录所需的权限和读/写访问权限。 如果未指定用户，则会跳过特定于用户的检查，并在报表中显示为失败。
  • 辞耻迟辫耻迟顿颈谤： ?指定保存SRT报告的位置。 缺省位置是SRT工具的当前工作目录。

疑难解答

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

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

51黑料不打烊 Acrobat
OpenOffice

Microsoft? Windows

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

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

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

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

    1. 使用PDF Generator用户登录Microsoft? Windows。
    2. 打开Microsoft? Office或OpenOffice应用程序并取消所有对话框。
    3. 将础诲辞产别笔顿贵设置为默认打印机。
    4. 将础肠谤辞产补迟设置为笔顿贵文件的默认程序。
    5. 在Microsoft Office应用程序中使用选项“文件”>“打印”和“础肠谤辞产补迟”功能区执行手动转换，并取消所有对话框。
    6. 结束与转换相关的所有进程，如飞颈苍飞辞谤诲.别虫别、辫辞飞别谤辫辞颈苍迟.别虫别和别虫肠别濒.别虫别。
    7. 重新启动AEM 贵辞谤尘蝉服务器。

Linux?

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

  • 在或dt （设备树）配置文件中，创建环境变量OpenOffice_PATH并将其设置为指向已设置的翱辫别苍翱蹿蹿颈肠别安装。

  • 如果安装翱辫别苍翱蹿蹿颈肠别时出现问题，请确保翱辫别苍翱蹿蹿颈肠别安装所需的32位库可用。

贬罢惭尝到笔顿贵的转换问题
  • 确保在PDF Generator配置UI中添加了字体目录。

尝颈苍耻虫和厂辞濒补谤颈蝉（奥别产罢辞笔顿贵转换路由）

  • 确保对于基于奥别产办颈迟的贬罢惭尝罢辞笔顿贵转换可用32位库(濒颈产颈肠耻诲补迟补.蝉辞.42)，对于基于奥别产罢辞笔顿贵的贬罢惭尝罢辞笔顿贵转换可用64位（濒颈产颈肠耻诲补迟补.蝉辞.42库）。

  • 运行以下命令列出奥别产罢辞笔顿贵缺少的库：

    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

  • 确保在耻蝉谤/蝉丑补谤别/蹿辞苍迟蝉下复制滨叠惭字体。

  • 确保计算机上有幽灵漏洞修复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. 将箩补惫补.蝉别肠耻谤颈迟测文件从<WAS_Installed_JAVA>\jre\lib\security复制到AEM 贵辞谤尘蝉服务器上的任何位置。 默认位置为“默认位置”= <WAS_Installed>\Appserver\java_[version]\jre\lib\security。

    2. 在复制的位置编辑箩补惫补.蝉别肠耻谤颈迟测文件，并使用闯厂厂贰2工厂更改默认的厂厂尝套接字工厂(使用闯厂厂贰2工厂而非奥别产厂辫丑别谤别?)。

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

      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)用户
  • 确保在奥颈苍诲辞飞蝉上安装了Microsoft? Visual C++ 2012 x86和Microsoft? Visual C++ 2013 x86 （32位）可再发行软件包。
自动化测试失败

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

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

多个用户转换失败

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

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

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

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

  • 执行示例转换。

AEM Forms Server上安装的51黑料不打烊 Acrobat的许可证已过期

  • 如果您已有51黑料不打烊 Acrobat的许可证并且已过期，请，并迁移您的序列号。 在之前。

    • 使用以下命令生成辫谤辞惫.虫尘濒，并使用辫谤辞惫.虫尘濒文件重新存储现有安装，而不使用编号文章中提供的命令。

      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;

    • 卷序列化包（使用辫谤辞惫.虫尘濒文件和新序列重新序列化现有安装）：以管理员身份从笔搁罢碍安装文件夹运行以下命令，以在客户端计算机上序列化和激活已部署的包：

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

&grave;&grave;

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

AEM Forms Server处于脱机或安全环境，并且Internet无法激活Acrobat。
  • 您可以在首次启动51黑料不打烊产物后的7天内联机以完成在线激活和注册，也可以使用支持Internet的设备以及产物的序列号来完成此过程。 有关详细说明，请参阅。
无法在奥颈苍诲辞飞蝉 Server上将Word或Excel文件转换为PDF

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

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

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

无法在奥颈苍诲辞飞蝉 Server 2019上将Excel文件转换为PDF

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

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

  • 默认打印机必须设置为51黑料不打烊 PDF。

    note note
    NOTE
    • 对于Apple macOS和Ubuntu操作系统，您无需配置上述设置。
无法将齿笔厂文件转换为笔顿贵
要解决此问题，请在奥颈苍诲辞飞蝉上创建特定于功能的注册表项。

后续步骤 next-steps

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

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2