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.
Os princípios usados no desenvolvimento das configurações foram baseados nos seguintes conceitos:
O caminho base das configurações é:
/etc/cloudservices
.
Para cada tipo de configuração, será fornecido um modelo e um componente. Isso possibilita ter modelos de configuração que podem atender à maioria das necessidades após a personalização.
Para fornecer uma configuração para novos serviços, é necessário:
criar uma página de serviço no
/etc/cloudservices
nesta seção:
O modelo e o componente devem herdar o sling:resourceSuperType
a partir do modelo base:
cq/cloudserviceconfigs/templates/configpage
ou componente base, respectivamente
cq/cloudserviceconfigs/components/configpage
O provedor de serviços também deve fornecer a página de serviço:
/etc/cloudservices/<service-name>
Seu modelo estenderá o modelo base:
cq/cloudserviceconfigs/templates/configpage
e definir um resourceType
que aponta 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
Seu componente deve estender o componente básico:
cq/cloudserviceconfigs/templates/configpage
/libs/cq/analytics/components/sitecatalystpage
/libs/cq/analytics/components/generictrackerpage
Depois de definir o modelo e o componente, é possível adicionar a configuração adicionando subpáginas em:
/etc/cloudservices/<service-name>
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
.
jcr:node
diretamente.parsys
ou iparsys
) usar um subnó para armazenar os dados do componente./etc/cloudservices/service/config/jcr:content as nt:unstructured
propertyname
*
par/component/ as cq:Component
propertyname
*
Para obter a documentação de referência sobre a API, consulte com.day.cq.wcm.webservicesupport.
Os serviços disponíveis estão listados na Cloud Services guia do Propriedades da página caixa de diálogo (de qualquer página que herde de foundation/components/page
ou wcm/mobile/components/page
).
A guia também fornece:
Ao armazenar credenciais de usuário para o serviço, todas as senhas devem ser criptografadas.
Você pode fazer isso adicionando um campo de formulário oculto. Este campo deve ter a anotação @Encrypted
no nome da propriedade; ou seja, para a variável password
o nome seria escrito como:
password@Encrypted
A propriedade será criptografada automaticamente (usando o CryptoSupport
serviço) pela EncryptionPostProcessor
.
É semelhante ao padrão [SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html)
anotações.
Por padrão, a variável EcryptionPostProcessor
somente criptografa POST
pedidos feitos a /etc/cloudservices
.
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 que cq/cloudserviceconfigs/components/servicecomponents está incluído (normalmente antes da body tag).No caso do Analytics e do Target, usamos isso para incluir funcionalidades adicionais, como chamadas 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 para URL de serviço. |
thumbnailPath | Caminho para a miniatura do serviço. |
visível | Visibilidade na caixa de diálogo de propriedades da página; visível por padrão (opcional) |
Esses serviços são fornecidos por padrão:
Consulte também Criação de um Cloud Service personalizado.