Étendre Multi Site Manager extending-the-multi-site-manager

Ce document vous aide à comprendre comment étendre les fonctionnalités de Multi Site Manager et couvre les rubriques suivantes.

  • En savoir plus sur les principaux membres de l’API Java MSM
  • Création d’une action de synchronisation pouvant être utilisée dans une configuration de déploiement
  • Modification de la langue et des codes pays par défaut
TIP
Cette page est plus facile à comprendre dans le contexte du document Réutilisation de contenu : Multi Site Manager.
CAUTION
Le Multi Site Manager et son API sont utilisés lors de la création d’un site web. Ils ne sont donc destinés qu’à être utilisés dans un environnement de création.

Vue d’ensemble de l’API Java overview-of-the-java-api

La gestion multisite se compose des packages suivants :

Les principaux objets API MSM interagissent comme suit (voir aussi la section Termes utilisés) :

Principaux objets de l’API MSM

  • Blueprint - Un Blueprint (comme dans la configuration de plan directeur) spécifie les pages à partir desquelles une Live Copy peut hériter du contenu.

    Plan directeur

    • L’utilisation d’une configuration de plan directeur (Blueprint) est facultative, mais :

      • Il permet à l’auteur d’utiliser l’option Déploiement sur la source pour pousser explicitement les modifications vers les Live Copies qui héritent de cette source.
      • Il permet à l’auteur d’utiliser Créer un site, ce qui permet à l’utilisateur de sélectionner facilement des langues et de configurer la structure de la Live Copy.
      • Il définit la configuration de déploiement par défaut pour toutes les Live Copies créées.
  • LiveRelationship - LiveRelationship spécifie la connexion (relation) entre une ressource dans la branche Live Copy et sa ressource source/plan directeur équivalente.

    • Les relations sont utilisées lors de la réalisation de l’héritage et du déploiement.

    • Les objets LiveRelationship fournissent un accès (références) aux objets de configuration de déploiement (RolloutConfig), LiveCopy et LiveStatus liés à la relation.

    • Par exemple, une Live Copy est créée dans /content/copy/us à partir de la source ou du plan directeur au niveau /content/wknd/language-masters. Les ressources /content/wknd/language-masters/en/jcr:content et /content/copy/us/en/jcr:content forment une relation.

  • LiveCopy - Un LiveCopy contient les détails de configuration des relations (LiveRelationship) entre les ressources Live Copy et leurs ressources source/de plan directeur.

    • Utilisez la classe LiveCopy pour accéder au chemin d’accès de la page, au chemin d’accès de la page de source ou de plan directeur, aux configurations de déploiement et si les pages enfants sont également incluses dans la LiveCopy.

    • Un nœud LiveCopy est créé chaque fois que Créer un site ou Créer une Live Copy est utilisé.

  • LiveStatus - LiveStatus les objets permettent d’accéder à l’état d’exécution d’un LiveRelationship. Permet d’interroger le statut de synchronisation d’une Live Copy.

  • LiveAction - Une LiveAction est une action exécutée sur chaque ressource impliquée dans le déploiement.

    • Les LiveAction ne sont générés que par les RolloutConfig.
  • LiveActionFactory - Un LiveActionFactory crée des objets LiveAction selon une configuration LiveAction. Les configurations sont stockées en tant que ressources dans le référentiel.

  • RolloutConfig - Le RolloutConfig contient une liste de LiveActions, à utiliser lors du déclenchement. La LiveCopy hérite de RolloutConfig et le résultat est présent dans LiveRelationship.

    • La configuration d’une Live Copy pour la toute première fois utilise également un RolloutConfig (qui déclenche les LiveAction).

Créer une action de synchronisation creating-a-new-synchronization-action

Vous pouvez créer des actions de synchronisation personnalisées à utiliser avec vos configurations de déploiement. Cela peut s’avérer utile lorsque les actions installées ne répondent pas aux exigences de votre application spécifique.

Pour ce faire, créez deux classes :

