URL mnemónicas de Dispatcher | AEM

Este documento le ayudará a comprender cómo gestiona Adobe Experience Manager las URL personalizadas y las técnicas adicionales, como el uso de reglas de reescritura para acercar el contenido al límite de la entrega.

Descripción description

Entorno

Adobe Experience Manager

Problemas/Síntomas

AEM ¿Cómo trata la con las direcciones URL mnemónicas? ¿Existen técnicas adicionales para asignar contenido más cerca del borde del envío?

¿Qué son las URL mnemónicas?

Cuando tiene contenido que se aloja en una estructura de carpetas lógica, no siempre vive en una dirección URL de referencia fácil. Las URL mnemónicas son como accesos directos. Direcciones URL únicas o más cortas que hacen referencia al lugar donde se encuentra el contenido real.

Un ejemplo: /aboutus apuntó a /content/we-retail/us/en/about-us.html

AEM AEM Los autores de tienen la opción de establecer propiedades de URL mnemónicas en un fragmento de contenido de y publicarlo.

Para que funcione, tendrá que ajustar los filtros de Dispatcher para permitir el elemento mnemónico. Esto no es razonable con el ajuste de los archivos de configuración de Dispatcher a la velocidad que los autores necesitarían para configurar estas entradas de página mnemónicas.

Por este motivo, el módulo de Dispatcher tiene una función para permitir automáticamente cualquier elemento enumerado como mnemónico en el árbol de contenido.

Resolución resolution

¿Cómo funciona?

Creación de URL mnemónicas

AEM El autor visita una página en, y las propiedades de la página, y las entradas del complemento en la sección de la URL de vanidad, en la página de inicio.

Una vez que guardan los cambios y activan la página, el elemento mnemónico se asigna a esta página.

IU táctil:

Buscador de contenido clásico:

Nota: Tenga en cuenta que esto es muy vulnerable a problemas con el área de nombres. Las entradas mnemónicas son globales para todas las páginas. Esta es solo una de las deficiencias para las que debe planificar las soluciones. Explicaremos algunas de ellas más adelante.

Asignación/resolución de recursos:

Cada entrada mnemónica es una entrada de mapa sling para una redirección interna. AEM Estos mapas se pueden ver en la consola Felix de instancias de la instancia de la aplicación (/system/console/jcrresolver)

Esta es una captura de pantalla de una entrada de mapa creada por una entrada mnemónica:

AEM En el ejemplo anterior, cuando solicitamos a la instancia de que visite /aboutus, se resolverá en /content/we-retail/us/en/about-us.html

Filtros de permiso automático de Dispatcher:

Dispatcher en un estado seguro filtra las solicitudes en la ruta / a través de Dispatcher porque esa es la raíz del árbol JCR.

Es importante asegurarse de que los editores solo permitan contenido de /content y otras rutas seguras, etc. y no rutas como /system, etc.

Aquí están las URL mnemónicas activas en la carpeta base de /. Entonces, ¿cómo les permitimos llegar a los editores mientras se mantienen seguros?

AEM El Dispatcher simple tiene un mecanismo de autorización de filtro automático y debe instalar un paquete de y luego configurar el Dispatcher para que se oriente a esa página de paquetes. AEM Visite aquí para obtener el paquete de.

Dispatcher tiene una sección de configuración en su archivo de granja de servidores:

/vanity_urls {      /url    "/libs/granite/dispatcher/content/vanityUrls.html"
  /file   "/tmp/vanity_urls"      /delay  300 }

Esta configuración indica a Dispatcher AEM que recupere esta URL de su instancia de que se abre cada 300 segundos para recuperar la lista de los elementos que queremos permitir.

Almacena su caché de la respuesta en el argumento /file; en este ejemplo, /tmp/vanity_urls.

AEM Por lo tanto, si visita la instancia de en la URI, verá lo que arroja:

Es una lista muy sencilla.

Reescribir reglas como reglas mnemónicas

AEM ¿Por qué mencionamos el uso de reglas de reescritura en lugar del mecanismo predeterminado integrado en el código de tiempo de ejecución, tal como se describe más arriba

Se explican sencillamente los problemas de área de nombres, rendimiento y lógica de nivel superior que se pueden gestionar mejor.

Veamos un ejemplo de la entrada mnemónica /aboutus de su contenido /content/we-retail/us/en/about-us.html mediante el módulo mod_rewrite de Apache para lograr esto.

RewriteRule /aboutus /content/we-retail/us/en/about-us.html PT,L,NC

Esta regla buscará el elemento mnemónico /aboutus y recuperará la ruta completa del procesador con el indicador PT (Pasar).

También dejará de procesar todas las demás reglas del indicador L (Última), lo que significa que no tendrá que atravesar una enorme lista de reglas como la resolución JCR.

AEM Además de no tener que representar la solicitud y esperar a que el editor de la responda a estos dos elementos de este método, se hace mucho más eficaz.

A continuación, la cereza del pastel aquí es la marca NC (sin distinción de mayúsculas y minúsculas), lo que significa que si cambia la dirección URL por /Aboutus en lugar de /aboutus, seguirá funcionando y se recuperará la página correcta.

Para crear una regla de reescritura, debe crear un archivo de configuración en Dispatcher (ejemplo: /etc/httpd/conf.d/rewrites/examplevanity_rewrite.rules) e incluirlo en el archivo .vhost que administra el dominio que necesita aplicar estas URL de vanidad.

Este es un ejemplo de fragmento de código de la inclusión dentro de:

/etc/httpd/conf.d/enabled_vhosts/we-retail.vhost
 VirtualHost *:80    ServerName    weretail.com    ServerAlias

www.weretail.com        ........ SNIP ........     IfModule mod_rewrite.c

   ReWriteEngine    on       LogLevel warn rewrite:info

Include /etc/httpd/conf.d/rewrites/examplevanity_rewrite.rules      / IfModule
   ........ SNIP ......../VirtualHost

¿Qué método y dónde utilizarlo?

AEM R. Usar el control de las entradas mnemónicas por parte de los usuarios tiene las siguientes ventajas:

B. Usar mod_rewrite para controlar las entradas personales ofrece las siguientes ventajas:

C. Utilice ambos métodos, pero aquí están los consejos y criterios que debe utilizar cuando:

AEM Nota: Si desea usar la característica de vanidad de la y evitar el área de nombres, puede crear una convención de nomenclatura. Usando URL personales anidadas como /brand1/aboutus, brand2/aboutus, brand3/aboutus