安装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文件，并按照自述文件中提供的说明安装帮助文件。

在此页面上