安装Workbench

本文档提供了有关安装和配置AEM Forms Workbench的说明。 安装程序还安装Forms Designer。

谁应该阅读此文档?

本文档面向负责安装、配置、管理或部署Workbench的管理员或开发人员。 还包括配置系统以支持升级的AEM Forms进程所需的信息。 提供的信息基于以下假设:阅读本文档的任何人都熟悉Microsoft® Windows®操作系统。

附加信息

此表中的资源可帮助您进一步了解和使用AEM Forms。

有关信息

请参阅

Workbench的过程信息

Workbench帮助

有关AEM Forms及其如何与其他Adobe产品集成的一般信息

AEM Forms概述

所有可用于AEM Forms的文档

AEM Forms文档

有关此产品版本的修补程序更新、技术说明和其他信息

联系Adobe企业支持

注意

Flex工作区已弃用于AEM Forms。 它适用于AEM Forms版本。

安装之前

Workbench安装概述

Workbench是一个集成开发环境(IDE),开发人员和表单作者使用它来创建自动化的业务流程和表单。 它还用于管理流程和表单所使用的资源和服务。

下图描述了Workbench安装,包括:

  • 使用Workbench进行流程设计
  • 使用Designer进行表单设计
注意

AEM Forms服务器需要单独的安装程序。 有关更多信息,请参阅JEE上的AEM Forms安装文档。

default-render-form

系统先决条件

本节概述了硬件和软件要求以及支持的平台。

最低硬件和软件要求


工作台建议满足以下最低要求:安装的磁盘空间:

  • 680 MB(仅适用于Workbench)。
  • 在单个驱动器上安装2.15 GB,以完整安装Workbench、Designer和示例组件。
  • 临时安装目录为400 MB — 用户\temp目录为200 MB,Windows临时目录为200 MB。
注意

如果所有这些位置都位于单个驱动器上,则安装期间必须有1.5 GB的可用空间。 安装完成后,复制到临时目录的文件将被删除。

  • 硬件要求:英特尔®奔腾® 4或AMD等效处理器,1 GHz。
  • Java™ Runtime Environment(JRE)7.0将51或更高版本更新为7.0。
  • 最小1024 X 768像素或更高的显示器分辨率(16位颜色或更高)。
  • 到AEM Forms服务器的TCP/IPv4或TCP/IPv6网络连接。
  • 安装Visual C++ Redistributable Runtime Packages 2012 32位。
  • 安装Visual C++ Redistributable Runtime Packages 2013 32位。
注意

您必须具有管理权限才能安装Workbench。 如果您使用非管理员帐户进行安装,安装程序将提示您输入相应帐户的凭据。

支持的平台

请在AEM Forms支持的平台上查看Workbench支持的平台的完整列表。

Designer安装注意事项

默认情况下,Workbench安装包含相应的仅英文版Designer。 如果Workbench安装应用程序在您的计算机上检测到Designer的现有版本,则安装可能会终止,您需要先删除当前版本的Designer,然后才能继续。
下表提供了安装Workbench时您可能遇到的Designer安装方案以及必须执行的任何操作的完整列表。

当前安装的Designer版本

必需操作

Acrobat Pro或Acrobat Pro扩展(包括Designer)

无.
Workbench安装会在您的计算机上检测到一个安装了Acrobat Pro或Acrobat Pro Extended的Designer实例。
Designer的不同版本可以共存于同一系统上,例如Workbench 6.4的Designer 6.4.x和Workbench 6.5的Designer 6.5.0.x。无需卸载随Acrobat 10 Pro或Acrobat 10 Pro Extended或更高版本一起安装的Designer版本。

设计人员(独立)

无.
Workbench随附的Designer版本是纯英语版本。
Workbench安装程序不会重新安装新版本的Designer。将修补与Workbench安装程序捆绑在一起的更新版本。 这还允许您在Workbench中使用Designer的本地化版本。

在Windows 10上卸载Designer(独立)

  1. 转到​控制面板>程序>程序和功能
  2. 在“当前安装的程序”列表中,选择​Adobe设计器
  3. 单击​卸载,然后单击​

安装Workbench

本章介绍如何安装Workbench。

安装和运行Workbench

在安装Workbench之前,必须确保您的环境包含运行Workbench所需的软件和硬件(请参阅章节:安装之前)。

要安装并运行Workbench,请执行以下操作:

  1. 执行以下任务之一:

    • 导航到安装介质上的\workbench目录,然后双击run_windows_installer.bat文件。
    • 将Workbench下载并解压缩到您的文件系统。 下载后,导航到\workbench目录并双击run_windows_installer.bat文件。
    重要

    Workbench安装程序仅从本地驱动器运行。 无法从远程站点运行。

    注意

    如果遇到“无法创建Java虚拟机”错误,请创建名为_JAVA_OPTIONS(值为 — Xmx512M)的环境变量并运行安装程序。

  2. 在“Introduction(简介)”屏幕上,单击“Next(下一步)”。

  3. 阅读产品许可协议,选择“我接受许可协议的条款”,然后单击“下一步”。

  4. (可选)如果需要此工具来创建和修改表单,请选择安装Adobe设计器。

    注意

    通过取消选中此选项,您可以继续使用随Acrobat 10一起安装的Designer。

  5. 接受列出的缺省目录或 单击选择并导航到要安装Workbench的目录,然后单击下一步。

    注意

    安装目录路径不应包含#(井号)和$(美元)字符。

  6. 查看预安装摘要,然后单击“Install(安装)”。 安装程序显示安装进度。

  7. 查看安装摘要。 选择启动AEM Forms Workbench以启动Workbench,然后单击下一步。

  8. 查看发行说明,然后单击完成。

  9. 现在,您的计算机上安装了以下项目:

    • 工作台:要从“开始”菜单运行Workbench,请选择“所有程序”>“AEM Forms”>“Workbench”(如果您选择将快捷方式文件夹存储在此处)。有关信息, 请参阅使用Workbench文档。
    • 设计器:您可以从Workbench中访问Designer。有关信息,请参阅Designer Help中的快速入门主题。
    • AEM Forms SDK:有关使用SDK的更多信息,请参阅 使用AEM Forms编程

升级过程

可以使用升级向导将JEE上的AEM Forms进程升级到AEM Forms应用程序。 有关更多信息,请参阅Workbench帮助中的升级旧工件文档。

配置和登录到服务器

要使用Workbench,您必须运行一个AEM Forms实例,通常在单独的计算机上运行。 您必须具有登录AEM Forms的用户名和密码,以及有关服务器位置的详细信息。

注意

如果您将AEM Forms配置为使用EMC Documentum或IBM FileNet存储库提供程序,并且您希望登录到除在AEM Forms管理控制台中配置为默认存储库的存储库之外的其他存储库,请提供用户名(username@Repository)。

配置超时设置

默认情况下,Workbench会在两小时后超时,而不考虑活动或不活动状态。 要编辑超时设置,请参阅管理控制台帮助中的“配置用户管理>配置高级系统属性”。

配置Workbench以通过HTTPS连接

要通过HTTPS将Workbench连接到AEM Forms服务器,您必须确保颁发公共密钥的证书颁发机构(CA)被Workbench识别为受信任。 如果证书未被识别为来自可信来源,则必须更新位于[Workbench_HOME]/workbench/jre/lib/security目录中的cacert文件。

注意

[Workbench_] HOME表示安装Workbench的目录。默认位置为C:\Program Files (x86)\Adobe Experience Manager Forms Workbench。

确保使用证书中指定的名称连接到HTTPS。 此名称通常是完全限定的主机名。

要更新缓存文件:

  1. 确保您有安全套接字层(SSL)证书的副本。 请与配置SSL服务器的管理员联系,或使用Web浏览器导出证书。

    注意

    要导出证书,请打开Web浏览器并登录到管理控制台,在浏览器中安装证书,然后将证书从浏览器导出到临时存储位置(或直接导出到[Workbench_HOME]/workbench/jre/lib/security目录)。

  2. 将证书复制到[Workbench_HOME]/workbench/jre/lib/security目录。

  3. 打开命令提示符窗口,导航到[Workbench_HOME]/workbench/jre/bin,然后键入以下命令:
    keytool -import -storepass changeit -file [Workbench_HOME]\workbench\jre\lib\security\ssl_cert_for_certname.cer -keystore [Workbench_HOME]\workbench\jre\lib\security\cacerts -alias example
    其中:

    • changeit是cacerts密钥库的默认密码。
    • certname是您在步骤1中选择的证书。
    • 示例是您为证书选择的别名。 此值可以更改
  4. 当系统提示您信任证书时,请键入Yes并按Enter键。 键工具继续将缓存文件导入[Workbench_HOME]/workbench/jre/lib/security目录。

  5. 关闭并重新启动Workbench以应用更改。

