Instalar Workbench install-workbench

Este documento fornece instruções para instalar e configurar o AEM Forms Workbench. O programa de instalação também instala o Forms Designer.

Quem deve ler este documento? who-should-read-this-doc

Este documento destina-se a administradores ou desenvolvedores responsáveis por instalar, configurar, administrar ou implantar o Workbench. Também estão incluídas informações para configurar seu sistema para dar suporte aos processos atualizados do AEM Forms. As informações fornecidas são baseadas no pressuposto de que qualquer pessoa que leia este documento está familiarizada com o sistema operacional Microsoft® Windows®.

Informações adicionais additional-information

Os recursos nesta tabela podem ajudar você a saber mais sobre o e começar a usar o AEM Forms.

Para obter informações sobre
Consulte
Informações de procedimentos do Workbench
Ajuda do Workbench
Informações gerais sobre a AEM Forms e como ela se integra a outros produtos Adobe
Visão geral do AEM Forms
Toda a documentação disponível para o AEM Forms
Documentação do AEM Forms
Atualizações de patches, notas técnicas e informações adicionais sobre esta versão do produto
Entre em contato com o Suporte do Adobe Enterprise
NOTE
O espaço de trabalho do Flex está obsoleto para o AEM Forms. Ele está disponível para a versão do AEM Forms.

Antes de instalar before-you-install

Visão geral da instalação do Workbench workbench-installation-overview

O Workbench é um ambiente de desenvolvimento integrado (IDE) que desenvolvedores e autores de formulários usam para criar processos e formulários comerciais automatizados. Ele também é usado para gerenciar os recursos e serviços que os processos e formulários usam.

A ilustração a seguir descreve a instalação do Workbench, incluindo:

  • Design de processos usando o Workbench
  • Design do formulário usando Designer
NOTE
O AEM Forms Server requer um programa de instalação separado. Para obter mais informações, consulte a documentação de instalação do AEM Forms no JEE.

default-render-form

Pré-requisitos do sistema system-prerequisites

Esta seção descreve os requisitos de hardware e software e as plataformas suportadas.

Requisitos mínimos de hardware e software minimum-hardware-software-requirements

Workbench
Os seguintes requisitos são recomendados como o mínimo: Espaço em disco para instalação:

  • 680 MB somente para Workbench.
  • 2,15 GB em uma única unidade para uma instalação completa do Workbench, Designer e do conjunto de amostras.
  • 400 MB para diretórios de instalação temporários - 200 MB no diretório usuário \temp e 200 MB no diretório temporário do Windows.
NOTE
Se todos esses locais residirem em uma única unidade, deverá haver 1,5 GB de espaço disponível durante a instalação. Os arquivos copiados para os diretórios temporários são excluídos quando a instalação é concluída.
  • Requisito de hardware: processador Intel® Pentium® 4 ou AMD® equivalente, 1 GHz.
  • Java™ Runtime Environment (JRE) 7.0 atualização 51 ou atualizações posteriores para 7.0.
  • Resolução mínima do monitor de 1024 X 768 pixels ou superior com cor de 16 bits ou superior.
  • Conexão de rede TCP/IPv4 ou TCP/IPv6 com o AEM Forms Server.
  • Instalar Pacotes de Tempo de Execução Redistribuíveis do Visual C++ 2012 de 32 bits.
  • Instalar Pacotes de Tempo de Execução Redistribuíveis do Visual C++ 2013 de 32 bits.
NOTE
Você deve ter privilégios administrativos para instalar o Workbench. Se você estiver instalando usando uma conta de não administrador, o instalador solicitará as credenciais de uma conta apropriada.

Plataformas compatíveis supported-platforms

Consulte a lista completa de plataformas compatíveis com o Workbench em Plataformas compatíveis com AEM Forms.

Considerações sobre a instalação do Designer designer-installation-considerations

Por padrão, a instalação do Workbench inclui uma versão correspondente somente em inglês do Designer. Se o aplicativo de instalação do Workbench detectar uma versão existente do Designer no computador, a instalação poderá terminar e será necessário remover a versão atual do Designer para continuar.
A tabela abaixo tem uma lista completa de cenários possíveis de instalação do Designer que podem ser encontrados e as ações que devem ser executadas ao instalar o Workbench.

