Versión de diciembre de 2023 de Adobe Experience Manager Guides as a Cloud Service
Esta nota de la versión cubre las instrucciones de actualización, la matriz de compatibilidad y los problemas corregidos en la versión de diciembre de 2023 del as a Cloud Service de Adobe Experience Manager Guides (más adelante denominado Experience Manager Guides as a Cloud Service).
Para obtener más información acerca de las nuevas características y mejoras, vea Novedades de la versión de diciembre de 2023 de Experience Manager Guides as a Cloud Service.
Actualización a la versión de diciembre de 2023
Actualice la configuración as a Cloud Service de Experience Manager Guides actual realizando los siguientes pasos:
- Consulte el código Git de los Cloud Service y cambie a la rama configurada en la canalización de Cloud Service correspondiente al entorno que desea actualizar.
- Actualice la propiedad
<dox.version>en el archivo/dox/dox.installer/pom.xmlde su código Git de Cloud Service a 2023.12.0.16. - Confirme los cambios y ejecute la canalización de Cloud Service para actualizar a la versión de diciembre de 2023 de Experience Manager Guides as a Cloud Service.
Pasos para activar el déclencheur de una secuencia de comandos mediante un servlet
(Solo si tiene una versión anterior a la versión de junio de 2023 de Experience Manager Guides as a Cloud Service)
Una vez finalizada la instalación, puede optar por PULSAR el déclencheur para iniciar el trabajo de traducción:
POST:
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
Respuesta:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
En el JSON de respuesta anterior, la clave lockNodePath contiene la ruta al nodo creado en el repositorio que señala al trabajo enviado. Se eliminará automáticamente una vez finalizado el trabajo. A continuación, puede hacer referencia a este nodo para ver el estado del trabajo.
Espere hasta que se complete este trabajo antes de continuar con los siguientes pasos.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
Pasos para publicar y procesar el contenido existente a fin de utilizar el informe de vínculos rotos
(Solo si tiene una versión anterior a la versión de junio de 2023 de Experience Manager Guides as a Cloud Service)
Realice los siguientes pasos para posprocesar el contenido existente y utilizar el nuevo informe de vínculos rotos:
-
(Opcional) Si hay más de 100 000 archivos DITA en el sistema, actualice
queryLimitReadsyqueryLimitInMemoryenorg.apache.jackrabbit.oak.query.QueryEngineSettingsServicea un valor mayor (cualquier valor mayor que el número de recursos presentes, por ejemplo 200 000) y vuelva a implementar.-
Siga las instrucciones que se indican en la sección Anulaciones de configuración de Instalar y configurar Adobe Experience Manager Guides as a Cloud Service para crear el archivo de configuración.
-
En el archivo de configuración, proporcione los siguientes detalles (propiedad) para configurar las opciones
queryLimitReadsyqueryLimitInMemory:table 0-row-3 1-row-3 2-row-3 PID Clave de propiedad Valor de propiedad org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Value: 200000 Valor predeterminado: 100000 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Value: 200000 Valor predeterminado: 100000
-
-
Ejecute una solicitud de POST al servidor (con la autenticación correcta):
http://<server>//bin/guides/reports/upgrade. -
La API devuelve un jobId. Para comprobar el estado del trabajo, puede enviar una solicitud de GET con el ID del trabajo al mismo punto final:
http://<server>/bin/guides/reports/upgrade?jobId= {jobId}
(Por ejemplo:http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
Una vez finalizado el trabajo, la solicitud de GET anterior responde correctamente. Si el trabajo falla por algún motivo, los errores se pueden ver en los registros del servidor.
-
Revertir al valor existente predeterminado o anterior de
queryLimitReadssi lo ha cambiado en el paso 1.
Pasos para indexar el contenido existente para utilizar la nueva lista de temas y buscar y reemplazar en la pestaña Informes:
(Solo si tiene una versión anterior a la versión de junio de 2023 de Experience Manager Guides as a Cloud Service)
Realice los siguientes pasos para indexar el contenido existente y utilice el nuevo texto de buscar y reemplazar en el nivel de asignación y en la lista de temas de la pestaña Informes:
-
Ejecute una solicitud de POST al servidor (con la autenticación correcta):
http://<server:port>/bin/guides/map-find/indexing. (Opcional: puede pasar rutas específicas de los mapas para indexarlas, de forma predeterminada se indexarán todas las asignaciones|| Por ejemplo:https://<Server:port>/bin/guides/map-find/indexing?paths=<map_path_in_repository>) -
También se puede pasar una carpeta raíz para indexar las asignaciones DITA de una carpeta específica (y sus subcarpetas). Por ejemplo,
http://<server:port>/bin/guides/map-find/indexing?root=/content/dam/test. Tenga en cuenta que si se pasan tanto el parámetro de rutas como el parámetro raíz, solo se tendrá en cuenta el parámetro de rutas. -
La API devuelve un jobId. Para comprobar el estado del trabajo, puede enviar una solicitud de GET con el ID del trabajo al mismo punto final:
http://<server:port>/bin/guides/map-find/indexing?jobId={jobId}(por ejemplo:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
Una vez finalizado el trabajo, la solicitud de GET anterior responde correctamente y menciona si alguna asignación ha fallado. Los mapas indexados correctamente se pueden confirmar desde los registros del servidor.
Pasos para gestionar el conflicto 'fmdita rewriter'
Experience Manager Guides tiene un módulo reescritor de sling personalizado para administrar los vínculos generados en caso de mapas cruzados (vínculos entre los temas de dos mapas diferentes).
Si tiene otra reescritura de sling personalizada en la base de código, utilice un valor de 'order' mayor que 50, ya que la reescritura de sling de Experience Manager Guides utiliza 'order' 50. Para anular esto, necesita un valor >50. Para obtener más información, vea Canalizaciones de reescritura de salida.
Durante esta actualización, dado que el valor 'order' ha cambiado de 1000 a 50, debe combinar la reescritura personalizada existente, si la hay, con 'fmdita-rewriter'.
Matriz de compatibilidad
Esta sección enumera la matriz de compatibilidad para las aplicaciones de software compatibles con la versión de Experience Manager Guides as a Cloud Service para diciembre de 2023.
FRAMEMAKER y FRAMEMAKER PUBLISHING SERVER
Conector de oxígeno
Versión de plantilla de base de conocimiento
Problemas solucionados
A continuación se enumeran los errores corregidos en varias áreas:
Creación
- El Título de la ficha Editor web se trunca después de un punto (.) extra. (14372)
- No se ha actualizado la mensajería de error para nombres de mapa duplicados en la IU de Assets. (14320)
- Se produce un error en la lógica de creación de versiones al arrastrar y soltar recursos. (14291)
- El contenido reutilizable omite los ID de elemento. (14213)
- Falta el control de configuración para ocultar el panel Variables de idioma en la ficha Salida. (14194)
- El Editor Web genera errores de aplicación al agregar una nueva referencia o tema mediante un esquema especializado en la vista Presentación. (14094)
- Un vínculo de anclaje al elemento
<dlentry>o<dt>no puede mostrar el texto del vínculo. (13543) - La colección Favoritos del Editor web no se puede cargar. (13495)
- Las citas muestran vínculos en los que no se puede hacer clic cuando se crean con un ID único con espacios. (13447)
- En la vista Diseño para un Bookmap, al usar Mover a la derecha para hacer que un capítulo seleccionado sea un subelemento no funcione. (12567)
- La ventana de vista previa del Editor XML se trunca en los navegadores Google Chrome y Microsoft Edge. (10755)
- El editor web carece de la capacidad de envolver un elemento dentro de los posibles elementos principales. (8791)
Publicación
- Los componentes de Fodita tienen una ruta de acceso codificada de
delegator.jsp, lo que evita la superposición de los componentes de AEM Sites. (13993) - La vista etiquetada del reactor de PDF en la salida de publicación del PDF nativo no funciona como se esperaba. (13622)
- AEM La publicación de sitios encuentra un problema al comprometerse con el almacén de datos para mapas grandes con vínculos de igual a igual de ámbito. (13531)
- No se puede activar un sitio mediante el panel de publicación masiva de Experience Manager Guides. (13439)
- La localización de las etiquetas de elementos no funciona correctamente en la salida de AEM Sites. (12144)
- Falta la opción ditaval en los ajustes preestablecidos de salida de nivel de perfil de carpeta creados mediante la interfaz de usuario del editor web. (11903)
Administración
- AEM Los entornos de nube de se encuentran con la excepción MongoWrite debido a nodos de gran tamaño. (13509)
Traducción
- Los botones Aceptar/Rechazar aparecen erróneamente para la traducción humana aprobada automáticamente. (14318)
- AEM Los problemas de internacionalización (i18n) se producen durante la transformación de archivos DITA que no están en inglés a páginas de. (14286)
- El contenido traducido no se puede sincronizar desde proyectos de traducción temporales y el asistente de traducción del editor XML DITA muestra incorrectamente el estado En curso para los trabajos aprobados. (9938)
Accesibilidad
- No se puede navegar por la interfaz de usuario del lienzo de creación, ya que el enfoque queda atrapado en el editor de temas. (13517)
Problema conocido
El Adobe ha identificado el siguiente problema conocido para la versión de diciembre de 2023:
- "Error de DTD no válido" se produce de forma intermitente al actualizar a la versión de diciembre de 2023.