Solución de problemas de Experience Modernization Agent troubleshooting

Busque el síntoma y siga su sección. La mayoría de los problemas provienen del acceso al sitio de origen, de las cuentas que escriben código y contenido en el sitio Edge Delivery Services de Adobe Experience Manager o de una diferencia entre el espacio de trabajo de la consola y lo que se guarda en Git y en el origen de contenido.

Síntoma
Sección
Se produce un error en una importación o una página capturada muestra un error o una página de inicio de sesión.
Error de importación
Las direcciones URL faltan después del descubrimiento o el sitio de origen devuelve HTTP 403, 429 o 503.
Sitios Source con protección para bots
Un cambio que has hecho no aparece.
Falta Un Cambio
La vista previa de la consola no coincide con el sitio de vista previa.
La vista previa de la consola difiere del sitio
Se produce un error en la carga, la extracción o la transferencia.
Error al escribir contenido
La consola no muestra el repositorio o no puede insertarlo en él.
Problemas De Conexión De Git
La consola sigue preparando el espacio de trabajo.
La instalación de Workspace tarda tiempo o falla
El proyecto desaparece después de iniciar sesión.
Parece Que Falta El Proyecto
No se pudo enviar el mensaje. Inténtelo de nuevo.
No se pudo enviar el mensaje
Debe eliminar las páginas importadas.
Quitar páginas

Antes de restablecer, descartar, reemplazar o sobrescribir cualquier elemento, conserve el trabajo afectado. El código y el contenido se recuperan por separado; consulte Liberar, recuperar y entregar.

Si esta página no resuelve el problema, solicita ayuda en la consola o selecciona Obtener ayuda en las páginas del modo automático.

Error de importación import-fails

Mantenga el error y la dirección URL de origen exacta y compruebe que la dirección URL se abre en un explorador. Si las páginas requieren inicio de sesión o una captura muestra una página de inicio de sesión en lugar del contenido, configure autenticación de sitio protegido. Si el sitio de origen bloquea el acceso automatizado, consulte Sitios Source con protección para bots. Si se puede acceder al origen, proporcione al agente el error y pídale que corrija la importación de esa página. Vuelva a intentar una página afectada antes de repetir un lote.

Source Sites con protección de bots bot-protection

La protección contra bots en una red de distribución de contenido (CDN) o un cortafuegos de aplicaciones web (WAF) puede bloquear o desafiar las solicitudes del agente a un sitio de origen en cada flujo de trabajo: detección de URL, catálogo de sitios, captura de páginas e importación. Los signos habituales son errores de acceso denegado, como HTTP 403, 429 o 503, direcciones URL que faltan después de la detección, páginas con errores o una página de desafío o verificación capturada en lugar del contenido de la página.

Migre solo los sitios que le pertenecen o que están autorizados a migrar. Organice el acceso con el administrador del sitio en lugar de solucionar el problema de la protección:

  1. Pida al administrador que permita el acceso durante el período de migración, por ejemplo, mediante la inclusión en la lista de permitidos de las direcciones back-end en CDN o WAF.
  2. Si la protección acepta una credencial en su lugar, como un encabezado de solicitud secreto, ingréselo en los controles de autenticación que ofrece el flujo de trabajo, como Autenticación de sitio protegido en la configuración de la consola. Use una credencial con ámbito y quítela cuando se complete la migración.
  3. Si el administrador proporciona un host de origen o ensayo accesible con el mismo contenido, utilícelo como origen y registre de dónde procede el contenido.
  4. Si solo se bloquea la detección, proporcione la lista de direcciones URL de la página que se migrarán.

Compruebe una página, incluidas sus imágenes y otros recursos, antes de iniciar un catálogo o una ejecución por lotes. Después de cambiar el acceso, vuelva a intentar las páginas con errores y compruebe si hay capturas de páginas con desafío o acceso denegado antes de aceptar el contenido.

Direcciones IP de lista de permitidos allowlist-ip-addresses

Con la aprobación del administrador del sitio de origen, lista de permitidos estas direcciones back-end para la extracción de origen:

  • 34.228.136.112
  • 54.90.51.39
  • 3.224.194.242

