DocumentaciónAEM 6.4Guía de Forms

Instalación y configuración de Document Services installing-and-configuring-document-services

Last update: Fri May 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Admin
CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

AEM Forms proporciona un conjunto de servicios de OSGi para realizar distintas operaciones a nivel de documento, por ejemplo, servicios para crear, ensamblar, distribuir y archivar documentos PDF, agregar firmas digitales para limitar el acceso a documentos y descodificar formularios codificados de barras. Estos servicios están incluidos en el paquete de complementos de AEM Forms. El conjunto de estos servicios se denomina Document Services. A continuación, encontrará una lista de los servicios de Document Services disponibles y sus principales capacidades:

  • Servicio Assembler: permite combinar, reorganizar y aumentar documentos PDF y XDP y obtener información sobre documentos PDF. También permite convertir documentos PDF al estándar PDF/A y validarlos, y transformar formularios PDF, formularios XML y formularios PDF a PDF/A-1b, PDF/A-2b y PDFA/A-3b. Para obtener más información, consulte Servicio Assembler.

  • Servicio ConvertPDF: permite convertir documentos PDF en archivos PostScript o archivos de imagen (JPEG, JPEG 2000, PNG y TIFF). Para obtener más información, consulte Servicio ConvertPDF.

  • Servicio de formularios con códigos de barras: permite extraer datos de imágenes electrónicas de códigos de barras. El servicio acepta archivos TIFF y PDF que incluyen uno o más códigos de barras como entrada y extrae los datos del código de barras. Para obtener más información, consulte Servicio de formularios con códigos de barras.

  • Servicio DocAssurance: permite cifrar y descifrar documentos, ampliar la funcionalidad de Adobe Reader con derechos de uso adicionales y agregar firmas digitales a los documentos. El servicio Doc Assurance contiene tres servicios: Signature, Encryption y Extensiones de Reader. Para obtener más información, consulte Servicio DocAssurance.

  • Servicio Encryption: permite cifrar y descifrar documentos. Cuando se cifra un documento, su contenido se vuelve ilegible. Un usuario autorizado puede descifrar el documento para obtener acceso a su contenido. Para obtener más información, consulte Servicio Encryption.

  • Servicio Forms: permite crear aplicaciones cliente de captura de datos interactivas que validen, procesan, transforman y entregan formularios que normalmente se crean en Forms Designer. El servicio Forms procesa cualquier diseño de formulario que hay desarrollado en documentos PDF. Para obtener más información, consulte Servicio de Forms.

  • Servicio Output: permite crear documentos en diferentes formatos, incluidos PDF, formatos de impresora láser y formatos de impresora de etiquetas. Los formatos de impresora láser son PostScript y Lenguaje de control de impresora (PCL). Para obtener más información, consulte Servicio Output.

  • Servicio PDF Generator: el servicio PDF Generator proporciona API para convertir formatos de archivo nativos a PDF. También convierte PDF a otros formatos de archivo y optimiza el tamaño de los documentos PDF. Para obtener más información, consulte Servicio PDF Generator.

  • Servicio Extensiones de Reader: permite a su organización compartir fácilmente documentos PDF interactivos mediante la ampliación de la funcionalidad de Adobe Reader con derechos de uso adicionales. El servicio activa funciones que no están disponibles cuando se abre un documento PDF con Adobe Reader, como agregar comentarios a un documento, rellenar formularios y guardar el documento. Para obtener más información, consulte Servicio Extensiones de Reader.

  • Servicio Signature: permite trabajar con firmas digitales y documentos en el servidor de AEM. Por ejemplo, el servicio Signature se suele utilizar en las siguientes situaciones:

    • El servidor de AEM certifica un formulario antes de enviarlo a un usuario para que lo abra con Acrobat o Adobe Reader.
    • El servidor de AEM valida una firma que se ha agregado a un formulario mediante Acrobat o Adobe Reader.
    • El servidor de AEM firma un formulario en nombre de un notario público.

    El servicio Signature accede a los certificados y credenciales almacenados en el almacén de confianza. Para obtener más información, consulte Servicio Signature.

AEM Forms es una potente plataforma de clase empresarial, y Document Services es solo una de sus capacidades. Para obtener la lista completa de capacidades, consulte Introducción a AEM Forms.

Topología de implementación deployment-topology

