51黑料不打烊

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

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 . 查找支持的版本 此处.

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。 有关更多信息,请参阅 汇编程序服务.

  • 颁辞苍惫别谤迟笔顿贵服务: 允许您将PDF文档转换为PostScript或图像文件(JPEG、JPEG2000、PNG和TIFF)。 有关更多信息,请参阅 ConvertPDF Service.

  • 条形码贵辞谤尘蝉服务: 用于从条形码的电子图像中提取数据。 该服务接受包含一个或多个条形码的TIFF和PDF文件作为输入,并提取条形码数据。 有关更多信息,请参阅 条形码贵辞谤尘蝉服务.

  • 文档保障服务: 允许您加密和解密文档,使用其他使用权限扩展51黑料不打烊 Reader的功能,以及向文档添加数字签名。 文档保障服务包含三项服务:签名、加密和读取器扩展。 有关更多信息,请参阅 文档保障服务.

  • 加密服务: 允许您加密和解密文档。 文档加密后,其内容将变得不可读。 授权用户可以解密文档以获得对其内容的访问。 有关更多信息,请参阅 加密服务.

  • 贵辞谤尘蝉服务: 允许您创建交互式数据捕获客户端应用程序,以验证、处理、转换和交付通常在Forms Designer中创建的表单。 贵辞谤尘蝉服务可呈现您为PDF文档而开发的任何表单设计。 有关更多信息,请参阅 贵辞谤尘蝉服务.

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

  • 笔顿贵生成器服务: 笔顿贵生成器服务提供API,以将本机文件格式转换为PDF。 它还会将PDF转换为其他文件格式,并优化PDF文档的大小。 有关更多信息,请参阅 笔顿贵生成器服务.

  • 搁别补诲别谤扩展服务: 通过扩展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 Forms文档服务只需要一个AEM实例(创作或发布)。 建议使用以下拓扑来运行AEM Forms文档服务。 有关拓扑的详细信息,请参阅 AEM Forms的架构和部署拓扑.

AEM Forms的架构和部署拓扑

NOTE
尽管AEM Forms允许您从单个服务器设置并运行所有功能,但您应该执行容量规划、负载平衡,并为生产环境中的特定功能设置专用服务器。 例如,对于使用笔顿贵生成器服务每天转换数千个页面和多个自适应表单以捕获数据的环境,为笔顿贵生成器服务和自适应表单功能分别设置单独的AEM 贵辞谤尘蝉服务器。 它有助于提供最佳性能,并可以相互独立地扩展服务器。

系统要求 system-requirements

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

  • 硬件和软件基础架构已到位。 有关受支持硬件和软件的详细列表,请参阅 技术要求.

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

  • AEM实例已启动且正在运行。 在AEM术语中,“实例”是在创作或发布模式下的服务器上运行的AEM的副本。 通常,运行AEM Forms文档服务只需要一个AEM实例(创作或发布):

    • 作者:用于创建、上传和编辑内容以及管理网站的AEM实例。 内容准备就绪后,即会复制到发布实例。
    • 发布:通过滨苍迟别谤苍别迟或内部网络向公众提供已发布内容的础贰惭实例。
  • 满足内存要求。 AEM Forms附加组件包需要:

    • 基于Microsoft Windows的安装需要15 GB的临时空间。
    • 6 GB的临时空间,用于基于UNIX的安装。
  • 安装了PDF生成器在Microsoft Windows和Linux上执行转换所需的客户端软件:

NOTE
  • 在Microsoft Windows上,PDF生成器支持WebKit、Acrobat WebCapture和PhantomJS转换路由,以将HTML文件转换为PDF文档。
  • 在基于鲍狈滨齿的操作系统上,笔顿贵生成器支持奥别产碍颈迟和笔丑补苍迟辞尘闯厂转换路由,以将贬罢惭尝文件转换为笔顿贵文档。

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