La inclusión en la lista de permitidos solo proporciona acceso a la red: el origen debe seguir siendo accesible a través de Internet y las páginas protegidas siguen necesitando Autenticación de sitio protegido.

Falta Un Cambio missing-change

El código y el contenido se guardan en diferentes lugares, por lo que debe comprobar cada uno: el espacio de trabajo de la consola, el contenido cargado, la rama insertada y la página de vista previa. Una reimportación sobrescribe los cambios del contenido local, por lo que debe cargar o reconciliar las ediciones antes de volver a importar una página. Para comparar la vista previa de la consola con el sitio de vista previa, vea La vista previa de la consola difiere del sitio.

La vista previa de consola difiere del sitio preview-differs

La vista previa de la consola y el sitio de vista previa muestran diferentes copias del contenido y el código, como explica Saber qué resultado está viendo. Busque una de estas causas:

  • Contenido no cargado: Las páginas cambiadas en la consola aún no están en Experience Workspace. Cárgalos con Sync > Push > Contenido.
  • Contenido editado en otra parte: Las páginas cambiadas en Experience Workspace aún no se encuentran en el espacio de trabajo de la consola. Extraerlos con Sync > Pull > Content, que sobrescribe las ediciones locales en esas páginas; Refresh solo vuelve a cargar la renderización.
  • Código diferente: El código no se inserta o la dirección URL de vista previa usa otra rama. Inserte el código y abra la URL de vista previa de la rama que lo tiene.
  • Anchura diferente: La vista previa de la consola rellena el panel de forma predeterminada. Compara con la misma anchura, usando el menú de la ventanilla.
  • Marcado que quita el sitio de vista previa: Edge Delivery Services guarda solamente secciones, bloques y contenido predeterminado, por lo que se pierde el estilo dentro del marcado de la página. Pida al agente que lo mueva al archivo CSS del proyecto. Ver Cómo funciona la vista previa.

Error de escritura de contenido write-errors

El código y el contenido utilizan cuentas diferentes. El código se inserta con la conexión de GitHub o con la conexión de Cloud Manager para otros hosts de Git. El contenido se escribe en Experience Workspace con la cuenta de Adobe con la que inició sesión. Por lo tanto, una inserción de código puede realizarse correctamente mientras falla la carga de contenido o al contrario.

Si una carga, extracción o transferencia indica que la sesión de creación de documentos ha caducado, vuelva a iniciar sesión y vuelva a intentarlo. La consola muestra el mismo mensaje cuando la sesión es válida, pero la cuenta de Adobe no tiene acceso de escritura al contenido del sitio. Si continúa, pídale al administrador del sitio que confirme que su cuenta, con la dirección de correo electrónico y la organización que utiliza en la consola, puede escribir en el sitio en Experience Workspace. El acceso a Experience Manager en Adobe Admin Console no concede por sí solo acceso de escritura al contenido de un sitio. Si la consola indica que tiene una velocidad limitada, espere un minuto y vuelva a intentarlo.

Problemas de conexión de Git git-connection

Para ver lo que hace cada aplicación de GitHub, consulte Iniciar desde un repositorio.

Problema
Qué hacer
Su organización o repositorio no aparece en la lista.
La aplicación AEM Code Connector no aparece en la organización o cuenta, solo cubre otros repositorios seleccionados o espera la aprobación del propietario de una organización. Añádalo tal como se describe en Comenzar desde un repositorio. Con un token de acceso personal, la consola solo enumera los repositorios a los que puede insertar.
No cuenta con acceso de escritura para el repositorio.
La conexión necesita acceso push. Solicite a un administrador de repositorio acceso de escritura o conecte otro repositorio.
La consola no puede comprobar la URL de vista previa.
Sin la sincronización de código de AEM en el repositorio, el sitio no tiene una URL de vista previa. Compruebe que la aplicación esté allí y que la dirección URL siga el patrón https://{branch}--{site}--{organization}.aem.page.
Se deshabilitó la inserción hasta que se instaló la aplicación AEM Code Connector, o se requiere AEM Code Connector.
La consola puede leer el repositorio pero no escribir en él: AEM Code Sync permite que Edge Delivery Services lea su código y solo AEM Code Connector permite que la consola lo cambie. Agregue el conector de código AEM al repositorio.
Token no válido o caducado, o bien el token carece de acceso de lectura de usuario.
Cree un nuevo token. Utilice un token clásico o un token preciso que pueda leer su cuenta de usuario y escribir en el contenido del repositorio.
Permitir que LLM use mis credenciales de Git no está en Configuración.
La configuración aún no está disponible para usted. El agente aún puede cambiar el código en el área de trabajo de la consola. Envíelo usted mismo con Sync > Push > Code.
Inserción denegada: necesita la función Administrador de implementación en Cloud Manager.
Para un repositorio conectado a través de Cloud Manager, solicite al administrador la función Administrador de implementación en Cloud Manager.

