Configuración del servicio de conversión automatizada de formularios about-this-help
Esta ayuda describe cómo un administrador de AEM puede configurar el servicio de conversión automatizada de formularios para automatizar la conversión de sus formularios PDF a formularios adaptables. Esta ayuda es para los administradores de TI y AEM de su organización. La información proporcionada se basa en la suposición 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 los sistemas operativos Linux® y Windows® de Microsoft®,
-
Configuración de los servidores de correo SMTP.
Incorporación onboarding
El servicio está disponible de forma gratuita para los clientes a plazo de AEM Forms 6.4 y AEM Forms 6.5 locales y los clientes empresariales de Managed Services de 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 las personas de su organización designadas como administradores. Estos administradores pueden otorgar acceso a los desarrolladores de AEM Forms (usuarios) de su organización para conectarse al servicio.
Requisitos previos prerequisites
Para utilizar el servicio de conversión automatizada de formularios, es necesario lo siguiente:
- Que el servicio de conversión automatizada de formularios esté habilitado para su organización.
- Que tenga una cuenta de Adobe ID con privilegios de administrador para el servicio de conversión.
- Que tenga una instancia de autor de AEM Forms as a Cloud Service que se esté ejecutando AEM 6.4, AEM 6.5 o con el Service Pack de AEM más reciente o con las actualizaciones más recientes.
- Un usuario de AEM (en la instancia de AEM) que sea miembro del grupo de usuarios de formularios.
Configuración del entorno setuptheservice
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:
- Descargue e instale AEM 6.4, AEM 6.5 o AEM Forms as a Cloud Service incorporado
- Descargue e instale el Service Pack de AEM más reciente
- Descargue e instale el último paquete de complementos de AEM Forms
- (opcional) Descargue e instale el paquete de conectores más reciente
- Creación de temas y plantillas personalizadas
Descarga e instalación de AEM 6.4 o AEM 6.5 o AEM Forms as a Cloud Service incorporado aemquickstart
El servicio de conversión automatizada de formularios se ejecuta en la instancia de autor de AEM. Se necesita AEM 6.4, AEM 6.5 o AEM Forms as a Cloud Service para configurar la instancia de autor de AEM.
-
Si no tiene AEM 6.4 o AEM 6.5 en funcionamiento, descárguelo desde las siguientes ubicaciones. Después de descargar AEM, para obtener instrucciones para configurar una instancia de autor de AEM, consulte implementación y mantenimiento:
-
Si ya es cliente de AEM, descargue AEM 6.4 o AEM 6.5 desde el sitio web de licencias de Adobe.
-
Si es socio de Adobe, utilice el Programa de formación para socios de Adobe para solicitar AEM 6.4 o AEM 6.5.
-
-
Si utiliza AEM Forms as a Cloud Service, consulte Incorporarse a AEM Forms as a Cloud Service y la configuración de un entorno de desarrollo local.
(Solo para AEM 6.4 y 6.5) Descarga e instalación del último Service Pack de AEM servicepack
Descargue e instale el Service Pack de AEM más reciente. Para obtener instrucciones detalladas, consulte las Notas de la versión de Service Pack de AEM 6.4 o las Notas de la versión de Service Pack de AEM 6.5.
(Solo para AEM 6.4 y 6.5) Descarga e instalación del paquete de complementos de AEM Forms downloadaemformsaddon
La instancia de AEM contiene funciones básicas para los 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 Instalación y configuración de las funcionalidades de captura de datos.
Creación de temas y plantillas personalizadas referencepackage
Si comienza con AEM 6.4 o AEM 6.5 en modo de producción (modo nosamplecontent run), los paquetes de referencia no están instalados. Los paquetes de referencia contienen muestras de temáticas y plantillas. El servicio de conversión automatizada de formularios necesita al menos una temática y una plantilla para convertir un formulario PDF en un formulario adaptable. Cree una temática y una plantilla personalizadas propias y marque configuración del servicio para utilizar plantillas y temáticas personalizadas antes de usar el servicio.
También puede descargar e instalar el paquete de Activos de referencia de AEM Forms en la instancia de autor. Crea algunas temáticas y plantillas de referencia.
Configuración del servicio configure-the-service
Antes de comenzar con la configuración del servicio y conectar la instancia local con el servicio que se ejecuta en Adobe Cloud, obtenga información sobre los perfiles y los privilegios necesarios para conectarse al servicio. El servicio utiliza dos tipos de perfiles, administradores y desarrolladores:
- Administradores: son responsables de administrar el software y los servicios de Adobe para su organización. Conceden acceso a los desarrolladores de su organización para que se conecten al servicio de conversión automatizada de formularios 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 un correo electrónico en su buzón con el título mencionado anteriormente y proceda a conceder acceso a los desarrolladores de su organización.
- Desarrolladores: conectan una instancia de autor de AEM Forms local con el servicio de conversión automatizada de formularios que se ejecuta en Adobe Cloud. Cuando un administrador concede derechos a un desarrollador para que se conecte al servicio de conversión automatizada de formularios, se envía un mensaje de correo electrónico al desarrollador con el título “Ahora tiene acceso como desarrollador para administrar las integraciones de API de Adobe para su organización”. Si es un desarrollador, compruebe si tiene un correo electrónico en su buzón con el título mencionado anteriormente y proceda a Conectar la instancia de AEM local al servicio de conversión automatizada de formularios en Adobe Cloud.
(Solo para administradores de AEM 6.4 y 6.5) Concesión de acceso a los desarrolladores de su organización adduseranddevs
Una vez que Adobe habilita el acceso para su organización y proporciona los privilegios necesarios al administrador, este puede iniciar sesión en Admin Console (instrucciones detalladas a continuación), crear un perfil y agregar desarrolladores. Los desarrolladores pueden conectar una instancia local de AEM Forms al servicio de conversión automatizada de formularios en Adobe Cloud.
Los desarrolladores son miembros de su organización que están designados para ejecutar el servicio de conversión. Solo aquellos desarrolladores que se agregan al perfil del servicio de conversión automatizada de formularios de Adobe tienen derecho a utilizarlo. 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.
-
Inicie sesión en Admin Console. Use el Adobe ID del administrador suministrado para utilizar el servicio de conversión automatizada de formularios para iniciar sesión. No utilice ningún otro ID o Federated ID para iniciar sesión.
-
Haga clic en la opción Automated Forms Conversion.
-
Haga clic New Profile en la pestaña Products.
-
Especifique Name, Display Name y Description para el perfil. Haga clic en Done. Se crea el perfil.
-
Agregue un desarrollador al perfil. Para agregar a los desarrolladores, haga lo siguiente:
- En Admin Console, vaya a la pestaña Información general.
- Haga clic en Assign Developers en la tarjeta de producto requerida.
- Escriba la dirección de correo electrónico de los desarrolladores y, opcionalmente, los nombres y apellidos.
- Seleccione los perfiles del producto. Pulse Save.
Repita los pasos anteriores para todos los usuarios. Para obtener más información sobre cómo agregar desarrolladores, vea Administrar desarrolladores.
Una vez que un administrador agrega desarrolladores al perfil de Adobe I/O, se les notifica a los desarrolladores por correo electrónico. Después de recibir el correo electrónico, los desarrolladores pueden continuar con una conexión de una instancia local de AEM Forms con el servicio de conversión automatizada de formularios en Adobe Cloud.
(Solo para desarrolladores) Conexión de la instancia local de AEM Forms al servicio de conversión automatizada de formularios en Adobe Cloud connectafcadobeio
Una vez que un administrador le proporcione acceso para desarrolladores, puede conectar la instancia local de AEM Forms al servicio de conversión automatizada de formularios que se ejecuta en Adobe Cloud. Realice los siguientes pasos en la secuencia indicada para conectar la instancia de AEM Forms al servicio:
Configuración de las notificaciones por correo electrónico configureemailnotification
El servicio de conversión automatizada de formularios utiliza el servicio de correo Day CQ para enviar notificaciones por correo electrónico. Estas notificaciones por correo electrónico contienen información sobre las conversiones correctas o fallidas. Si no desea recibir notificaciones, 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:
-
Vaya al administrador de configuración de AEM en
http://localhost:4502/system/console/configMgr -
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 en 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 del 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.
-
Abra la configuración Day CQ Link Externalizer. En el campo Domains, especifique el nombre del host o la dirección IP real y el número de puerto para las instancias locales, autor y publicación. Haga clic en Save.
-
-
Para AEM Forms as a Cloud Service, registre una incidencia de soporte técnico para habilitar el servicio de correo electrónico.
Adición de usuarios a grupos de usuarios de los formularios adduserstousergroup
Especifique una dirección de correo electrónico en el perfil de AEM del usuario designado para ejecutar el servicio. Asegúrese de que el usuario sea miembro del grupo de usuarios de formularios. Se envían correos electrónicos a la dirección 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, haga lo siguiente:
-
Inicie sesión en AEM en la instancia de autor de AEM Forms como administrador. Use sus credenciales de AEM locales para iniciar sesión. No use el Adobe ID para iniciar sesión. Toque Adobe Experience Manager > Tools > Security > Users.
-
Seleccione un usuario designado para ejecutar el servicio de conversión y pulse Properties. Se abrirá la página Editar configuración de usuario.
-
Especifique una dirección de correo electrónico en el campo Email y toque Save. Se envían correos electrónicos a la dirección especificada si la conversión se realiza correctamente o si no.
-
Pulse la pestaña Grupos. En la pestaña seleccionar grupo, escriba y seleccione el grupo usuarios de formularios. Pulse Guardar y cerrar. El usuario es ahora miembro del grupo de usuarios de formularios.
(Solo para AEM 6.4 y 6.5) Obtener certificados públicos obtainpubliccertificates
Un certificado público le permite autenticar su perfil en Adobe I/O.
-
Inicie sesión en la instancia de autor de AEM Forms. Navegue hasta Tools> Security > Adobe IMS Configurations. Pulse Create. Se abre la página Adobe IMS Technical Account Configuration.
-
Seleccione Automated Forms Conversion Service en Cloud Solution.
-
Seleccione la casilla de verificación Create new certificate y especifique un alias. El alias sirve como nombre del cuadro de diálogo. Pulse Create certificate. Aparece un cuadro de diálogo. Haga clic en OK. Se crea un certificado.
-
Pulse Download Public Key y guarde el archivo de certificado AEM-Adobe-IMS.crt en el equipo. El archivo de certificado se utiliza para la Configuración de las API de servicio en Adobe Developer Console. Pulse Next.
-
Especifique lo siguiente.
- Título: especifique un título.
- Servidor de autorización: https://ims-na1.adobelogin.com\
Deje los demás campos en blanco por ahora (se proporcionarán más adelante). Mantenga la página abierta.
(Solo para AEM 6.4 y 6.5) Configuración de las API de servicio en Adobe Developer Console createintegration
Para utilizar el servicio de conversión automatizada de formularios, cree un proyecto y agregue la API del servicio de configuración automatizada de formularios al proyecto en la consola de Adobe Developer. La integración genera la clave de la API, el secreto del cliente y la carga útil (JWT).
-
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.
-
Seleccione su organización en la esquina superior derecha. Si no conoce su organización, póngase en contacto con su administrador.
-
Toque Create new project. Aparece una pantalla para comenzar con el nuevo proyecto. Toque Add API. Aparece una pantalla con una lista de todas las API habilitadas para su cuenta.
-
Seleccione Automated Forms Conversion service y pulse Next. Aparece una pantalla para configurar la API.
-
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 la credencial Crear una nueva cuenta de servicio (JWT). Pulse Next.
-
Seleccione un perfil de producto y pulse 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 su administrador.
-
Pulse Service Account (JWT) para ver la clave de la API, el secreto del cliente y otra información necesaria para conectar la instancia de AEM local al servicio de conversión de automatizada de formularios. La información de la página se utiliza para crear la configuración de IMS en el equipo local.
-
Abra la página Configuración de IMS en la instancia local. Si mantuvo la página abierta al final de la sección, podrá Obtener un certificado público.
-
En la página técnica de Adobe IMS, 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 Adobe Developer console.
note note NOTE Para la carga útil, utilice el código proporcionado en la pestaña Generar JWT de la página de la cuenta del servicio (JWT) de Adobe Developer Console. -
Pulse Save. Se crea la configuración IMS.
note caution CAUTION Cree solo una configuración IMS. No cree más de una. -
Seleccione la configuración de IMS y pulse Check Health. Aparecerá un cuadro de diálogo. Pulse Check. Cuando la conexión se realiza correctamente, aparece el mensaje Token recuperado correctamente.
Configuración de Cloud Service configure-the-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 para 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 para los de asistencia al cliente. Siga estos pasos para crear la configuración del servicio en la nube:
-
En la instancia de AEM Forms, pulse Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration.
-
Pulse la carpeta Global y pulse Create. Aparece la página para crear la configuración de la conversión automatizada de formularios. La configuración se crea en la carpeta Global. También puede crear la configuración en una carpeta diferente que ya exista o crear una para las configuraciones.
-
En la página Create Automated Forms Conversion Configuration, especifique el valor de los campos siguientes y pulse Next.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 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 de la miniatura Ubicación de la miniatura para la configuración. URL del servicio URL del servicio de conversión automatizada de los formularios en Adobe Cloud. Utilice la URL https://aemformsconversion.adobe.io/.Plantilla Plantilla predeterminada que se aplica a los formularios convertidos. 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 proporcionadas de forma predeterminada. También puede crear una plantilla personalizada. Tema Tema predeterminado que se aplica 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 proporcione de forma predeterminada. También puede crear un tema personalizado. Fragmentos existentes Ubicación de los fragmentos existentes, si los hay. Metamodelo 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. -
En la pestaña Advanced de la página Create Automated Forms Conversion Configuration, especifique el valor para el siguiente campo:
table 0-row-2 1-row-2 2-row-2 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 (formularios XDP y PDF). 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. Este registro se denomina documento de registro. Activar Analytics (Solo para AEM 6.4 y 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), 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,
code language-css { "Type": "Principal", "Amount": "10.00", "currency": "USD" } -
Pulse Create. Se crea la configuración de la nube. La instancia de AEM Forms está lista para empezar a convertir formularios heredados a formularios adaptables.