Configuraciones y el explorador de configuración

Última actualización: 2023-11-18

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?

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

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

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:

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

Configuraciones como administrador

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

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, 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:

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

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

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.

NOTA

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

Creación de una configuración

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.

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

  2. Seleccione Crear.

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

    Crear configuración

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

  5. Seleccione Crear.

SUGERENCIA

Las configuraciones pueden estar anidadas.

Edición de configuraciones y sus derechos de acceso

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.

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

  2. Seleccione la configuración que desee editar y, a continuación, seleccione Propiedades en la barra de herramientas.

  3. Seleccione cualquier función adicional que desee añadir a la configuración.

    NOTA

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

  4. Utilice el Permisos efectivos para ver una matriz de funciones y los permisos que se otorgan actualmente a las configuraciones.
    Ventana de permisos efectivos

  5. Para asignar nuevos permisos, introduzca el nombre de usuario o grupo en la Seleccionar usuario o grupo en el campo Añadir nuevos permisos sección.

    • El Seleccionar usuario o grupo El campo ofrece finalización automática en función de los usuarios y funciones existentes.
  6. Seleccione el usuario o rol apropiado en los resultados de autocompletar.

    • Puede seleccionar más de un usuario o rol.
  7. Compruebe las opciones de acceso que deben tener uno o más usuarios o funciones seleccionados y haga clic en Añadir.
    Añadir derechos de acceso a una configuración

  8. Repita los pasos para poder seleccionar usuarios o funciones y asignar derechos de acceso adicionales según sea necesario.

  9. Seleccionar Guardar y cerrar cuando termine.

Configuraciones como desarrollador

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

Separación de configuración y contenido

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

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

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

Ejemplos

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 toda la búsqueda de configuración es un recurso de contenido en alguna parte 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 busca la configuración correcta que se aplica en este contexto.

Ahora, con el Conf objeto en 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 el imageserver. El getItem la llamada devuelve un ValueMap. A continuación, puede leer una 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. Empezando por esa carpeta /content/dam/wknd, puede ver que hay una propiedad de cadena llamada cq:conf que hace referencia a la configuración que se aplica al subárbol. La propiedad se establece en jcr:content de una página o carpeta de recursos. Estos conf Los vínculos son explícitos, por lo que es fácil seguirlos con solo mirar el contenido en CRXDE.

Saltando dentro /conf, siga la referencia y compruebe que hay un /conf/wknd nodo. 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 Conf objeto. La configuración que se aplica se controla mediante el contenido JCR.

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

Por último, verá la propiedad bgkcolor que necesita este código de ejemplo. El ValueMap regresas de… getItem se basa en el jcr:content nodo.

Resolución de configuración

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:

  1. /conf/<siteconfig>/<parentconfig>/<myconfig>
    • Configuración específica a la que se hace referencia desde cq:conf en algún lugar de /content
    • La jerarquía es arbitraria y se puede diseñar igual que la estructura del sitio, no es asunto del código de la aplicación saber esto
    • Cambiable durante la ejecución por usuarios con privilegios de configuración
  2. /conf/<siteconfig>/<parentconfig>
    • Recorrer elementos principales para configuraciones de reserva
    • Cambiable durante la ejecución por usuarios con privilegios de configuración
  3. /conf/<siteconfig>
    • Recorrer elementos principales para configuraciones de reserva
    • Cambiable durante la ejecución por usuarios con privilegios de configuración
  4. /conf/global
    • Configuración global del sistema
    • Valores globales predeterminados para la instalación
    • Establecido por un admin función
    • Cambiable durante la ejecución por usuarios con privilegios de configuración
  5. /apps
    • Valores predeterminados de aplicación
    • Corregido con la implementación de aplicaciones
    • Solo lectura durante la ejecución
  6. /libs
    • AEM Valores predeterminados de producto
    • Solo se puede cambiar por Adobe; no se permite el acceso al proyecto
    • Corregido con la implementación de aplicaciones
    • Solo lectura durante la ejecución

Uso de configuraciones

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 tal como estaban descrito en el ejemplo anterior.

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

Consola web de 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 determinados.

ConfMgr

Proporcione simplemente:

  • Ruta de contenido
  • Elemento
  • Usuario

Clic Resolver para que pueda ver qué configuraciones se resuelven y obtener ejemplos de código que le ayudarán a resolverlas.

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

Proporcione simplemente:

  • Ruta de contenido
  • Nombre de configuración

Clic Resolver para que pueda recuperar las rutas de contexto y propiedades asociadas para la configuración seleccionada.

En esta página