Para ver cambios conflictivos y ramas protegidas, consulte Cambios en el código push.

La configuración de Workspace tarda o falla workspace-setup

La preparación de un espacio de trabajo tarda hasta 10 minutos, la primera vez que se inicia sesión y después de un restablecimiento. Si todos los espacios de trabajo están en uso, la consola se lo indica y comienza a configurar los suyos en cuanto hay uno disponible; no es necesario que lo vuelva a intentar. Si lo necesita antes, seleccione Solicitar asistencia. Si la configuración falla, la consola ofrece la opción de reintentar. Si sigue fallando, usa el vínculo Solicitar asistencia en la pantalla de configuración. Si la consola indica que su cuenta no puede utilizarla, póngase en contacto con el equipo de la cuenta de Adobe. Para un área de trabajo que muestra Su área de trabajo está en pausa, consulte Abrir la consola de modernización de experiencias.

El proyecto parece faltar missing-workspace

Si pertenece a varias organizaciones de Adobe, es posible que el proyecto se encuentre en el espacio de trabajo de la consola de otra organización. Cierre sesión, luego inicie sesión con la misma cuenta y elija el perfil de la organización que utilizó anteriormente. No restablezca el espacio de trabajo mientras investiga: un restablecimiento elimina el trabajo que no ha insertado. Si el proyecto aún no se encuentra, solicite soporte técnico con el nombre del proyecto y la URL de vista previa. El código insertado y el contenido cargado son seguros en el repositorio Git y en el origen de contenido de cualquier manera.

Error al enviar mensaje send-failed

No se pudo enviar el mensaje. Inténtelo de nuevo. significa que la consola no pudo entregar el mensaje al agente. El mensaje no indica la causa, que puede ser la conexión de red, un inicio de sesión caducado o un problema temporal del servicio.

  1. Compruebe la conexión de red y vuelva a enviar la solicitud. La consola no se reintenta automáticamente.
  2. Si vuelve a fallar, copie el mensaje, vuelva a cargar la página e inicie sesión si se le solicita. Se conserva su historial de chat.
  3. Si sigue fallando después de unos minutos, usa Solicitar soporte técnico en Configuración, con la hora del error y el nombre de tu proyecto.

Si la consola indica que está a plena capacidad, consulte La configuración de Workspace tarda o falla.

Eliminar páginas remove-pages

Una protección en la consola impide que el agente elimine archivos en la carpeta de contenido del proyecto, de modo que el contenido migrado no se elimine por error. Por lo tanto, no funciona pedir al agente que elimine páginas. Elimínelos usted mismo, en cada lugar donde existan:

  • Espacio de trabajo de la consola: En una vista de contenido, seleccione la página y use Eliminar, página por página. Esto elimina únicamente la copia del espacio de trabajo de la consola.
  • Origen del contenido: Elimine las páginas cargadas en Experience Workspace o en la instancia de autor. Hasta que lo haga, la página que haya eliminado en la consola volverá a aparecer en la vista de contenido con un icono de nube.
  • Vista previa y sitios activos: Cancele la publicación o elimine las páginas publicadas y con vista previa con AEM Sidekick.

Si las páginas se importaron en una ruta incorrecta, impórtelas de nuevo en la ruta correcta, compruébelas y, a continuación, elimine las copias en la ruta incorrecta.

recommendation-more-help
experience-manager-cloud-service-help-main-toc