La LiveActionFactory crée des instances de la classe LiveAction pour une configuration donnée :

  • Les classes LiveAction incluent les méthodes suivantes :

    • getName - Renvoie le nom de l’action

      • Le nom est utilisé pour faire référence à l’action, par exemple, dans les configurations de déploiement.
    • execute - Effectue les tâches de l’action

  • Les classes LiveActionFactory incluent les méthodes suivantes :

    • LIVE_ACTION_NAME - Un champ qui contient le nom du LiveAction associé

      • Ce nom doit coïncider avec la valeur renvoyée par la méthode getName de la classe LiveAction.
    • createAction - Crée une instance de LiveAction

      • Le paramètre facultatif Resource peut être utilisé pour fournir des informations de configuration.
    • createsAction - Renvoie le nom du LiveAction associé

Accès au nœud de configuration LiveAction accessing-the-liveaction-configuration-node

Utilisez le nœud de configuration LiveAction dans le référentiel pour stocker les informations qui affectent le comportement d’exécution de l’instance LiveAction. Le nœud du référentiel qui stocke la configuration LiveAction est disponible pour l’objet LiveActionFactory lors de l’exécution. Par conséquent, vous pouvez ajouter des propriétés au nœud de configuration et les utiliser dans votre implémentation LiveActionFactory si nécessaire.

Par exemple, un LiveAction doit stocker le nom de l’auteur du plan directeur. Une propriété du nœud de configuration inclut le nom de la propriété de la page plan directeur qui stocke les informations. Lorsqu’elle est exécutée, la LiveAction récupère le nom de la propriété à partir de la configuration, puis obtient la valeur de la propriété.

Le paramètre de la méthode LiveActionFactory.createAction est un objet Resource. Cet objet Resource représente le noeud cq:LiveSyncAction pour cette action en direct dans la configuration du déploiement.

Voir Création d’une configuration de déploiement pour plus d’informations.

Comme d’habitude, lorsque vous utilisez un nœud de configuration, vous devez l’adapter à un objet ValueMap :

public LiveAction createAction(Resource resource) throws WCMException {
        ValueMap config;
        if (resource == null || resource.adaptTo(ValueMap.class) == null) {
            config = new ValueMapDecorator(Collections.<String, Object>emptyMap());
        } else {
            config = resource.adaptTo(ValueMap.class);
        }
        return new MyLiveAction(config, this);
}

Accès aux nœuds cibles, aux nœuds sources et à la relation LiveRelationship accessing-target-nodes-source-nodes-and-the-liverelationship

Les objets suivants sont fournis en tant que paramètres de la méthode execute de l’objet LiveAction :

  • Objet Resource représentant la source de la Live Copy

  • Un objet Resource qui représente la cible de la Live Copy.

  • Objet LiveRelationship pour la Live Copy

    • La valeur autoSave indique si votre LiveAction doit enregistrer les modifications apportées au référentiel.
    • La valeur reset indique le mode de réinitialisation du déploiement.

À partir de ces objets, vous pouvez obtenir des informations sur le LiveCopy. Vous pouvez également utiliser les objets Resource pour obtenir les objets ResourceResolver, Session et Node. Ces objets sont utiles pour manipuler le contenu du référentiel :

Dans la première ligne du code suivant, source est l’objet Resource de la page source :

ResourceResolver resolver = source.getResourceResolver();
Session session = resolver.adaptTo(javax.jcr.Session.class);
Node sourcenode = source.adaptTo(javax.jcr.Node.class);
NOTE
Les arguments Resource peuvent être des objets null ou Resources qui ne s’adaptent pas aux objets Node, tels que les objets NonExistingResource.

Créer une configuration de déploiement creating-a-new-rollout-configuration

Vous pouvez créer une configuration de déploiement lorsque les configurations de déploiement installées ne répondent pas aux exigences de votre application en procédant comme suit :

La nouvelle configuration de déploiement est alors disponible pour vous lors de la définition des configurations de déploiement sur une page de plan directeur ou de Live Copy.

Créer la configuration de déploiement create-the-rollout-configuration