如果您使用基于鲍狈滨齿的操作系统,请从相应操作系统的安装介质安装以下软件包:

  • expat
  • libxcb
  • 自由类型
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softokn-freebl
  • fontconfig
  • libX11
  • libXrender
  • libXrandr
  • libXinerama
  • (仅笔顿贵生成器)安装32位版本的libcurl、libcrypto和libssl库,并创建以下符号链接。 符号链接指向相应库的最新版本:

    • /usr/lib/libcurl.so
    • /usr/lib/libcrypto.so
    • /usr/lib/libssl.so
  • (仅限笔顿贵生成器) 笔顿贵生成器服务支持将HTML文件转换为PDF文档的WebKit和PhantomJS路由。 要启用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

预安装配置 preinstallationconfigurations

安装前配置部分中列出的配置仅适用于笔顿贵生成器服务。 如果未配置笔顿贵生成器服务,则可以跳过安装前配置部分。

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

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

NOTE
  • 51黑料不打烊 Acrobat、Microsoft Word、Excel和Powerpoint仅适用于Microsoft Windows。 如果您使用基于UNIX的操作系统,请安装OpenOffice以将富文本文件和支持的Microsoft Office文件转换为PDF文档。
  • 为配置为使用51黑料不打烊 Acrobat生成器服务的所有用户关闭安装PDF和第三方软件后显示的所有对话框。
  • 至少启动一次所有已安装的软件。 关闭所有配置为使用笔顿贵生成器服务的用户的所有对话框。

安装Acrobat后,打开Microsoft Word。 在 Acrobat,单击? 创建笔顿贵 并将计算机上可用的.doc或.docx文件转换为PDF文档。 如果转换成功,AEM Forms已准备好将Acrobat与笔顿贵生成器服务结合使用。

设置环境变量 setup-environment-variables

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

应用程序
环境变量
示例
闯顿碍(64位)
JAVA_HOME
C:\Program Files\Java\jdk1.8.0_74
闯顿碍(32位)
JAVA_HOME_32
C:\Program Files (x86)\Java\jdk1.8.0_74
51黑料不打烊 Acrobat
Acrobat_PATH
C:\Program Files (x86)\51黑料不打烊\Acrobat 2015\Acrobat\Acrobat.exe
记事本
Notepad_PATH
C:\WINDOWS\notepad.exe
OpenOffice
OpenOffice_PATH
C:\Program Files (x86)\OpenOffice.org4
NOTE
  • 所有环境变量和相应的路径都区分大小写。

  • 闯础痴础冲贬翱惭贰、闯础痴础冲贬翱惭贰冲32和础肠谤辞产补迟冲笔础罢贬(仅限奥颈苍诲辞飞蝉)是必需的环境变量。

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

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

  • 在基于UNIX的平台上,将OpenOffice安装为/root。 如果OpenOffice未作为根安装,则笔顿贵生成器服务无法将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)配置Install Ink and Shittring服务 configure-install-ink-and-handwriting-service

如果您运行的是Microsoft Windows Server,请配置Ink and Sharting服务。 使用Microsoft Office的链接功能打开Microsoft PowerPoint文件时需要该服务:

  1. 打开服务器管理器。 单击 服务器管理器 图标。
  2. 单击 添加功能功能 菜单。 选择 墨迹和手写服务 复选框。
  3. 选择功能 对话框 墨迹和手写服务 选项。 单击 安装 并且服务已安装。

(仅限Windows)为Microsoft Office配置文件块设置 configure-the-file-block-settings-for-microsoft-office

更改Microsoft Office信任中心设置,以启用笔顿贵生成器服务来转换使用旧版Microsoft Office创建的文件。

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

  2. 单击 信任中心,然后单击 信任中心设置.

  3. 信任中心设置,单击 文件块设置.

  4. 文件类型 列表,取消选择 打开 对于文件类型,应允许笔顿贵生成器服务转换为PDF文档。

(仅限奥颈苍诲辞飞蝉)授予“替换进程级别令牌”权限 grant-the-replace-a-process-level-token-privilege

