Configurações do Cloud Service

As configurações são projetadas para fornecer a lógica e a estrutura para armazenar configurações de serviço.

É possível estender as instâncias existentes para criar suas próprias configurações.

Conceitos

Os princípios utilizados no desenvolvimento das configurações basearam-se nos seguintes conceitos:

  • Serviços/Adaptadores são usados para recuperar as configurações.
  • As configurações (por exemplo, propriedades/parágrafos) são herdadas dos pais.
  • Referenciado de nó(s) do Analytics por caminho.
  • Facilmente extensível.
  • Tem a flexibilidade de atender a configurações mais complexas, como Adobe Analytics.
  • Suporte para dependências (por exemplo, Os plug-ins Adobe Analytics precisam de uma configuração Adobe Analytics).

Estrutura

O caminho básico das configurações é:

/etc/cloudservices.

Para cada tipo de configuração, um modelo e um componente serão fornecidos.Isso possibilita a existência de modelos de configuração que possam atender à maioria das necessidades após serem personalizados.

Para fornecer uma configuração para novos serviços, é necessário:

  • criar uma página de serviço em

    /etc/cloudservices

  • nesta rubrica:

    • um modelo de configuração
    • um componente de configuração

O modelo e o componente devem herdar sling:resourceSuperType do modelo base:

cq/cloudserviceconfigs/templates/configpage

ou componente de base, respectivamente

cq/cloudserviceconfigs/components/configpage

O provedor de serviço também deve fornecer a página de serviço:

/etc/cloudservices/<service-name>

Modelo

Seu modelo estenderá o modelo base:

cq/cloudserviceconfigs/templates/configpage

e defina um resourceType que aponte para o componente personalizado.

/libs/cq/analytics/templates/sitecatalyst
sling:resourceSuperType = cq/cloudserviceconfigs/templates/configpage
allowedChildren = /libs/cq/analytics/templates/sitecatalyst
allowedPaths = /etc/cloudservices/analytics/*, /etc/cloudservices/analytics/.*
componentReference = cq/analytics/components/sitecatalyst
jcr:content/
cq:designPath = /etc/designs/cloudservices
sling:resourceType = cq/analytics/components/sitecatalystpage

/libs/cq/analytics/templates/generictracker
sling:resourceSuperType = cq/cloudservices/templates/configpage
allowedChildren = /libs/cq/analytics/templates/generictracker
allowedPaths = /etc/cloudservices/analytics/*, /etc/cloudservices/analytics/.*
jcr:content/
cq:designPath = /etc/designs/cloudservices
sling:resourceType = cq/analytics/components/generictrackerpage

Componentes

Seu componente deve estender o componente básico:

cq/cloudserviceconfigs/templates/configpage

/libs/cq/analytics/components/sitecatalystpage

/libs/cq/analytics/components/generictrackerpage

Depois de configurar seu modelo e componente, você pode adicionar sua configuração adicionando subpáginas em:

/etc/cloudservices/<service-name>

Modelo de conteúdo

O modelo de conteúdo é armazenado como cq:Page em:

/etc/cloudservices/<service-name>(/*)

/etc/cloudservices
/etc/cloudservices/service-name
/etc/cloudservices/service-name/config
/etc/cloudservices/service-name/config/inherited-config

As configurações são armazenadas no subnó jcr:content.

  • As propriedades fixas, definidas em uma caixa de diálogo, devem ser armazenadas diretamente em jcr:node.
  • Os elementos dinâmicos (usando parsys ou iparsys) usam um subnó para armazenar os dados do componente.
/etc/cloudservices/service/config/jcr:content as nt:unstructured
propertyname
*
par/component/ as cq:Component
propertyname
*

API

Para obter a documentação de referência sobre a API, consulte com.day.cq.wcm.webservicessupport.

Integração AEM

Os serviços disponíveis são listados na guia Cloud Services da caixa de diálogo Propriedades da página (de qualquer página herdada de foundation/components/page ou wcm/mobile/components/page).

A guia também fornece:

  • um link para o local onde você pode ativar o serviço
  • escolha uma configuração (subnó do serviço) de um campo de caminho

Criptografia de senha

Ao armazenar credenciais de usuário para o serviço, todas as senhas devem ser criptografadas.

Para isso, adicione um campo de formulário oculto. Esse campo deve ter a anotação @Encrypted no nome da propriedade; Ou seja, para o campo password, o nome seria escrito como:

password@Encrypted

A propriedade será automaticamente criptografada (usando o serviço CryptoSupport) pelo EncryptionPostProcessor.

OBSERVAÇÃO

Isso é semelhante às anotações padrão [SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html).

OBSERVAÇÃO

Por padrão, as solicitações EcryptionPostProcessor somente criptografam POST feitas para /etc/cloudservices.

Propriedades adicionais do jcr da página de serviço:nós de conteúdo

Propriedade Descrição
componentReference Caminho de referência para um componente a ser incluído automaticamente na página.
Isso é usado para funcionalidade adicional e inclusões de JS.
Isso inclui o componente na página em
cq/cloudserviceconfigs/components/servicecomponents
que está incluído (normalmente antes da body tag).
No caso de o Analytics e o Público alvo usarmos isso para incluir funcionalidades adicionais, como chamadas de JavaScript para rastrear o comportamento do visitante.
descrição Breve descrição do serviço.
descriptionExtended Descrição estendida do serviço.
classificação Classificação de serviço para uso em listagens.
seletableChildren Filtro para exibir configurações na caixa de diálogo de propriedades da página.
serviceUrl URL do site de serviço.
serviceUrlLabel Rótulo do URL do serviço.
thumbnailPath Caminho para a miniatura do serviço.
visible Visibilidade na caixa de diálogo de propriedades da página; visível por padrão (opcional)

Casos de uso

Esses serviços são fornecidos por padrão:

OBSERVAÇÃO

Nesta página