El paquete de complementos de AEM Forms es una aplicación implementada en AEM. Por lo general, solo se necesita una instancia de AEM (de autor o publicación) para ejecutar AEM Forms Document Services. Se recomienda la siguiente topología para ejecutar AEM Forms Document Services. Para obtener información detallada sobre topologías, consulte Arquitectura y topologías de implementación para AEM Forms.

Arquitectura y topologías de implementación para AEM Forms

NOTE
Aunque AEM Forms permite configurar y ejecutar todas las funcionalidades desde un solo servidor, debe planificar la capacidad y el equilibrio de carga y configurar servidores dedicados para las capacidades específicas en entornos de producción. Por ejemplo, en el caso de un entorno que utiliza el servicio PDF Generator para convertir miles de páginas al día y varios formularios adaptables para capturar datos, deberá configurar servidores de AEM Forms independientes para el servicio PDF Generator y las capacidades relacionadas con los formularios adaptables. Esto permite proporcionar un rendimiento óptimo y escalar los servidores de forma independiente entre sí.

Requisitos del sistema system-requirements

Antes de empezar a instalar y configurar AEM Forms Document Services, asegúrese de lo siguiente:

  • Se ha implementado la infraestructura de hardware y software. Para obtener una lista detallada del hardware y el software compatibles, consulte Requisitos técnicos.

  • La ruta de instalación de la instancia de AEM no contiene espacios en blanco.

  • Se está ejecutando una instancia de AEM. En la terminología de AEM, una "instancia" es una copia de AEM que se ejecuta en un servidor en el modo Autor o Publicación. Por lo general, solo necesita una instancia de AEM (Autor o Publicación) para ejecutar AEM Forms Document Services:

    • Autor: la instancia de AEM utilizada para crear, cargar y editar contenido y administrar el sitio web. Una vez que el contenido está listo para su publicación, se replica en la instancia de publicación.
    • Publicación: la instancia de AEM que sirve el contenido publicado al público a través de Internet o de una red interna.

  • Se cumplen los requisitos de memoria. El paquete de complementos de AEM Forms requiere:

    • 15 GB de espacio temporal para instalaciones basadas en Microsoft Windows.
    • 6 GB de espacio temporal para instalaciones basadas en UNIX.

  • El software cliente necesario para que el generador de PDF realice la conversión en Microsoft Windows y Linux está instalado:

NOTE
  • En Microsoft Windows, el Generador de PDF admite las rutas de conversión WebKit, Acrobat WebCapture y PhantomJS para convertir archivos HTML en documentos PDF.
  • En sistemas operativos basados en UNIX, PDF Generator admite las rutas de conversión WebKit y PhantomJS para convertir archivos HTML en documentos PDF.

Requisitos adicionales para sistemas operativos basados en UNIX extrarequirements

Si está utilizando un sistema operativo basado en UNIX, instale los siguientes paquetes de los medios de instalación del sistema operativo correspondiente:

  • expat
  • libxcb
  • freetype
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softokn-freebl
  • fontconfig
  • libX11
  • libXrender
  • libXrandr
  • libXinerama

  • (Solo PDF Generator) Instale la versión de 32 bits de las bibliotecas libcurl, libcrypto y libssl, y cree los siguientes enlaces simbólicos. Los enlaces simbólicos apuntan a la última versión de sus respectivas bibliotecas:

    • /usr/lib/libcurl.so
    • /usr/lib/libcrypto.so
    • /usr/lib/libssl.so

  • (Solo PDF Generator) El servicio PDF Generator admite rutas WebKit y PhantomJS para convertir archivos HTML en documentos PDF. Para habilitar la conversión para la ruta PhantomJS, instale las bibliotecas de 64 bits que se enumeran a continuación. Por lo general, estas bibliotecas ya están instaladas. Si falta alguna biblioteca, instálela 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

Configuraciones previas a la instalación preinstallationconfigurations

Las configuraciones que aparecen en la sección de configuraciones previas a la instalación solo se aplican al servicio PDF Generator. Si no está configurando el servicio PDF Generator, puede omitir la sección Configuración previa a la instalación.

Instalación de Adobe Acrobat y aplicaciones de terceros install-adobe-acrobat-and-third-party-applications

