Les configurations apportent la logique et la structure de stockage des configurations de service.
Vous pouvez étendre les instances existantes pour créer vos propres configurations.
Les principes suivis dans le développement des configurations sont basés sur les concepts ci-après :
Le chemin de base des configurations est :
/etc/cloudservices
.
Pour chaque type de configuration, un modèle et un composant sont fournis. Ainsi, une fois personnalisés, les modèles de configuration peuvent répondre à la plupart des besoins.
Pour configurer un nouveau service, vous devez effectuer les opérations suivantes :
créez une page de service dans
/etc/cloudservices
sous :
Le modèle et le composant doivent hériter du sling:resourceSuperType
du modèle de base :
cq/cloudserviceconfigs/templates/configpage
ou composant de base respectivement
cq/cloudserviceconfigs/components/configpage
Le fournisseur de services doit également fournir la page de service :
/etc/cloudservices/<service-name>
Votre modèle étendra le modèle de base :
cq/cloudserviceconfigs/templates/configpage
et définissez un resourceType
qui pointe vers le composant personnalisé.
/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
Votre composant devrait étendre le composant de base :
cq/cloudserviceconfigs/templates/configpage
/libs/cq/analytics/components/sitecatalystpage
/libs/cq/analytics/components/generictrackerpage
Après avoir configuré votre modèle et votre composant, vous pouvez ajouter votre configuration en ajoutant des sous-pages sous :
/etc/cloudservices/<service-name>
Le modèle de contenu est stocké sous cq:Page
sous :
/etc/cloudservices/<service-name>(/*)
/etc/cloudservices
/etc/cloudservices/service-name
/etc/cloudservices/service-name/config
/etc/cloudservices/service-name/config/inherited-config
Les configurations sont stockées sous le sous-noeud jcr:content
.
jcr:node
.parsys
ou iparsys
) se servent d’un sous-nœud pour stocker les données du composant./etc/cloudservices/service/config/jcr:content as nt:unstructured
propertyname
*
par/component/ as cq:Component
propertyname
*
Pour la documentation de référence sur l’API, voir com.day.cq.wcm.webservicesupport.
Les services disponibles sont répertoriés dans l'onglet Cloud Services de la boîte de dialogue Propriétés de la page (de toute page héritant de foundation/components/page
ou wcm/mobile/components/page
).
L’onglet contient également :
Lorsque vous stockez des informations d’identification d’utilisateur pour le service, tous les mots de passe doivent être chiffrés.
Pour cela, il faut ajouter un champ de formulaire masqué. Ce champ doit avoir l'annotation @Encrypted
dans le nom de la propriété ; Par exemple, pour le champ password
, le nom serait écrit comme suit :
password@Encrypted
La propriété est alors automatiquement chiffrée (en utilisant le service CryptoSupport
) par EncryptionPostProcessor
.
Ceci est similaire aux annotations [SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html)
standard.
Par défaut, EcryptionPostProcessor
ne chiffre que les demandes POST
envoyées à /etc/cloudservices
.
Propriété | Description |
componentReference | Chemin d’accès de référence à un composant à inclure automatiquement dans la page. Ceci est utilisé pour des fonctionnalités supplémentaires et des inclusions JS. Cela inclut le composant sur la page cq/cloudserviceconfigs/components/servicecomponents où est incluse (normalement avant la body balise).Dans le cas de Google Analytics et Target, nous utilisons ceci pour insérer des fonctionnalités supplémentaires, telles que des appels JavaScript, afin de suivre le comportement des visiteurs. |
description | Brève description du service. |
descriptionExtended | Description étendue du service. |
classement | Classement des services à utiliser dans les annonces. |
selectableChildren | Filtre permettant d’afficher les configurations dans la boîte de dialogue des propriétés de page. |
serviceUrl | URL vers le site Web du service. |
serviceUrlLabel | Libellé de l’URL de service. |
thumbnailPath | Chemin d’accès à la miniature pour le service. |
visible | Visibilité dans la boîte de dialogue des propriétés de page ; visible par défaut (facultatif) |
Ces services sont fournis par défaut :
Voir aussi Création d’un service cloud personnalisé.