Instalar e configurar serviços de documento installing-and-configuring-document-services

A AEM Forms fornece um conjunto de serviços OSGi para realizar diferentes operações em nível de documento, por exemplo, serviços para criar, montar, distribuir e arquivar documentos de PDF, adicionar assinaturas digitais para limitar o acesso a documentos e decodificar Forms com código de barras. Esses serviços estão incluídos no pacote complementar do AEM Forms. Coletivamente, esses serviços são conhecidos como serviços de documentos. A lista de serviços de documentos disponíveis e seus principais recursos são os seguintes:

  • Serviço de Assembler: permite combinar, reorganizar e aumentar documentos PDF e XDP e obter informações sobre documentos PDF. Também ajuda a converter e validar documentos PDF para o padrão PDF/A, transforma PDF forms, formulários XML e PDF forms em PDF/A-1b, PDF/A-2b e PDFA/A-3b. Para obter mais informações, consulte Serviço de Assembler.

  • Serviço ConvertPDF: permite converter documentos PDF em arquivos PostScript ou de imagem (JPEG, JPEG 2000, PNG e TIFF). Para obter mais informações, consulte Converter serviço PDF.

  • Serviço Forms com código de barras: permite extrair dados de imagens eletrônicas de códigos de barras. O serviço aceita arquivos TIFF e PDF que incluem um ou mais códigos de barras como entrada e extrai os dados do código de barras. Para obter mais informações, consulte Serviço Forms com código de barras.

  • Serviço DocAssurance: permite criptografar e descriptografar documentos, estender a funcionalidade do Adobe Reader com direitos de uso adicionais e adicionar assinaturas digitais aos documentos. O serviço Doc Assurance contém três serviços: assinatura, criptografia e extensão do leitor. Para obter mais informações, consulte DocAssurance Service.

  • Serviço de criptografia: permite que você criptografe e descriptografe documentos. Quando um documento é criptografado, seu conteúdo fica ilegível. Um usuário autorizado pode descriptografar o documento para obter acesso ao conteúdo. Para obter mais informações, consulte Serviço de criptografia.

  • Serviço Forms: permite criar aplicativos cliente de captura de dados interativos que validam, processam, transformam e entregam formulários que normalmente são criados no Forms Designer. O serviço Forms renderiza qualquer design de formulário que você desenvolve em documentos PDF. Para obter mais informações, consulte Forms Service.

  • Serviço de saída: permite que você crie documentos em diferentes formatos, incluindo PDF, formatos de impressora a laser e formatos de impressora de etiquetas. Os formatos de impressora a laser são PostScript e PCL (Printer Control Language). Para obter mais informações, consulte Serviço de Saída.

  • serviço de PDF Generator: o serviço de PDF Generator fornece APIs para converter formatos de arquivo nativos em PDF. Ele também converte o PDF para outros formatos de arquivo e otimiza o tamanho dos documentos PDF. Para obter mais informações, consulte PDF Generator Service.

  • Serviço de extensão de Reader: permite que sua organização compartilhe facilmente documentos PDF interativos estendendo a funcionalidade do Adobe Reader com direitos de uso adicionais. O serviço ativa recursos que não estão disponíveis quando um documento PDF é aberto usando o Adobe Reader, como adicionar comentários a um documento, preencher formulários e salvar o documento. Para obter mais informações, consulte Serviço de Extensão Reader.

  • Serviço de assinatura: permite que você trabalhe com assinaturas e documentos digitais no servidor AEM. Por exemplo, o serviço de Assinatura é normalmente usado nas seguintes situações:

    • O servidor AEM certifica um formulário antes que ele seja enviado a um usuário para ser aberto usando o Acrobat ou o Adobe Reader.
    • O servidor AEM valida uma assinatura que foi adicionada a um formulário usando Acrobat ou Adobe Reader.
    • O servidor AEM assina um formulário em nome de um notário público.

    O serviço de assinatura acessa certificados e credenciais armazenados no armazenamento de confiança. Para obter mais informações, consulte Serviço de assinatura.

O AEM Forms é uma plataforma corporativa poderosa e os serviços de documentos são apenas um dos recursos do AEM Forms. Para obter a lista completa de recursos, consulte Introdução ao AEM Forms.

Topologia de implantação deployment-topology

O pacote complementar do AEM Forms é um aplicativo implantado no AEM. Geralmente, você precisa de apenas uma instância do AEM (autor ou publicação) para executar os serviços de documento da AEM Forms. A topologia a seguir é recomendada para executar serviços de documento do AEM Forms. Para obter informações detalhadas sobre topologias, consulte Arquitetura e topologias de implantação para AEM Forms.

Arquitetura e topologias de implantação para o AEM Forms

NOTE
Embora o AEM Forms permita configurar e executar todas as funcionalidades de um único servidor, você deve fazer o planejamento de capacidade, o balanceamento de carga e configurar servidores dedicados para recursos específicos em um ambiente de produção. Por exemplo, para um ambiente que usa o serviço PDF Generator para converter milhares de páginas por dia e vários formulários adaptáveis para capturar dados, configure servidores AEM Forms separados para o serviço PDF Generator e recursos de formulários adaptáveis. Ele ajuda a fornecer o melhor desempenho e a dimensionar os servidores independentemente uns dos outros.

Requisitos do sistema system-requirements