Si va a usar el servicio Generador de PDF para convertir formatos de archivo nativos como Microsoft Word, Microsoft Excel, Microsoft PowerPoint, OpenOffice, WordPerfect X7 y Adobe Acrobat a documentos PDF, asegúrese de que estas aplicaciones estén instaladas en el servidor AEM Forms.

NOTE
  • Adobe Acrobat, Microsoft Word, Excel y Powerpoint solo están disponibles para Microsoft Windows. Si está utilizando el sistema operativo basado en UNIX, instale OpenOffice para convertir archivos de texto enriquecido y archivos compatibles de Microsoft Office a documentos de PDF.
  • Descarte todos los cuadros de diálogo que se muestran después de instalar Adobe Acrobat y el software de terceros en todos los usuarios configurados para utilizar el servicio PDF Generator.
  • Inicie todo el software instalado al menos una vez. Descarte todos los cuadros de diálogo de todos los usuarios configurados para utilizar el servicio PDF Generator.

Después de instalar Acrobat, abra Microsoft Word. En la pestaña Acrobat, haga clic en Crear PDF y convierta un archivo .doc o .docx disponible en su equipo en un documento PDF. Si la conversión se realiza correctamente, AEM Forms está listo para usar Acrobat con el servicio PDF Generator.

Configuración de variables de entorno setup-environment-variables

Establezca variables de entorno para el kit de desarrollo de Java de 32 y 64 bits, las aplicaciones de terceros y Adobe Acrobat. Las variables de entorno deben contener la ruta absoluta del ejecutable utilizado para iniciar la aplicación correspondiente. Por ejemplo, la siguiente tabla siguiente muestra las variables de entorno de algunas aplicaciones:

Aplicación
Variable de entorno
Ejemplo
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
Bloc de notas
Notepad_PATH
C:\WINDOWS\notepad.exe
OpenOffice
OpenOffice_PATH
C:\Program Files (x86)\OpenOffice.org4
NOTE

  • Todas las variables de entorno y sus respectivas rutas distinguen entre mayúsculas y minúsculas.

  • JAVA_HOME, JAVA_HOME_32 y Acrobat_PATH (solo Windows) son variables de entorno obligatorias.

  • La variable de entorno OpenOffice_PATH se establece en la carpeta de instalación en lugar de en la ruta del ejecutable.

  • No configure variables de entorno para aplicaciones de Microsoft Office como Word, PowerPoint, Excel y Project, o para AutoCAD. Si estas aplicaciones están instaladas en el servidor, el servicio Generate PDF las inicia automáticamente.

  • En plataformas basadas en UNIX, instale OpenOffice como /root. Si OpenOffice no está instalado como raíz, el servicio PDF Generator no convierte los documentos de OpenOffice en documentos PDF. Si necesita instalar y ejecutar OpenOffice como un usuario no raíz, proporcione derechos sudo al usuario no raíz.

  • Si está utilizando OpenOffice en una plataforma basada en UNIX, ejecute el siguiente comando para configurar la variable de ruta:

    export OpenOffice_PATH=/opt/openoffice.org4

(Solo para IBM WebSphere) Configure el proveedor de sockets SSL de IBM only-for-ibm-websphere-configure-ibm-ssl-socket-provider