Pour créer une configuration de déploiement :

  1. Ouvrez le CRXDE Lite à l’adresse https://<host>:<port>/crx/de.

  2. Accédez à /apps/msm/<your-project>/rolloutconfigs, la version personnalisée de /libs/msm/wcm/rolloutconfigs de votre projet.

    • S’il s’agit de votre première configuration, cette branche /libs doit être utilisée comme modèle pour créer la branche sous /apps.
  3. Sous cet emplacement, créez un noeud avec les propriétés suivantes :

    • Name : nom de noeud de la configuration de déploiement, par exemple contentCopy ou workflow
    • Type  : cq:RolloutConfig
  4. Ajoutez les propriétés suivantes à ce nœud :

    • Nom  : jcr:title

      Type  : String
      Valeur : titre d’identification qui apparaîtra dans l’interface utilisateur

    • Nom  : jcr:description

      Type  : String
      Valeur  : une description facultative.

    • Nom  : cq:trigger

      Type  : String
      Valeur : Déclencheur de déploiement à utiliser

      • rollout
      • modification
      • publish
      • deactivate
  5. Cliquez sur Enregistrer tout.

Ajouter des actions de synchronisation à la configuration de déploiement add-synchronization-actions-to-the-rollout-configuration

Les configurations de déploiement sont stockées sous le noeud de configuration de déploiement que vous avez créé sous le noeud /apps/msm/<your-project>/rolloutconfigs.

Ajoutez des nœuds enfants de type cq:LiveSyncAction pour ajouter des actions de synchronisation à la configuration de déploiement. L’ordre des nœuds d’action de synchronisation détermine l’ordre dans lequel les actions se produisent.

  1. Dans CRXDE Lite, sélectionnez votre noeud Configuration de déploiement, par exemple /apps/msm/myproject/rolloutconfigs/myrolloutconfig.

  2. Créez un noeud avec les propriétés de noeud suivantes :

    • Name : nom de noeud de l’action de synchronisation
      • Le nom doit être identique au Nom de l’action de la table sous Actions de synchronisation telles que contentCopy ou workflow.
    • Type  : cq:LiveSyncAction
  3. Ajoutez et configurez autant de noeuds d’action de synchronisation que nécessaire.

  4. Réorganisez les noeuds d’action de sorte que leur ordre corresponde à l’ordre dans lequel vous souhaitez qu’ils se produisent.

    • Le nœud d’action le plus haut se produit en premier.

Création et utilisation d’une classe LiveActionFactory simple creating-and-using-a-simple-liveactionfactory-class

Suivez les procédures de cette section pour développer une LiveActionFactory et l’utiliser dans une configuration de déploiement. Les procédures utilisent Maven et Eclipse pour développer et déployer la LiveActionFactory :

Le projet Maven et le code source de la classe Java sont disponibles dans le référentiel Git public.

Créer le projet Maven create-the-maven-project

La procédure suivante nécessite que vous ayez ajouté le profil adobe-public à votre fichier de paramètres Maven.

  1. Ouvrez une session de terminal ou de ligne de commande, puis modifiez le répertoire pour qu’il pointe vers l’emplacement où le projet sera créé.

  2. Saisissez la commande suivante :

    code language-text
    mvn archetype:generate -DarchetypeGroupId=com.day.jcr.vault -DarchetypeArtifactId=multimodule-content-package-archetype -DarchetypeVersion=1.0.0 -DarchetypeRepository=adobe-public-releases
    
  3. Spécifiez les valeurs suivantes à l’invite interactive :

    • groupId: com.adobe.example.msm
    • artifactId: MyLiveActionFactory
    • version: 1.0-SNAPSHOT
    • package: MyPackage
    • appsFolderName: myapp
    • artifactName: MyLiveActionFactory package
    • packageGroup: myPackages
  4. Démarrez Eclipse et importez le projet Maven.

Ajouter des dépendances au fichier POM add-dependencies-to-the-pom-file