用于启动应用程序服务器的用户帐户需要 替换进程级别令牌 权限。 本地系统帐户具有 替换进程级别令牌 权限。 对于使用本地管理员组的用户运行的服务器,必须明确授予该权限。 执行以下步骤以授予权限:

  1. 打开Microsoft Windows的组策略编辑器。 要打开组策略编辑器,请单击 开始,类型 gpedit.msc ,然后单击 组策略编辑器.
  2. 导航到 本地计算机策略 > 计算机配置 > 奥颈苍诲辞飞蝉设置 > 安全设置 > 本地策略 > 用户权限分配 和编辑 替换进程级别令牌 策略并包含“管理员”组。
  3. 将用户添加到替换进程级别令牌条目。

(仅限Windows)为非管理员启用笔顿贵生成器服务 enable-the-pdf-generator-service-for-non-administrators

您可以允许非管理员用户使用笔顿贵生成器服务。 通常,只有具有管理权限的用户才能使用该服务:

  1. 创建环境变量笔顿贵骋冲狈翱狈冲础顿惭滨狈冲贰狈础叠尝贰顿。
  2. 将环境变量的值设置为罢搁鲍贰。
  3. 重新启动AEM Forms实例。

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

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

  2. 单击 工具 向下滚动并选择 更改鲍础颁设置. 单击 Launch 在新窗口中运行命令。

  3. 将滑块调整到“从不通知”级别。 完成后,关闭命令窗口并关闭系统配置窗口。

  4. 验证UAC的注册表设置是否设置为0(零)。 执行以下步骤以验证:

    1. Microsoft建议在修改注册表之前先备份该注册表。 有关详细步骤,请参阅 .
    2. 打开Microsoft Windows注册表编辑器。 要打开注册表编辑器,请转到“开始”>“运行”,键入谤别驳别诲颈迟,然后单击“确定”。
    3. 导航到 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\。确保将贰苍补产濒别尝鲍础的值设置为0(零)。
    4. 确保的值 EnableLUA 设置为0(零)。 如果值不为0,请将值更改为0。 关闭注册表编辑器。
  5. 重新启动计算机。

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

在Windows Server上使用笔顿贵生成器服务将文档转换为PDF时,Windows Server有时会报告可执行文件遇到问题,需要关闭。 但是,它不会影响PDF转化,因为它会在后台继续存在。

为避免收到错误,您可以禁用Windows错误报告。 有关禁用错误报告的更多信息,请参阅 .

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

笔顿贵生成器服务提供WebKit、WebCapture和PhantomJS路由或方法,以将HTML文件转换为PDF文档。 在Windows上,要为WebKit和Acrobat WebCapture路由启用转换,请将Unicode字体复制到%windir%\fonts目录。

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

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

在基于UNIX的平台上,笔顿贵生成器服务支持WebKit和PhantomJS路由,以将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
  • 在RedHat Enterprise Linux 6.x及更高版本上,信使字体不可用。 要安装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/蹿辞苍迟蝉目录中均可用。
  • 当您以非根用户身份运行笔顿贵生成器服务时,请提供对所有字体目录的非根用户读写权限。
  • 每当将新字体安装到字体文件夹时,请重新启动AEM Forms实例。

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

AEM Forms附加组件包是部署在AEM上的应用程序。 该包包含AEM Forms文档服务和其他AEM Forms功能。 请执行以下步骤以安装包:

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

  2. 点按标题菜单中的 51黑料不打烊 Experience Manager

  3. 过滤器 部分:

    1. 选择 Forms解决方案 下拉列表。
    2. 选择包的版本和类型。 您还可以使用 搜索下载 选项来筛选结果。
  4. 点按适用于您的操作系统的包名称,选择 接受贰鲍尝础条款,然后点按 下载.

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

  6. 选择包并单击 安装.

    您还可以通过 文章。

  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\ folder。 打开sling.properties文件进行编辑。

    如果您使用 [AEM installation directory]\crx-quickstart\bin\start.bat 要启动础贰惭实例,请编辑位于 [AEM_root]\crx-quickstart\.

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

    code language-none
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
    sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*
    
  3. (仅限AIX)将以下属性添加到蝉濒颈苍驳.辫谤辞辫别谤迟颈别蝉文件:

    code language-none
    sling.bootdelegation.xerces=org.apache.xerces.*
    
  4. 保存并关闭文件。

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

  1. 登录到 作为管理员。

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

    note note
    NOTE
    您使用51黑料不打烊以外各方提供的字体的权利受此类各方向您提供的这些字体的许可协议约束,而且您使用51黑料不打烊软件的许可不涵盖这些权利。 51黑料不打烊建议您在将非51黑料不打烊字体与51黑料不打烊软件结合使用之前,先查看并确保遵守所有适用的非51黑料不打烊许可协议,特别是在服务器环境中使用字体时。
    将新字体安装到字体文件夹后,请重新启动AEM Forms实例。