为动态生成的模板配置缓存设置

如果您的应用程序通过自动更新XFA内容来动态生成唯一的模板,则应考虑缓存操作的以下方面。 实际上,每个交易都使用一个唯一的新模板。

当表单生成器或输出在缓存中搜索或更新特定表单模板的条目时,它会使用多个键值来查找将要访问的特定缓存条目。

  • 模板文件名:用作缓存表单的主要唯一标识符的模板的位置和文件名。

  • 时间戳:模板文件包含用于确定表单上次更新时间的时间戳。

  • 模板UUID:Designer在每个模板中为表单及其版本插入一个唯一标识符(UUID)。每次更新表单时,嵌入的UUID都会更新。 例如,XDP模板可能会显示以下内容:

    <?xml version="1.0" encoding="UTF-8"?>
    <?xfa generator="AdobeAEM formsDesignerES_V8.2" APIVersion="2.6.7185.0"?><xdp:xdp xmlns:xdp=http://ns.adobe.com/xdp/ timeStamp="2008-07-29T21:22:12Z" uuid="823e538f-ff6c-4961-b759-f7626978a223"><template xmlns="http://www.xfa.org/schema/xfa-template/2.6/">

  • 渲染选项:在渲染的表单缓存中,针对每组唯一渲染选项分别存储缓存内容。

Forms服务通过引用文件名或存储库位置或作为内存中XML对象的值来接收模板。

  • 通过引用传递的模板:使用内容根和表单名称。如果使用此方法在每个请求中传递具有不同文件名的唯一模板,则磁盘缓存将无休止地增长,永远不会重复使用。 为防止出现这种情况,应使用相同的文件名传递唯一模板,以确保为所有请求更新相同的缓存。
  • 传递值的模板:使用使用theinDataDoc参数随数据一起传递的模板字节。如果使用此方法传递具有不同UUID的唯一模板,则磁盘缓存将会无限增长,并且永远不会重复使用。 为防止出现这种情况,应从所有模板中去除UUID属性,以确保不会为模板创建缓存。 或者,传递相同的非空UUID可以创建缓存对象,但可以确保使用每个请求更新相同的缓存。

为防止缓存无休止地增长,请考虑以下因素来使用新的AEM Forms API渲染动态生成的模板(即renderHTMLForm2和renderPDFForm2的模板)。

使用新API时,模板将作为文档对象传递,该文档对象将在Forms服务中根据模板是否被钝化处理来处理。

对于以UUID和内容根作为缓存键的钝化文档,请考虑以下方面:

  • 对于没有UUID的被钝化输入模板,不会创建缓存。
  • 如果传递了多个具有相同UUID和内容根的钝化输入模板,则会覆盖相同的缓存。

对于文件名和内容根目录用作缓存键的非钝化文档,请考虑以下方面:

  • 对于非钝化的输入模板,缓存取决于从中生成文档的内容根目录和文件名。
    同一缓存将仅用于具有相同内容根目录和模板文件名的请求。
    以下最佳实践将确保在将动态生成的模板传递到Forms服务时,缓存不会无限增长:
    • 删除UUID,或在所有动态生成的模板中传递相同的UUID。
    • 从模板字节生成文档,或从磁盘上的相同文件名生成文档。

卸载Workbench

使用控制面板中的“添加或删除程序”功能启动卸载程序。 Workbench和Designer应用程序具有单独的卸载程序。

配置AEM Forms XDC编辑器

使用XDC编辑器,网络打印机管理员可以创建和修改XML Forms架构设备配置(XDC)文件。 XDC文件描述了打印机的功能,如打印机语言或纸张大小与纸盒位置之间的关联。

在网络打印机管理员使用XDC编辑器之前,请重新定位示例XDC文件,并参阅使用XDC编辑器创建设备配置文件。

要获取示例XDC文件:

  1. 在AEM Forms服务器上,在[AEM Forms根]\sdk\samples\Output\IVS中找到XDC文件夹。
  2. 将此文件夹的内容复制到可从Workbench或Eclipse系统访问的目录中。

要获取XDC编辑器帮助:

  1. 转到AEM Forms文档网站。
  2. 单击​Develop​选项卡,然后导航至使用XDC编辑器创建设备配置文件。 下载xdc_editor_help_web.zip文件,并按照自述文件中提供的说明安装帮助文件。

在此页面上