DocumentaciónAEM GuidesDocumentación de AEM Guides

Configuración adicional para actualizar AEM Guides as a Cloud Service

Last update: Tue Mar 17 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Usuario
INFO
Este artículo se aplica si ha configurado la configuración de perfil de carpeta personalizada (ui_config.json). Después de cada actualización, revise y modifique la configuración según sea necesario para garantizar la compatibilidad con los cambios más recientes.

Según la versión desde la que realice la actualización, es posible que se requieran pasos de configuración adicionales para integrar los cambios introducidos en las versiones más recientes de Cloud Service.

Algunas configuraciones solo se aplican a versiones específicas. Asegúrese de consultar las secciones de configuración que aparecen a continuación y aplicar las configuraciones necesarias aplicables a su configuración.

Pasos para aplicar filtros de búsqueda en archivos DITAVAL para todos los ajustes preestablecidos de salida

Para asegurarse de que los filtros funcionan correctamente, actualice ui_config.json. Cambie las propiedades enumeradas en browseFilters > Archivos no DITA > Archivos Ditaval como se muestra a continuación:

{
  "title": "Ditaval Files",
  "property": "LOWER_NAME",
  "operation": "like",
  "value": ".ditaval"
}

Pasos para realizar la migración de árbol B para fragmentos de contenido

Si las referencias no se muestran para los fragmentos de contenido, puede optar por ejecutar el trabajo de migración:

PUBLICACIÓN:

http://localhost:4503/bin/guides/script/start?jobType=cf-reference-store-btree-migration

Respuesta:

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886",
"status": "SCHEDULED"
}

En la respuesta anterior, JSON, la clave lockNodePath contiene la ruta de acceso al nodo creado en el repositorio, que apunta al trabajo enviado. Se eliminará automáticamente una vez completado el trabajo. 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.

NOTE
Debe comprobar si el nodo sigue presente y el estado del trabajo.

GET:

http://<aem_domain>/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886.json

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.

Configuraciones aplicables a las versiones anteriores a junio de 2023

Las siguientes configuraciones solo son necesarias si utiliza una versión de Experience Manager Guides as a Cloud Service publicada antes de junio de 2023. Expanda las secciones relevantes a continuación para aplicar la configuración necesaria y garantizar la compatibilidad con las actualizaciones necesarias.

Pasos para indexar el contenido existente para utilizar la nueva lista de temas y buscar y reemplazar en la pestaña Informes

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:

  1. Ejecute una petición POST en el servidor (con la autenticación correcta): http://<server:port>/bin/guides/map-find/indexing. (Opcional: puede pasar rutas específicas de las asignaciones para indexarlas; de forma predeterminada, todas las asignaciones están indexadas|| Ejemplo: https://<Server:port>/bin/guides/map-find/indexing?paths=<path of the MAP in repository>)

  2. 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.

  3. 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/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678)

  4. Una vez completado 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 publicar y procesar el contenido existente a fin de utilizar el informe de vínculos rotos

Realice los siguientes pasos para posprocesar el contenido existente y utilizar el nuevo informe de vínculos rotos:

  1. (Opcional) Si hay más de 100 000 archivos DITA en el sistema, actualice queryLimitReads y queryLimitInMemory en org.apache.jackrabbit.oak.query.QueryEngineSettingsService a un valor mayor (cualquier valor mayor que el número de recursos presentes, por ejemplo 200 000) y vuelva a implementar.

    • Siga las instrucciones de la sección Anulaciones de configuración en 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 queryLimitReads y queryLimitInMemory:

      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

  2. Ejecute una petición POST en el servidor (con la autenticación correcta): http://<server>//bin/guides/reports/upgrade.

  3. 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)

  4. Una vez completado el trabajo, la solicitud de GET anterior responde correctamente. Si el trabajo falla por algún motivo, el error se puede ver en los registros del servidor.

  5. Volver al valor predeterminado o anterior existente de queryLimitReads si lo ha cambiado en el paso 1.

Pasos para activar el déclencheur de una secuencia de comandos mediante un servlet

Una vez finalizada la instalación, puede elegir iniciar el trabajo de traducción:

PUBLICACIÓN:

code language-none 
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

Respuesta:

code language-none 
{
"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 elimina automáticamente una vez finalizado el trabajo y, 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.

note note
NOTE
Debe comprobar si el nodo sigue presente y el estado del trabajo.
code language-none 
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178