Versão do Designer instalada atualmente
Ações necessárias
Acrobat Pro ou Acrobat Pro Extended (inclui Designer)
Nenhum.
A instalação do Workbench detecta uma instância do Designer no computador que foi instalada com o Acrobat Pro ou o Acrobat Pro Extended.
Diferentes versões do Designer podem coexistir no mesmo sistema, por exemplo, Designer 6.4.x para Workbench 6.4 e Designer 6.5.0.x para Workbench 6.5. Não é necessário desinstalar a versão do Designer instalada com o Acrobat 10 Pro ou Acrobat 10 Pro Extended ou superior.
Designer (independente)
Nenhum.
A versão do Designer incluída com o Workbench é somente em inglês.
O instalador do Workbench não reinstala uma nova versão do Designer. Em vez disso, uma versão atualizada, fornecida com o instalador do Workbench, é corrigida. Isso também permite usar a versão localizada do Designer no Workbench.

Para desinstalar o Designer (independente) no Windows 10 uninstall-designer-standalone-windows10

  1. Ir para Painel de controle > Programas > Programas e recursos
  2. Na lista Programas instalados, selecione Adobe Designer.
  3. Clique em Desinstalar e clique em Sim.

Instalar o Workbench installing-workbench

Este capítulo descreve como instalar o Workbench.

Instalação e execução do Workbench installing-and-running-workbench

Antes de instalar o Workbench, você deve garantir que seu ambiente inclua o software e o hardware necessários para executá-lo (Consulte a seção: Antes de instalar).

Para instalar e executar o Workbench:

  1. Execute uma destas tarefas:

    • Navegue até o diretório \workbench na mídia de instalação e clique duas vezes no arquivo run_windows_installer.bat.
    • Baixe e descompacte o Workbench no seu sistema de arquivos. Após o download, navegue até o diretório \workbench e clique duas vezes no arquivo run_windows_installer.bat.
    note important
    IMPORTANT
    O instalador do Workbench é executado somente a partir de uma unidade local. Ele não pode ser executado de um site remoto.
    note note
    NOTE
    Se você encontrar um erro "Não foi possível criar a máquina virtual Java™", crie uma variável de ambiente chamada _JAVA_OPTIONS com o valor -Xmx512M e execute o instalador.
  2. Na tela de Introdução, clique em Avançar.

  3. Leia o Contrato de licença do produto, selecione Aceito os termos do Contrato de licença e clique em Avançar.

  4. (Opcional) Selecione Instalar o Adobe Designer se precisar dessa ferramenta para criar e modificar formulários.

    note note
    NOTE
    Você pode continuar a usar o Designer instalado com o Acrobat 10 deixando essa opção desmarcada.
  5. Aceite o diretório padrão listado ou clique em Escolher e navegue até o diretório onde deseja instalar o Workbench e clique em Próximo.

    note note
    NOTE
    O caminho do diretório de instalação não deve conter os caracteres # (libra) e $ (dólar).
  6. Revise o resumo da pré-instalação e clique em Instalar. O programa de instalação mostra o andamento da instalação.

  7. Revise o resumo da instalação. Selecione Iniciar AEM Forms Workbench para iniciar o Workbench e, em seguida, clique em Próximo.

  8. Revise as Notas de versão e clique em Concluído.

  9. Os seguintes itens estão instalados no computador:

    • Workbench: para executar o Workbench no menu Iniciar, selecione Todos os programas > AEM Forms > Workbench, se você optou por armazenar a pasta de atalho lá. Para obter informações, consulte a Uso do Workbench documentação.
    • Designer: você pode acessar o Designer de dentro do Workbench. Para obter informações, consulte o tópico Introdução em Ajuda do Designer.
    • AEM FORMS SDK: para obter mais informações sobre o uso do SDK, consulte Programação com o AEM Forms.

Atualização de processos upgrading-processes