Ajoutez des dépendances pour que le compilateur Eclipse puisse référencer les classes utilisées dans le code LiveActionFactory.

  1. Dans l’Explorateur de projets Eclipse, ouvrez le fichier MyLiveActionFactory/pom.xml.

  2. Dans l’éditeur, cliquez sur l’onglet pom.xml et localisez la section project/dependencyManagement/dependencies.

  3. Ajoutez le code XML suivant dans l’élément dependencyManagement, puis enregistrez le fichier.

    code language-xml
     <dependency>
      <groupId>com.day.cq.wcm</groupId>
      <artifactId>cq-msm-api</artifactId>
      <version>5.6.2</version>
      <scope>provided</scope>
     </dependency>
     <dependency>
      <groupId>org.apache.sling</groupId>
      <artifactId>org.apache.sling.api</artifactId>
      <version>2.4.3-R1488084</version>
      <scope>provided</scope>
     </dependency>
     <dependency>
      <groupId>com.day.cq.wcm</groupId>
      <artifactId>cq-wcm-api</artifactId>
      <version>5.6.6</version>
      <scope>provided</scope>
     </dependency>
     <dependency>
      <groupId>org.apache.sling</groupId>
      <artifactId>org.apache.sling.commons.json</artifactId>
      <version>2.0.6</version>
      <scope>provided</scope>
     </dependency>
     <dependency>
      <groupId>com.day.cq</groupId>
      <artifactId>cq-commons</artifactId>
      <version>5.6.4</version>
      <scope>provided</scope>
     </dependency>
     <dependency>
      <groupId>org.apache.sling</groupId>
      <artifactId>org.apache.sling.jcr.jcr-wrapper</artifactId>
      <version>2.0.0</version>
      <scope>provided</scope>
     </dependency>
     <dependency>
      <groupId>com.day.cq</groupId>
      <artifactId>cq-commons</artifactId>
      <version>5.6.4</version>
      <scope>provided</scope>
     </dependency>
    
  4. Ouvrez le fichier POM pour le bundle depuis l’explorateur de projets à l’adresse MyLiveActionFactory-bundle/pom.xml.

  5. Dans l’éditeur, cliquez sur l’onglet pom.xml et localisez la section project/dependencies. Ajoutez le code XML suivant dans l’élément des dépendances, puis enregistrez le fichier :

    code language-xml
     <dependency>
      <groupId>com.day.cq.wcm</groupId>
      <artifactId>cq-msm-api</artifactId>
     </dependency>
     <dependency>
      <groupId>org.apache.sling</groupId>
      <artifactId>org.apache.sling.api</artifactId>
     </dependency>
     <dependency>
      <groupId>com.day.cq.wcm</groupId>
      <artifactId>cq-wcm-api</artifactId>
     </dependency>
     <dependency>
      <groupId>org.apache.sling</groupId>
      <artifactId>org.apache.sling.commons.json</artifactId>
     </dependency>
     <dependency>
      <groupId>com.day.cq</groupId>
      <artifactId>cq-commons</artifactId>
     </dependency>
     <dependency>
      <groupId>org.apache.sling</groupId>
      <artifactId>org.apache.sling.jcr.jcr-wrapper</artifactId>
     </dependency>
     <dependency>
      <groupId>com.day.cq</groupId>
      <artifactId>cq-commons</artifactId>
     </dependency>
    

Implémenter LiveActionFactory implement-liveactionfactory