Antes de começar a instalar e configurar os serviços de documento do AEM Forms, verifique se:

  • A infraestrutura de hardware e software está em vigor. Para obter uma lista detalhada de hardware e software com suporte, consulte requisitos técnicos.

  • O caminho de instalação da instância do AEM não contém espaços em branco.

  • Uma instância do AEM está em funcionamento. Na terminologia do AEM, uma "instância" é uma cópia do AEM em execução em um servidor no modo de criação ou publicação. Geralmente, você precisa de apenas uma instância do AEM (autor ou publicação) para executar os serviços de documento da AEM Forms:

    • Autor: uma instância do AEM usada para criar, carregar, editar conteúdo e administrar o site. Quando o conteúdo estiver pronto para entrar em funcionamento, ele será replicado para a instância de publicação.
    • Publish: uma instância AEM que fornece o conteúdo publicado ao público pela Internet ou por uma rede interna.
  • Os requisitos de memória são atendidos. O pacote complementar do AEM Forms exige:

    • 15 GB de espaço temporário para instalações baseadas no Microsoft® Windows.
    • 6 GB de espaço temporário para instalações baseadas em UNIX.
  • O software cliente necessário para o gerador de PDF executar a conversão no Microsoft® Windows e Linux® está instalado:

NOTE
  • No Microsoft® Windows, o PDF Generator suporta as rotas de conversão WebKit, Acrobat WebCapture e WebToPDF para converter arquivos HTML em documentos PDF.
  • Em sistemas operacionais baseados em UNIX, o PDF Generator suporta rotas de conversão WebKit e WebToPDF para converter arquivos HTML em documentos PDF.

Requisitos adicionais para o sistema operacional baseado em UNIX extrarequirements

Se você estiver usando um sistema operacional baseado em UNIX, instale os seguintes pacotes de 32 bits a partir da mídia de instalação do respectivo sistema operacional:

  • expat
  • libxcb
  • freetype
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softoken-freebl
  • fontconfig
  • libX11
  • libXrender
  • libXrandr
  • libXinerama
  • (PDF Generator only) Instale a versão de 32 bits das bibliotecas libcurl, libcrypto e libssl e crie os symlinks abaixo. Os symlinks apontam para a versão mais recente das respectivas bibliotecas:

    • /usr/lib/libcurl.so
    • /usr/lib/libcrypto.so
    • /usr/lib/libssl.so
  • (somente PDF Generator) o serviço PDF Generator oferece suporte às rotas WebKit e WebToPDF para converter arquivos HTML em documentos PDF. Para habilitar a conversão para a rota WebToPDF, instale as bibliotecas de 64 bits listadas abaixo. Geralmente, essas bibliotecas já estão instaladas. Se alguma biblioteca estiver ausente, instale-a manualmente:

    • 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

Configurações de pré-instalação preinstallationconfigurations

As configurações listadas na seção de configurações de pré-instalação se aplicam somente ao serviço PDF Generator. Se você não estiver configurando o serviço PDF Generator, ignore a seção de configuração de pré-instalação.

Instalar o Adobe Acrobat e aplicativos de terceiros install-adobe-acrobat-and-third-party-applications

Se você for usar o serviço PDF Generator para converter formatos de arquivo nativos como Microsoft® Word, Microsoft® Excel, Microsoft® PowerPoint, OpenOffice, WordPerfect X7 e Adobe Acrobat em documentos PDF, verifique se esses aplicativos estão instalados no servidor AEM Forms.

NOTE
  • Se o AEM Forms Server estiver em um ambiente offline ou seguro e a Internet não estiver disponível para ativar o Adobe Acrobat, consulte Ativação offline para obter instruções sobre como ativar essas instâncias do Adobe Acrobat.
  • Adobe Acrobat, Microsoft® Word, Excel e Powerpoint estão disponíveis apenas para Microsoft® Windows. Se você estiver usando o sistema operacional baseado em UNIX, instale o OpenOffice para converter arquivos rich text e arquivos suportados do Microsoft® Office em documentos PDF.
  • Ignore todas as caixas de diálogo exibidas após a instalação do Adobe Acrobat e de software de terceiros para todos os usuários configurados para usar o serviço PDF Generator.
  • Inicie todos os softwares instalados pelo menos uma vez. Ignore todas as caixas de diálogo de todos os usuários configurados para usar o serviço PDF Generator.
  • Verifique a data de expiração de seus números de série da Adobe Acrobat e defina uma data para atualizar a licença ou migre seu número de série com base na data de expiração.

Após instalar o Acrobat, abra o Microsoft® Word. Na guia Acrobat, clique em Criar PDF e converta um arquivo .doc ou .docx disponível no computador em um Documento PDF. Se a conversão for bem-sucedida, o AEM Forms estará pronto para usar o Acrobat com o serviço PDF Generator.

Configurar variáveis de ambiente setup-environment-variables

Defina variáveis de ambiente para o Java Development Kit de 64 bits, aplicativos de terceiros e Adobe Acrobat. As variáveis de ambiente devem conter o caminho absoluto do executável usado para iniciar o aplicativo correspondente. Por exemplo, a tabela abaixo lista as variáveis de ambiente para alguns aplicativos:

Aplicativo
Variável de ambiente
Exemplo
JDK (64 bits)
JAVA_HOME
C:\Program Files\Java\jdk1.8.0_74
Adobe Acrobat
Acrobat_PATH
Arquivos C:\Program (x86)\Adobe\Acrobat 2015\Acrobat\Acrobat.exe
Bloco de notas
Notepad_PATH
C:\WINDOWS\notepad.exe
OpenOffice
OpenOffice_PATH
Arquivos C:\Program (x86)\OpenOffice.org4
NOTE
  • Todas as variáveis de ambiente e os respectivos caminhos fazem distinção entre maiúsculas e minúsculas.

  • JAVA_HOME e Acrobat_PATH (somente Windows) são variáveis de ambiente obrigatórias.

  • A variável de ambiente OpenOffice_PATH está definida como a pasta de instalação em vez do caminho para o executável.

  • Não configure variáveis de ambiente para aplicativos do Microsoft® Office como Word, PowerPoint, Excel e Project, ou para AutoCAD. Se esses aplicativos estiverem instalados no servidor, o serviço Gerar PDF iniciará automaticamente esses aplicativos.

  • Em plataformas baseadas em UNIX, instale o OpenOffice como /root. Se o OpenOffice não estiver instalado como raiz, o serviço PDF Generator não converterá documentos OpenOffice em documentos PDF. Se você precisar instalar e executar o OpenOffice como um usuário não raiz, forneça direitos sudo ao usuário não raiz.

  • Se você estiver usando o OpenOffice em uma plataforma baseada em UNIX, execute o seguinte comando para definir a variável de caminho:

    export OpenOffice_PATH=/opt/openoffice.org4

