Las configuraciones están diseñadas para proporcionar la lógica y la estructura para almacenar configuraciones de servicio.
Puede ampliar las instancias existentes para crear sus propias configuraciones.
Los principios utilizados para desarrollar las configuraciones se han basado en los siguientes conceptos:
La ruta de acceso base de las configuraciones es:
/etc/cloudservices
.
Para cada tipo de configuración se proporcionará una plantilla y un componente.Esto permite tener plantillas de configuración que puedan satisfacer la mayoría de las necesidades después de personalizarlas.
Para proporcionar una configuración para un nuevo servicio, debe:
crear una página de servicios en
/etc/cloudservices
en este contexto:
La plantilla y el componente deben heredar sling:resourceSuperType
de la plantilla base:
cq/cloudserviceconfigs/templates/configpage
o componente base respectivamente
cq/cloudserviceconfigs/components/configpage
El proveedor de servicio también debe proporcionar la página de servicio:
/etc/cloudservices/<service-name>
La plantilla extenderá la plantilla base:
cq/cloudserviceconfigs/templates/configpage
y defina un resourceType
que apunte al 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
El componente debe ampliar el componente base:
cq/cloudserviceconfigs/templates/configpage
/libs/cq/analytics/components/sitecatalystpage
/libs/cq/analytics/components/generictrackerpage
Después de configurar la plantilla y el componente, puede agregar la configuración agregando subpáginas en:
/etc/cloudservices/<service-name>
El modelo de contenido se almacena como cq:Page
en:
/etc/cloudservices/<service-name>(/*)
/etc/cloudservices
/etc/cloudservices/service-name
/etc/cloudservices/service-name/config
/etc/cloudservices/service-name/config/inherited-config
Las configuraciones se almacenan en el subnodo jcr:content
.
jcr:node
.parsys
o iparsys
) utilizan un subnodo para almacenar los datos del componente./etc/cloudservices/service/config/jcr:content as nt:unstructured
propertyname
*
par/component/ as cq:Component
propertyname
*
Para obtener documentación de referencia sobre la API, consulte com.day.cq.wcm.webservicesupport.
Los servicios disponibles se enumeran en la ficha Cloud Services del cuadro de diálogo Propiedades de la página (de cualquier página que herede de foundation/components/page
o wcm/mobile/components/page
).
La ficha también proporciona:
Al almacenar las credenciales de usuario para el servicio, todas las contraseñas deben cifrarse.
Esto se puede lograr agregando un campo de formulario oculto. Este campo debe tener la anotación @Encrypted
en el nombre de la propiedad; Es decir, para el campo password
el nombre se escribiría como:
password@Encrypted
La propiedad será cifrada automáticamente (mediante el servicio CryptoSupport
) por el EncryptionPostProcessor
.
Esto es similar a las [SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html)
anotaciones estándar.
De manera predeterminada, EcryptionPostProcessor
sólo cifra POST
las solicitudes realizadas a /etc/cloudservices
.
Propiedad | Descripción |
componentReference | Ruta de referencia a un componente que se incluirá automáticamente en la página. Se utiliza para funcionalidad adicional e inclusiones de JS. Esto incluye el componente en la página cq/cloudserviceconfigs/components/servicecomponents donde se incluye (normalmente antes de la body etiqueta).En el caso de que el uso de Analytics y Destinatario lo utilice para incluir funcionalidad adicional, como llamadas de JavaScript para rastrear el comportamiento del visitante. |
Descripción | Descripción breve del servicio. |
descriptionExtended | Descripción ampliada del servicio. |
clasificación | Clasificación de servicio para su uso en anuncios. |
selectableChildren | Filtro para mostrar configuraciones en el cuadro de diálogo de propiedades de página. |
serviceUrl | Dirección URL del sitio web de servicio. |
serviceUrlLabel | Etiqueta para la dirección URL del servicio. |
thumbnailPath | Ruta a la miniatura del servicio. |
visible | Visibilidad en el cuadro de diálogo de propiedades de página; visible de forma predeterminada (opcional) |
Estos servicios se proporcionan de forma predeterminada:
Consulte también Creación de un Cloud Service personalizado.