La classe LiveActionFactory suivante implémente une LiveAction qui enregistre les messages sur les pages source et cible et copie la propriété cq:lastModifiedBy du nœud source vers le nœud cible. Le nom de la live action est exampleLiveAction.

  1. Dans l’Explorateur de projets Eclipse, cliquez avec le bouton droit sur le package MyLiveActionFactory-bundle/src/main/java/com.adobe.example.msm et cliquez sur Nouveau > Classe.

  2. Comme nom, entrez ExampleLiveActionFactory, puis cliquez sur Terminer.

  3. Ouvrez le fichier ExampleLiveActionFactory.java, remplacez le contenu par le code suivant et enregistrez le fichier.

    code language-java
    package com.adobe.example.msm;
    
    import java.util.Collections;
    
    import org.apache.felix.scr.annotations.Component;
    import org.apache.felix.scr.annotations.Property;
    import org.apache.felix.scr.annotations.Service;
    import org.apache.sling.api.resource.Resource;
    import org.apache.sling.api.resource.ResourceResolver;
    import org.apache.sling.api.resource.ValueMap;
    import org.apache.sling.api.wrappers.ValueMapDecorator;
    import org.apache.sling.commons.json.io.JSONWriter;
    import org.apache.sling.commons.json.JSONException;
    
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    
    import javax.jcr.Node;
    import javax.jcr.RepositoryException;
    import javax.jcr.Session;
    
    import com.day.cq.wcm.msm.api.ActionConfig;
    import com.day.cq.wcm.msm.api.LiveAction;
    import com.day.cq.wcm.msm.api.LiveActionFactory;
    import com.day.cq.wcm.msm.api.LiveRelationship;
    import com.day.cq.wcm.api.WCMException;
    
    @Component(metatype = false)
    @Service
    public class ExampleLiveActionFactory implements LiveActionFactory<LiveAction> {
     @Property(value="exampleLiveAction")
     static final String actionname = LiveActionFactory.LIVE_ACTION_NAME;
    
     public LiveAction createAction(Resource config) {
      ValueMap configs;
      /* Adapt the config resource to a ValueMap */
            if (config == null || config.adaptTo(ValueMap.class) == null) {
                configs = new ValueMapDecorator(Collections.<String, Object>emptyMap());
            } else {
                configs = config.adaptTo(ValueMap.class);
            }
    
      return new ExampleLiveAction(actionname, configs);
     }
     public String createsAction() {
      return actionname;
     }
     /************* LiveAction ****************/
     private static class ExampleLiveAction implements LiveAction {
      private String name;
      private ValueMap configs;
      private static final Logger log = LoggerFactory.getLogger(ExampleLiveAction.class);
    
      public ExampleLiveAction(String nm, ValueMap config){
       name = nm;
       configs = config;
      }
    
      public void execute(Resource source, Resource target,
        LiveRelationship liverel, boolean autoSave, boolean isResetRollout)
          throws WCMException {
    
       String lastMod = null;
    
       log.info(" *** Executing ExampleLiveAction *** ");
    
       /* Determine if the LiveAction is configured to copy the cq:lastModifiedBy property */
       if ((Boolean) configs.get("repLastModBy")){
    
        /* get the source's cq:lastModifiedBy property */
        if (source != null && source.adaptTo(Node.class) !=  null){
         ValueMap sourcevm = source.adaptTo(ValueMap.class);
         lastMod = sourcevm.get(com.day.cq.wcm.msm.api.MSMNameConstants.PN_PAGE_LAST_MOD_BY, String.class);
        }
    
        /* set the target node's la-lastModifiedBy property */
        Session session = null;
        if (target != null && target.adaptTo(Node.class) !=  null){
         ResourceResolver resolver = target.getResourceResolver();
         session = resolver.adaptTo(javax.jcr.Session.class);
         Node targetNode;
         try{
          targetNode=target.adaptTo(javax.jcr.Node.class);
          targetNode.setProperty("la-lastModifiedBy", lastMod);
          log.info(" *** Target node lastModifiedBy property updated: {} ***",lastMod);
         }catch(Exception e){
          log.error(e.getMessage());
         }
        }
        if(autoSave){
         try {
          session.save();
         } catch (Exception e) {
          try {
           session.refresh(true);
          } catch (RepositoryException e1) {
           e1.printStackTrace();
          }
          e.printStackTrace();
         }
        }
       }
      }
      public String getName() {
       return name;
      }
    
      /************* Deprecated *************/
      @Deprecated
      public void execute(ResourceResolver arg0, LiveRelationship arg1,
        ActionConfig arg2, boolean arg3) throws WCMException {
      }
      @Deprecated
      public void execute(ResourceResolver arg0, LiveRelationship arg1,
        ActionConfig arg2, boolean arg3, boolean arg4)
          throws WCMException {
      }
      @Deprecated
      public String getParameterName() {
       return null;
      }
      @Deprecated
      public String[] getPropertiesNames() {
       return null;
      }
      @Deprecated
      public int getRank() {
       return 0;
      }
      @Deprecated
      public String getTitle() {
       return null;
      }
      @Deprecated
      public void write(JSONWriter arg0) throws JSONException {
      }
     }
    }
    
  4. A l’aide du terminal ou de la session de commande, remplacez le répertoire par le répertoire MyLiveActionFactory (répertoire du projet Maven). Ensuite, entrez la commande suivante :

    code language-shell
    mvn -PautoInstallPackage clean install
    
  5. Le fichier d'AEM error.log doit indiquer que le lot est démarré, visible dans les journaux à l'emplacement https://<host>:<port>/system/console/status-slinglogs.

    code language-text
    13.08.2013 14:34:55.450 *INFO* [OsgiInstallerImpl] com.adobe.example.msm.MyLiveActionFactory-bundle BundleEvent RESOLVED
    13.08.2013 14:34:55.451 *INFO* [OsgiInstallerImpl] com.adobe.example.msm.MyLiveActionFactory-bundle BundleEvent STARTING
    13.08.2013 14:34:55.451 *INFO* [OsgiInstallerImpl] com.adobe.example.msm.MyLiveActionFactory-bundle BundleEvent STARTED
    13.08.2013 14:34:55.453 *INFO* [OsgiInstallerImpl] com.adobe.example.msm.MyLiveActionFactory-bundle Service [com.adobe.example.msm.ExampleLiveActionFactory,2188] ServiceEvent REGISTERED
    13.08.2013 14:34:55.454 *INFO* [OsgiInstallerImpl] org.apache.sling.audit.osgi.installer Started bundle com.adobe.example.msm.MyLiveActionFactory-bundle [316]
    

Création de l’exemple de configuration de déploiement create-the-example-rollout-configuration

Créez la configuration de déploiement du MSM qui utilise la LiveActionFactory que vous avez créée :

  1. Créez et configurez une configuration de déploiement avec la procédure standard à l’aide des propriétés :

    • Titre  : exemple de configuration de déploiement
    • Nom  : examplerolloutconfig
    • cq:trigger  : publish

Ajout de la LiveAction à l’exemple de configuration de déploiement add-the-live-action-to-the-example-rollout-configuration

Paramétrez la configuration de déploiement que vous avez créée dans la procédure précédente afin qu’elle utilise la classe ExampleLiveActionFactory.

  1. Ouvrez CRXDE Lite.

  2. Créez le nœud correspondant sous /apps/msm/rolloutconfigs/examplerolloutconfig/jcr:content :

    • Nom  : exampleLiveAction
    • Type  : cq:LiveSyncAction
  3. Cliquez sur Enregistrer tout.

  4. Sélectionnez le noeud exampleLiveAction et ajoutez une propriété pour indiquer à la classe ExampleLiveAction que la propriété cq:LastModifiedBy doit être répliquée de la source vers le noeud cible.

    • Nom  : repLastModBy
    • Type  : Boolean
    • Valeur  : true
  5. Cliquez sur Enregistrer tout.

Créer la Live Copy create-the-live-copy

Créez une Live Copy de la branche English/Products du site de référence WKND à l’aide de votre configuration de déploiement :

  • Source  : /content/wknd/language-masters/en/products

  • Configuration de déploiement  : exemple de configuration de déploiement

Activez la page Products (en anglais) de la branche source et observez les messages de journalisation générés par la classe LiveAction :

16.08.2013 10:53:33.055 *INFO* [Thread-444535] com.adobe.example.msm.ExampleLiveActionFactory$ExampleLiveAction  ***ExampleLiveAction has been executed.***
16.08.2013 10:53:33.055 *INFO* [Thread-444535] com.adobe.example.msm.ExampleLiveActionFactory$ExampleLiveAction  ***Target node lastModifiedBy property updated: admin ***

Modifer les noms de langue et les pays par défaut changing-language-names-and-default-countries

AEM utilise un ensemble par défaut de codes de langue et de pays.

  • Le code de langue par défaut est le code à deux lettres en minuscules, tel que défini par la norme ISO-639-1.
  • Le code de pays par défaut est le code à deux lettres, en minuscules ou en majuscules, comme défini par la norme ISO 3166.

MSM utilise une liste stockée de codes de langue et de pays pour déterminer le nom du pays associé au nom de la version linguistique de votre page. Si nécessaire, vous pouvez modifier les aspects suivants de la liste :

  • Titres de langue
  • Noms de pays
  • Pays par défaut pour les langues (pour les codes tels que en, de, entre autres)

La liste des langues est stockée sous le nœud /libs/wcm/core/resources/languages. Chaque nœud enfant représente une langue ou un code langue-pays :

  • Le nom du noeud est le code de langue (par exemple en ou de) ou le code language_country (par exemple en_us ou de_ch).

  • La propriété language du nœud stocke le nom complet de la langue pour le code.

  • La propriété country du nœud stocke le nom complet du pays pour le code.

  • Lorsque le nom de nœud consiste uniquement en un code de langue (en, par exemple), la propriété de pays est * et une propriété supplémentaire defaultCountry stocke le code langue-pays pour indiquer le pays à utiliser.

