Show Menu
TEMAS×

Configurar el servicio de conversión automatizada de formularios

Esta ayuda describe cómo un administrador de AEM puede configurar el servicio de conversión automatizada de Forms para automatizar la conversión de sus PDF forms a formularios adaptables. Esta ayuda es para administradores de TI y AEM de su organización. La información proporcionada se basa en el supuesto de que cualquiera que lea esta Ayuda está familiarizado con las siguientes tecnologías:
  • Instalación, configuración y administración de paquetes de Adobe Experience Manager y AEM,
  • Uso de sistemas operativos Linux y Microsoft Windows,
  • Configuración de servidores de correo SMTP

Incorporación

El servicio está disponible de forma gratuita para clientes de AEM 6.4 Forms y AEM 6.5 Forms On-Premise y clientes empresariales de Adobe Managed Services. Póngase en contacto con el equipo de ventas de Adobe o con su representante de Adobe para solicitar acceso al servicio.
Adobe posibilita el acceso a su organización y otorga los pertinentes privilegios a la persona de su organización designada como administrador. El administrador puede otorgar acceso a los desarrolladores de AEM Forms (usuarios) de su organización para conectarse al servicio.

Requisitos previos

Para utilizar el servicio de conversión automatizada de Forms, necesita lo siguiente:
  • El servicio de conversión automatizada de Forms está habilitado para su organización
  • Una cuenta de Adobe ID con privilegios de administrador para el servicio de conversión
  • Una instancia de creación de AEM 6.4 o AEM 6.5 activa con el último AEM Service Pack
  • Un usuario AEM (en la instancia de AEM) que es miembro del grupo de usuarios de formularios

Configuración de entorno

Antes de usar el servicio, prepare la instancia de creación de AEM para conectarse al servicio que se ejecuta en Adobe Cloud. Realice los siguientes pasos en la secuencia indicada para preparar la instancia para el servicio:

Descargar e instalar AEM 6.4 o AEM 6.5

El servicio de conversión automatizada de Forms se ejecuta en AEM instancia de creación. Se requiere AEM 6.4 o AEM 6.5 para configurar una instancia de autor AEM. Si no AEM en ejecución, descárguelo de las siguientes ubicaciones:
Después de descargar AEM, para obtener instrucciones sobre cómo configurar una instancia de AEM autor, consulte Implementación y mantenimiento .

Descargar e instalar AEM último Service Pack

Descargue e instale AEM Service Pack más reciente. Para obtener instrucciones detalladas, consulte o AEM Notas de la versión de Service Pack 6.4 o AEM Notas de la versión de Service Pack 6.5.

Descargar e instalar el paquete de complementos de AEM Forms

Una instancia de AEM contiene funciones básicas de formularios. El servicio de conversión requiere todas las capacidades de AEM Forms. Descargue e instale el paquete de complementos de AEM Forms para aprovechar todas las funciones de AEM Forms. El paquete es necesario para configurar y ejecutar el servicio de conversión. Para obtener instrucciones detalladas, consulte Instalación y configuración de funciones de captura de datos.
Asegúrese de realizar las configuraciones obligatorias posteriores a la instalación después de instalar el paquete de complemento.

(Opcional) Descarga e instalación del paquete de conector

El paquete de conector proporciona acceso anticipado a las funciones de secciones lógicas de detección automática y a las mejoras ofrecidas en la versión AFC-2020.03.1. No instale el paquete si no necesita la función y las mejoras suministradas en AFC-2020.03.1. Puede descargar el paquete de conector desde AEM Package Share .

Creación de temáticas y plantillas personalizadas

Si inicio AEM en modo production-ready.html de producción (nosamplecontent runmode), los paquetes de referencia no se instalan. Los paquetes de referencia contienen temáticas y plantillas de ejemplo. El servicio de conversión automatizada de Forms requiere al menos un tema y una plantilla para convertir a un PDF form en un formulario adaptable. Cree un tema personalizado y una plantilla propios y una configuración de servicio de puntos para utilizar plantillas y temáticas personalizadas antes de utilizar el servicio.

Configure el servicio

