Migrar recursos y documentos de AEM Forms migrate-aem-forms-assets-and-documents
La utilidad de migración convierte los recursos de formularios adaptables, las configuraciones en la nube y los recursos de Administración de correspondencia desde el formato utilizado en versiones anteriores hasta el formato utilizado en AEM 6.4 Forms. Al ejecutar la utilidad de migración, se migran los siguientes elementos:
- Componentes personalizados para formularios adaptables
- Plantillas de formularios adaptables y Administración de correspondencia
- Configuraciones en la nube
- Recursos de Administración de correspondencia y formularios adaptables
Método de migración approach-to-migration
Puede actualización a la versión más reciente de AEM Forms 6.4 de AEM Forms 6.3 o 6.2 o realice una instalación nueva. Dependiendo de si ha actualizado la instalación anterior o si ha realizado una instalación nueva, deberá llevar a cabo una de las siguientes acciones:
Actualizaciones in situ
Si ha realizado una actualización in situ, la instancia actualizada ya contiene los recursos y los documentos. Sin embargo, para poder utilizarlos, deberá instalar el paquete de compatibilidad de AEMFD (incluye el paquete de compatibilidad de Administración de correspondencia).
A continuación, deberá actualizar los recursos y los documentos ejecutando la utilidad de migración.
Actualizaciones fuera del sitio
Si se trata de una instalación fuera del sitio (nueva), antes de poder utilizar los recursos y documentos, deberá instalar el paquete de compatibilidad de AEMFD (incluye el paquete de compatibilidad de Administración de correspondencia).
A continuación, debe importar el paquete de recursos (zip o cmp) en la nueva configuración y, después, actualizar los recursos y los documentos ejecutando la utilidad de migración. Debido a los cambios en la compatibilidad con versiones anteriores, las ubicaciones de algunas carpetas se cambian en el repositorio CRX. Exportar e importar manualmente dependencias (bibliotecas y recursos personalizados) de la configuración anterior a un entorno nuevo.
Lea esta sección antes de continuar con la migración prerequisites
Para los recursos de Administración de correspondencia:
- En el caso de los recursos importados de la plataforma anterior, se agrega una propiedad, fd:version=1.0.
- A partir de AEM 6.1 Forms, los comentarios no están disponibles de forma predeterminada. Los comentarios que se agregaron anteriormente están disponibles en los recursos, pero no son visibles en la interfaz automáticamente. Es necesario personalizar la propiedad extendedProperties en la interfaz de usuario de AEM Forms para hacerlos visibles.
- En algunas versiones anteriores, como LiveCycle ES4, el texto se editaba con RichTextEditor de Flex, pero desde AEM 6.1 Forms, se utiliza un editor HTML. Debido a este procesamiento y al aspecto de las fuentes, los tamaños y los márgenes de fuente pueden diferir de las versiones anteriores en la interfaz de usuario del Autor. Sin embargo, las cartas tienen el mismo aspecto cuando se representan.
- Las listas de los módulos de texto se han mejorado, y ahora se procesan de forma diferente. Es posible que haya diferencias visuales. Le recomendamos que procese y visualice las secciones de las cartas en las que utiliza listas en módulos de texto.
- Dado que los módulos de contenido de imagen se convierten en recursos DAM, y que los diseños y los fragmentos se añaden a los formularios durante la migración, la propiedad Updated By de estos módulos cambia a admin.
- El historial de versiones de los recursos no se migra y no está disponible después de la migración. El historial de versiones posterior a la migración se conserva.
- El estado Listo para publicación está obsoleto desde AEM Forms 6.1, por lo que todos los recursos con este estado se cambian al estado Modificado.
- Dado que la interfaz de usuario se ha actualizado en AEM Forms 6.3, los pasos para realizar las personalizaciones también son diferentes. Si está migrando de una versión anterior a la 6.3, deberá volver a realizar las personalizaciones.
- Los fragmentos de diseño se mueven de /content/apps/cm/layouts/fragmentlayouts/1001 a /content/apps/cm/module/fragmentlayouts. La referencia del diccionario de datos en los recursos muestra la ruta del diccionario de datos en lugar de su nombre.
- Es necesario reajustar los espacios de tabulación que se utilizan para la alineación en los módulos de texto. Para obtener más información, consulte Administración de correspondencia - Use el espaciado del tabulador para organizar el texto.
- Las configuraciones del Compositor de recursos cambian a las configuraciones de Administración de correspondencia.
- Los recursos se mueven a carpetas con nombres como Existing Text y Existing List.
Uso de la utilidad de migración using-the-migration-utility
Ejecución de la utilidad de migración runningmigrationutility
Ejecute la utilidad de migración antes de realizar cambios en los recursos o crear recursos. Le recomendamos que no ejecute la utilidad después de realizar cambios o crear recursos. Asegúrese de que la interfaz de usuario de Administración de correspondencia o de los recursos de formularios adaptables no esté abierta mientras se esté ejecutando el proceso de migración.
Cuando ejecuta la utilidad de migración por primera vez, se crea un registro con la siguiente ruta y nombre: \[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log. Este registro sigue actualizándose con la información de migración de Administración de correspondencia y los formularios adaptables, como la transferencia de recursos.
-
En una sesión del explorador, inicie sesión en la instancia de autor de AEM como administrador.
-
Abra la siguiente URL en el explorador:
https://[hostname]:[port]/[context_path]/libs/fd/foundation/gui/content/migration.html
El explorador muestra cuatro opciones:
- Migración de recursos de AEM Forms
- Migración de componentes de formulario adaptable personalizados
- Migración de plantillas de formulario adaptable
- Migración de configuraciones en la nube de AEM Forms
-
Para realizar la migración, realice los siguientes pasos:
-
Para migrar recursos, pulse Migración de recursos de AEM Forms y, en la siguiente pantalla, pulse Iniciar migración. Se migrarán los siguiente elementos:
- Formularios adaptables
- Fragmentos de documento
- Temas
- Cartas
- Diccionarios de datos
note note NOTE Durante la migración de recursos, puede encontrar mensajes de advertencia como "Conflicto encontrado para…". Estos mensajes indican que no se han podido migrar las reglas de algunos de los componentes de los formularios adaptables. Por ejemplo, si el componente tenía un evento con reglas y scripts, si las reglas se aplican después de uno de los scripts, no se migran ninguna de las reglas del componente. Sin embargo, estas reglas se pueden migrar abriendo el editor de reglas en la creación de formularios adaptables. Estos componentes se pueden migrar abriéndolos en el Editor de reglas desde el Editor de formularios adaptables. -
Para migrar reglas y scripts (no es necesario si se actualiza desde la versión 6.3) de componentes personalizados, pulse Migración de componentes de formulario adaptable personalizados y, en la pantalla siguiente, pulse Iniciar migración. Se migrarán los siguiente elementos:
- Reglas y scripts creados con el Editor de reglas (6.1 FP1 y versiones posteriores)
- Scripts creados con la pestaña Script en la IU de 6.1 y versiones anteriores
-
Para migrar plantillas (no es necesario si se actualiza desde la versión 6.3), pulse Migración de plantillas de Forms adaptable y, en la pantalla siguiente, pulse Iniciar migración. Se migrarán los siguiente elementos:
- Plantillas antiguas: las plantillas de formulario adaptable creadas en /apps con AEM 6.1 Forms o versiones anteriores. Eso incluye los scripts definidos en los componentes de plantilla.
- Nuevas plantillas: las plantillas de formulario adaptable creadas con el Editor de plantillas en /conf. Eso incluye la migración de reglas y scripts creados con el Editor de reglas.
-
Para migrar componentes de formulario adaptable personalizados, pulse Migración de componentes de formulario adaptable personalizados y, en la página Migración de componentes personalizados, pulse Iniciar migración. Se migrarán los siguiente elementos:
- Componentes personalizados escritos para formularios adaptables
- Superposiciones de componentes, si las hay.
-
Para migrar plantillas de formulario adaptable, pulse Migración de componentes de formulario adaptable personalizados y, en la página Migración de componentes personalizados, pulse Iniciar migración. Se migrarán los siguiente elementos:
- Plantillas de formulario adaptables creadas en /apps o /conf con AEM Editor de plantillas.
-
Migre los servicios de configuración de AEM Forms Cloud para aprovechar el nuevo paradigma de servicio en la nube según el contexto, que incluye la IU táctil (en /conf). Al migrar los servicios de configuración de AEM Forms Cloud, los servicios de nube en /etc se mueven a /conf. Si no tiene personalizaciones de servicios de nube que dependan de las rutas heredadas (https://experienceleague.adobe.com/etc.?lang=es), se recomienda ejecutar la utilidad de migración justo después de actualizar a la versión 6.4 y utilizar la configuración de nube Touch UI para cualquier trabajo posterior. Si tiene personalizaciones de servicios de nube existentes, continúe usando la IU clásica en la configuración actualizada hasta que las personalizaciones se actualicen para alinearlas con las rutas migradas (https://experienceleague.adobe.com/conf?lang=es) y luego ejecute la utilidad de migración.
Para migrar servicios en la nube de AEM Forms, que incluyen lo siguiente, pulse Migración de configuración de AEM Forms Cloud (la migración de configuración en la nube es independiente del paquete de compatibilidad de AEMFD), pulse Migración de configuraciones de AEM Forms Cloud y, a continuación, en la página Migración de configuración, pulse Iniciar migración:
-
Servicios en la nube del modelo de datos de formulario
- Ruta de origen: /etc/cloudservices/fdm
- Ruta de destino: /conf/global/settings/cloudconfigs/fdm
-
Recaptcha
- Ruta de origen: /etc/cloudservices/recaptcha
- Ruta de destino: /conf/global/settings/cloudconfigs/recaptcha
-
Acrobat Sign
- Ruta de origen: /etc/cloudservices/echosign
- Ruta de destino: /conf/global/settings/cloudconfigs/echosign
-
Servicios de nube de Typekit
- Ruta de origen: /etc/cloudservices/typekit
- Ruta de destino: /conf/global/settings/cloudconfigs/typekit
La ventana del explorador muestra lo siguiente a medida que se produce el proceso de migración:
- Cuando se actualizan los recursos: Recursos actualizados correctamente.
- Una vez completada la migración: Migración de recursos finalizada.
Cuando se ejecuta, la utilidad de migración realiza las siguientes acciones:
- Añade las etiquetas a los recursos: Agrega la etiqueta "Gestión de correspondencia : Recursos migrados" / "Forms adaptable : Recursos migrados". a los recursos migrados, de forma que los usuarios puedan identificar los recursos migrados. Al ejecutar la utilidad de migración, todos los recursos existentes en el sistema se marcan como Migrados.
- Genera etiquetas: las categorías y subcategorías presentes en el sistema anterior se crean como etiquetas y, a continuación, estas etiquetas se asocian a los recursos relevantes de Administración de correspondencia en AEM. Por ejemplo, una categoría (Reclamaciones) y una subcategoría (Reclamaciones) de una plantilla de carta se generan como etiquetas.
- Mueve los diseños y los fragmentos de diseño a la interfaz de usuario de Forms AEM 6.4: Si está actualizando de 6.2 a 6.4, las plantillas de presentación y los fragmentos de presentación se añaden como formularios en la sección de la interfaz de usuario de AEM Forms 6.4.
note note NOTE Si está actualizando de 6.2 a 6.4, en el caso de la Gestión de correspondencia, es posible que aparezcan nuevas carpetas en la interfaz de usuario que incluyan sus recursos. Es posible que deba comprobar estas carpetas para localizar los recursos. -
-
Una vez que la utilidad de migración haya terminado de ejecutarse, continúe con las tareas de mantenimiento.
Tareas de mantenimiento después de ejecutar la utilidad de migración. housekeepingtasks
Después de ejecutar la utilidad de migración, debe encargarse de las siguientes tareas de mantenimiento:
-
Compruebe que la versión XFA de los diseños y los diseños de fragmento sea la 3.3 o posterior. Si utiliza diseños y diseños de fragmento de una versión anterior, es posible que se produzcan problemas al procesar la carta. Para actualizar la versión de un XFA anterior a la versión más reciente, realice los siguientes pasos:
- Descargue el XFA como archivo zip desde la interfaz de usuario de Forms.
- Extraiga el archivo.
- Abra el archivo XFA en la última versión de Designer y guárdelo. El XFA se actualiza a la versión más reciente.
- Cargue el XFA en la interfaz de usuario de Forms.
-
Publique todos los recursos publicados en el sistema anterior antes de la migración. La utilidad de migración actualiza los recursos solo en la instancia de autor. Para actualizar los recursos en la instancia de publicación es necesario publicarlos.
-
En AEM Forms 6.4, se cambian algunos de los derechos de los grupos de usuarios de formularios. Si desea que cualquiera de los usuarios pueda cargar formularios XDP y formularios adaptables que contengan scripts o utilizar el Editor de código, debe agregarlos al grupo forms-power-users. Del mismo modo, los autores de plantillas ya no pueden utilizar el editor de código del Editor de reglas. Para que los usuarios puedan utilizar el editor de código, agréguelos al grupo af-template-script-writers. Para obtener instrucciones sobre cómo agregar usuarios a grupos, consulte Administración de usuarios y grupos de usuarios.