Configuraciones y el explorador de configuración

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

¿Qué es una configuración?

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

  • Un administrador utiliza 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 mantener y buscar ajustes en AEM.

En resumen: desde el punto de vista de un administrador, las configuraciones son cómo se crean 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 recopilar grupos de configuraciones juntas, así como su contenido asociado con fines organizativos mediante la implementación de derechos de acceso para esas funciones.

Las configuraciones se pueden crear para muchas funciones diferentes dentro de AEM.

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 utilizando la configuración de WKND-General y, a continuación, plantillas específicas para la revista en WKND-Magazine.

El administrador puede 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 página nueva para la revista, el autor puede elegir entre plantillas generales (WKND-General) o plantillas de revista (WKND-Magazine).
  • Cuando un autor de contenido crea una página nueva para otra parte del sitio que no es la revista, el autor 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 explorador 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.

NOTA

Solo es posible crear configuraciones utilizando el navegador de configuración si el usuario tiene admin derechos. admin también se requieren para asignar derechos de acceso a la configuración o modificar una configuración de otro modo.

Creación de una configuración

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

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

  2. Haga clic o pulse en Crear.

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

    Crear configuración

    • El Título debe ser descriptivo.
    • El Nombre se convertirá en el nombre de nodo en el repositorio.
  4. Compruebe el tipo de configuraciones que desea permitir.

  5. Haga clic o pulse en Crear.

SUGERENCIA

Las configuraciones se pueden anidar.

Edición de configuraciones y sus derechos de acceso

Si piensa en las configuraciones como espacios de trabajo, se pueden establecer derechos de acceso en esas configuraciones para hacer cumplir quién puede acceder a esos espacios de trabajo y quién no.

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

    No es posible anular la selección de una función una vez creada la configuración.

    1. Utilice la variable **Permisos efectivos** para ver una matriz de funciones y qué permisos se conceden actualmente a las configuraciones. ![Ventana de permisos efectivos](/docs/experience-manager-cloud-service/assets/configuration-effective-permissions.png?lang=es)
  4. Para asignar nuevos permisos, introduzca el nombre de usuario o grupo en la Seleccionar usuario o grupo en el campo Agregar nuevos permisos para obtener más información.
    • La variable Seleccionar usuario o grupo El campo ofrece la finalización automática en función de los usuarios y funciones existentes.
  5. Seleccione el usuario o función apropiado 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 funciones seleccionados y haga clic en Agregar.
    Añadir derechos de acceso a una configuración
  7. Repita los pasos para seleccionar usuarios o funciones y asigne derechos de acceso adicionales según sea necesario.
  8. Toque o haga clic Guardar y cerrar cuando termine.

Configuraciones como Desarrollador

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

Separación de configuración y contenido

Aunque la variable 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 mediante AEM en el repositorio.

  • /content es el hogar de todo el contenido.
  • /conf es el hogar de todas las configuraciones.

El contenido hace referencia a su configuración asociada a través de una cq:conf propiedad. AEM realiza una búsqueda basada en el contenido y su contexto 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, normalmente en algún lugar de /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 la variable Conf podemos recuperar el elemento de configuración específico que nos interese. En este caso, es dam/imageserver, que es una colección de configuraciones relacionadas con el imageserver. La variable getItem la llamada devuelve un valor ValueMap. Luego leemos un bgkcolor cadena y proporcione 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. Empezando en 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 se suele establecer en la variable jcr:content de una carpeta o página de recursos. Estos conf Los vínculos son explícitos, por lo que es fácil seguirlos mirando el contenido en CRXDE.

Saltar dentro /conf, seguimos la referencia y vemos que hay un /conf/wknd nodo . 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 de la variable Conf objeto. La configuración que se aplica se controla completamente a través del contenido JCR.

Veremos que la configuración contiene un nombre fijo settings nodo que contiene los elementos reales, incluido el dam/imageserver necesitamos en nuestro caso. Ese elemento puede considerarse como un "documento de configuración" y normalmente está representado por un cq:Page incluido un jcr:content contiene el contenido real.

Finalmente, vemos la propiedad bgkcolor que nuestro código de muestra necesita. La variable ValueMap regresamos de getItem se basa en el jcr:content nodo .

Resolución de configuración

El ejemplo básico anterior mostraba una sola configuración. Sin embargo, hay muchos casos en los que desea tener diferentes configuraciones, 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 un mecanismo de herencia y reserva en el siguiente orden de preferencia:

  1. /conf/<siteconfig>/<parentconfig>/<myconfig>
    • Configuración específica a la que se hace referencia desde cq:conf en algún lugar /content
    • La jerarquía es arbitraria y puede diseñarse como la estructura del sitio, no es negocio del código de la aplicación saber esto
    • Se puede cambiar en tiempo de ejecución por usuarios con privilegios de configuración
  2. /conf/<siteconfig>/<parentconfig>
    • Principales de travesía para configuraciones de reserva
    • Se puede cambiar en tiempo de ejecución por usuarios con privilegios de configuración
  3. /conf/<siteconfig>
    • Principales de travesía para configuraciones de reserva
    • Se puede cambiar en tiempo de ejecución por usuarios con privilegios de configuración
  4. /conf/global
    • Configuración global del sistema
    • Normalmente, los valores predeterminados globales para la instalación
    • Configurado por un admin función
    • Se puede cambiar en tiempo de ejecución por usuarios con privilegios de configuración
  5. /apps
    • Valores predeterminados de aplicación
    • Se ha corregido la implementación de la aplicación
    • Solo lectura en tiempo de ejecución
  6. /libs
    • Valores predeterminados de AEM producto
    • Solo se puede cambiar por Adobe, no se permite el acceso al proyecto
    • Se ha corregido la implementación de la aplicación
    • Solo 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, tal como estaba descrito 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.

Consola Web ConfMgr

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

ConfMgr

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 fines de depuración y prueba, existe un Configuración según el contexto consola web en https://<host>:<port>/system/console/slingcaconfig, que permite consultar las configuraciones según el contexto en el repositorio y ver sus propiedades.

Consola web de configuración según el contexto

Simplemente proporcione:

  • Ruta de contenido
  • Nombre de configuración

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

En esta página