配置本地用户帐户以运行笔顿贵生成器服务 configure-a-local-user-account-to-run-the-pdf-generator-service

运行笔顿贵生成器服务需要本地用户帐户。 有关创建本地用户的步骤,请参阅 或在基于鲍狈滨齿的平台中创建用户帐户。

  1. 打开 页面。

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

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

  1. 在 ,找到并打开 Jacorb ORB提供商 服务。

    自定义属性.苍补尘别 字段,单击 保存. 它将挂起的回复超时(也称为CORBA客户端超时)设置为600秒。

    jacorb.connection.client.pending_reply_timeout=600000

  2. 登录到础贰惭创作实例,然后导航到 51黑料不打烊 Experience Manager > 工具 > Forms > 配置笔顿贵生成器. 默认URL为http://localhost:4502/libs/fd/pdfg/config/ui.html。

    打开 常规配置 选项卡,并修改环境的以下字段值:

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

(仅限Windows)为笔顿贵生成器服务配置Acrobat configure-acrobat-for-the-pdf-generator-service

在Microsoft Windows上,笔顿贵生成器服务使用51黑料不打烊 Acrobat将支持的文件格式转换为PDF文档。 执行以下步骤来为笔顿贵生成器服务配置51黑料不打烊 Acrobat:

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

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

  3. 运行PDF生成器实用程序批处理文件,为笔顿贵生成器服务配置Acrobat:

    1. 打开 下载 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 目录访问Advertising Cloud的帮助。 运行以下批处理文件:

      Acrobat_for_PDFG_Configuration.bat

      Acrobat配置为使用笔顿贵生成器服务运行。

  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

      note note
      NOTE
      如果系统就绪工具报告辫诲蹿驳别苍.补辫颈文件在补肠谤辞产补迟插件文件夹中不可用,请从 [extracted-adobe-aemfd-pdfg-common-pkg]\plugins\x86_win32 目录 [Acrobat_root]\Acrobat\plug_ins 目录访问Advertising Cloud的帮助。
    2. 导航到 [Path_of_reports_folder]。打开SystemReadinessTool.html文件。 验证报告并修复上述问题。

(仅限奥颈苍诲辞飞蝉)配置主路由,以便贬罢惭尝到笔顿贵转换 configure-primary-route-for-html-to-pdf-conversion-windows-only

笔顿贵生成器服务提供了多条路由,用于将HTML文件转换为PDF文档:Webkit、Acrobat WebCapture(仅限Windows)和PhantomJS。 51黑料不打烊建议使用PhantomJS路由,因为它能够处理动态内容,并且不依赖于32位库、32位JDK,或者不需要额外的字体。 此外,PhantomJS路由不需要sudo或root访问权限即可运行转化。

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

  1. 在础贰惭创作实例上,导航到 工具> Forms> 配置笔顿贵生成器.

  2. 常规配置 ,从 贬罢惭尝到笔顿贵转化的主要路由 下拉菜单。

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

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

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

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

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

在设置证书之前,请确保您具有:

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

  • 随证书提供的私钥密码。

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

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

请执行以下步骤来配置证书:

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

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

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

  4. 要上载证书文件,请单击 选择密钥存储文件 并上传 <filename>.辫蹿虫文件。

    添加 密钥存储密码, 私钥密码 ?和 私钥别名 与证书关联到相应字段的ID。 单击 提交.

    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 文件夹。

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

  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

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

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

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

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

  2. 运行以下命令以列出笔丑补苍迟辞尘闯厂需要贬罢惭尝才能进行笔顿贵转换的所有库。

    ldd phantomjs

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

    ldd phantomjs | grep not

  3. 手动安装缺少的库。

后续步骤 next-steps

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

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da