Configuraciones y el explorador de configuración configuration-browser

Las configuraciones de Adobe Experience Manager AEM AEM () sirven para administrar la configuración de los espacios de trabajo de y sirven como espacios de trabajo de.

¿Qué es una configuración? what-is-a-configuration

Una configuración se puede considerar desde dos puntos de vista diferentes.

AEM AEM En resumen: desde el punto de vista de un administrador, las configuraciones son la forma en que se crean espacios de trabajo para administrar la configuración en el repositorio, mientras que el desarrollador debe comprender cómo utiliza y administra estas configuraciones en el repositorio el desarrollador, de manera que los usuarios puedan utilizarlas y administrarlas de forma más eficaz, en el repositorio de.

AEM Independientemente de su perspectiva, las configuraciones sirven para dos propósitos principales en la:

Configuraciones como administrador configurations-administrator

AEM El administrador y los autores de la pueden considerar las configuraciones como espacios de trabajo. Estos espacios de trabajo se pueden utilizar para recopilar grupos de configuraciones y su contenido asociado con fines organizativos mediante la implementación de derechos de acceso para esas funciones.

AEM Se pueden crear configuraciones para muchas funciones diferentes dentro de los entornos de trabajo de la aplicación de la.

Ejemplos administrator-example

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

A continuación, el administrador puede crear plantillas de página generales utilizando la configuración de WKND-General y, luego, plantillas específicas de 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 estaría asociada al sitio de la revista.

Al hacer esto:

Configuraciones similares son posibles 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 using-configuration-browser

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

Creación de una configuración creating-a-configuration

AEM Es sencillo crear una configuración en mediante el Explorador de configuración en la interfaz de usuario de la interfaz de usuario de.

Edición de configuraciones y sus derechos de acceso access-rights

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

Configuraciones como desarrollador configurations-developer

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 separation-of-config-and-content

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

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

Ejemplos developer-example

Para este ejemplo, supongamos que tiene código de aplicación 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 por debajo 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 busca la configuración correcta que se aplica en este contexto.

Ahora con el objeto Conf en la mano, puede recuperar el elemento de configuración específico que le interesa. En este caso, es dam/imageserver, que es una colección de configuraciones relacionadas con imageserver. La llamada de getItem devuelve un ValueMap. A continuación, lea una propiedad de cadena bgkcolor y proporcione un valor predeterminado de "FFFFFF" en caso de que la propiedad (o todo el elemento de configuración) no esté presente.

Ahora vamos a echar un vistazo al contenido JCR correspondiente:

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

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

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

Saltando dentro de /conf, siga la referencia y vea que hay un nodo /conf/wknd. Esta es una configuración. Su búsqueda es 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 mediante el contenido JCR.

Verá que la configuración contiene un nodo settings de nombre fijo que contiene los elementos reales, incluido el dam/imageserver que necesita en este caso. Un elemento de este tipo se puede considerar como un "documento de configuración" y está representado por un cq:Page que incluye un jcr:content que contiene el contenido real.

Finalmente, verá la propiedad bgkcolor que necesita este código de ejemplo. El ValueMap que recupera de getItem se basa en el nodo jcr:content de la página.

Resolución de configuración configuration-resolution

El ejemplo básico anterior mostraba una sola configuración. Pero 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.

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

Uso de configuraciones using-configurations

AEM Las configuraciones en las configuraciones de los segmentos de la lista se basan en Configuraciones según el contexto de Sling. Los paquetes Sling proporcionan una API de servicio que se puede utilizar 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 acerca de configuraciones según el contexto, ejemplos y cómo usarlas, consulte la documentación de Sling..

Consola web de ConfMgr confmgr-web-console

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

Proporcione simplemente:

Haga clic en Resolver para ver qué configuraciones se resuelven y obtener ejemplos de código que ayuden a resolverlas.

Consola web de configuración según el contexto context-aware-web-console

Para la depuración y las pruebas, hay 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.

Proporcione simplemente:

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