Configurações e o navegador de configuração configuration-browser

AEM configurações servem para gerenciar configurações no AEM e servir como espaços de trabalho.

O que é uma configuração? what-is-a-configuration

Uma configuração pode ser considerada a partir de dois pontos de vista diferentes.

Em resumo: do ponto de vista do administrador, as configurações são a forma como você cria espaços de trabalho para gerenciar as configurações no AEM, enquanto o desenvolvedor deve entender como o AEM usa e gerencia essas configurações no repositório.

Independentemente da sua perspectiva, as configurações atendem a dois objetivos principais no AEM:

Configurações como administrador configurations-administrator

O administrador do AEM e os autores podem considerar as configurações como espaços de trabalho. Esses espaços de trabalho podem ser usados para coletar grupos de configurações, bem como seu conteúdo associado para fins organizacionais, implementando direitos de acesso para esses recursos.

As configurações podem ser criadas para vários recursos diferentes no AEM.

Exemplo administrator-example

Por exemplo, um administrador pode criar duas configurações para Modelos editáveis.

O administrador pode então criar modelos de página gerais usando a configuração WKND-General e, em seguida, modelos específicos para a revista em WKND-Magazine.

O administrador pode então associar o WKND-General a todo o conteúdo do site WKND. No entanto, a configuração da WKND-Magazine seria associada apenas ao site de revistas.

Ao fazer isso:

Configurações semelhantes são possíveis não apenas para Modelos editáveis, mas também para Configurações de nuvem, Segmentos do ContextHub e Modelos de fragmento de conteúdo.

Usar o navegador de configuração using-configuration-browser

O Navegador de configuração permite que um administrador crie, gerencie e configure facilmente os direitos de acesso às configurações no AEM.

Criação de uma configuração creating-a-configuration

É muito simples criar uma nova configuração no AEM usando o Navegador de configuração.

Editar configurações e seus direitos de acesso access-rights

Se você pensar em configurações como espaços de trabalho, os direitos de acesso poderão ser definidos nessas configurações para impor quem pode ou não acessar esses espaços de trabalho.

Configurações como um desenvolvedor configurations-developer

Como desenvolvedor, é importante saber como o AEM as a Cloud Service funciona com configurações e como ele processa a resolução da configuração.

Separação de configuração e conteúdo separation-of-config-and-content

Embora a variável administradores e usuários podem considerar configurações como locais de trabalho para gerenciar configurações e conteúdo diferentes, é importante entender que as configurações e o conteúdo são armazenados e gerenciados separadamente pelo AEM no repositório.

O conteúdo faz referência à configuração associada por meio de uma cq:conf propriedade. AEM realiza uma pesquisa com base no conteúdo e é contextual cq:conf para encontrar a configuração apropriada.

Exemplo developer-example

Neste exemplo, suponhamos que você tenha algum código de aplicativo interessado nas configurações do DAM.

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

O ponto de partida de toda a pesquisa de configuração é um recurso de conteúdo, geralmente em algum lugar em /content. Pode ser uma página, um componente dentro de uma página, um ativo ou uma pasta DAM. Este é o conteúdo real para o qual estamos procurando a configuração correta que se aplica neste contexto.

Agora com o Conf em mãos, podemos recuperar o item de configuração específico em que estamos interessados. Nesse caso, é dam/imageserver, que é uma coleção de configurações relacionadas ao imageserver. O getItem chamada retorna um ValueMap. Então, lemos um bgkcolor propriedade string e forneça um valor padrão de "FFFFF" caso a propriedade (ou o item de configuração inteiro) não esteja presente.

Agora vamos analisar o conteúdo do JCR correspondente:

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

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

Neste exemplo, assumimos uma pasta DAM específica do WKND aqui e uma configuração correspondente. Iniciando nessa pasta /content/dam/wknd, veremos que há uma propriedade de string chamada cq:conf que faz referência à configuração que deve ser aplicada à subárvore. A propriedade geralmente será definida no jcr:content de uma pasta ou página de ativos. Esses conf os links são explícitos, portanto, é fácil segui-los observando apenas o conteúdo no CRXDE.

Pulando para dentro /conf, seguimos a referência e vemos que há uma /conf/wknd nó . Esta é uma configuração. Observe que sua pesquisa é totalmente transparente para o código do aplicativo. O código de exemplo nunca tem uma referência dedicada, está oculto atrás do Conf objeto. Qual configuração se aplica é totalmente controlada pelo conteúdo do JCR.

Vemos que a configuração contém um nome fixo settings nó que contém os itens reais, incluindo o dam/imageserver precisamos no nosso caso. Tal item pode ser considerado como um "documento de configurações" e geralmente é representado por um cq:Page incluindo um jcr:content mantendo o conteúdo real.

Finalmente, vemos a propriedade bgkcolor que nosso código de amostra precisa. O ValueMap voltamos de getItem é baseado no jcr:content nó .

Resolução de Configuração configuration-resolution

O exemplo básico acima mostrou uma única configuração. Mas há muitos casos em que você deseja ter configurações diferentes, como uma configuração global padrão, uma diferente para cada marca e talvez uma específica para seus subprojetos.

Para dar suporte a isso, a pesquisa de configuração no AEM tem o mecanismo de herança e fallback na seguinte ordem de preferência:

Uso de configurações using-configurations

As configurações em AEM são baseadas em configurações sensíveis ao contexto do Sling. Os pacotes do Sling fornecem uma API de serviço que pode ser usada para obter configurações sensíveis ao contexto. As configurações sensíveis ao contexto são configurações relacionadas a um recurso de conteúdo ou a uma árvore de recursos como estava descrito no exemplo anterior.

Para obter mais detalhes sobre configurações sensíveis ao contexto, exemplos e como usá-las, consulte a documentação do Sling.

Console da Web do ConfMgr confmgr-web-console

Para fins de depuração e teste, há um ConfMgr console da Web em https://<host>:<port>/system/console/conf, que pode mostrar configurações para um determinado caminho/item.

Basta fornecer:

Clique em Resolver para ver quais configurações são resolvidas e receber o código de amostra que resolverá essas configurações.

Console da Web de configuração sensível ao contexto context-aware-web-console

Para fins de depuração e teste, há um Configuração sensível ao contexto console da Web em https://<host>:<port>/system/console/slingcaconfig, que permite consultar configurações sensíveis ao contexto no repositório e exibir suas propriedades.

Basta fornecer:

Clique em Resolver para recuperar os caminhos de contexto e as propriedades associadas para a configuração selecionada.