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, um modelo e um componente serão fornecidos.Isso possibilita ter modelos de configuração que podem atender à maioria das necessidades após serem personalizados.
Para fornecer uma configuração para novos serviços, você precisa:
criar uma página de serviço em
/etc/cloudservices
nesta rubrica:
O modelo e o componente devem herdar o sling:resourceSuperType
do template 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 defina uma 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 base:
cq/cloudserviceconfigs/templates/configpage
/libs/cq/analytics/components/sitecatalystpage
/libs/cq/analytics/components/generictrackerpage
Após configurar 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
) use 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 variável Cloud Services da guia Propriedades da página de qualquer página herdada de foundation/components/page
ou wcm/mobile/components/page
).
A guia também fornece:
Ao armazenar credenciais do usuário para o serviço, todas as senhas devem ser criptografadas.
Para isso, adicione um campo de formulário oculto. Este campo deve ter a anotação @Encrypted
no nome da propriedade; ou seja, para o password
o nome seria escrito como:
password@Encrypted
A propriedade será automaticamente criptografada (usando o CryptoSupport
pela EncryptionPostProcessor
.
Isso é 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 criptografia POST
pedidos apresentados /etc/cloudservices
.
Propriedade | Descrição |
componentReference | Caminho de referência para um componente a ser incluído automaticamente na página. Isso é usado para funcionalidades adicionais e inclusões de JS. Isso inclui o componente na página em que cq/cloudserviceconfigs/components/servicecomponents é incluída (normalmente antes da variável body tag).Caso o Analytics e o Target sejam usados 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 do serviço para uso em listas. |
seletedChildren | Filtrar para exibir configurações na caixa de diálogo de propriedades da página. |
serviceUrl | URL para o site do serviço. |
serviceUrlLabel | Rótulo do 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.