Realice los siguientes pasos para configurar el proveedor de sockets SSL de IBM:

  1. Cree una copia del archivo java.security. La ubicación predeterminada del archivo es [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security.

  2. Abra el archivo java.security copiado para editarlo.

  3. Cambie las fábricas de socket SSL predeterminadas para utilizar las fábricas JSSE2 en lugar de las fábricas predeterminadas de IBM WebSphere:

    Contenido predeterminado:

    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

    Contenido 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 el servidor de AEM Forms utilice el archivo java.security actualizado, al iniciar el servidor de AEM Forms, agregue el siguiente argumento java:

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

(Solo Windows) Configurar el servicio Instalar Escritura con lápiz y Escritura a mano configure-install-ink-and-handwriting-service

Si está ejecutando Microsoft Windows Server, configure el servicio de tinta y escritura a mano. El servicio es necesario para abrir archivos de Microsoft PowerPoint que utilicen funciones de vinculación de Microsoft Office:

  1. Abra el Administrador de servidores. Haga clic en el icono Administrador del servidor de la bandeja de inicio rápido.
  2. Haga clic en Agregar características en el menú Características. Seleccione la casilla de verificación Servicios de escritura a mano y tinta.
  3. Seleccione el cuadro de diálogo Características con la opción Servicios de Escritura con lápiz y Escritura a mano seleccionada. Haga clic en Instalar, y el servicio se instalará.

(Solo Windows) Configure las opciones del bloque de archivos para Microsoft Office configure-the-file-block-settings-for-microsoft-office

Cambie la configuración del centro de confianza de Microsoft Office para permitir que el servicio Generador de PDF convierta los archivos creados con versiones anteriores de Microsoft Office.

  1. Abra una aplicación de Microsoft Office. Por ejemplo, Microsoft Word. Vaya a Archivo > Opciones. Aparece el cuadro de diálogo opciones.

  2. Haga clic en Centro de confianza y, después, en Configuración del Centro de confianza.

  3. En el Configuración del Centro de confianza, haga clic en Configuración de bloqueo de archivos.

  4. En la lista Tipo de archivo, anule la selección de Abrir para el tipo de archivo que debe permitirse al servicio PDF Generator convertir archivos en documentos PDF.

(Solo Windows) Conceder el privilegio Reemplazar un símbolo (token) de nivel de proceso grant-the-replace-a-process-level-token-privilege

La cuenta de usuario utilizada para iniciar el servidor de aplicaciones requiere el privilegio Reemplazar un token de nivel de proceso. La cuenta del sistema local tiene el privilegio Reemplazar un token de nivel de proceso de forma predeterminada. En los servidores que se ejecutan con un usuario del grupo Administradores locales, el privilegio debe otorgarse explícitamente. Siga estos pasos para conceder el privilegio:

  1. Abra el Editor de directivas de grupo para Microsoft Windows. Para abrir el Editor de directivas de grupo, haga clic en Inicio, escriba gpedit.msc en el cuadro Iniciar búsqueda y haga clic en Editor de directivas de grupo.
  2. Vaya a Directiva de equipo local > Configuración del equipo > Configuración de Windows > Configuración de seguridad > Directivas locales > Asignación de derechos de usuario y edite la directiva Reemplazar un símbolo (token) de nivel de proceso e incluya el grupo Administradores.
  3. Agregue el usuario a la entrada Reemplazar un símbolo (token) de nivel de proceso.

(Solo Windows) Habilite el servicio PDF Generator para usuarios que no sean administradores enable-the-pdf-generator-service-for-non-administrators

Puede habilitar a un usuario que no sea administrador para que utilice el servicio PDF Generator. Normalmente, solo los usuarios con privilegios administrativos pueden utilizar el servicio:

  1. Cree una variable de entorno, PDFG_NON_ADMIN_ENABLED.
  2. Establezca el valor de la variable de entorno en TRUE.
  3. Reinicie la instancia de AEM Forms.

(Solo Windows) Deshabilitar el Control de cuentas de usuario (UAC) disable-user-account-control-uac

  1. Para acceder a la Utilidad de configuración del sistema, vaya a Inicio > Ejecutar y, a continuación, escriba MSCONFIG.

  2. Haga clic en la pestaña Herramientas, desplácese hacia abajo y seleccione Cambiar configuración de UAC. Haga clic en Iniciar para ejecutar el comando en una nueva ventana.

  3. Ajuste el control deslizante al nivel No notificar nunca. Cuando termine, cierre la ventana de comandos y la de Configuración del sistema.

  4. Compruebe que la configuración del registro para UAC está establecida en 0 (cero). Siga estos pasos para comprobarlo:

    1. Microsoft recomienda realizar una copia de seguridad del registro antes de modificarlo. Para ver los pasos detallados, consulte Realizar una copia de seguridad y restaurar el registro en Windows.
    2. Abra el editor del Registro de Windows de Microsoft. Para abrir el editor del registro, vaya a Inicio > Ejecutar, escriba regedit y haga clic en Aceptar.
    3. Navegue hasta HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\. Asegúrese de que el valor de EnableLUA está establecido en 0 (cero).
    4. Asegúrese de que el valor de EnableLUA esté establecido en 0 (cero). Si el valor no es 0, cambie el valor a 0. Cierre el editor del registro.

  5. Reinicie el equipo.

(Solo Windows) Deshabilitar el servicio Informes de errores disable-error-reporting-service

Al convertir un documento a PDF mediante el servicio Generador de PDF en Windows Server, ocasionalmente Windows Server informa de que el archivo ejecutable ha encontrado un problema y debe cerrarse. Sin embargo, esto no afecta a la conversión a PDF, ya que continúa en segundo plano.

Para evitar recibir el error, puede deshabilitar los informes de errores de Windows. Para obtener más información sobre cómo deshabilitar los informes de errores, consulte https://technet.microsoft.com/es-es/library/cc754364.aspx.

(Solo Windows) Configurar la conversión de HTML a PDF configure-html-to-pdf-conversion

El servicio PDF Generator proporciona rutas o métodos WebKit, WebCapture y PhantomJS para convertir archivos HTML en documentos PDF. Para habilitar la conversión mediante las rutas WebKit y Acrobat WebCapture en Windows, copie la fuente Unicode al directorio %windir%\fonts.

NOTE
Reinicie la instancia de AEM Forms siempre que instale fuentes nuevas en la carpeta de fuentes.

(Solo plataformas basadas en UNIX) Configuraciones adicionales para la conversión de HTML a PDF extra-configurations-for-html-to-pdf-conversion

En plataformas basadas en UNIX, el servicio PDF Generator admite las rutas WebKit y PhantomJS para convertir archivos HTML en documentos PDF. Para habilitar la conversión de HTML a PDF, realice las siguientes configuraciones, según la ruta de conversión que prefiera:

(Solo plataformas basadas en UNIX) Habilitar la compatibilidad con fuentes Unicode (solo WebKit) enable-support-for-unicode-fonts-webkit-only

Copie la fuente Unicode en cualquiera de los siguientes directorios según corresponda para su 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
  • En RedHat Enterprise Linux 6.x y versiones posteriores, las fuentes de mensajería no están disponibles. Para instalar las fuentes Courier, descargue el archivo font-ibm-type1-1.0.3.zip. Extraiga el archivo en /usr/share/fonts. Cree un enlace simbólico desde /usr/share/X11/fonts a /usr/share/fonts.
  • Elimine todos los archivos de caché de fuentes .lst de los directorios Html2PdfSvc/bin y /usr/share/fonts.
  • Asegúrese de que los directorios /usr/lib/X11/fonts y /usr/share/fonts existan. Si los directorios no existen, utilice el comando ln para crear un enlace simbólico de /usr/share/X11/fonts a /usr/lib/X11/fonts y otro enlace simbólico de /usr/share/fonts a /usr/share/X11/fonts. Asegúrese también de que las fuentes Courier están disponibles en /usr/lib/X11/fonts.
  • Asegúrese de que todas las fuentes (Unicode y no Unicode) estén disponibles en los directorios /usr/share/fonts o /usr/share/X11/fonts.
  • Cuando ejecute el servicio PDF Generator como usuario no raíz, proporcione a ese usuario acceso de lectura y escritura a todos los directorios de fuentes.
  • Reinicie la instancia de AEM Forms siempre que instale fuentes nuevas en la carpeta de fuentes.

Instalación del paquete de complementos de AEM Forms install-aem-forms-add-on-package

El paquete de complementos de AEM Forms es una aplicación implementada en AEM. El paquete contiene AEM Forms Document Services y otras capacidades de AEM Forms. Realice los siguientes pasos para instalar el paquete:

  1. Abra Distribución de software. Necesitará un Adobe ID para iniciar sesión en la distribución de software.

  2. Pulse Adobe Experience Manager, disponible en el menú del encabezado.

  3. En la sección Filtros:

    1. Seleccione Forms en la lista desplegable Solución.
    2. Seleccione la versión y el tipo del paquete. También puede usar la opción Buscar descargas para filtrar los resultados.

  4. Pulse el nombre del paquete aplicable a su sistema operativo, seleccione Aceptar términos de EULA y pulse Descargar.

  5. Abra el Administrador de paquetes y haga clic en Cargar paquete para cargar el paquete.

  6. Seleccione el paquete y haga clic en Instalar.

    También puede descargar el paquete a través del vínculo directo que aparece en el artículo Versiones de AEM Forms.

  7. Una vez instalado el paquete, se le pedirá que reinicie la instancia de AEM. No detenga el servidor inmediatamente. Antes de detener el servidor de AEM Forms, espere hasta que los mensajes ServiceEvent REGISTER y ServiceEvent UNREGISTER dejen de aparecer en la variable [AEM-Installation-Directory]/crx-quickstart/logs/error.log y el registro es estable.

Configuraciones posteriores a la instalación post-installation-configurations

Configuración de la delegación de arranque para bibliotecas RSA/BouncyCastle configure-boot-delegation-for-rsa-bouncycastle-libraries

  1. Detenga la instancia de AEM. Vaya al [directorio de instalación de AEM]\crx-quickstart\conf\ folder. Abra el archivo sling.properties para editarlo.

    Si usa [AEM installation directory]\crx-quickstart\bin\start.bat para iniciar una instancia de AEM, edite el archivo sling.properties ubicado en [AEM_root]\crx-quickstart\.

  2. Agregue las siguientes propiedades al archivo sling.properties:

    code language-none 
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*

  3. (Solo AIX) Agregue las siguientes propiedades al archivo sling.properties :

    code language-none 
    sling.bootdelegation.xerces=org.apache.xerces.*

  4. Guarde y cierre el archivo.

Configuración del servicio Administrador de fuentes configuring-the-font-manager-service

  1. Iniciar sesión en el Administrador de configuración de AEM como administrador.

  2. Busque y abra el servicio CQ-DAM-Handler-Gibson Font Managers. Especifique la ruta de los directorios de las fuentes del sistema, las fuentes del servidor de Adobe y las fuentes de cliente. Haga clic en Guardar.

    note note
    NOTE
    Su derecho a utilizar fuentes de terceros distintos de Adobe se rige por los acuerdos de licencia que estos terceros le proporcionen junto con las fuentes, y no está cubierto por la licencia para utilizar el software de Adobe. Adobe recomienda revisar y asegurarse de que cumple todos los acuerdos de licencia aplicables que no sean de Adobe antes de utilizar fuentes que no sean de Adobe con software de Adobe, especialmente con respecto al uso de fuentes en un entorno de servidor.
    Cuando instale nuevas fuentes en la carpeta de fuentes, reinicie la instancia de AEM Forms.

Configuración de una cuenta de usuario local para ejecutar el servicio PDF Generator configure-a-local-user-account-to-run-the-pdf-generator-service

Se necesita una cuenta de usuario local para ejecutar el servicio PDF Generator. Para ver los pasos para crear un usuario local, consulte Crear una cuenta de usuario en Windows o Crear una cuenta de usuario en plataformas basadas en UNIX.

  1. Abra la página Configuración de AEM Forms PDF Generator.

  2. En la pestaña Cuentas de usuario, proporcione las credenciales de una cuenta de usuario local y haga clic en Enviar. Si Microsoft Windows solicita, permita el acceso al usuario. Cuando se agrega correctamente, el usuario configurado se muestra en la sección Sus cuentas de usuario de la pestaña Cuentas de usuario.

Configuración del tiempo de espera configure-the-time-out-settings

  1. En el Administrador de configuración de AEM, busque y abra el servicio Jacorb ORB Provider.

    Agregue lo siguiente en el campo Custom Properties.name y haga clic en Guardar. Esto establece el tiempo de espera de respuesta pendiente (también conocido como tiempo de espera del cliente CORBA) en 600 segundos.

    jacorb.connection.client.pending_reply_timeout=600000

  2. Inicie sesión en la instancia de autor de AEM y vaya a Adobe Experience Manager > Herramientas > Forms > Configuración de PDF Generator. La dirección URL predeterminada es http://localhost:4502/libs/fd/pdfg/config/ui.html.

    Abra la Configuración general y modifique el valor de los siguientes campos para su entorno:

Campo
Descripción
Valor predeterminado
Tiempo de espera de conversión del servidor
Una conversión de PDF Generator permanece activa durante el número de segundos definido en el tiempo de espera de conversión del servidor
270 segundos
Segundos de análisis de limpieza de PDF Generator
El número de segundos necesarios para realizar las operaciones posteriores a la conversión.
3600 segundos
Segundos de caducidad del trabajo
La duración durante la cual el servicio PDF Generator puede ejecutar una conversión. Asegúrese de que el valor de Segundos de caducidad del trabajo sea mayor que el valor de Segundos del análisis de limpieza de PDF Generator.
7200 segundos

(Solo Windows) Configurar Acrobat para el servicio PDF Generator configure-acrobat-for-the-pdf-generator-service

En Microsoft Windows, el servicio Generador de PDF utiliza Adobe Acrobat para convertir los formatos de archivo admitidos a un documento PDF. Siga estos pasos para configurar Adobe Acrobat para el servicio PDF Generator:

  1. Abra Acrobat y seleccione Editar > Preferencias > Actualizador. En Buscar actualizaciones, anule la selección de Instalar actualizaciones automáticamente y haga clic en Aceptar. Cierre Acrobat.

  2. Haga doble clic en un documento PDF del sistema. Cuando Acrobat se inicia por primera vez, aparecen los cuadros de diálogo Iniciar sesión, Pantalla de bienvenida y EULA. Descarte estos cuadros de diálogo para todos los usuarios configurados para usar PDF Generator.

  3. Ejecute el archivo por lotes de la utilidad PDF Generator para configurar Acrobat para el servicio PDF Generator:

    1. Apertura Administrador de paquetes AEM y descargue el adobe-aemfd-pdfg-common-pkg-[version].zip del gestor de paquetes.

    2. Descomprima el archivo .zip descargado. Abra el Símbolo del sistema con privilegios administrativos.

    3. Navegue hasta el directorio [extracted-zip-file]\jcr_root\etc\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\scripts Ejecute el siguiente archivo por lotes:

      Acrobat_for_PDFG_Configuration.bat

      Acrobat está configurado para ejecutarse con el servicio PDF Generator.

  4. Ejecute la Herramienta de preparación del sistema (SRT) para validar la instalación de Acrobat. La herramienta comprueba si el equipo está configurado correctamente para ejecutar conversiones de Generador de PDF y genera un informe en la ruta especificada:

    1. Abra el Símbolo del sistema y navegue hasta la carpeta [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\etc\fd\ pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\srt. Ejecute el siguiente comando desde el Símbolo del sistema:

      cscript SystemReadinessTool.vbs [Path_of_reports_folder] en

      note note
      NOTE
      Si la herramienta de preparación del sistema informa de que el archivo pdfgen.api no está disponible en la carpeta de complementos de acrobat, copie el archivo pdfgen.api de la [extracted-adobe-aemfd-pdfg-common-pkg]\plugins\x86_win32 para [Acrobat_root]\Acrobat\plug_ins directorio.

    2. Navegue hasta [Path_of_reports_folder]. Abra el archivo SystemReadinessTool.html. Compruebe el informe y corrija los problemas mencionados.

(Solo Windows) Configure la ruta principal para la conversión de HTML a PDF configure-primary-route-for-html-to-pdf-conversion-windows-only

El servicio PDF Generator ofrece varias rutas para convertir archivos HTML en documentos PDF: Webkit, Acrobat WebCapture (solo Windows) y PhantomJS. Adobe recomienda utilizar la ruta PhantomJS porque tiene la capacidad de gestionar contenido dinámico, no depende de bibliotecas de 32 bits ni JDK de 32 bits, y no requiere fuentes adicionales. Además, la ruta PhantomJS no requiere acceso raíz o sudo para ejecutar la conversión.

La ruta principal predeterminada para la conversión de HTML a PDF es Webkit. Para cambiar la ruta de conversión:

  1. En la instancia de autor de AEM, vaya a Herramientas > Forms > Configuración de PDF Generator.

  2. En la pestaña Configuración general, seleccione la ruta de conversión preferida en la lista desplegable Ruta principal para conversiones de HTML a PDF.

Inicializar el Almacén de confianza global intialize-global-trust-store

Con la administración de almacén de confianza, puede importar, editar y eliminar certificados en los que confía en el servidor para validar firmas digitales y autenticación de certificados. Puede importar y exportar cualquier número de certificados. Una vez importado un certificado, puede editar la configuración de confianza y el tipo de almacén de confianza. Realice los siguientes pasos para inicializar un almacén de confianza:

  1. Inicie sesión en la instancia de AEM Forms como administrador.
  2. Vaya a Herramientas > Seguridad > Almacén de confianza.
  3. Haga clic en Crear almacén de confianza. Establezca una contraseña y pulse Guardar.

Configuración de certificados para los servicios Encryption y Extensiones de Reader set-up-certificates-for-reader-extension-and-encryption-service

El servicio DocAssurance puede aplicar derechos de uso a los documentos PDF. Para aplicar derechos de uso a documentos PDF, configure los certificados.

Antes de configurar los certificados, asegúrese de que dispone de lo siguiente:

  • El archivo del certificado (.pfx).

  • La contraseña de la clave privada proporcionada con el certificado.

  • El alias de la clave privada. Puede ejecutar el comando keytool de Java para ver el alias de la clave privada:
    keytool -list -v -keystore [keystore-file] -storetype pkcs12

  • La contraseña del archivo del almacén de claves. Si utiliza el certificado de Extensiones de Reader de Adobe, la contraseña del archivo del almacén de claves siempre es la misma que la contraseña de la clave privada.

Siga los siguientes pasos para configurar los certificados:

  1. Inicie sesión en la instancia de autor de AEM como administrador. Vaya a Herramientas > Seguridad > Usuarios.

  2. Haga clic en el campo Nombre de la cuenta de usuario. Se abrirá la página Editar configuración de usuario. En la instancia de autor de AEM, los certificados residen en un almacén de claves. Si no ha creado ningún almacén de claves anteriormente, haga clic en Crear almacén de claves y establezca una nueva contraseña para el almacén. Si el servidor ya contiene un almacén de claves, omita este paso. Si utiliza el certificado de Extensiones de Reader de Adobe, la contraseña del archivo del almacén de claves siempre es la misma que la contraseña de la clave privada.

  3. En la página Editar configuración de usuario, seleccione la pestaña Almacén de claves. Expanda la opción Añadir clave privada del archivo del almacén de claves y proporcione un alias. El alias se utiliza para realizar la operación de las Extensiones de Reader.

  4. Para cargar el archivo del certificado, haga clic en Seleccionar archivo de almacén de claves y cargue un archivo <filename>.pfx.

    Agregue la Contraseña del almacén de claves, la Contraseña de la clave privada y el Alias de la clave privada asociados con el certificado a los campos respectivos. Haga clic en Enviar.

    note note
    NOTE
    En el entorno de producción, sustituya las credenciales de evaluación por credenciales de producción. Asegúrese de eliminar las credenciales antiguas de las Extensiones de Reader antes de actualizar una credencial caducada o de evaluaciones.

  5. Haga clic en Guardar y cerrar en la página Editar configuración de usuario.

Habilitar AES-256 enable-aes

Para utilizar el cifrado AES 256 en archivos PDF, obtenga e instale los archivos de política de jurisdicción de fuerza ilimitada de la Extensión de criptografía de Java (JCE). Reemplace los archivos local_policy.jar y US_export_policy.jar en la carpeta jre/lib/security. Por ejemplo, si está utilizando el JDK de Sun, copie los archivos descargados en la carpeta [JAVA_HOME]/jre/lib/security.

El servicio Assembler depende del servicio Extensiones de Reader, del servicio Signature, del servicio Forms y del servicio Output. Realice los siguientes pasos para verificar que los servicios necesarios estén en funcionamiento:

  1. Inicie sesión en la URL https://'[server]:[port]'/system/console/bundles como administrador.
  2. Busque el siguiente servicio y asegúrese de que los servicios estén en funcionamiento:
Nombre del servicio
Nombre de paquete
Servicio de firmas
adobe-aemfd-signatures
Servicio Extensiones de Reader
com.adobe.aemfd.adobe-aemfd-readerextensions
Servicio de Forms
com.adobe.livecycle.adobe-lc-forms-bedrock-connector
Servicio de salida
com.adobe.livecycle.adobe-lc-forms-bedrock-connector

Problemas y limitaciones conocidos known-issues-and-troubleshooting

  • La conversión de HTML a PDF falla si un archivo de entrada comprimido contiene archivos HTML con caracteres de doble byte en los nombres de archivo. Para evitar este problema, no utilice caracteres de doble byte al nombrar los archivos HTML.

  • En sistemas operativos basados en UNIX, siga los siguientes pasos para encontrar las bibliotecas que faltan:

  1. Navegue hasta [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/.

  2. Ejecute el siguiente comando para ver una lista de todas las bibliotecas que PhantomJS requiere para la conversión de HTML a PDF.

    ldd phantomjs

    Ejecute el siguiente comando para ver una lista de las bibliotecas que faltan.

    ldd phantomjs | grep not

  3. Instale manualmente las bibliotecas que faltan.

Pasos siguientes next-steps

Tiene un entorno de AEM Forms Document Services en funcionamiento. Puede utilizar Document Services mediante lo siguiente:

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da