La activación del árbol falla con “Prefijo de área de nombres desconocido” durante la publicación masiva de recursos

Cuando publica recursos de forma masiva con Administrar publicación o Publicación rápida, AEM puede generar un error con el prefijo de espacio de nombres desconocido si uno o más recursos contienen propiedades de metadatos que utilizan un prefijo de espacio de nombres JCR no registrado. Registre el área de nombres que falta con el URI correcto usando repoinit y, a continuación, ejecute de nuevo la acción de publicación.

Descripción description

Entorno

Adobe Experience Manager (AEM) as a Cloud Service

Problema/Síntomas

Cuando se usa Administrar publicación (Activación de árbol) o Publicación rápida para publicar recursos de forma masiva desde una carpeta DAM, el flujo de trabajo de publicación falla con errores relacionados con un prefijo de espacio de nombres no registrado.

Los síntomas incluyen:

  • Administrar publicación produce un error o se detiene durante el flujo de trabajo de publicación.
  • Publicación rápida se realiza correctamente para recursos individuales o selecciones pequeñas, pero falla durante las acciones de publicación en lotes más grandes.
  • Algunos recursos se publican correctamente, pero el trabajo de publicación general falla.
  • Los registros de errores incluyen mensajes similares a:
javax.jcr.NamespaceException: Unknown namespace prefix: ns11
        ReplicationException: One or more agents failed to replicate.
        DistributionException: Failed to create content package
        ... failed to resolve namespace prefix

Este problema se produce cuando los recursos seleccionados incluyen propiedades de metadatos que utilizan un prefijo de espacio de nombres JCR no registrado, como ns11.

Causa raíz

El flujo de trabajo de publicación falla porque uno o varios recursos contienen metadatos con un prefijo de área de nombres JCR que no está registrado en el repositorio. Durante el empaquetado y la replicación de contenido, AEM no puede resolver ese prefijo, por lo que la operación de publicación masiva falla.

Resolución resolution

Para resolver el problema de error de activación del árbol, siga estos pasos:

  1. Revise los registros de errores de AEM e identifique el prefijo indicado en el error Prefijo de espacio de nombres desconocido.

  2. Utilice una secuencia de comandos de Groovy o una consulta JCR para enumerar áreas de nombres registradas e identificar recursos con propiedades de metadatos que utilizan prefijos no registrados.

  3. Agregue una configuración repoinit para registrar el prefijo del área de nombres que falta con su URI correcto.

  4. Utilice la siguiente sintaxis repoinit:

    code language-none
    register namespace (ns11) http://your-namespace-uri
    
  5. Implemente la configuración repoinit a través de su proyecto de AEM as a Cloud Service para registrar el área de nombres en el entorno de destino.

  6. Compruebe que el área de nombres está registrada ejecutando un script Groovy o comprobando el registro de área de nombres JCR.

  7. Vuelva a ejecutar Administrar publicación o Publicación rápida para los recursos o la carpeta afectados.

  8. Confirme que los recursos que anteriormente fallaban debido al área de nombres no registrada ahora se publican correctamente.

Nota adicional

Utilice el URI correcto para el prefijo del espacio de nombres al registrarlo. AEM requiere una asignación de prefijo a URI válida para las propiedades de metadatos que utilizan áreas de nombres personalizadas.

Lectura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles