Show Menu
TOPICS×

Utilisation de la couche de données client Adobe avec les composants principaux

L’objectif de la couche de données client Adobe est de réduire les efforts d’instrumentalisation des sites web en fournissant une méthode normalisée afin d’exposer et d’accéder à tout type de données pour tout script.
La couche de données client Adobe est indépendante de la plate-forme, mais elle est entièrement intégrée aux composants principaux pour l’utilisation avec AEM.
Tout comme les composants principaux, le code de la couche de données client Adobe est disponible sur GitHub avec sa documentation destinée aux développeurs. Ce document donne un aperçu de la façon dont les composants principaux interagissent avec la couche de données ; les détails techniques complets sont disponibles dans la documentation GitHub.
Pour plus d’informations sur la couche de données client Adobe, reportez-vous aux ressources de son référentiel GitHub.
Pour obtenir des détails techniques sur l’intégration de la couche de données client Adobe avec les composants principaux, voir le fichier
DATA_LAYER_INTEGRATION.md
dans le référentiel des composants principaux.

Installation et activation

Depuis la version 2.9.0 des composants principaux, la couche de données est distribuée avec ceux-ci en tant que bibliothèque cliente. Aucune installation n’est nécessaire.
Cependant, la couche de données n’est pas activée par défaut. Pour activer la couche de données
  1. Créez la structure suivante sous le nœud
    /conf
     :
    • /conf/<mySite>/sling:configs/com.adobe.cq.wcm.core.components.internal.DataLayerConfig
  2. Ajoutez une propriété booléenne appelée
    enabled
    et définissez-la sur
    true
    .
  3. Ajoutez une propriété
    sling:configRef
    sur le nœud
    jcr:content
    de votre site ci-dessous
    /content
    (par exemple,
    /content/<mySite>/jcr:content
    ) et définissez-la sur
    /conf/<mySite>
    .
Une fois activée, vous pouvez vérifier l’activation en chargeant une page du site en dehors de l’éditeur. Lorsque vous examinez la page, vous constatez que la couche de données client Adobe est chargée.

Schémas de données des composants principaux

Voici une liste de schémas que les composants principaux utilisent avec la couche de données.

Schéma d’élément de composant/conteneur

Le schéma d’élément de composant/conteneur est utilisé dans les composants suivants :
Le schéma d’élément de composant/conteneur est défini comme suit.
id: { // component ID @type // resource type repo:modifyDate // last modified date dc:title // title dc:description // description xdm:text // text xdm:linkURL // link URL parentId // parent component ID }

Schéma de page

Le schéma de page est utilisé par le composant suivant :
Le schéma de page est défini comme suit.
id: { @type repo:modifyDate dc:title dc:description xdm:text xdm:linkURL parentId xdm:tags // page tags repo:path // page path xdm:template // page template xdm:language // page language }

Schéma de conteneur

Le schéma de conteneur est utilisé par les composants suivants :
Le schéma de conteneur est défini comme suit.
id: { @type repo:modifyDate dc:title dc:description xdm:text xdm:linkURL parentId shownItems // array of the displayed item IDs }

Schéma d’image

Le schéma d’image est utilisé par le composant suivant :
Le schéma d’image est défini comme suit.
id: { @type repo:modifyDate dc:title dc:description xdm:text xdm:linkURL parentId image // asset detail (see below section) }

Schéma de ressource

Le schéma de ressource est utilisé dans le composant Image.
Le schéma de ressource est défini comme suit.
id: { repo:id // asset UUID repo:path // asset path @type // asset resource type xdm:tags // asset tags repo:modifyDate }