(Somente para IBM® WebSphere®) Configurar o provedor de soquete SSL da IBM® only-for-ibm-websphere-configure-ibm-ssl-socket-provider

Execute as seguintes etapas para configurar o provedor de soquete IBM® SSL:

  1. Crie uma cópia do arquivo java.security. O local padrão do arquivo é [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security.

  2. Abra o arquivo java.security copiado para edição.

  3. Altere as fábricas de soquetes SSL padrão para usar as fábricas JSSE2 em vez das fábricas IBM® WebSphere® padrão:

    Conteúdo padrão:

    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
    

    Conteúdo modificado:

    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. Para permitir que o AEM Forms Server use o arquivo java.security atualizado, ao iniciar o servidor do AEM Forms, adicione o seguinte argumento java:

    -Djava.security.properties= [path of newly created Java.security file].

(Somente para Windows) Definir as configurações de bloco de arquivo do Microsoft® Office configure-the-file-block-settings-for-microsoft-office

Altere as configurações da central de confiança do Microsoft® Office para habilitar o serviço PDF Generator para converter arquivos criados com versões mais antigas do Microsoft® Office.

  1. Abra um aplicativo do Microsoft® Office. Por exemplo, Microsoft® Word. Navegue até Arquivo> Opções. A caixa de diálogo de opções é exibida.

  2. Clique em Central de Confiabilidade e em Configurações da Central de Confiabilidade.

  3. Nas configurações da Central de Confiabilidade, clique em Configurações de Bloqueio de Arquivo.

  4. Na lista Tipo de Arquivo, desmarque Abrir para o tipo de arquivo que o serviço de PDF Generator deve ter permissão para converter em documentos PDF.

(Somente Windows) Conceder o privilégio Substituir um token de nível de processo grant-the-replace-a-process-level-token-privilege

A conta de usuário usada para iniciar o servidor de aplicativos requer o privilégio Substituir um token de nível de processo. Por padrão, a conta do sistema local tem o privilégio Substituir um token de nível de processo. Para os servidores executados com um usuário do grupo Administradores locais, o privilégio deve ser concedido explicitamente. Execute as seguintes etapas para conceder o privilégio:

  1. Abra o Editor de Diretiva de Grupo para Microsoft® Windows. Para abrir o Editor de Diretiva de Grupo, clique em Iniciar, digite gpedit.msc na caixa Iniciar Pesquisa e clique em Editor de Diretiva de Grupo.
  2. Navegue até Política do Computador Local > Configuração do Computador > Configurações do Windows > Configurações de Segurança > Políticas Locais > Atribuição de Direitos de Usuário e edite a política Substituir um token de nível de processo e inclua o grupo Administradores.
  3. Adicione o usuário à entrada Substituir um token no nível do processo.
NOTE
Como implicado acima, se o servidor AEM estiver sendo executado como um serviço na conta LocalSystem (LSA), não será necessário atribuir explicitamente esse privilégio a um usuário.

(Somente para Windows) Habilitar o serviço PDF Generator para não administradores enable-the-pdf-generator-service-for-non-administrators

Você pode permitir que um usuário não administrador use o serviço PDF Generator. Normalmente, somente usuários com privilégios administrativos podem usar o serviço:

  1. Crie uma variável de ambiente, PDFG_NON_ADMIN_ENABLED.
  2. Defina o valor da variável de ambiente como TRUE.
  3. Reinicie a instância do AEM Forms.
NOTE
É recomendável usar o comando "Ctrl + C" para reiniciar o SDK. Reiniciar o SDK do AEM usando métodos alternativos, por exemplo, parar processos Java, pode levar a inconsistências no ambiente de desenvolvimento do AEM.

(Somente para Windows) Desabilitar o UAC (Controle de Conta de Usuário) disable-user-account-control-uac

  1. Para acessar o Utilitário de Configuração do Sistema, vá para Iniciar > Executar e digite MSCONFIG.

  2. Clique na guia Ferramentas, role para baixo e selecione Alterar Configurações de UAC. Clique em Iniciar para executar o comando em uma nova janela.

  3. Ajuste o controle deslizante para o nível Nunca notificar. Quando terminar, feche a janela de comando e a janela Configuração do sistema.

  4. Verifique se a configuração do Registro para UAC está definida como 0 (zero). Execute as seguintes etapas para verificar:

    1. A Microsoft® recomenda fazer backup do registro antes de modificá-lo. Para obter etapas detalhadas, consulte Como fazer backup e restaurar o Registro no Windows.
    2. Abra o editor de Registro do Microsoft® Windows. Para abrir o editor de registro, vá para Iniciar > Executar, digite regedit e clique em OK.
    3. Navegue até HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\. Verifique se o valor de EnableLUA está definido como 0 (zero).
    4. Verifique se o valor de EnableLUA está definido como 0 (zero). Se o valor não for 0, altere o valor para 0. Feche o editor de Registro.
  5. Reinicie o computador.

(Somente para Windows) Desabilitar o Serviço de Relatório de Erros disable-error-reporting-service

Ao converter um documento em PDF usando o serviço PDF Generator no Windows Server, ocasionalmente, o Windows Server relata que o executável encontrou um problema e deve ser fechado. No entanto, isso não afeta a conversão de PDF, pois continua em segundo plano.

Para evitar o recebimento do erro, você pode desativar o relatório de erros do Windows. Para obter mais informações sobre como desativar o relatório de erros, consulte https://technet.microsoft.com/en-us/library/cc754364.aspx.

(Somente para Windows) Configurar conversão de HTML em PDF configure-html-to-pdf-conversion

O serviço PDF Generator fornece rotas WebKit, WebCapture e WebToPDF ou métodos para converter arquivos HTML em documentos PDF. No Windows, para habilitar a conversão para rotas WebKit e Acrobat WebCapture, copie a fonte Unicode para o diretório %windir%\fonts.

NOTE
Sempre que você instalar novas fontes na pasta de fontes, reinicie a instância do AEM Forms.

(Somente plataformas baseadas em UNIX) Configurações extras para conversão de HTML para PDF extra-configurations-for-html-to-pdf-conversion

Em plataformas baseadas em UNIX, o serviço PDF Generator suporta rotas WebKit e WebToPDF para converter arquivos HTML em documentos PDF. Para habilitar a conversão de HTML em PDF, execute as seguintes configurações, aplicáveis à rota de conversão de sua preferência:

(Somente plataformas baseadas em UNIX) Habilitar suporte para fontes Unicode (somente WebKit) enable-support-for-unicode-fonts-webkit-only

Copie a fonte Unicode para qualquer um dos seguintes diretórios, conforme apropriado para o seu sistema:

  • /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
  • No Red Hat® Enterprise Linux® 6.x e versões posteriores, as fontes courier não estão disponíveis. Para instalar as fontes do courier, baixe o arquivo font-ibm-type1-1.0.3.zip. Extraia o arquivo em /usr/share/fonts. Crie um link simbólico de /usr/share/X11/fonts para /usr/share/fonts.
  • Exclua todos os arquivos de cache de fontes .lst dos diretórios Html2PdfSvc/bin e /usr/share/fonts.
  • Verifique se os diretórios /usr/lib/X11/fonts e /usr/share/fonts existem. Se os diretórios não existirem, use o comando ln para criar um link simbólico de /usr/share/X11/fonts para /usr/lib/X11/fonts e outro link simbólico de /usr/share/fonts para /usr/share/X11/fonts. Verifique também se as fontes do courier estão disponíveis em /usr/lib/X11/fonts.
  • Verifique se todas as fontes (Unicode e não-unicode) estão disponíveis no diretório /usr/share/fonts ou /usr/share/X11/fonts.
  • Quando você executa o serviço PDF Generator como um usuário não-raiz, forneça a ele acesso de leitura e gravação a todos os diretórios de fontes.
  • Sempre que você instalar novas fontes na pasta de fontes, reinicie a instância do AEM Forms.

Instalar pacote complementar do AEM Forms install-aem-forms-add-on-package

O pacote complementar do AEM Forms é um aplicativo implantado no AEM. O pacote contém os Serviços de documento da AEM Forms e outros recursos do AEM Forms. Execute as seguintes etapas para instalar o pacote:

  1. Abra a Distribuição de softwares. Você precisa de uma Adobe ID para fazer logon na Distribuição de softwares.

  2. Selecione Adobe Experience Manager, disponível no menu de cabeçalho.

  3. Na seção Filtros:

    1. Selecione Forms na lista suspensa Solução.
    2. Selecione a versão e o tipo do pacote. Você também pode usar a opção Downloads de Pesquisa para filtrar os resultados.
  4. Selecione o nome do pacote aplicável ao seu sistema operacional, selecione Aceitar termos do EULA e selecione Baixar.

  5. Abra o Gerenciador de Pacotes e clique em Carregar Pacote para carregar o pacote.

  6. Selecione o pacote e clique em Instalar.

    Você também pode baixar o pacote através do link direto listado no artigo versões do AEM Forms.

  7. Após a instalação do pacote, você será solicitado a reiniciar a instância do AEM. Não interromper imediatamente o servidor. Antes de parar o AEM Forms Server, aguarde até que as mensagens ServiceEvent REGISTERED e ServiceEvent UNREGISTERED parem de aparecer no arquivo [AEM-Installation-Directory]/crx-quickstart/logs/error.log e o log fique estável.

Configurações de instalação do Post post-installation-configurations

Configurar delegação de inicialização para bibliotecas RSA/BouncyCastle configure-boot-delegation-for-rsa-bouncycastle-libraries

  1. Pare a instância do AEM. Navegue até a pasta [diretório de instalação do AEM]\crx-quickstart\conf. Abra o arquivo sling.properties para edição.

    Se você usar [AEM installation directory]\crx-quickstart\bin\start.bat para iniciar uma instância de AEM, edite o sling.properties localizado em [AEM_root]\crx-quickstart\.

  2. Adicione as seguintes propriedades ao arquivo sling.properties:

    code language-shell
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
    
  3. (Somente no AIX®) Adicione as seguintes propriedades ao arquivo sling.properties:

    code language-shell
    sling.bootdelegation.xerces=org.apache.xerces.*
    
  4. Salvar e fechar o arquivo.

Configurando o serviço gerenciador de fontes configuring-the-font-manager-service

  1. Faça logon no Gerenciador de configurações do AEM como administrador.

  2. Localize e abra o serviço CQ-DAM-Handler-Gibson Font Managers. Especifique o caminho dos diretórios Fontes do sistema, Fontes do servidor de Adobe e Fontes do cliente. Clique em Salvar.

    note note
    NOTE
    Seu direito de usar fontes fornecidas por terceiros que não sejam o Adobe é regido pelos contratos de licença fornecidos a você por esses terceiros com essas fontes, e não está coberto pela sua licença para usar o software Adobe. A Adobe recomenda que você analise e garanta que esteja em conformidade com todos os contratos de licença não-Adobe aplicáveis antes de usar fontes não-Adobe com o software Adobe, especialmente no que diz respeito ao uso de fontes em um ambiente de servidor.
    Ao instalar novas fontes na pasta fontes, reinicie a instância do AEM Forms.

Configurar uma conta de usuário local para executar o serviço PDF Generator configure-a-local-user-account-to-run-the-pdf-generator-service

Uma conta de usuário local é necessária para executar o serviço PDF Generator. Para obter as etapas para criar um usuário local, consulte Criar uma conta de usuário no Windows ou criar uma conta de usuário em plataformas baseadas em UNIX.

  1. Abra a página Configuração de AEM Forms PDF Generator.

  2. Na guia Contas de Usuário, forneça as credenciais de uma conta de usuário local e clique em Enviar. Se o Microsoft® Windows solicitar, permita o acesso ao usuário. Quando adicionado com êxito, o usuário configurado é exibido na seção Suas contas de usuário da guia Contas de Usuário.

Definir as configurações de tempo limite configure-the-time-out-settings

  1. No gerenciador de configuração do AEM, localize e abra o serviço Provedor ORB Jacorb.

    Adicione o seguinte ao campo Propriedades personalizadas.nome e clique em Salvar. Ele define o tempo limite de resposta pendente (também conhecido como, tempo limite do cliente CORBA) como 600 segundos.

    jacorb.connection.client.pending_reply_timeout=600000

  2. Faça logon na instância de autor do AEM e navegue até Adobe Experience Manager > Ferramentas > Forms > Configurar PDF Generator. A URL padrão é http://localhost:4502/libs/fd/pdfg/config/ui.html.

    Abra a guia Configuração Geral e modifique o valor dos seguintes campos para seu ambiente:

Texto
Descrição
Valor padrão
Tempo limite da conversão do servidor
Uma conversão PDFG permanece ativa pelo número de segundos definidos no tempo limite de Conversão do servidor
270 segundos
Segundos para exploração de limpeza do PDFG
O número de segundos necessários para executar operações pós-conversão.
3600 segundos
Segundos para expiração da tarefa
Duração para a qual o serviço PDF Generator pode executar uma conversão. Verifique se o valor de Segundos para expiração da tarefa é maior que o valor de Segundos para varredura de limpeza do PDFG.
7200 segundos

(Somente para Windows) Configurar o Acrobat para o serviço PDF Generator configure-acrobat-for-the-pdf-generator-service

No Microsoft® Windows, o serviço de PDF Generator usa o Adobe Acrobat para converter formatos de arquivo suportados em um documento PDF. Execute as seguintes etapas para configurar o Adobe Acrobat para o serviço PDF Generator:

  1. Abra o Acrobat e selecione Editar> Preferências> Atualizador. Em Verificar atualizações, desmarque Instalar atualizações automaticamente e clique em OK. Feche o Acrobat.

  2. Clique duas vezes em um documento PDF no sistema. Quando o Acrobat é iniciado pela primeira vez, as caixas de diálogo para logon, tela de boas-vindas e EULA são exibidas. Ignore essas caixas de diálogo para todos os usuários configurados para usar o PDF Generator.

  3. Execute o arquivo de lote do utilitário PDF Generator para configurar o Acrobat para o serviço PDF Generator:

    1. Abra o Gerenciador de Pacotes do AEM e baixe o arquivo adobe-aemfd-pdfg-common-pkg-[version].zip do Gerenciador de Pacotes.

    2. Descompacte o arquivo .zip baixado. Abra o prompt de comando com privilégios administrativos.

    3. Navegue até [extracted-zip-file]\jcr_root\etc\packages\day\cq60\fd\adobe-aemds-common-pkg-[version]\jcr_root\etc\packages\day\cq60\fd\

    4. Descompacte o adobe-aemfd-pdfg-common-pkg-[version].

    5. Navegue até o diretório [downloaded-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]. Execute o seguinte arquivo de lote:

      Acrobat_for_PDFG_Configuration.bat

      O Acrobat está configurado para ser executado com o serviço PDF Generator.

  4. Execute a Ferramenta de Preparação do Sistema (SRT) para validar a instalação do Acrobat.

(Somente para Windows) Configurar a rota principal para conversão de HTML para PDF configure-primary-route-for-html-to-pdf-conversion-windows-only

O serviço PDF Generator fornece várias rotas para converter arquivos HTML em documentos PDF: Webkit, Acrobat WebCapture (somente Windows) e WebToPDF. A Adobe recomenda usar a rota WebToPDF porque ela tem a capacidade de lidar com conteúdo dinâmico e não tem dependências em bibliotecas de 32 bits ou não requer fontes extras. Além disso, a rota WebToPDF não requer acesso sudo ou root para executar a conversão.

A rota principal padrão para a conversão de HTML para PDF é Webkit. Para alterar o roteiro de conversão:

  1. Na instância do autor AEM, navegue até Ferramentas> Forms> Configurar PDF Generator.

  2. Na guia Configuração Geral, selecione a rota de conversão preferencial na lista suspensa Rota Primária para conversões de HTML para PDF.

Inicializar armazenamento global de confiança intialize-global-trust-store

Usando o Gerenciamento de Armazenamento Confiável, você pode importar, editar e excluir certificados confiáveis no servidor para validação de assinaturas digitais e autenticação de certificado. É possível importar e exportar qualquer número de certificados. Após importar um certificado, você poderá editar as configurações de confiança e o tipo de armazenamento de confiança. Execute as seguintes etapas para inicializar um armazenamento de confiança:

  1. Faça logon na instância do AEM Forms como administrador.
  2. Vá para Ferramentas > Segurança > Armazenamento de Confiança.
  3. Clique em Criar TrustStore. Defina a senha e selecione Salvar.

Configurar certificados para extensão Reader e serviço de criptografia set-up-certificates-for-reader-extension-and-encryption-service

O serviço DocAssurance pode aplicar direitos de uso a documentos PDF. Para aplicar direitos de uso a documentos do PDF, configure os certificados.

Antes de configurar os certificados, verifique se você tem:

  • Arquivo de certificado (.pfx).

  • Senha da chave de privacidade fornecida com o certificado.

  • Alias da chave de privacidade. Você pode executar o comando Java keytool para exibir o Alias da chave de privacidade:
    keytool -list -v -keystore [keystore-file] -storetype pkcs12

  • Senha do arquivo de armazenamento de chave. Se você estiver usando o certificado Adobe Reader Extensions, a senha do arquivo do Keystore será sempre a mesma da senha da Chave privada.

Execute as seguintes etapas para configurar os certificados:

  1. Faça logon na instância do autor do AEM como administrador. Vá para Ferramentas > Segurança > Usuários.

  2. Clique no campo nome da conta de usuário. A página Editar configurações do usuário é aberta. Na instância do autor do AEM, os certificados residem em um KeyStore. Se você não criou um KeyStore anteriormente, clique em Criar KeyStore e defina uma nova senha para o KeyStore. Se o servidor já contiver um KeyStore, ignore esta etapa. Se você estiver usando o certificado Adobe Reader Extensions, a senha do arquivo do Keystore será sempre a mesma da senha da Chave privada.

  3. Na página Editar Configurações de Usuário, selecione a guia KeyStore. Expanda a opção Adicionar Chave Privada do arquivo de Armazenamento de Chave e forneça um alias. O alias é usado para executar a operação Reader Extensions.

  4. Para carregar o arquivo de certificado, clique em Selecionar Arquivo de Repositório de Chaves e carregue um arquivo <filename>.pfx.

    Adicione a Senha da Chave de Armazenamento, a Senha da Chave Privada e o Alias da Chave Privada associados ao certificado nos respectivos campos. Clique em Enviar.

    note note
    NOTE
    No ambiente de produção, substitua suas credenciais de avaliação pelas credenciais de produção. Exclua suas credenciais antigas de extensões do Reader antes de atualizar uma credencial expirada ou de avaliações.
  5. Clique em Salvar e fechar na página Editar configurações de usuário.

Ativar AES-256 enable-aes

Para usar a criptografia AES 256 para arquivos PDF, obtenha e instale os arquivos de Política de Jurisdição de Força Ilimitada Java Cryptography Extension (JCE). Substitua os arquivos local_policy.jar e US_export_policy.jar na pasta jre/lib/security. Por exemplo, se você estiver usando o Sun JDK, copie os arquivos baixados para a pasta [JAVA_HOME]/jre/lib/security.

O serviço do Assembler depende do serviço Reader Extensions, do serviço Signature, do serviço Forms e do serviço Output. Execute as seguintes etapas para verificar se os serviços necessários estão em execução:

  1. Faça logon na URL https://'[server]:[port]'/system/console/bundles como administrador.
  2. Pesquise no serviço a seguir e verifique se os serviços estão em funcionamento:
Nome do serviço
Nome do pacote
Serviço de assinaturas
adobe-aemfd-signatures
Serviço de extensões do Reader
com.adobe.aemfd.adobe-aemfd-readerextensions
Serviço do Forms
com.adobe.livecycle.adobe-lc-forms-bedrock-connector
Serviço de saída
com.adobe.livecycle.adobe-lc-forms-bedrock-connector

(Somente para Windows) Configure a entrada de registro para o Projeto Microsoft® configure-registry-entry-for-microsoft-project

Depois de instalar o complemento AEM Forms e o Microsoft® Project na sua máquina, registre uma entrada para o Microsoft® Project no local de 64 bits. Ele facilita a execução de testes de conversões de Project para PDFG. Veja a seguir as etapas que descrevem o processo de entrada de registro:

  1. Abra o editor do Registro do Microsoft® Windows (regedit). Para abrir o editor do Registro, vá para Iniciar > Executar, digite regedit e clique em OK.
  2. Navegue até Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\Acrobat PDFMaker\<version>\Office\SupportedApp, crie um novo Registro de Valor Binário e renomeie-o para Projeto.
  3. Modifique o valor de dados do Registro binário criado para 01 e clique em OK.
  4. Feche a entrada do Registro.

Problemas conhecidos e solução de problemas known-issues-and-troubleshooting

  • A conversão de HTML para PDF falha se um arquivo de entrada compactado contiver arquivos HTML com caracteres de dois bytes em nomes de arquivo. Para evitar esse problema, não use caracteres de byte duplo ao nomear arquivos HTML.

  • Em sistemas operacionais baseados em UNIX, faça o seguinte para localizar bibliotecas ausentes:

  1. Vá até [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/.

  2. Execute o comando a seguir para listar todas as bibliotecas que o WebToPDF requer para a conversão de HTML em PDF.

    ldd phantomjs

    Execute o seguinte comando para listar as bibliotecas ausentes.

    ldd phantomjs | grep not

  3. Instale manualmente as bibliotecas ausentes.

SRT (System Readiness Tool, ferramenta de preparação do sistema) SRT

A Ferramenta de Preparação do Sistema verifica se o computador está configurado corretamente para executar conversões de PDF Generator. A ferramenta gera o relatório no caminho especificado. Para executar a ferramenta:

  1. Abra o prompt de comando. Navegue até a pasta [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools.

  2. Execute o seguinte comando no prompt de comando:

    java -jar forms-srt-[version].jar [Path_of_reports_folder] en

    O comando gera o relatório e também cria o arquivo srt_config.yaml. Você pode usá-lo para configurar opções para a ferramenta SRT. É opcional configurar opções para a ferramenta SRT.

    note note
    NOTE
    • Se a Ferramenta de preparação do sistema relatar que o arquivo pdfgen.api não está disponível na pasta de plug-ins do Acrobat, copie o arquivo pdfgen.api do diretório [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]\plugins\x86_win32 para o diretório [Acrobat_root]\Acrobat\plug_ins.
  3. Navegue até [Path_of_reports_folder]. Abra o arquivo SystemReadinessTool.html. Verifique o relatório e corrija os problemas mencionados.

Configuração de opções para a ferramenta SRT srt-configuration

Você pode usar o arquivo srt_config.yaml para definir várias configurações para a ferramenta SRT. O formato do arquivo é:

   # =================================================================
   # SRT Configuration
   # =================================================================
   #Note - follow correct format to avoid parsing failures
   #for example, <param name>:<space><param value>
   #locale: (mandatory field)Locale to be used for SRT. Supported locales [en/fr/de/ja].
   locale: en

   #aemTempDir: AEM Temp direcotry
   aemTempDir:

   #users: provide PDFG converting users list
   #users:
   # - user1
   # - user2
   users:

   #profile: select profile to run specific checks. Choose from [LCM], more will be added soon
   profile:

   #outputDir: directory where output files will be saved
   outputDir:
  • Localidade: É um parâmetro obrigatório. É compatível com inglês (en), alemão (de), francês (fr) e japonês (ja). O valor padrão é en. Isso não afeta os serviços de PDF Generator em execução no AEM Forms no OSGi.
  • aemTempDir: é um parâmetro opcional. Especifica o local de armazenamento temporário do Adobe Experience Manager.
  • usuários: é um parâmetro opcional. Você pode especificar um usuário para verificar se ele tem as permissões necessárias e o acesso de leitura/gravação nos diretórios necessários para executar o PDF Generator. Se nenhum usuário for especificado, as verificações específicas do usuário serão ignoradas e exibidas como falha no relatório.
  • outputDir: especifique o local para salvar o relatório SRT. O local padrão é o diretório de trabalho atual da ferramenta SRT.

Resolução de problemas

Se você enfrentar problemas mesmo depois de corrigir todos os problemas relatados pela ferramenta SRT, execute as seguintes verificações:

Antes de executar as seguintes verificações, verifique se a Ferramenta de Preparação do Sistema não relata erros.

Adobe Acrobat
  • Verifique se apenas a versão com suporte do Microsoft® Office (32 bits) e do Adobe Acrobat está instalada e se as caixas de diálogo de abertura foram canceladas.
  • Certifique-se de que o Adobe Acrobat Update Service esteja desativado.
  • Verifique se o arquivo de lote Acrobat_for_PDFG_Configuration.bat foi executado com privilégios de administrador.
  • Verifique se um usuário PDF Generator foi adicionado na interface de configuração de PDF.
  • Verifique se a permissão Substituir um token de nível de processo foi adicionada para o usuário PDF Generator.
  • Verifique se o suplemento Acrobat PDFMaker Office COM está ativado para os aplicativos do Microsoft Office.
OpenOffice

Microsoft® Windows

  • Verifique se a versão com suporte de 32 bits do Microsoft Office está instalada e se as caixas de diálogo de abertura foram canceladas para todos os aplicativos.

  • Verifique se um usuário PDF Generator foi adicionado na interface de configuração de PDF.

  • Verifique se o usuário PDF Generator é membro do grupo de administradores e se o privilégio Substituir um token de nível de processo está definido para o usuário.

  • Verifique se o usuário está configurado na interface do usuário do PDF Generator e execute as seguintes ações:

    1. Efetue login no Microsoft® Windows com o usuário PDF Generator.
    2. Abra os aplicativos do Microsoft® Office ou OpenOffice e cancele todas as caixas de diálogo.
    3. Defina Adobe PDF como impressora padrão.
    4. Defina Acrobat como programa padrão para arquivos PDF.
    5. Execute a conversão manual usando as opções Arquivo > Imprimir e faixa de opções do Acrobat nos aplicativos do Microsoft Office e cancele todas as caixas de diálogo.
    6. Encerre todos os processos relacionados à conversão, como winword.exe, powerpoint.exe e excel.exe.
    7. Reinicie o servidor do AEM Forms.

Linux®

  • Instale a versão com suporte do OpenOffice. O AEM Forms é compatível com versões de 32 e 64 bits. Após a instalação, abra todos os aplicativos OpenOffice, cancele todas as janelas de diálogo e feche os aplicativos. Reabra os aplicativos e verifique se nenhuma caixa de diálogo é exibida ao abrir um aplicativo OpenOffice.

  • Crie uma variável de ambiente OpenOffice_PATH e defina-a para apontá-la para que a instalação do OpenOffice seja definida no console ou no perfil dt (Árvore de Dispositivo).

  • Se houver problemas na instalação do OpenOffice, verifique se as bibliotecas de 32 bits necessárias para a instalação do OpenOffice estão disponíveis.

problemas de conversão de HTML para PDF
  • Verifique se os diretórios de fontes foram adicionados na interface de configuração do PDF Generator.

Linux e Solaris (rota de conversão WebToPDF)

  • Verifique se a biblioteca de 32 bits está disponível (libicudata.so.42) para conversão de HTMLToPDF baseada em Webkit e se as bibliotecas de 64 bits (libicudata.so.42 libs estão disponíveis para conversão de HTMLToPDF baseada em WebToPDF.

  • Execute o seguinte comando para listar as bibliotecas ausentes para WebToPDF:

    code language-none
    ldd phantomjs | grep not
    

Linux® e Solaris™ (rota de conversão do WebKit)

  • Verifique se os diretórios /usr/lib/X11/fonts e /usr/share/fonts existem. Se os diretórios não existirem, crie um link simbólico de /usr/share/X11/fonts a /usr/lib/X11/fonts e outro link simbólico de /usr/share/fonts a /usr/share/X11/fonts.

    code language-none
    ln -s /usr/share/fonts /usr/share/X11/fonts
    
    ln -s /usr/share/X11/fonts /usr/lib/X11/fonts
    
  • Verifique se as fontes do IBM são copiadas em usr/share/fonts.

  • Verifique se a correção de vulnerabilidade de fantasma glibc está disponível na máquina. Use seu gerenciador de pacotes padrão para atualizar para a versão mais recente do glibc. Ele inclui a correção de vulnerabilidade de fantasma.

  • Verifique se as versões mais recentes das bibliotecas lib curl, libcrypto e libssl de 32 bits estão instaladas no sistema. Crie também symlinks /usr/lib/libcurl.so (ou libcurl.a para AIX®), /usr/lib/libcrypto.so (ou libcrypto.a para AIX®) e /usr/lib/libssl.so (ou libssl.a para AIX®) apontando para as versões mais recentes (32 bits) das respectivas bibliotecas.

  • Execute as seguintes etapas para o Provedor de soquete IBM® SSL:

    1. Copie o arquivo java.security de <WAS_Installed_JAVA>\jre\lib\security para qualquer local no AEM Forms Server. O local padrão é Local Padrão = <WAS_Installed>\Appserver\java_[version]\jre\lib\security.

    2. Edite o arquivo java.security no local copiado e altere as fábricas padrão do SSL Socket com fábricas JSSE2 (use fábricas JSSE2 em vez do WebSphere®).

      Altere as seguintes fábricas de soquetes JSSE padrão:

      code language-none
      #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
      

      com

      code language-none
      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
      
Não é possível adicionar um usuário de PDF Generator (PDFG)
  • Verifique se o Microsoft® Visual C++ 2012 x86 e o Microsoft® Visual C++ 2013 x86 (32 bits) redistribuíveis estão instalados no Windows.
Falhas no teste de automação
  • Para o Microsoft® Office e OpenOffice, execute pelo menos uma conversão manualmente (como cada usuário) para garantir que nenhuma caixa de diálogo seja exibida durante a conversão. Se alguma caixa de diálogo for exibida, a descartará. Nenhuma caixa de diálogo deve aparecer durante a conversão automática.

  • Antes de executar a automação em um ambiente AEM Forms no OSGi, verifique se o pacote de teste está instalado e ativo.

Várias falhas de conversão de usuário
  • Verifique os logs do servidor para verificar se a conversão está falhando para um usuário específico.(O Process Explorer pode ajudar você a verificar o processo em execução para usuários diferentes)

  • Verifique se o usuário configurado para o PDF Generator tem direitos de administrador local.

  • Verifique se o usuário do PDF Generator tem permissões de leitura, gravação e execução em usuários temporários de LC e PDFG.

  • Para o Microsoft® Office e OpenOffice, execute pelo menos uma conversão manualmente (como cada usuário) para garantir que nenhuma caixa de diálogo seja exibida durante a conversão. Se alguma caixa de diálogo for exibida, a descartará. Nenhuma caixa de diálogo deve aparecer durante a conversão automática.

  • Execute uma conversão de amostra.

Licença do Adobe Acrobat instalada no AEM Forms Server expira
  • Se você tiver uma licença existente do Adobe Acrobat e ela tiver expirado, Baixe a versão mais recente do Adobe Application Manager e migre seu número de série. Antes de migrar seu número de série.

    • Use os seguintes comandos para gerar o prov.xml e reserializar a instalação existente usando o arquivo prov.xml em vez dos comandos fornecidos no artigo migrando o número de série.

      code language-none
      &quot;
      
      adobe_prtk —tool=VolumeSerialize —generate —serial=&lt;serialnum> [—leid=&lt;LEID>] [—regsuppress=ss] [—eulasuppress] [—locales=lista limitada de localidades no formato xx_XX ou ALL>] [—provfile=&lt;Caminho absoluto para prov.xml>]
      
      &quot;
      
    • Serialização de volume do pacote (serialize novamente a instalação existente usando o arquivo prov.xml e o novo serial): execute o seguinte comando da pasta de instalação do PRTK como administrador para serializar e ativar os pacotes implantados nas máquinas clientes:

      code language-none
      &quot;
      adobe_prtk —tool=VolumeSerialize —provfile=C:\prov.xml -stream
      
      &quot;
      
  • Para instalações em larga escala, use o Customization Wizard do Acrobat para remover versões anteriores do Reader e do Acrobat. Personalize o instalador e implante-o em todos os computadores de sua organização.

O AEM Forms Server está em um ambiente offline ou seguro e a Internet não está disponível para ativar o Acrobat.
  • Você pode entrar on-line dentro de 7 dias a partir do primeiro lançamento do seu produto Adobe para concluir uma ativação e um registro on-line ou usar um dispositivo habilitado para a Internet e o número de série do seu produto para concluir esse processo. Para obter instruções detalhadas, consulte Ativação offline.
Não é possível converter arquivo do Word ou Excel em PDF no Windows Server

Quando o usuário tenta converter arquivos do Word ou Excel em PDF no Microsoft Windows Server, o seguinte erro é encontrado como:

Mensagem de erro do conversor primário:
ALC-PDG-015-003-O sistema não pode abrir o arquivo de entrada. Envie seu arquivo novamente ou contate o administrador do sistema.

Para resolver o problema, consulte Não é possível converter o arquivo do Word ou Excel em PDF no Windows Server.

Não é possível converter arquivos do Excel em PDF no Windows Server 2019

Ao converter o Microsoft Excel 2019 para PDF no Microsoft Windows Server 2019, você deve garantir o seguinte:

  • Ao usar o serviço PDF Generator, o computador com Windows não deve ter nenhuma conexão remota ativa com o servidor AEM (sessão RDP do Windows).

  • A impressora padrão deve ser definida como Adobe PDF.

    note note
    NOTE
    • Para o Apple macOS e o Ubuntu OS, não é necessário definir as configurações acima.
Não é possível converter arquivos XPS em PDF
Para resolver o problema, crie uma chave do Registro específica para o recurso no Windows.

Próximas etapas next-steps

Você tem um ambiente de serviços de documento da AEM Forms em funcionamento. Você pode usar serviços de documento por meio de:

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2