Show Menu
TEMAS×

Instalar Workbench

Este documento proporciona instrucciones para instalar y configurar AEM Forms Workbench. El programa de instalación también instala Forms Designer.

Who should read this document?

Este documento está dirigido a administradores o desarrolladores responsables de la instalación, configuración, administración o implementación de Workbench. También se incluye la información necesaria para configurar el sistema de forma que admita los procesos actualizados de AEM Forms. La información proporcionada se basa en el supuesto de que cualquiera que lea este documento está familiarizado con el sistema operativo Microsoft® Windows®.

Información adicional

Los recursos de esta tabla pueden ayudarle a obtener más información y a empezar a utilizar AEM Forms.
Para obtener información acerca de
Consulte
Información de procedimiento para Workbench
Información general sobre AEM Forms y cómo se integra con otros productos de Adobe
Toda la documentación disponible para AEM Forms
Documentación de AEM Forms
Actualizaciones de parches, notas técnicas e información adicional sobre esta versión de producto
Póngase en contacto con el servicio de asistencia empresarial de Adobe
Flex Workspace está en desuso para AEM Forms. Está disponible para la versión de AEM Forms.

Before You Install

Información general sobre la instalación de Workbench

Workbench es un entorno de desarrollo integrado (IDE) que los desarrolladores y los autores de formularios utilizan para crear formularios y procesos empresariales automatizados. También se utiliza para administrar los recursos y servicios que utilizan los procesos y formularios.
En la ilustración siguiente se muestra la instalación de Workbench, que incluye:
  • Diseño de procesos con Workbench
  • Diseño de formularios con Designer
El servidor de AEM Forms requiere un programa de instalación independiente. Para obtener más información, consulte la documentación de instalación de AEM Forms en JEE.

Requisitos previos del sistema

Esta sección describe los requisitos de hardware y software y las plataformas admitidas.

Requisitos mínimos de hardware y software

Workbench Se recomiendan como mínimo los siguientes requisitos:Espacio en disco para la instalación:
  • 680 MB solo para Workbench.
  • 2,15 GB en una sola unidad para una instalación completa de Workbench, Designer y el conjunto de muestras.
  • 400 MB para directorios de instalación temporales: 200 MB en el directorio \temp del usuario y 200 MB en el directorio temporal de Windows.
Si todas estas ubicaciones residen en una sola unidad, debe haber 1,5 GB de espacio disponible durante la instalación. Los archivos copiados en los directorios temporales se eliminan al finalizar la instalación.
  • Requisitos de hardware: Procesador Intel® Pentium® 4 o AMD equivalente, 1 GHz.
  • Java™ Runtime Environment (JRE) 7.0 actualización 51 o posterior se actualiza a 7.0.
  • Resolución mínima de pantalla de 1024 X 768 píxeles o superior con color de 16 bits o superior.
  • Conexión de red TCP/IPv4 o TCP/IPv6 al servidor de AEM Forms.
  • Instale los paquetes de tiempo de ejecución redistribuibles de Visual C++ 2012 de 32 bits.
  • Instale los paquetes de tiempo de ejecución redistribuibles de Visual C++ 2013 de 32 bits.
Debe tener privilegios de administrador para instalar Workbench. Si va a realizar la instalación con una cuenta que no sea de administrador, el programa de instalación le pedirá las credenciales de una cuenta adecuada.

Plataformas compatibles

Consulte la lista completa de plataformas compatibles con Workbench en las plataformas compatibles con AEM Forms .

Consideraciones sobre la instalación de Designer

De forma predeterminada, la instalación de Workbench incluye una versión correspondiente solo en inglés de Designer. Si la aplicación de instalación de Workbench detecta una versión existente de Designer en el equipo, la instalación puede finalizar y se le solicitará que elimine la versión actual de Designer antes de poder continuar. La tabla siguiente contiene una lista completa de los posibles escenarios de instalación de Designer que puede encontrar, así como de las acciones que debe realizar al instalar Workbench.
Versión de Designer instalada actualmente
Acciones necesarias
Acrobat Pro o Acrobat Pro Extended (incluye Designer)
Ninguna. La instalación de Workbench detecta una instancia de Designer en el equipo que se instaló con Acrobat Pro o Acrobat Pro Extended. En el mismo sistema pueden coexistir distintas versiones de Designer, por ejemplo, Designer 6.4.x para Workbench 6.4 y Designer 6.5.0.x para Workbench 6.5. No es necesario desinstalar la versión de Designer instalada con Acrobat 10 Pro o Acrobat 10 Pro Extended, o posterior.
Designer (independiente)
Ninguna. La versión de Designer incluida con Workbench solo está disponible en inglés. El instalador de Workbench no reinstalará una nueva versión de Designer. En su lugar, se realizará una revisión de una versión actualizada, incluida con el instalador de Workbench. Esto también le permite utilizar la versión localizada de Designer en Workbench.

Para desinstalar Designer (independiente) en Windows 10

  1. Vaya al Panel de control > Programas > Programas y características
  2. En la lista Programas instalados actualmente, seleccione Adobe Designer .
  3. Haga clic en Desinstalar y, a continuación, en .

Instalación de Workbench

En este capítulo se describe cómo instalar Workbench.

Instalación y ejecución de Workbench

Antes de instalar Workbench, debe asegurarse de que su entorno incluye el software y el hardware necesarios para ejecutarlo (consulte la sección: Antes De Instalar ).
Para instalar y ejecutar Workbench:
  1. Realice una de estas tareas:
    • Vaya al directorio \Workbench del medio de instalación y haga doble clic en el archivo run_windows_installer.bat.
    • Descargue y descomprima Workbench en el sistema de archivos. Después de descargarlo, vaya al directorio \Workbench y haga doble clic en el archivo run_windows_installer.bat.
    El instalador de Workbench solo se ejecuta desde una unidad local. No se puede ejecutar desde un sitio remoto.
    Si aparece un error "No se pudo crear la máquina virtual Java", cree una variable de entorno denominada _JAVA_OPTIONS con el valor -Xmx512M y ejecute el programa de instalación.
  2. En la pantalla Introducción, haga clic en Siguiente.
  3. Lea el contrato de licencia del producto, seleccione Acepto los términos del contrato de licencia y haga clic en Siguiente.
  4. (Opcional) Seleccione Instalar Adobe Designer si necesita esta herramienta para crear y modificar formularios.
    Puede seguir utilizando Designer instalado con Acrobat 10 si deja esta opción sin seleccionar.
  5. Acepte el directorio predeterminado como se muestra en la lista o haga clic en Elegir, vaya al directorio en el que va a instalar Workbench y, a continuación, haga clic en Siguiente.
    La ruta del directorio de instalación no debe contener los caracteres # (libras) y $ (dólares).
  6. Revise el resumen de la preinstalación y haga clic en Instalar. El programa de instalación muestra el progreso de la instalación.
  7. Revise el resumen de la instalación. Seleccione Iniciar AEM Forms Workbench para iniciar Workbench y haga clic en Siguiente.
  8. Revise las Notas de la versión y haga clic en Finalizado.
  9. Los siguientes elementos ya están instalados en el equipo:
    • Workbench : Para ejecutar Workbench desde el menú Inicio, seleccione Todos los programas > Formularios AEM > Workbench si decide almacenar la carpeta de accesos directos en ella. Para obtener más información, consulte la documentación WorkbenchHelp.pdfUso de Workbench .
    • Designer : Puede acceder a Designer desde Workbench. Para obtener más información, consulte el tema Introducción en la Ayuda using-designer.pdfdeDesigner.
    • SDK de AEM Forms: Para obtener más información sobre el uso del SDK, consulte learn_aemforms_programming_65Programación con AEM Forms.

Procesos de actualización

Los formularios AEM en procesos JEE se pueden actualizar a aplicaciones de AEM Forms mediante el Asistente para la actualización. Consulte Actualización de la documentación de artefactos heredados en la Ayuda de Workbench para obtener más información.

Configuración e inicio de sesión en un servidor