Définition de la langue

Pour modifier les langues :

  1. Ouvrez CRXDE Lite.

  2. Sélectionnez le dossier /apps et cliquez sur Créer, puis sur Créer un dossier.

  3. Nommez le nouveau dossier wcm.

  4. Répétez l’étape précédente pour créer l’arborescence de dossiers /apps/wcm/core. Créez un noeud de type sling:Folder dans core appelé resources.

  5. Cliquez avec le bouton droit sur le nœud /libs/wcm/core/resources/languages et cliquez sur Copier.

  6. Cliquez avec le bouton droit sur le dossier /apps/wcm/core/resources et cliquez sur Coller. Modifiez les nœuds enfants selon les besoins.

  7. Cliquez sur Enregistrer tout.

  8. Cliquez sur Outils, Opérations puis Console Web. Dans cette console, cliquez sur OSGi, puis Configuration.

  9. Recherchez et cliquez sur le Gestionnaire de langues de gestion de contenu Web Day CQ et redéfinissez la valeur de Liste de langues sur /apps/wcm/core/resources/languages, puis cliquez sur Enregistrer.

    Gestionnaire de langues de la gestion du contenu web Day CQ

Configuration des verrous MSM sur les propriétés de page configuring-msm-locks-on-page-properties

Lors de la création d’une propriété de page personnalisée, vous devrez peut-être déterminer si la nouvelle propriété doit être éligible au déploiement sur des Live Copies.

Par exemple, si deux nouvelles propriétés de page sont ajoutées :

  • Contact e-mail :

    • Cette propriété ne doit pas être déployée, car elle sera différente dans chaque pays (ou marque, etc.).
  • Style visuel clé :

    • Cette propriété doit être déployée, car elle est (généralement) commune à tous les pays (ou marques, etc.).

Assurez-vous ensuite que les propriétés suivantes sont correctement configurées :

  • Contact e-mail :

  • Style visuel clé :

    • Assurez-vous que vous n’êtes pas autorisé à modifier cette propriété, sauf si l’héritage est annulé.
    • Veillez également à pouvoir rétablir l’héritage. Pour le contrôler, cliquez sur les liens de chaîne/chaîne brisée qui s’activent pour indiquer l’état de la connexion.

La propriété de boîte de dialogue détermine si une propriété de page est soumise au déploiement, et donc à l’annulation ou au rétablissement de l’héritage lors de la modification :

  • cq-msm-lockable

    • Le symbole de lien de chaîne est alors créé dans la boîte de dialogue.

    • Cela ne permet de modifier que si l’héritage est annulé (le lien de chaîne est rompu).

    • Cela s’applique uniquement au premier niveau enfant de la ressource.

      • Type  : String

      • Valeur : contient le nom de la propriété en question et est comparable à la valeur de la propriété name

        • Par exemple, voir

          /libs/foundation/components/page/cq:dialog/content/items/tabs/items/basic/items/column/items/title/items/title

Lorsque cq-msm-lockable a été défini, la rupture/le verrouillage de la chaîne interagit avec le MSM de la façon suivante :

  • Si la valeur de cq-msm-lockable est :

    • Relative (par exemple, myProperty ou ./myProperty)

      • Le fait de rompre la chaîne ajoute et supprime la propriété de cq:propertyInheritanceCancelled.
    • Absolue (par exemple, /image)

      • La rupture de la chaîne annule l’héritage en ajoutant le mixin cq:LiveSyncCancelled à ./image et en définissant cq:isCancelledForChildren sur true.

      • La fermeture de la chaîne rétablit l’héritage.

NOTE
cq-msm-lockable s’applique au premier niveau enfant de la ressource à éditer et il n’est pas fonctionnel à un niveau plus profond, que la valeur soit définie comme absolue ou relative.
NOTE
Lorsque vous réactivez l’héritage, la propriété de page de la Live Copy n’est pas automatiquement synchronisée avec la propriété source. Vous pouvez demander manuellement une synchronisation si nécessaire.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab