Configuraciones y el explorador de configuración

AEM configuraciones sirven para administrar la configuración en AEM y servir como espacios de trabajo.

¿Qué es una configuración?

Se puede considerar una configuración desde dos puntos de vista diferentes.

• Un administrador utiliza las configuraciones como espacios de trabajo dentro de AEM para definir y administrar grupos de configuraciones.
• Un desarrollador utiliza el mecanismo de configuración subyacente que implementa las configuraciones para persistir y buscar los ajustes en AEM.

En resumen: desde el punto de vista del administrador, las configuraciones son la forma en que se crean los espacios de trabajo para administrar la configuración en AEM, mientras que el desarrollador debe comprender cómo AEM utiliza y administra estas configuraciones dentro del repositorio.

Independientemente de su perspectiva, las configuraciones tienen dos propósitos principales en AEM:

• Las configuraciones habilitan ciertas funciones para determinados grupos de usuarios.
• Las configuraciones definen los derechos de acceso para esas funciones.

Configuraciones como administrador

Tanto el administrador de AEM como los autores pueden considerar las configuraciones como espacios de trabajo. Estos espacios de trabajo se pueden utilizar para reunir grupos de configuraciones, así como el contenido asociado, con fines organizativos, mediante la implementación de derechos de acceso para dichas funciones.

Se pueden crear configuraciones para muchas funciones distintas dentro de AEM.

• Configuraciones de nube
• Segmentos de Context Hub
• Modelos de fragmento de contenido
• Plantillas editables

Ejemplo

Por ejemplo, un administrador puede crear dos configuraciones para Plantillas editables.

• WKND-General
• WKND-Magazine

A continuación, el administrador puede crear plantillas de página generales mediante la configuración de WKND-General y, a continuación, plantillas específicas de la revista en WKND-Magazine.

El administrador puede luego asociar el WKND-General con todo el contenido del sitio WKND. Sin embargo, la configuración de WKND-Magazine solo se asociaría con el sitio de la revista.

Haciendo esto:

• Cuando un autor de contenido crea una nueva página para la revista, puede elegir entre plantillas generales (WKND-General) o plantillas de revista (WKND-Magazine).
• Cuando un autor de contenido crea una nueva página para otra parte del sitio que no es la revista, solo puede elegir entre las plantillas generales (WKND-General).

Se pueden realizar configuraciones similares no solo para plantillas editables, sino también para configuraciones de nube, segmentos de ContextHub y modelos de fragmentos de contenido.

Uso del navegador de configuración

El navegador de configuración permite a un administrador crear, administrar y configurar fácilmente los derechos de acceso a las configuraciones en AEM.

Creación de una configuración

Es muy sencillo crear una nueva configuración en AEM mediante el navegador de configuración.

1. Inicie sesión en AEM como Cloud Service y, en el menú principal, seleccione Herramientas -> General -> Navegador de configuración.

2. Haga clic o pulse Crear.

3. Proporcione un Título y un Nombre para la configuración.

   

   • El Título debe ser descriptivo.
   • El Nombre se convertirá en el nombre del nodo en el repositorio.
     • Se generará automáticamente en función del título y se ajustará en función de convenciones de nombres de AEM.
     • Puede ajustarse si es necesario.

4. Compruebe el tipo de configuraciones que desea permitir.

   • Configuraciones de nube
   • Segmentos de Context Hub
   • Modelos de fragmento de contenido
   • Plantillas editables

5. Haga clic o pulse Crear.

Edición de configuraciones y sus derechos de acceso

Si considera que las configuraciones son espacios de trabajo, se pueden establecer derechos de acceso en esas configuraciones para imponer quién puede acceder a esos espacios de trabajo y quién no.

1. Inicie sesión en AEM como Cloud Service y, en el menú principal, seleccione Herramientas -> General -> Navegador de configuración.
2. Seleccione la configuración que desee modificar y toque o haga clic en Propiedades en la barra de herramientas.
3. Seleccione las funciones adicionales que desee agregar a la configuración
   NOTA

   Una vez creada la configuración, no es posible anular la selección de una función.

   1. Utilice el botón **Permisos efectivos** para vista de una matriz de funciones y los permisos que se otorgan actualmente a las configuraciones. 
4. Para asignar nuevos permisos, introduzca el nombre de usuario o grupo en el campo Seleccionar usuario o grupo de la sección Añadir nuevos permisos.
   • El campo Seleccionar usuario o grupo oferta la finalización automática en función de los usuarios y roles existentes.
5. Seleccione el usuario o la función correspondiente en los resultados de autocompletar.
   • Puede seleccionar más de un usuario o función.
6. Compruebe las opciones de acceso que deben tener los usuarios o roles seleccionados y haga clic en Añadir.
   
7. Repita los pasos para seleccionar usuarios o funciones y asignar derechos de acceso adicionales según sea necesario.
8. Toque o haga clic en Guardar y cerrar cuando termine.

Configuraciones como programador

Como desarrollador, es importante saber cómo AEM como Cloud Service trabaja con las configuraciones y cómo procesa la resolución de la configuración.

Separación de configuración y contenido

Aunque el administrador y los usuarios pueden considerar las configuraciones como lugares de trabajo para administrar diferentes configuraciones y contenido, es importante comprender que las configuraciones y el contenido se almacenan y administran por separado por AEM en el repositorio.

• /content es el hogar de todo el contenido.
• /conf es el hogar de toda la configuración.

El contenido hace referencia a su configuración asociada mediante una propiedad cq:conf. AEM realiza una búsqueda basada en el contenido y es la propiedad contextual cq:conf para encontrar la configuración adecuada.

Ejemplo

Para este ejemplo, supongamos que tiene algún código de aplicación que esté interesado en la configuración de DAM.

Conf conf = resource.adaptTo(Conf.class);
ValueMap imageServerSettings = conf.getItem("dam/imageserver");
String bgkcolor = imageServerSettings.get("bgkcolor", "FFFFFF");

El punto de partida de todas las búsquedas de configuración es un recurso de contenido, generalmente en algún lugar bajo /content. Podría ser una página, un componente dentro de una página, un recurso o una carpeta DAM. Este es el contenido real para el que buscamos la configuración correcta que se aplica en este contexto.

Ahora, con el objeto Conf en la mano, podemos recuperar el elemento de configuración específico en el que estamos interesados. En este caso es dam/imageserver, que es una colección de configuraciones relacionadas con imageserver. La llamada getItem devuelve un ValueMap. Luego leemos una propiedad de cadena bgkcolor y proporcionamos un valor predeterminado de "FFFFFF" en caso de que la propiedad (o el elemento de configuración completo) no esté presente.

Ahora veamos el contenido JCR correspondiente:

/content/dam/wknd
    + jcr:content
      - cq:conf = "/conf/wknd"
    + image.png [dam:Asset]

/conf/wkns
    + settings
      + dam
        + imageserver [cq:Page]
          + jcr:content
            - bgkcolor = "FF0000"

En este ejemplo, asumimos una carpeta DAM específica de WKND aquí y una configuración correspondiente. A partir de esa carpeta /content/dam/wknd, veremos que hay una propiedad de cadena denominada cq:conf que hace referencia a la configuración que debe aplicarse al subárbol. La propiedad generalmente se establece en jcr:content de una carpeta o página de recursos. Estos vínculos conf son explícitos, por lo que es fácil seguirlos con solo mirar el contenido en CRXDE.

Al saltar dentro de /conf, seguimos la referencia y vemos que hay un nodo /conf/wknd. Esta es una configuración. Tenga en cuenta que su búsqueda es completamente transparente para el código de la aplicación. El código de ejemplo nunca tiene una referencia dedicada a él, está oculto detrás del objeto Conf. La configuración que se aplica se controla completamente a través del contenido JCR.

Vemos que la configuración contiene un nodo con nombre fijo settings que contiene los elementos reales, incluido el dam/imageserver que necesitamos en nuestro caso. Este elemento se puede considerar como un "documento de configuración" y generalmente se representa mediante un cq:Page que incluye un jcr:content que contiene el contenido real.

Finalmente, vemos la propiedad bgkcolor que necesita nuestro código de muestra. El ValueMap que obtenemos de getItem se basa en el nodo jcr:content de la página.

Resolución de configuración

El ejemplo básico anterior mostraba una configuración única. Sin embargo, hay muchos casos en los que desea tener configuraciones diferentes, como una configuración global predeterminada, una diferente para cada marca y tal vez una específica para sus subproyectos.

Para admitir esto, la búsqueda de configuración en AEM tiene herencia y mecanismo de reserva en el siguiente orden de preferencia:

1. /conf/<siteconfig>/<parentconfig>/<myconfig>
   • Configuración específica referenciada desde cq:conf en algún lugar de /content
   • La jerarquía es arbitraria y se puede diseñar de la misma manera que la estructura del sitio, no es asunto del código de la aplicación saber esto
   • Modificable en tiempo de ejecución por usuarios con privilegios de configuración
2. /conf/<siteconfig>/<parentconfig>
   • Padres de recorrido para configuraciones de reserva
   • Modificable en tiempo de ejecución por usuarios con privilegios de configuración
3. /conf/<siteconfig>
   • Padres de recorrido para configuraciones de reserva
   • Modificable en tiempo de ejecución por usuarios con privilegios de configuración
4. /conf/global
   • Configuración global del sistema
   • Generalmente valores predeterminados globales para la instalación
   • Configurado por una función admin
   • Modificable en tiempo de ejecución por usuarios con privilegios de configuración
5. /apps
   • Valores predeterminados de la aplicación
   • Se ha corregido la implementación de la aplicación
   • Sólo lectura en tiempo de ejecución
6. /libs
   • Valores predeterminados del producto AEM
   • Solo se puede cambiar por Adobe, no se permite el acceso al proyecto
   • Se ha corregido la implementación de la aplicación
   • Sólo lectura en tiempo de ejecución

Uso de configuraciones

Las configuraciones de AEM se basan en configuraciones según el contexto de Sling. Los paquetes de Sling proporcionan una API de servicio que puede utilizarse para obtener configuraciones según el contexto. Las configuraciones según el contexto son configuraciones que están relacionadas con un recurso de contenido o un árbol de recursos como se describió en el ejemplo anterior.

Para obtener más información sobre las configuraciones según el contexto, ejemplos y cómo utilizarlos, consulte la documentación de Sling.

ConfMgr Web Console

Para fines de depuración y prueba, existe una consola Web ConfMgr en https://<host>:<port>/system/console/conf, que puede mostrar configuraciones para una ruta/elemento determinado.

Simplemente proporcione:

• Ruta de contenido
• Elemento
• Usuario

Haga clic en Resolver para ver qué configuraciones se resuelven y recibir código de muestra que resuelva dichas configuraciones.

Consola Web de configuración según el contexto

Para depurar y probar, existe una consola web de configuración según el contexto en https://<host>:<port>/system/console/slingcaconfig, que permite consultar las configuraciones según el contexto en el repositorio y ver sus propiedades.

Simplemente proporcione:

• Ruta de contenido
• Nombre de configuración

Haga clic en Resolver para recuperar las rutas y propiedades de contexto asociadas para la configuración seleccionada.

Recursos de Business.Adobe.com