Os processos do AEM Forms no JEE podem ser atualizados para aplicativos do AEM Forms usando o Assistente de atualização. Consulte Atualização da documentação de artefatos herdados na Ajuda do Workbench para obter mais informações.

Configurar e fazer logon em um servidor configuring-and-logging-server

Para usar o Workbench, você deve ter uma instância do AEM Forms em execução, normalmente em um computador separado. Você deve ter um nome de usuário e senha para fazer logon no AEM Forms e detalhes sobre a localização do servidor.

NOTE
Se você tiver configurado o AEM Forms para usar o EMC Documentum® ou o IBM® FileNet Repository Provider e quiser fazer logon em um repositório diferente do configurado como padrão no console de administração do AEM Forms, forneça o nome de usuário como username@Repository.

Definição das configurações de tempo limite configuring-timeout-settings

Por padrão, o Workbench expira após duas horas, independentemente da atividade ou inatividade. Para editar a configuração de tempo limite, consulte "Configurar o gerenciamento de usuários > Configurar atributos avançados do sistema" no Ajuda do console de administração.

Configuração do Workbench para se conectar via HTTPS configuring-workbench-to-connect-over-HTTPS

Para conectar o Workbench a um servidor do AEM Forms por HTTPS, você deve garantir que a autoridade de certificação que emitiu a chave pública seja reconhecida como confiável pelo Workbench. Se o certificado não for reconhecido como proveniente de uma fonte confiável, você deverá atualizar o arquivo cacert no [Workbench_HOME]diretório /workbench/jre/lib/security.

NOTE
[Workbench_HOME] representa o diretório onde você instalou o Workbench. O local padrão é C:\Program Files (x86)\Adobe Experience Manager Forms Workbench.

Conecte-se ao HTTPS usando o nome especificado no certificado. Normalmente, esse é o nome de host totalmente qualificado.

Para atualizar o arquivo cacert:

  1. Verifique se você tem uma cópia do certificado SSL. Entre em contato com o administrador que configurou o servidor SSL ou exporte o certificado usando um navegador da Web.

    note note
    NOTE
    Para exportar o certificado, abra um navegador da Web e faça logon no console de administração. Instale o certificado no navegador e exporte-o do navegador para um local de armazenamento temporário (ou diretamente para o [Workbench_HOME]/workbench/jre/lib/security).
  2. Copie o certificado para a [Workbench_HOME]diretório /workbench/jre/lib/security.

  3. Abra uma janela de prompt de comando, navegue até [Workbench_HOME]/workbench/jre/bin e digite o seguinte 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
    Onde:

    • changeit é a senha padrão para o armazenamento de chaves cacerts.
    • certname é o certificado selecionado na etapa 1.
    • exemplo é o alias escolhido para o certificado. Esse valor pode ser alterado.
  4. Quando solicitado a confiar no certificado, digite Yes e pressione a tecla Enter. O keytool continua a importar o arquivo cacerts para o [Workbench_HOME]diretório /workbench/jre/lib/security.

  5. Feche e reinicie o Workbench para aplicar as alterações.

Definição das configurações de cache para modelos gerados dinamicamente configuring-cache-settings-for-dynamically-generated-templates

Os seguintes aspectos da operação de cache devem ser considerados se seu aplicativo gerar modelos exclusivos em tempo real atualizando automaticamente o conteúdo XFA. Na verdade, cada transação usa um modelo novo e exclusivo.

Quando o gerador ou a saída de formulários pesquisa ou atualiza entradas no cache para um modelo de formulário específico, ele usa vários valores principais para localizar a entrada de cache específica acessada.

  • Nome do arquivo de modelo: o local e o nome de arquivo do modelo usado como o identificador exclusivo principal do formulário em cache.

  • Carimbo de data e hora: O arquivo de modelo contém um carimbo de data e hora usado para determinar a hora da última atualização do formulário.

  • UUID do modelo: o Designer insere em cada modelo um identificador exclusivo (UUID) para o formulário e sua versão. Cada vez que o formulário é atualizado, a UUID incorporada é atualizada. Por exemplo, um modelo XDP pode mostrar o seguinte conteúdo:

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

  • Opções de renderização: no cache de formulários renderizado, o conteúdo do cache é armazenado separadamente para cada conjunto de opções de renderização exclusivas.

