A AEM Forms fornece um conjunto de serviços OSGi para realizar operações de nível de documento diferentes, por exemplo, serviços para criar, montar, distribuir e arquivar documentos PDF, adicionar assinaturas digitais para limitar o acesso a documentos e decodificar formulários com códigos 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 documento. A lista de serviços de documento disponíveis e seus principais recursos é a seguinte:
Serviço 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 em PDF/A padrão, 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 Assembler Service.
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 Serviço ConvertPDF.
Serviço Forms com códigos 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 de garantia de documentos contém três serviços: assinatura, criptografia e extensão do leitor. Para obter mais informações, consulte Serviço de Garantia de Doc.
Serviço de criptografia: permite criptografar e descriptografar documentos. Quando um documento é criptografado, seu conteúdo se torna ilegível. Um usuário autorizado pode descriptografar o documento para obter acesso a seu conteúdo. Para obter mais informações, consulte Encryption Service.
Serviço Forms: permite criar aplicativos clientes interativos de captura de dados que validam, processam, transformam e entregam formulários normalmente criados no Forms Designer. O serviço Forms renderiza qualquer design de formulário desenvolvido para 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 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 gerador de PDF: o serviço Gerador de PDF fornece APIs para converter formatos de arquivo nativos em PDF. Também converte PDF em outros formatos de arquivo e otimiza o tamanho dos documentos PDF. Para obter mais informações, consulte Serviço de Gerador de PDF.
Serviço de extensão do 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 Reader Extension Service.
Serviço de assinatura: permite trabalhar com assinaturas e documentos digitais no servidor de AEM. Por exemplo, o serviço de assinatura é normalmente usado nas seguintes situações:
O serviço de assinatura acessa certificados e credenciais armazenadas no armazenamento de confiança. Para obter mais informações, consulte Serviço de assinatura.
A AEM Forms é uma plataforma corporativa poderosa e os serviços de documento são apenas um dos recursos da AEM Forms. Para obter a lista completa de recursos, consulte Introdução ao AEM Forms.
O pacote do complemento AEM Forms é um aplicativo implantado em AEM. Geralmente, é necessário apenas uma instância AEM (autor ou publicação) para executar os serviços de documento da AEM Forms. A topologia a seguir é recomendada para executar os serviços de documento da AEM Forms. Para obter informações detalhadas sobre topologias, consulte Topologias de arquitetura e implantação para AEM Forms.
Embora o AEM Forms permita configurar e executar todas as funcionalidades de um único servidor, você deve fazer o planejamento da 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 Gerador de PDF 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 Gerador de PDF e recursos de formulários adaptáveis. Ele ajuda a fornecer desempenho ideal e dimensionar os servidores independentemente uns dos outros.
Antes de começar a instalar e configurar os serviços de documento da AEM Forms, verifique se:
A infraestrutura de hardware e software está em vigor. Para obter uma lista detalhada de hardware e software suportados, consulte requisitos técnicos.
O caminho de instalação da instância de AEM não contém espaços em branco.
Uma instância de AEM está em execução. Na terminologia AEM, uma "instância" é uma cópia do AEM em execução em um servidor no modo de criação ou publicação. Geralmente, é necessário apenas uma instância AEM (autor ou publicação) para executar os serviços de documento da AEM Forms:
Os requisitos de memória são cumpridos. O pacote do complemento AEM Forms requer:
O software cliente necessário para que o gerador de PDF execute a conversão no Microsoft Windows e Linux está instalado:
Se você estiver usando o sistema operacional baseado em UNIX, instale os seguintes pacotes da mídia de instalação do respectivo sistema operacional:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(Somente Gerador de PDF) Instale a versão de 32 bits das bibliotecas libcurl, libcrypto e libssl e crie os links simbólicos abaixo. Os links simbólicos apontam para a versão mais recente das respectivas bibliotecas:
(Somente PDF Generator) O serviço PDF Generator oferece suporte às rotas WebKit e PhantomJS para converter arquivos HTML em documentos PDF. Para habilitar a conversão para a rota PhantomJS, instale as bibliotecas de 64 bits listadas abaixo. Geralmente, essas bibliotecas já estão instaladas. Se alguma biblioteca estiver ausente, instale-a manualmente:
As configurações listadas na seção de configurações de pré-instalação são aplicáveis somente ao serviço Gerador de PDF. Se você não estiver configurando o serviço PDF Generator, ignore a seção de configuração de pré-instalação.
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, certifique-se de que esses aplicativos estejam instalados no servidor AEM Forms.
Depois de instalar o Acrobat, abra o Microsoft Word. Na guia Acrobat, clique em Criar PDF e converta um arquivo .doc ou .docx disponível em sua máquina em um Documento PDF. Se a conversão for bem-sucedida, o AEM Forms estará pronto para usar o Acrobat com o serviço Gerador de PDF.
Defina variáveis de ambiente para o Java Development Kit de 32 e 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 |
JDK (32 bits) |
JAVA_HOME_32 |
C:\Program Files (x86)\Java\jdk1.8.0_74 |
Adobe Acrobat |
Acrobat_PATH |
C:\Program Files (x86)\Adobe\Acrobat 2015\Acrobat\Acrobat.exe |
Bloco de notas |
Notepad_PATH |
C:\WINDOWS\notepad.exe |
OpenOffice |
OpenOffice_PATH |
C:\Program Files (x86)\OpenOffice.org4 |
export OpenOffice_PATH=/opt/openoffice.org4
Execute as seguintes etapas para configurar o provedor de soquete SSL da IBM:
Crie uma cópia do arquivo java.security. O local padrão do arquivo é [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security
.
Abra o arquivo java.security copiado para edição.
Altere as fábricas de soquete SSL padrão para usar as fábricas JSSE2 em vez das fábricas padrão IBM WebSphere:
Conteúdo padrão:
#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:
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
Para permitir que o servidor do AEM Forms use o arquivo java.security atualizado, enquanto inicia o servidor do AEM Forms, adicione o seguinte argumento java:
-Djava.security.properties= [path of newly created Java.security file].
Se você estiver executando o Microsoft Windows Server, configure o serviço de Tinta e Manuscrito. O serviço é necessário para abrir arquivos do Microsoft PowerPoint que usam recursos de vinculação do Microsoft Office:
Altere as configurações do centro de confiança do Microsoft Office para habilitar o serviço Gerador de PDF para converter arquivos criados com versões mais antigas do Microsoft Office.
Abra um aplicativo do Microsoft Office. Por exemplo, Microsoft Word. Navegue até Arquivo> Opções. A caixa de diálogo opções é exibida.
Clique em Central de Confiança e clique em Definições da Central de Confiança.
Nas Definições da Central de Confiança, clique em Definições de Bloqueio de Ficheiros.
Na lista Tipo de Arquivo, desmarque Abrir para o tipo de arquivo que o serviço Gerador de PDF deve ter permissão para converter em documentos PDF.
A conta de usuário usada para iniciar o servidor de aplicativos requer o privilégio Substituir um token de nível de processo. A conta de sistema local tem o privilégio Substituir um token de nível de processo por padrão. Para os servidores em execução com um usuário do grupo Administradores locais, o privilégio deve ser concedido explicitamente. Execute as seguintes etapas para conceder o privilégio:
Você pode ativar um usuário não administrador para usar o serviço Gerador de PDF. Normalmente, somente os usuários com privilégios administrativos podem usar o serviço:
Para acessar o Utilitário de configuração do sistema, vá para Iniciar > Executar e digite MSCONFIG.
Clique na guia Ferramentas e role para baixo e selecione Alterar configurações do UAC. Clique em Launch para executar o comando em uma nova janela.
Ajuste o controle deslizante para o nível Nunca notificar . Quando terminar, feche a janela de comando e feche a janela Configuração do sistema.
Verifique se a configuração do Registro para UAC está definida como 0 (zero). Execute as seguintes etapas para verificar:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\
. Verifique se o valor de EnableLUA está definido como 0 (zero).Reinicie o computador.
Ao converter um documento em PDF usando o serviço Gerador de PDF no Windows Server, ocasionalmente, o Windows Server relata que o executável encontrou um problema e precisa fechar. No entanto, isso não afeta a conversão do PDF, pois continua em segundo plano.
Para evitar receber o 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.
O serviço Gerador de PDF fornece rotas ou métodos WebKit, WebCapture e PhantomJS para converter arquivos HTML em documentos PDF. No Windows, para ativar a conversão para rotas WebKit e Acrobat WebCapture, copie a fonte Unicode para o diretório %windir%\fonts.
Sempre que instalar novas fontes na pasta de fontes, reinicie a instância do AEM Forms.
Em plataformas baseadas em UNIX, o serviço Gerador de PDF oferece suporte às rotas WebKit e PhantomJS para converter arquivos HTML em documentos PDF. Para permitir a conversão de HTML em PDF, execute as seguintes configurações, aplicáveis à rota de conversão preferencial:
Copie a fonte Unicode em qualquer um dos seguintes diretórios, conforme apropriado para seu sistema:
O pacote do complemento AEM Forms é um aplicativo implantado em AEM. O pacote contém os Serviços de documento da AEM Forms e outros recursos da AEM Forms. Execute as seguintes etapas para instalar o pacote:
Abra a Distribuição de softwares. Você precisa de uma Adobe ID para fazer logon na Distribuição de softwares.
Clique em Adobe Experience Manager disponível no menu de cabeçalho.
Na seção Filtros:
Toque no nome do pacote aplicável ao seu sistema operacional, selecione Aceitar Termos do EULA e toque em Download.
Abra Gerenciador de pacotes e clique em Fazer upload de pacote para fazer upload do pacote.
Selecione o pacote e clique em Instalar.
Você também pode baixar o pacote por meio do link direto listado no artigo AEM Forms releases.
Depois que o pacote for instalado, você será solicitado a reiniciar a instância do AEM. Não pare imediatamente o servidor. Antes de parar o servidor do AEM Forms, 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 seja estável.
Pare a instância de AEM. Navegue até [AEM diretório de instalação]\crx-quickstart\conf\ folder. 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\
.
Adicione as seguintes propriedades ao arquivo sling.properties :
sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
(Somente para AIX) Adicione as seguintes propriedades ao arquivo sling.properties :
sling.bootdelegation.xerces=org.apache.xerces.*
Salve e feche o arquivo.
Faça logon em AEM Configuration Manager como administrador.
Localize e abra o serviço CQ-DAM-Handler-Gibson Font Managers. Especifique o caminho dos diretórios Fontes do sistema, Fontes do servidor do Adobe e Fontes do cliente. Clique em Salvar.
O seu direito de usar fontes fornecidas por outras partes que não o Adobe é regido pelos contratos de licença fornecidos por essas partes com essas fontes, e não é coberto pela licença de uso de software Adobe. O Adobe recomenda que você verifique e garanta que está 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 de fontes, reinicie a instância do AEM Forms.
Uma conta de usuário local é necessária para executar o serviço Gerador de PDF. Para obter 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.
Abra a página Configuração do gerador de PDF do AEM Forms .
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 acesso ao usuário. Quando adicionado com êxito, o usuário configurado é exibido na seção Suas contas de usuário na guia Contas de usuário.
Em AEM gerenciador de configuração, localize e abra o serviço Provedor Jacorb ORB.
Adicione o seguinte ao campo Custom Properties.name e clique em Save. 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
Faça logon na instância do autor do AEM e navegue até Adobe Experience Manager > Ferramentas > Forms > Configurar Gerador de PDF. O 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 o seu ambiente:
Texto | Descrição | Valor padrão |
Tempo limite da conversão do servidor | Uma conversão de PDFG permanece ativa pelo número de segundos definido 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 Gerador de PDF tem permissão para executar uma conversão. Verifique se o valor de Segundos da Expiração do Trabalho é maior que o valor de Segundos da Verificação de Limpeza de PDFG. | 7200 segundos |
No Microsoft Windows, o serviço PDF Generator usa o Adobe Acrobat para converter formatos de arquivo compatíveis em um documento PDF. Execute as seguintes etapas para configurar o Adobe Acrobat para o serviço Gerador de PDF:
Abra o Acrobat e selecione Editar> Preferências> Atualizador. Em Verificar se há atualizações, desmarque Instalar automaticamente atualizações e clique em OK. Feche o Acrobat.
Clique duas vezes em um documento PDF no seu sistema. Quando o Acrobat é iniciado pela primeira vez, as caixas de diálogo para Início de sessão, Tela de boas-vindas e EULA são exibidas. Ignore essas caixas de diálogo para todos os usuários configurados para usar o Gerador de PDF.
Execute o arquivo em lote do utilitário Gerador de PDF para configurar o Acrobat para o serviço Gerador de PDF:
Abra AEM Gerenciador de Pacotes e baixe o arquivo adobe-aemfd-pdfg-common-pkg-[version].zip
do gerenciador de pacotes.
Descompacte o arquivo .zip baixado. Abra o prompt de comando com privilégios administrativos.
Navegue até o diretório [extracted-zip-file]\jcr_root\etc\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\scripts
. Execute o seguinte arquivo em lote:
Acrobat_for_PDFG_Configuration.bat
O Acrobat está configurado para ser executado com o serviço Gerador de PDF.
Execute a ferramenta System Readiness (SRT) para validar a instalação do Acrobat. A ferramenta verifica se o computador está configurado corretamente para executar conversões do Gerador de PDF e gera um relatório no caminho especificado:
Abra o prompt de comando. Navegue até a pasta [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\etc\fd\ pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\srt
. Execute o seguinte comando no prompt de comando:
cscript SystemReadinessTool.vbs [Path_of_reports_folder] en
Se a Ferramenta de disponibilidade 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]\plugins\x86_win32
para o diretório [Acrobat_root]\Acrobat\plug_ins
.
Vá até [Path_of_reports_folder]
. Abra o arquivo SystemReadinessTool.html . Verifique o relatório e corrija os problemas mencionados.
O serviço PDF Generator fornece várias rotas para converter arquivos HTML em documentos PDF: Webkit, Acrobat WebCapture (somente Windows) e PhantomJS. O Adobe recomenda o uso da rota PhantomJS porque ela tem a capacidade de lidar com conteúdo dinâmico e não tem dependências em bibliotecas de 32 bits, JDK de 32 bits ou não requer fontes extras. Além disso, a rota PhantomJS não requer acesso sudo ou raiz para executar a conversão.
A rota primária padrão para conversão de HTML em PDF é o Webkit. Para alterar a rota de conversão:
Na instância AEM autor, navegue até Ferramentas> Forms> Configurar Gerador de PDF.
Na guia General Configuration, selecione a rota de conversão preferencial no menu suspenso Primary Route for HTML to PDF conversions.
Usando o Gerenciamento de armazenamento de confiança, você pode importar, editar e excluir certificados confiáveis no servidor para a validação de assinaturas digitais e autenticação de certificado. É possível importar e exportar qualquer número de certificados. Depois que um certificado é importado, você pode 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:
O serviço DocAssurance pode aplicar direitos de uso a documentos PDF. Para aplicar direitos de uso a documentos PDF, configure os certificados.
Antes de configurar os certificados, verifique se você tem um:
Arquivo de certificado (.pfx).
Senha da chave privada fornecida com o certificado.
Alias da chave de privacidade. Você pode executar o comando keytool do Java para exibir o Alias da chave privada:
keytool -list -v -keystore [keystore-file] -storetype pkcs12
Senha do arquivo de armazenamento de chaves. Se você estiver usando o certificado de extensões do Reader, a senha do arquivo de armazenamento de chaves será sempre a mesma da senha da chave privada.
Execute as seguintes etapas para configurar os certificados:
Faça logon na instância do AEM Author como administrador. Vá para Ferramentas > Segurança > Usuários.
Clique no campo name 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 Create KeyStore e defina uma nova senha para o KeyStore. Se o servidor já tiver um KeyStore, pule esta etapa. Se você estiver usando o certificado de extensões do Reader, a senha do arquivo de armazenamento de chaves será sempre a mesma da senha da chave privada.
Na página Editar configurações do 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 .
Para fazer upload do arquivo de certificado, clique em Selecionar arquivo de armazenamento de chaves e faça upload de um arquivo <filename>.pfx.
Adicione a Senha do Armazenamento de Chaves, Senha da Chave Privada e Alias da Chave Privada que estão associadas ao certificado aos respectivos campos. Clique em Enviar.
No ambiente de produção, substitua suas credenciais de avaliação por credenciais de produção. Certifique-se de excluir suas credenciais antigas das extensões do Reader antes de atualizar uma credencial expirada ou de avaliações.
Clique em Salvar e fechar na página Editar configurações do usuário.
Para usar a criptografia AES 256 para arquivos PDF, obtenha e instale os arquivos da Política de jurisdição de força ilimitada da Extensão de criptografia Java (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 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 funcionando:
https://'[server]:[port]'/system/console/bundles
como administrador.Nome do serviço | Nome do pacote |
---|---|
Serviço de assinaturas | adobe-aemfd-assinaturas |
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 |
A conversão de HTML em PDF falhará se um arquivo de entrada compactado contiver arquivos HTML com caracteres de byte duplo 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 encontrar as bibliotecas ausentes:
Vá até [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/
.
Execute o seguinte comando para listar todas as bibliotecas necessárias para o PhantomJS para conversão de HTML em PDF.
ldd phantomjs
Execute o seguinte comando para listar bibliotecas ausentes.
ldd phantomjs | grep not
Instale manualmente as bibliotecas ausentes.
Você tem um ambiente de serviços de documento da AEM Forms em funcionamento. Você pode usar serviços de documento por meio de: