Configurar el servicio de conversión automatizada de formularios

Esta ayuda describe cómo un administrador de AEM puede configurar el servicio de Automated forms conversion 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 cualquier persona que lea esta Ayuda está familiarizada 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 AEM 6.4 Forms y AEM 6.5 clientes locales de Forms y clientes empresariales de servicio administrado por Adobe. Póngase en contacto con el equipo de ventas de Adobe o con su representante de Adobe para solicitar acceso al servicio. El servicio también está disponible de forma gratuita y está prehabilitado para los clientes de AEM Forms as a Cloud Service.

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 Automated forms conversion, es necesario lo siguiente:

  • El servicio de automated forms conversion está habilitado para su organización
  • Una cuenta de Adobe ID con privilegios de administrador para el servicio de conversión
  • Una instancia de autor de AEM Forms como Cloud Service con el Service Pack AEM más reciente o con las últimas actualizaciones.
  • Un usuario AEM (en la instancia de AEM) que es miembro del grupo de usuarios de formularios

Configuración de entorno

Antes de utilizar el servicio, prepare la instancia de autor 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:

  1. Descargue e instale AEM 6.4, AEM 6.5 o AEM Forms incorporado como Cloud Service
  2. Descargar e instalar AEM Service Pack más reciente
  3. Descargue e instale el último paquete de complementos de AEM Forms
  4. (opcional) Descargue e instale el último paquete del conector
  5. Creación de temas y plantillas personalizados

Descargue e instale AEM 6.4 o AEM 6.5 o AEM Forms incorporado como Cloud Service

El servicio de automated forms conversion se ejecuta en AEM instancia de autor. Se necesita AEM 6.4, AEM 6.5 o AEM Forms como Cloud Service para configurar una instancia de autor AEM.

(Solo para AEM 6.4 y AEM 6.5) Descargue e instale AEM último Service Pack

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

(Solo para AEM 6.4 y AEM 6.5) Descargue e instale 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 funciones de AEM Forms. Descargue e instale el paquete de complementos de AEM Forms para disponer de todas las funcionalidades de AEM Forms. El paquete es necesario para configurar y ejecutar el servicio de conversión. Para obtener instrucciones detalladas, consulte Instalar y configurar las capacidades de captura de datos.

NOTA

Asegúrese de realizar las configuraciones obligatorias posteriores a la instalación después de instalar el paquete de complementos.

Creación de temas y plantillas personalizados

Si inicia AEM 6.4 o AEM 6.5 en modo de producción (modo de ejecución nosamplecontent), los paquetes de referencia no están instalados. Los paquetes de referencia contienen temas de muestra y plantillas. El servicio de automated forms conversion requiere al menos un tema y una plantilla para convertir un formulario PDF en un formulario adaptable. Cree un tema personalizado y una plantilla propia y apunte configuración del servicio para usar plantillas y temas personalizados antes de usar el servicio.

También puede descargar e instalar el paquete AEM Forms Reference Assets en la instancia de autor. Crea algunos temas de referencia y plantillas.

Configure el servicio

Antes de proceder a la configuración del servicio y conectar la instancia local con el servicio que se ejecuta en Adobe Cloud, obtenga información sobre las personas y los privilegios necesarios para conectarse al servicio. El servicio utiliza dos tipos diferentes de personalidades, administradores y desarrolladores:

  • Administradores: Los administradores son responsables de administrar el software y los servicios de Adobe para su organización. Los administradores conceden acceso a los desarrolladores de su organización para que se conecten al servicio de Automated forms conversion 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 es administrador, compruebe si hay algún correo electrónico en su buzón con el título mencionado anteriormente y vaya a conceder acceso a los desarrolladores de su organización.

Correo electrónico de concesión de acceso del administrador

  • Desarrolladores: Un desarrollador conecta una instancia de autor local de AEM Forms con el servicio de Automated forms conversion que se ejecuta en Adobe Cloud. Cuando un administrador concede derechos a un desarrollador para que se conecte al servicio de Automated forms conversion, se envía un mensaje de correo electrónico con el título Ahora tiene acceso de desarrollador para administrar las integraciones de API de Adobe para su organización al desarrollador. Si es un desarrollador, compruebe si hay un correo electrónico en su buzón con el título anteriormente mencionado y continúe con Conecte la instancia de AEM local al servicio de Automated forms conversion en Adobe Cloud.

Correo electrónico de concesión de acceso para desarrolladores

(Solo para administradores de AEM 6.4 y AEM 6.5) Conceda acceso a los desarrolladores de su organización