Antes de proceder a configurar el servicio y conectar la instancia local con el servicio que se ejecuta en Adobe Cloud, conozca las personas y los privilegios necesarios para conectarse al servicio. El servicio utiliza dos tipos diferentes de personas, administradores y desarrolladores:
  • Administradores : Los administradores son responsables de administrar los servicios y el software de Adobe de su organización. Los administradores otorgan acceso a los desarrolladores de su organización para conectarse al servicio de conversión automatizada de Forms que se ejecuta en Adobe Cloud. Cuando se aprovisiona un administrador para una organización, este recibe un correo electrónico con el título 'You now have administrator rights to manage Adobe software and services for your organization' . Si usted es un administrador, compruebe su buzón de correo electrónico con el título anteriormente mencionado y continúe concediendo acceso a los desarrolladores de su organización .
  • Desarrolladores : Un desarrollador conecta una instancia de autor local de AEM Forms con el servicio de conversión automatizada de Forms que se ejecuta en Adobe Cloud. Cuando un administrador concede derechos a un desarrollador para conectarse al servicio de conversión automatizada de Forms, se envía al desarrollador un correo electrónico con el título Ahora tiene acceso de desarrollador para administrar las integraciones de API de Adobe para su organización. Si usted es un desarrollador, compruebe su buzón de correo electrónico con el título anteriormente mencionado y continúe con Conectar su instancia de AEM local al servicio de conversión automatizada de Forms en Adobe Cloud.

(Solo para administradores) Conceder acceso a los desarrolladores de su organización

Una vez que Adobe habilita el acceso para su organización y proporciona los privilegios requeridos al administrador, éste puede iniciar sesión en el Admin Console (instrucciones detalladas a continuación), crear un perfil y agregar desarrolladores al perfil. Los desarrolladores pueden conectar una instancia local de AEM Forms al servicio de conversión automatizada de Forms en Adobe Cloud.
Los desarrolladores son miembros de su organización designados para ejecutar el servicio de conversión. Solo los desarrolladores que se agregan al perfil del servicio de conversión automatizada de Forms de Adobe tienen derecho a utilizar el servicio de conversión automatizada de Forms. Siga los pasos a continuación para crear un perfil y agregarle desarrolladores. Se requiere un mínimo de un perfil para otorgar el acceso necesario a los desarrolladores de su organización:
  1. Inicie sesión en el Admin Console . Utilice Adobe ID de administrador suministrado para utilizar el servicio de conversión automatizada de Forms para iniciar sesión. No utilice ningún otro ID o Federated ID para iniciar sesión.
  2. Haga clic en la Automated Forms Conversion opción.
  3. Haga clic New Profile en la Products ficha.
  4. Especifique Name , Display Name y Description para el perfil. Haga clic Done . Se crea un perfil.
  5. Añada el programador al perfil. Para agregar los desarrolladores:
    1. En el Admin Console , vaya a la ficha Información general.
    2. Haga clic Assign Developers en la tarjeta de producto requerida.
    3. Introduzca la dirección de correo electrónico del programador y, opcionalmente, los nombres y apellidos.
    4. Seleccione los perfiles del producto. Tocar Save .
Repita los pasos anteriores para todos los usuarios. Para obtener más información sobre cómo agregar desarrolladores, consulte Administrar desarrolladores .
Una vez que un administrador agrega desarrolladores a Adobe I/O perfil, se notifica a los desarrolladores por correo electrónico. Después de recibir el correo electrónico, los desarrolladores pueden conectar una instancia de AEM Forms local con el servicio de conversión automatizada de Forms en Adobe Cloud .

(Solo para desarrolladores) Conecte la instancia local de AEM Forms al servicio de conversión automatizada de Forms en Adobe Cloud

Una vez que un administrador le proporcione acceso para desarrolladores, puede conectar su instancia local de AEM Forms al servicio de conversión automatizada de Forms que se ejecuta en Adobe Cloud. Realice los siguientes pasos en la secuencia indicada para conectar la instancia de AEM Forms al servicio:

Configurar notificación por correo electrónico

El servicio de conversión automatizada de Forms utiliza el servicio de correo de Day CQ para enviar notificaciones por correo electrónico. Estas notificaciones por correo electrónico contienen información sobre conversiones correctas o fallidas. Si elige no recibir notificación, omita estos pasos. Realice los siguientes pasos para configurar el servicio de correo de CQ de día:
  1. Vaya a AEM administrador de configuración en http://localhost:4502/system/console/configMgr
  2. Abra la configuración de Day CQ Mail Service. Especifique un valor para los campos SMTP server host name , SMTP server port y From address . Haga clic Save .
    Puede ponerse en contacto con el proveedor de servicio de correo electrónico o con el administrador de TI para obtener información sobre el nombre de host y el puerto del servidor SMTP. Puede utilizar cualquier dirección de correo electrónico válida en el campo de formulario. Por ejemplo, notification@example.com o donotreply@example.com .
  3. Abra la Day CQ Link Externalizer configuración. En el Domains campo, especifique el nombre de host real o la dirección IP y el número de puerto para las instancias locales, de autor y de publicación. Haga clic Save .