Para utilizar Workbench, debe tener una instancia de AEM Forms en ejecución, normalmente en un equipo independiente. Debe tener un nombre de usuario y una contraseña para iniciar sesión en AEM Forms, así como detalles sobre la ubicación del servidor.
Si ha configurado AEM Forms para que utilice el proveedor de repositorio Documentum de EMC o IBM FileNet y desea iniciar sesión en un repositorio distinto del repositorio configurado como predeterminado en la consola de administración de formularios AEM, proporcione el nombre de usuario como username@Repository.

Configuración de la configuración del tiempo de espera

De forma predeterminada, el tiempo de espera de Workbench finaliza al cabo de dos horas, independientemente de la actividad o la inactividad. Para editar la configuración de tiempo de espera, consulte "Configuración de la administración de usuarios > Configuración de atributos avanzados del sistema" en la Ayuda configure-advanced-system-attributes.htmlde la consola deadministración.

Configuración de Workbench para conectarse a través de HTTPS

Para conectar Workbench con un servidor de AEM Forms a través de HTTPS, debe asegurarse de que Workbench reconozca que la entidad de certificación (CA) que emitió la clave pública es de confianza. Si no se reconoce que el certificado proviene de un origen de confianza, debe actualizar el archivo cacert ubicado en el directorio #/Workbench/jre/lib/security.
# representa el directorio donde instaló Workbench. La ubicación predeterminada es C:\Program Files (x86)\Adobe Experience Manager Forms Workbench.
Asegúrese de conectarse a HTTPS utilizando el nombre especificado en el certificado. Normalmente, este nombre es el nombre de host completo.
Para actualizar el archivo cacert:
  1. Asegúrese de que dispone de una copia del certificado de Capa de sockets seguros (SSL). Póngase en contacto con el administrador que configuró el servidor SSL o exporte el certificado mediante un navegador web.
    Para exportar el certificado, abra un navegador web e inicie sesión en la consola de administración, instale el certificado en el navegador y, a continuación, exporte el certificado desde el navegador a una ubicación de almacenamiento temporal (o directamente al directorio #/Workbench/jre/lib/security).
  2. Copie el certificado en el directorio #/Workbench/jre/lib/security.
  3. Abra una ventana del símbolo del sistema, vaya a #/Workbench/jre/bin y, a continuación, escriba el siguiente comando: 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 Donde:
    • change es la contraseña predeterminada para el almacén de claves cacerts.
    • certname es el certificado seleccionado en el paso 1.
    • ejemplo es el alias que elija para el certificado. Este valor se puede cambiar
  4. Cuando se le pida que confíe en el certificado, escriba Sí y pulse la tecla Intro. La herramienta de clave procede a importar el archivo cacerts en el directorio #/Workbench/jre/lib/security.
  5. Cierre y reinicie Workbench para aplicar los cambios.

Configuración de la caché para plantillas generadas dinámicamente

Se deben tener en cuenta los siguientes aspectos de la operación de caché si la aplicación genera plantillas únicas sobre la marcha mediante la actualización automática del contenido XFA. De hecho, cada transacción utiliza una plantilla nueva y única.
Cuando el generador de formularios o la salida buscan o actualizan entradas en la caché para una plantilla de formulario específica, utiliza varios valores clave para ubicar la entrada de caché específica a la que se accederá.
  • Nombre del archivo de plantilla: Ubicación y nombre de archivo de la plantilla utilizada como identificador único principal del formulario en caché.
  • Marca de hora : El archivo de plantilla contiene una marca de hora que se utiliza para determinar la hora de la última actualización del formulario.
  • UUID de plantilla: Designer inserta en cada plantilla un identificador único (UUID) para el formulario y su versión. Cada vez que se actualiza el formulario, se actualiza el UUID incrustado. Por ejemplo, una plantilla XDP puede mostrar el siguiente contenido:
    <?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/">
  • Opciones de procesamiento: Dentro de la caché de formularios procesada, el contenido de la caché se almacena por separado para cada conjunto de opciones de procesamiento únicas.
El servicio Forms recibe plantillas por referencia al nombre de archivo o la ubicación del repositorio, o por valor como un objeto XML en memoria.
  • Plantillas pasadas por referencia : Utiliza la raíz de contenido y el nombre del formulario. Si se pasan plantillas únicas con nombres de archivo diferentes en cada solicitud mediante este método, la caché de disco crecerá indefinidamente y nunca se volverá a utilizar. Para evitar esto, las plantillas únicas deben pasarse con el mismo nombre de archivo para garantizar que la misma caché se actualice para todas las solicitudes.
  • Plantillas pasadas por valor : Utiliza bytes de plantilla pasados junto con los datos mediante el parámetro theinDataDoc. Si se pasan plantillas únicas con UUID diferentes mediante este método, la caché de disco crecerá indefinidamente y nunca se volverá a utilizar. Para evitar esto, el atributo UUID debe eliminarse de todas las plantillas para garantizar que no se cree ninguna caché para la plantilla. De forma alternativa, si se pasa el mismo UUID que no sea nulo, se pueden crear los objetos de caché, pero se garantiza que la misma caché se actualiza con cada solicitud.
Para evitar que la caché crezca indefinidamente, tenga en cuenta los siguientes factores para procesar plantillas generadas dinámicamente con las nuevas API de AEM Forms, las cuales se procesan con los formatos renderizarHTMLForm2 y renderizarPDFForm2.
Al utilizar las nuevas API, la plantilla se pasa como un objeto de documento, que se gestiona en el servicio Forms en función de si está pasivada o no.
Para documentos pasivados en los que UUID y la raíz de contenido sirven como clave de caché, tenga en cuenta los siguientes aspectos:
  • La caché no se crea para plantillas de entrada pasivas sin UUID.
  • Si se pasa más de una plantilla de entrada pasiva con el mismo UUID y la misma raíz de contenido, se sobrescribe la misma caché.
Para los documentos no pasivos en los que el nombre de archivo y la raíz de contenido sirven como clave de caché, tenga en cuenta lo siguiente:
  • Para las plantillas de entrada no pasivas, el almacenamiento en caché depende de la raíz de contenido y el nombre de archivo desde los que se generó el documento. La misma caché se utilizará solamente para solicitudes con la misma raíz de contenido y nombre de archivo de plantilla. Las siguientes optimizaciones garantizan que la caché no crezca indefinidamente cuando se pasen plantillas generadas dinámicamente al servicio Forms:
    • Elimine el UUID o pase el mismo UUID en todas las plantillas generadas dinámicamente.
    • Genere el documento a partir de bytes de plantilla o del mismo nombre de archivo en disco.

Desinstalación de Workbench

Utilice la función Agregar o quitar programas del Panel de control para iniciar el programa de desinstalación. Las aplicaciones de Workbench y Designer tienen programas de desinstalación independientes.

Configuración del Editor XDC de AEM Forms

Con el Editor XDC, los administradores de impresoras en red pueden crear y modificar archivos de configuración de dispositivo de arquitectura de formularios XML (XDC). Los archivos XDC describen las funciones de las impresoras, como el idioma de la impresora o la correlación entre el tamaño del papel y la ubicación de la bandeja.
Antes de que el administrador de la impresora de red utilice el Editor XDC, reubique los archivos XDC de ejemplo y consulte Creación de perfiles de dispositivo mediante el Editor XDC.
Para obtener los archivos XDC de ejemplo:
  1. En el servidor de AEM Forms, busque la carpeta XDC en la carpeta raíz #AEM Forms.
  2. Copie el contenido de esta carpeta en un directorio al que se pueda acceder desde el sistema Workbench o Eclipse.
Para obtener la ayuda del Editor XDC:
  1. Vaya al sitio web de documentación de AEM Forms.
  2. Haga clic en la ficha Desarrollar y vaya a Creación de perfiles de dispositivo con el Editor XDC. Descargue el archivo xdc_editor_help_web.zip e instale los archivos de ayuda siguiendo las instrucciones que se proporcionan en el archivo Léame.