Una vez que el Adobe habilita el acceso para su organización y proporciona los privilegios necesarios al administrador, este 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 Automated forms conversion en Adobe Cloud.

Los desarrolladores son miembros de su organización designada para ejecutar el servicio de conversión. Solo los desarrolladores que se agregan al perfil de servicio de Automated forms conversion de Adobe tienen derecho a utilizar el servicio de Automated forms conversion. Realice los pasos siguientes para crear un perfil y agregarle desarrolladores. Se requiere un perfil como mínimo para conceder el acceso necesario a los desarrolladores de su organización:

  1. Inicie sesión en Admin Console. Utilice Adobe ID del administrador aprovisionado para utilizar el servicio de Automated forms conversion para iniciar sesión. No utilice ningún otro ID o Federated ID para iniciar sesión.

  2. Haga clic en la opción Automated Forms Conversion.

  3. Haga clic New Profile en la pestaña Products.

  4. Especifique Name, Display Name y Description para el perfil. Haga clic Done. Se crea un perfil.

    Especifique los detalles del nuevo perfil.

  5. Agregue un desarrollador al perfil. Para agregar los desarrolladores:

    1. En el Admin Console, vaya a la pestaña Información general .
    2. Haga clic Assign Developers en la tarjeta de producto requerida.
    3. Introduzca la dirección de correo electrónico de los desarrolladores y, opcionalmente, los nombres y apellidos.
    4. Seleccione perfiles de 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 al perfil de Adobe I/O, se notifica a los desarrolladores por correo electrónico. Después de recibir el correo electrónico, los desarrolladores pueden conectar una instancia local de AEM Forms con el servicio de Automated forms conversion en Adobe Cloud.

(Solo para desarrolladores) Conecte la instancia local de AEM Forms al servicio de Automated forms conversion en Adobe Cloud

Una vez que un administrador le proporcione acceso para desarrolladores, puede conectar la instancia local de AEM Forms al servicio de Automated forms conversion 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 automated forms conversion 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 Day CQ:

  • Para AEM 6.4 Forms o AEM 6.5 Forms:

    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 servicios de correo electrónico o 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 configuración Day CQ Link Externalizer. En el campo Domains, 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.

  • Para AEM Forms as a Cloud Service, registre un ticket de asistencia para habilitar el servicio de correo electrónico.

Agregar un usuario al grupo de usuarios de formularios

Especifique una dirección de correo electrónico en el perfil del usuario de AEM designado para ejecutar el servicio. Asegúrese de que el usuario es miembro del grupo user 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:

  1. Inicie sesión en la instancia de autor de AEM Forms como administrador de AEM. Use sus credenciales de AEM locales para iniciar sesión. No use Adobe ID para iniciar sesión. Toque Adobe Experience Manager > Tools > Security > Users.

  2. Seleccione un usuario designado para ejecutar el servicio de conversión y pulse Properties. Se abre la página Editar configuración de usuario .

  3. Especifique una dirección de correo electrónico en el campo Email y pulse Save. Los correos electrónicos se envían a la dirección de correo electrónico especificada cuando la conversión se completa o no se realiza correctamente.

  4. Pulse la pestaña Grupos. En la ficha seleccionar grupo, escriba y seleccione el grupo forms-users. Toque Guardar y cerrar. El usuario es ahora miembro del grupo de usuarios de formularios.

(Sólo para AEM 6.4 y AEM 6.5) Obtener certificados públicos

Un certificado público permite autenticar el perfil en el Adobe I/O.

  1. Inicie sesión en la instancia de autor de AEM Forms. Ir a Tools> Security > Adobe IMS Configurations. Tocar Create. Aparece la página Adobe IMS Technical Account Configuration.

    La página Configuración de cuenta técnica de Adobe IMS

  2. Seleccione Automated Forms Conversion Service en Cloud Solution.

  3. Seleccione la casilla de verificación Create new certificate 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. Pulse 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 Adobe Developer Console. Tocar Next.

  5. Especifique los siguientes:

    Deje los demás campos en blanco por ahora (para proporcionar más adelante). Mantenga la página abierta.

(Solo para AEM 6.4 y AEM 6.5) Configure las API de servicio en Adobe Developer Console

