Configuraciones de Cloud Service cloud-service-configurations
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.
Conceptos concepts
Los principios utilizados para desarrollar las configuraciones se han basado en los siguientes conceptos:
- Los servicios o adaptadores se utilizan para recuperar las configuraciones.
- Las configuraciones (por ejemplo, propiedades/párrafos) se heredan de los elementos principales.
- Referido desde nodos de análisis por ruta.
- Fácilmente extensible.
- Tiene la flexibilidad de adaptarse a configuraciones más complejas, como Adobe Analytics.
- Compatibilidad con dependencias (por ejemplo, Adobe Analytics Los complementos de necesitan un Adobe Analytics configuración).
Estructura structure
La ruta base de las configuraciones es:
/etc/cloudservices
.
Para cada tipo de configuración, se proporciona una plantilla y un componente. Esto permite tener plantillas de configuración que pueden satisfacer la mayoría de las necesidades después de personalizarse.
Para proporcionar una configuración para nuevos servicios, haga lo siguiente:
-
Creación de una página de servicio en
/etc/cloudservices
-
En esta sección:
- una plantilla de configuración
- un componente de configuración
La plantilla y el componente deben heredar la variable sling:resourceSuperType
desde la plantilla base:
cq/cloudserviceconfigs/templates/configpage
O componente base respectivamente
cq/cloudserviceconfigs/components/configpage
El proveedor de servicios también debe proporcionar la página de servicio:
/etc/cloudservices/<service-name>
Plantilla template
La plantilla amplía la plantilla base:
cq/cloudserviceconfigs/templates/configpage
Y defina una resourceType
que señala 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
Componentes components
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 añadiendo subpáginas en:
/etc/cloudservices/<service-name>
Modelo de contenido content-model
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
.
- Las propiedades fijas definidas en un cuadro de diálogo deben almacenarse en
jcr:node
directamente. - Elementos dinámicos (uso de
parsys
oiparsys
) utilice un subnodo para almacenar los datos del componente.
/etc/cloudservices/service/config/jcr:content as nt:unstructured
propertyname
*
par/component/ as cq:Component
propertyname
*
API api
Para obtener documentación de referencia sobre la API, consulte com.day.cq.wcm.webservicesupport.
AEM Integración de aem-integration
Los servicios disponibles se enumeran en la Cloud Services de la pestaña Propiedades de página (de cualquier página que herede de foundation/components/page
o wcm/mobile/components/page
).
La pestaña también proporciona lo siguiente:
- un vínculo a la ubicación donde puede habilitar el servicio
- elija una configuración (subnodo del servicio) en un campo de ruta
Cifrado de contraseña password-encryption
Al almacenar las credenciales de usuario del servicio, se deben cifrar todas las contraseñas.
Puede conseguirlo si agrega un campo de formulario oculto. Este campo debe tener la anotación @Encrypted
en el nombre de la propiedad; es decir, para el password
campo el nombre se escribiría de la siguiente manera:
password@Encrypted
La propiedad se cifrará automáticamente (con el CryptoSupport
servicio) por el EncryptionPostProcessor
.
[SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html)
anotaciones.EcryptionPostProcessor
solo cifra POST
solicitudes realizadas a /etc/cloudservices
.Propiedades adicionales para la página de servicio jcr:nodos de contenido additional-properties-for-service-page-jcr-content-nodes
Casos de uso use-cases
Estos servicios se proporcionan de forma predeterminada:
- Fragmentos de rastreador (Google, WebTrends, etc.)
- API de Rest
- Test&Target