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

As configurações do Adobe Experience Manager (AEM) servem para gerenciar configurações no AEM e servem 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 de um administrador, as configurações são a forma como você cria espaços de trabalho para gerenciar 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 e os autores do AEM podem considerar as configurações como espaços de trabalho. Esses espaços de trabalho podem ser usados para coletar grupos de configurações e seu conteúdo associado para fins organizacionais, implementando direitos de acesso para esses recursos.

Configurações podem ser criadas para vários recursos diferentes dentro do AEM.

Exemplo administrator-example

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

O administrador pode criar modelos de página gerais usando a configuração geral da WKND 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 WKND-Magazine seria associada somente ao site do periódico.

Ao fazer isso:

Configurações semelhantes são possíveis não apenas para modelos editáveis, mas também para configurações em 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 direitos de acesso a configurações no AEM.

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

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

Edição de configurações e seus direitos de acesso access-rights

Se você pensar nas 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 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 o administrador e os usuários possam considerar as configurações como locais de trabalho para gerenciar diferentes configurações e conteúdo, é 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 à sua configuração associada por meio de uma propriedade cq:conf. O AEM faz uma pesquisa com base no conteúdo e em sua propriedade cq:conf contextual para encontrar a configuração apropriada.

Exemplo developer-example

Neste exemplo, vamos supor 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 inicial de toda a pesquisa de configuração é um recurso de conteúdo em algum lugar abaixo de /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 você está procurando a configuração correta que se aplica neste contexto.

Agora, com o objeto Conf em mãos, você pode recuperar o item de configuração específico em que está interessado. Nesse caso, é dam/imageserver, que é uma coleção de configurações relacionadas a imageserver. A chamada getItem retorna um ValueMap. Em seguida, você lê uma propriedade de cadeia de caracteres bgkcolor e fornece um valor padrão de "FFFFFF", caso a propriedade (ou o item de configuração inteiro) não esteja presente.

Agora vamos observar o conteúdo JCR correspondente:

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

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

Neste exemplo, você pode assumir uma pasta DAM específica do WKND aqui e uma configuração correspondente. Começando por essa pasta /content/dam/wknd, você pode ver que há uma propriedade de cadeia de caracteres chamada cq:conf que faz referência à configuração que se aplica à subárvore. A propriedade é definida no jcr:content de uma pasta ou página de ativos. Esses links conf são explícitos, portanto, é fácil segui-los apenas observando o conteúdo no CRXDE.

Pulando dentro de /conf, siga a referência e veja se há um nó /conf/wknd. Esta é uma configuração. Sua pesquisa é transparente para o código do aplicativo. O código de exemplo nunca tem uma referência dedicada a ele, ele está oculto atrás do objeto Conf. A configuração que se aplica é controlada por meio do conteúdo JCR.

Você pode ver que a configuração contém um nó settings de nome fixo que contém os itens reais, incluindo o dam/imageserver necessário nesse caso. Esse item pode ser considerado um "documento de configurações" e é representado por um cq:Page, incluindo um jcr:content que contém o conteúdo real.

Finalmente, você vê a propriedade bgkcolor de que esse código de amostra precisa. O ValueMap que você recebe de getItem é baseado no nó jcr:content da página.

Resolução da configuração configuration-resolution

O exemplo básico acima mostrava 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 oferecer suporte a isso na pesquisa de configuração, o AEM tem um mecanismo de herança e fallback na seguinte ordem de preferência:

Usar configurações using-configurations

As configurações no AEM são baseadas em configurações sensíveis ao contexto do Sling. Os pacotes 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 foi 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 console da Web ConfMgr em https://<host>:<port>/system/console/conf, que pode mostrar configurações para determinado caminho/item.

Basta fornecer:

Clique em Resolver para que você possa ver quais configurações foram resolvidas e obter amostras de código que ajudam a resolver essas configurações.

Console da Web de configuração com reconhecimento de contexto context-aware-web-console

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

Basta fornecer:

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