Para utilizar el servicio de Automated forms conversion, cree un proyecto y añada la API del servicio de configuración automatizada de Forms al proyecto en Adobe Developer Console. 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 Adobe I/O 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 una lista de todas las API habilitadas para su cuenta.

  4. Seleccione Automated Forms Conversion service y pulse Next. Aparece una pantalla para configurar la API.

  5. Seleccione la opción Upload your public key, cargue el archivo AEM-Adobe-IMS.crt descargado en la sección Obtener certificados públicos y pulse Next. Aparece la opción de credencial Crear una nueva cuenta de servicio (JWT). Tocar Next.

  6. Seleccione un perfil de producto y pulse Save configured API. Seleccione el perfil creado mientras concede acceso a los desarrolladores de su organización. Si no conoce el perfil que desea seleccionar, póngase en contacto con su administrador.

  7. Pulse Service Account (JWT) para ver la clave de API, el secreto del cliente y otra información necesaria para conectar la instancia de AEM local al servicio de Automated forms conversion. 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.

    Especifique el título, la clave de API, el secreto del cliente y la carga útil

  9. En la página técnica de Adobe IMS, especifique la clave de API y el secreto del cliente. Utilice los valores especificados en Cuenta de servicio (JWT) de la página de la consola de desarrollador de Adobe.

    NOTA

    Para la carga útil, utilice el código proporcionado en la pestaña Generate JWT de la página Service Account (JWT) de Adobe Developer Console.

  10. Tocar Save. Se crea la configuración de IMS.

    PRECAUCIÓN

    Cree solo una configuración de IMS. No cree más de una configuración IMS.

  11. Seleccione la configuración de IMS y pulse Check Health. Aparecerá un cuadro de diálogo. Tocar Check. Cuando la conexión se realiza correctamente, aparece el mensaje Token recuperado correctamente .

    Cuando la conexión se realiza correctamente, aparece el mensaje token recuperado correctamente.



Configuración del Cloud Service

Cree una configuración de Cloud Service para conectar la instancia de AEM al servicio de conversión. También le permite especificar una plantilla, un tema y fragmentos de formulario para una conversión. Puede crear varias configuraciones de servicios de nube por separado para cada conjunto de formularios. Por ejemplo, puede tener una configuración independiente para los formularios de departamento de ventas y otra independiente para los formularios de asistencia al cliente. Siga estos pasos para crear una configuración de Cloud Service:

  1. En la instancia de AEM Forms, pulse Adobe Experience Manager > Tools Cloud Services > Automate Forms Conversion Configuration.

  2. Pulse la carpeta Global y pulse Create. Aparece la página para crear la configuración de Automated forms conversion. La configuración se crea en la carpeta Global . También puede crear la configuración en una carpeta diferente que existe o crear una carpeta para las configuraciones.

  3. En la página Create Automated Forms Conversion Configuration, especifique el valor para los campos siguientes y pulse Next.

    Campo Descripción
    Título Título único para la configuración. El título se muestra en la IU utilizada para iniciar la conversión.
    Nombre Nombre único para la configuración. La configuración se guarda en el repositorio CRX con el nombre especificado. El nombre puede ser idéntico al título.
    Ubicación en miniatura Ubicación de la miniatura para la configuración.
    URL de servicio URL del servicio de Automated forms conversion en Adobe Cloud. Utilice la dirección URL https://aemformsconversion.adobe.io/.
    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 estructura básica y contenido inicial para 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 que se proporciona de forma predeterminada. También puede crear un tema personalizado.
    Fragmentos existentes Ubicación de los fragmentos existentes, si los hay.
    Meta-modelo personalizado Ruta del archivo .schema.json del metamodelo personalizado. Puede crear metamodelos independientes para los idiomas inglés, francés, alemán, español, italiano y portugués.
  4. En la pestaña Advanced de la página Create Automated Forms Conversion Configuration, especifique el 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 se activa la opción, después de enviar un formulario, se puede permitir a los clientes mantener un registro, impreso o en formato de documento, de la información que han rellenado en el formulario para su referencia futura. Esto se denomina documento de registro.
    Activar Analytics (Solo para AEM 6.4 y AEM 6.5) Seleccione la opción para habilitar Adobe Analytics en todos los formularios convertidos. Antes de utilizar la opción , compruebe que Adobe Analytics está habilitado para su instancia de AEM Forms.
    • Cuando el origen es un formulario basado en XFA con la extensión .XDP, el DOR de salida conserva el diseño XFA. De lo contrario, el servicio de conversión utiliza una plantilla predeterminada para generar DOR para otros formularios basados en XFA.
    • Cuando se envía un formulario XFA, los datos enviados 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 divisa, 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 empezar a convertir formularios heredados a formularios adaptables.

En esta página