Añadir usuario al grupo de usuarios de formularios

Especifique una dirección de correo electrónico en el perfil del usuario AEM designado para ejecutar el servicio. Asegúrese de que el usuario es el miembro del grupo de usuarios de formularios. Se envían correos electrónicos a la dirección de correo electrónico del usuario que ejecuta la conversión. Para especificar una dirección de correo electrónico para el usuario y agregar el usuario al grupo de usuarios de formularios`e:
  1. Inicie sesión en la instancia de creación de AEM Forms como administrador de AEM. Utilice sus credenciales de AEM locales para iniciar sesión. No utilice Adobe ID para iniciar sesión. Tap Adobe Experience Manager > Tools > Security > Users .
  2. Seleccione un usuario designado para ejecutar el servicio de conversión y toque Properties . Se abre la página Editar configuración de usuario.
  3. Especifique una dirección de correo electrónico en el Email campo y toque Save . Los correos electrónicos se envían a la dirección de correo electrónico especificada cuando la conversión se completa correctamente o no se realiza correctamente.
  4. Puntee en la ficha Grupos . En la ficha Seleccionar grupo, escriba y seleccione el grupo de usuarios de formularios. Toque Guardar y cerrar . El usuario es ahora miembro del grupo de usuarios de formularios.

Obtención de certificados públicos

Un certificado público le permite autenticar su perfil en E/S de Adobe.
  1. Inicie sesión en la instancia de creación de AEM Forms. Ir a Tools > Security > Adobe IMS Configurations . Tocar Create . Aparece la Adobe IMS Technical Account Configuration página.
  2. Seleccione Automated Forms Conversion Service en Cloud Solution.
  3. Seleccione la Create new certificate casilla de verificación y especifique un alias. El alias sirve como nombre del cuadro de diálogo. Tocar Create certificate . Aparece un cuadro de diálogo. Haga clic OK . Se crea el certificado.
  4. Toque Download Public Key y guarde el archivo de certificado AEM-Adobe-IMS.crt en el equipo. El archivo de certificado se utiliza para configurar las API de servicio en la consola de Adobe Developer. Tocar Next .
  5. Especifique lo siguiente:
    Deje el resto de campos en blanco por ahora (se proporcionará más tarde). Mantenga la página abierta.

Configuración de las API de servicio en la consola de Adobe Developer

Para utilizar el servicio de conversión automatizada de Forms, cree un proyecto y agregue la API del servicio de configuración automatizada de Forms al proyecto en la consola de desarrollador de Adobe. La integración genera la clave de API, el secreto del cliente y la carga útil (JWT).
  1. Inicie sesión en https://console.adobe.io/ . Utilice su cuenta de desarrollador de Adobe ID que el administrador haya aprovisionado para iniciar sesión en la consola de E/S de Adobe para iniciar sesión.
  2. Seleccione su organización en la esquina superior derecha. Si no conoce su organización, póngase en contacto con su administrador.
  3. Tocar Create new project . Aparece una pantalla para comenzar con el nuevo proyecto. Tocar Add API . Aparece una pantalla con lista de todas las API habilitadas para su cuenta.
  4. Seleccione Automated Forms Conversion service y toque Next . Aparece una pantalla para configurar la API.
  5. Seleccione la Upload your public key opción, cargue el archivo AEM-Adobe-IMS.crt descargado en la sección Obtener certificados públicos y toque Next . Aparece la opción Crear una nueva cuenta de servicio (JWT). Tocar Next .
  6. Seleccione un Perfil de producto y toque Save configured API . Seleccione el perfil creado al conceder acceso a los desarrolladores de su organización . Si no conoce el perfil que desea seleccionar, póngase en contacto con el administrador.
  7. Toque Service Account (JWT) para vista de la clave de API, el secreto del cliente y otra información necesaria para conectar la instancia de AEM local al servicio de conversión automatizada de Forms. La información de la página se utiliza para crear la configuración de IMS en el equipo local.
  8. Abra la página Configuración de IMS en la instancia local. La página se ha mantenido abierta al final de la sección, Obtener un certificado público .
  9. En la página técnica de IMS de Adobe, especifique la clave de API y el secreto del cliente. Utilice los valores especificados en la cuenta de servicio (JWT) de la página de la consola de Adobe Developer.
    Para la carga útil, utilice el código proporcionado en la ficha Generar JWT de la página Cuenta de servicio (JWT) de la consola de desarrollador de Adobe.
  10. Tocar Save . Se crea la configuración de IMS.
    Cree una sola configuración de IMS. No cree más de una configuración IMS.
  11. Seleccione la configuración de IMS y toque Check Health . Aparecerá un cuadro de diálogo. Tocar Check . Cuando la conexión se realiza correctamente, aparece el mensaje Token recuperado correctamente .

Configure the cloud service

Cree una configuración de servicio en la nube para conectar la instancia de AEM al servicio de conversión. También permite especificar una plantilla, un tema y fragmentos de formulario para una conversión. Puede crear varias configuraciones de servicio en la nube por separado para cada conjunto de formularios. Por ejemplo, puede tener una configuración independiente para los formularios del departamento de ventas y otra distinta para los formularios de asistencia al cliente. Realice los siguientes pasos para crear una configuración de servicio en la nube:
  1. En la instancia de AEM Forms, toque Adobe Experience Manager > Tools > Cloud Services > Automate Forms Conversion Configuration .
  2. Toque la Global carpeta y toque Create . Aparece la página para crear la configuración de Conversión automatizada de Forms. La configuración se crea en la carpeta Global. También puede crear la configuración en una carpeta diferente que ya existe o crear una nueva carpeta para sus configuraciones.
  3. En la Create Automated Forms Conversion Configuration página, especifique el valor de los campos siguientes y toque Next .
    Campo
    Descripción
    Título
    Título único para la configuración. El título se muestra en la interfaz de usuario utilizada para la conversión de inicios.
    Nombre
    Nombre único para la configuración. La configuración se guarda en CRX-Repository con el nombre especificado. El nombre puede ser idéntico al título.
    Ubicación de miniaturas
    Ubicación de la miniatura de la configuración.
    URL de servicio
    Dirección URL del servicio de conversión automatizada de Forms en Adobe Cloud. Utilice la https://aemformsconversion.adobe.io/ URL.
    Plantilla
    Plantilla predeterminada que se aplicará a los formularios convertidos. Siempre puede especificar una plantilla diferente antes de iniciar la conversión. Una plantilla contiene la estructura básica y el contenido inicial de un formulario adaptable. Puede elegir una plantilla de las plantillas proporcionadas de forma predeterminada. También puede crear una plantilla personalizada.
    Tema
    Tema predeterminado que se aplicará a los formularios convertidos. Siempre puede especificar un tema diferente antes de iniciar la conversión. Puede hacer clic en el icono para elegir un tema incluido de forma predeterminada. También puede crear un tema personalizado.
    Fragmentos existentes
    Ubicación de fragmentos existentes, si los hay.
    Meta-model personalizado
    Ruta del archivo .esquema.json del metamodelo personalizado.
  4. En la Advanced ficha de la Create Automated Forms Conversion Configuration página, especifique un valor para el siguiente campo:
    Campo Descripción
    Generar documento de registro Seleccione la opción para generar automáticamente el Documento de registro para los formularios convertidos. La opción solo está disponible para formularios basados en XFA (XDP y PDF forms). Cuando activa la opción, después de enviar un formulario, puede permitir a los clientes que guarden un registro, impreso o en formato de documento, de la información que han rellenado en el formulario para su futura referencia. Esto se denomina documento de registro.
    Activar Analytics Seleccione la opción para activar Adobe Analytics en todos los formularios convertidos. Antes de utilizar la opción, asegúrese de que Adobe Analytics está habilitado para la instancia de AEM Forms.
    • Cuando el origen es un formulario basado en XFA con extensión .XDP y, a continuación, el DOR de salida conserva la presentación XFA, de lo contrario el servicio de conversión utiliza una plantilla lista para generar un DOR para otros formularios basados en XFA.
    • Cuando se envía un formulario XFA, los datos de envío del formulario se guardan como un elemento XML o un atributo. Por ejemplo, <Amount currency="USD"> 10.00 </Amount> . La moneda se guarda como un atributo y la cantidad de moneda; 10,00 se guarda como un elemento. Los datos de envío de un formulario adaptable no tienen atributos, solo tienen elementos. Por lo tanto, cuando un formulario basado en XFA se convierte en formulario adaptable, los datos de envío de formulario adaptable contienen un elemento para cada atributo. Por ejemplo,
       {
          "Type": "Principal",
    
          "Amount": "10.00",
    
          "currency": "USD"
       }
    
    
  5. Tocar Create . Se crea la configuración de nube. La instancia de AEM Forms está lista para convertir en inicio formularios heredados en formularios adaptables.