O serviço Forms recebe modelos por referência a nome de arquivo ou localização do repositório, ou por valor como um objeto XML na memória.

  • Modelos transmitidos por referência: usa a raiz do conteúdo e o nome do formulário. Se modelos exclusivos com nomes de arquivo diferentes forem passados em cada solicitação usando esse método, o cache de disco crescerá infinitamente e nunca será reutilizado. Para evitar isso, modelos exclusivos devem ser passados com o mesmo nome de arquivo para garantir que o mesmo cache seja atualizado para todas as solicitações.
  • Modelos transmitidos por valor: usa bytes de modelo transmitidos junto com os dados usando o parâmetro inDataDoc. Se modelos exclusivos com UUID diferente forem transmitidos usando esse método, o cache de disco crescerá infinitamente e nunca será reutilizado. Para evitar isso, o atributo UUID deve ser removido de todos os modelos para garantir que nenhum cache seja criado para o modelo. Como alternativa, passar a mesma UUID não nula permite que os objetos de cache sejam criados, mas garante que o mesmo cache seja atualizado com cada solicitação.

Para evitar que o cache cresça infinitamente, considere os seguintes fatores para renderizar modelos gerados dinamicamente usando as novas APIs do AEM Forms, que são renderHTMLForm2 e renderPDFForm2.

Ao usar as novas APIs, o modelo é passado como um objeto de documento, que é tratado no serviço do Forms com base no fato de ser passivo ou não.

Para documentos passivos em que o UUID e a raiz de conteúdo servem como a chave de cache, considere os seguintes aspectos:

  • O cache não é criado para modelos de entrada passivos sem UUID.
  • Se mais de um template de entrada passivo com a mesma UUID e raiz de conteúdo for transmitido, o mesmo cache será substituído.

Para documentos não passivos nos quais o nome do arquivo e a raiz do conteúdo servem como a chave de cache, considere o seguinte aspecto:

  • Para modelos de entrada não passivos, o armazenamento em cache depende da raiz do conteúdo e do nome de arquivo a partir dos quais o documento foi gerado.
    O mesmo cache é usado somente para solicitações com a mesma raiz de conteúdo e nome de arquivo de modelo.
    As práticas recomendadas a seguir garantem que o cache não cresça infinitamente quando modelos gerados dinamicamente forem passados para o serviço Forms:

    • Remova a UUID ou passe a mesma UUID em todos os modelos gerados dinamicamente.
    • Gere o documento a partir de bytes de modelo ou a partir do mesmo nome de arquivo no disco.

Desinstalar o Workbench uninstalling-workbench

Use a função Adicionar ou remover programas no Painel de controle do Campaign para iniciar o desinstalador. Os aplicativos do Workbench e do Designer têm programas de desinstalação separados.

Configuração do editor XDC do AEM Forms configuring-aem-forms-xdc-editor

Usando o Editor XDC, os administradores da impressora de rede podem criar e modificar arquivos XML Forms Architecture Device Configuration (XDC). Os arquivos XDC descrevem os recursos das impressoras, como o idioma da impressora ou a correlação entre o tamanho do papel e o local da bandeja.

Antes que o administrador da impressora de rede use o Editor XDC, realoque os arquivos XDC de amostra e consulte Criação de perfis de dispositivo usando o Editor XDC.

Para obter os arquivos XDC de amostra:

  1. No servidor do AEM Forms, localize a pasta XDC em [Raiz do AEM Forms]\sdk\samples\Output\IVS.
  2. Copie o conteúdo dessa pasta em um diretório que possa ser acessado do sistema Workbench ou Eclipse.

Para obter a ajuda do Editor XDC:

  1. Acesse o site de documentação do AEM Forms.
  2. Clique em Desenvolver e navegue até Criar perfis de dispositivo usando o Editor XDC. Descarregue o arquivo xdc_editor_help_web.zip e instale os arquivos de Ajuda seguindo as instruções fornecidas no arquivo Readme.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2