Utöka Multi Site Manager

På den här sidan kan du utöka funktionerna i Multi Site Manager:

  • Läs mer om huvudmedlemmarna i MSM Java API.
  • Skapa en ny synkroniseringsåtgärd som kan användas i en utrullningskonfiguration.
  • Ändra standardspråk och landskoder.
OBSERVERA

Den här sidan bör läsas tillsammans med Återanvända innehåll: Multi Site Manager.

Följande avsnitt av Omstrukturering av Sites Repository i AEM 6.4 kan också vara av intresse:

FÖRSIKTIGHET

Multi Site Manager och dess API används vid utvecklingen av en webbplats, så de är bara avsedda att användas i en författarmiljö.

Översikt över Java API

Hantering av flera platser består av följande paket:

De huvudsakliga MSM API-objekten interagerar på följande sätt (se även Villkor):

chlimage_1-73

  • Blueprint

    A Blueprint (som i konfiguration av utkast) anger de sidor från vilka en live-kopia kan ärva innehåll.

    chlimage_1-74

    • Användning av en ritningskonfiguration ( Blueprint) är valfritt, men:

      • Tillåter författaren att använda Utrullning på källan (för att (explicit) överföra ändringar till live-kopior som ärver från den här källan).
      • Tillåter författaren att använda Skapa webbplats; på så sätt kan användaren enkelt välja språk och konfigurera strukturen för live-kopian.
      • Definierar standardkonfigurationen för utrullning för alla resulterande live-kopior.
  • LiveRelationship

    The LiveRelationship Anger anslutningen (relationen) mellan en resurs i livekopiegrenen och dess ekvivalenta käll-/planresurs.

    • Relationerna används vid arv och utrullning.

    • LiveRelationship objekt ger åtkomst (referenser) till utrullningskonfigurationer ( RolloutConfig), LiveCopyoch LiveStatus objekt som är relaterade till relationen.

    • En live-kopia skapas till exempel i /content/copy/us från källan/ritningen på /content/we-retail/language-masters. Resurserna /content/we.retail/language-masters/en/jcr:content och /content/copy/us/en/jcr:content skapa en relation.

  • LiveCopy

    LiveCopy innehåller konfigurationsinformation för relationerna ( LiveRelationship) mellan de aktiva kopieringsresurserna och deras käll-/ritresurser.

    • Använd LiveCopy -klass för att komma åt sidans sökväg, sökvägen till käll-/ritningssidan, rollout-konfigurationerna och om underordnade sidor också inkluderas i LiveCopy.

    • A LiveCopy noden skapas varje gång Skapa webbplats eller Skapa Live Copy används.

  • LiveStatus

    LiveStatus objekt ger åtkomst till körningsstatus för en LiveRelationship. Används för att fråga synkroniseringsstatusen för en live-kopia.

  • LiveAction

    A LiveAction är en åtgärd som utförs på varje resurs som ingår i utrullningen.

    • LiveActions genereras endast av RolloutConfigs.
  • LiveActionFactory

    Skapar LiveAction objekt som LiveAction konfiguration. Konfigurationer lagras som resurser i databasen.

  • RolloutConfig

    The RolloutConfig innehåller en lista med LiveActions, som ska användas när den aktiveras. The LiveCopy ärver RolloutConfig och resultatet finns i LiveRelationship.

    • När du konfigurerar en live-kopia för första gången används också en RolloutConfig (som utlöser LiveActions).

Skapa en ny synkroniseringsåtgärd

Skapa anpassade synkroniseringsåtgärder som du kan använda med dina utrullningskonfigurationer. Skapa en synkroniseringsåtgärd när installerade åtgärder uppfyller inte dina specifika programkrav. Skapa då två klasser:

The LiveActionFactory skapar instanser av LiveAction klass för en viss konfiguration:

  • LiveAction -klasser innehåller följande metoder:

    • getName: Returnerar namnet på åtgärden Namnet används för att referera till åtgärden, till exempel i utrullningskonfigurationer.
    • execute: Utför åtgärderna.
  • LiveActionFactory -klasserna innehåller följande medlemmar:

    • LIVE_ACTION_NAME: Ett fält som innehåller namnet på det associerade LiveAction. Namnet måste sammanfalla med värdet som returneras av getName metoden LiveAction klassen.

    • createAction: Skapar en instans av LiveAction. Valfritt Resource -parametern kan användas för att tillhandahålla konfigurationsinformation.

    • createsAction: Returnerar namnet på associerad LiveAction.

Åtkomst till konfigurationsnoden för LiveAction

Använd LiveAction konfigurationsnoden i databasen för att lagra information som påverkar körningsbeteendet för LiveAction -instans. Noden i databasen som lagrar LiveAction konfigurationen är tillgänglig för LiveActionFactory objekt vid körning. Därför kan du lägga till egenskaper i konfigurationsnoden och använda dem i LiveActionFactory implementering efter behov.

Till exempel en LiveAction måste lagra namnet på den som skapat ritningen. En egenskap för konfigurationsnoden innehåller egenskapsnamnet för den planeringssida som lagrar informationen. Vid körning visas LiveAction hämtar egenskapsnamnet från konfigurationen och hämtar sedan egenskapsvärdet.

Parametern för [LiveActionFactory](https://helpx.adobe.com/experience-manager/6-5/sites/developing/using/reference-materials/javadoc/com/day/cq/wcm/msm/api/LiveActionFactory.html).createAction metoden är en Resource -objekt. Detta Resource objektet representerar cq:LiveSyncAction nod för denna live-åtgärd i utrullningskonfigurationen, se Skapa en utrullningskonfiguration. Som vanligt när du använder en konfigurationsnod bör du anpassa den till en ValueMap objekt:

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);
}

Åtkomst till målnoder, källnoder och LiveRelationship

Följande objekt anges som parametrar för execute metoden LiveAction objekt:

  • A Resource som representerar källan till Live Copy.

  • A Resource som representerar målet för Live Copy.

  • The LiveRelationship objekt för live-kopian.

  • The autoSave värdet anger om LiveAction bör spara ändringar som görs i databasen.

  • Återställningsvärdet anger återställningsläget för utrullning.

Från dessa objekt kan du hämta all information om LiveCopy. Du kan också använda Resource objekt att hämta ResourceResolver, Sessionoch Node objekt. De här objekten är användbara för att hantera databasinnehåll:

I den första raden i följande kod är källan Resource källsidans objekt:

ResourceResolver resolver = source.getResourceResolver();
Session session = resolver.adaptTo(javax.jcr.Session.class);
Node sourcenode = source.adaptTo(javax.jcr.Node.class);
OBSERVERA

The Resource argument kan null eller Resources objekt som inte anpassar sig till Node objekt, som NonExistingResource objekt.

Skapa en ny utrullningskonfiguration

Skapa en utrullningskonfiguration när de installerade utrullningskonfigurationerna inte uppfyller dina programkrav:

Den nya utrullningskonfigurationen är sedan tillgänglig för dig när du ställer in utrullningskonfigurationer på en ritnings- eller Live copy-sida.

Skapa utrullningskonfiguration

Så här skapar du en ny utrullningskonfiguration:

  1. Öppna CRXDE Lite, till exempel:
    http://localhost:4502/crx/de

  2. Navigera till :
    /apps/msm/<your-project>/rolloutconfigs

    OBSERVERA

    Det här är projektets anpassade version av:
    /libs/msm/wcm/rolloutconfigs
    Måste skapas om detta är din första konfiguration.

    OBSERVERA

    Du får inte ändra något i sökvägen /libs.
    Detta beror på att innehållet i /libs skrivs över nästa gång du uppgraderar din instans (och kan mycket väl skrivas över när du använder en snabbkorrigering eller ett funktionspaket).
    Den rekommenderade metoden för konfiguration och andra ändringar är:

    • Återskapa önskat objekt (t.ex. som det finns i /libs) under /apps
    • Gör ändringar i /apps
  3. Under Skapa en nod med följande egenskaper:

    • Namn: Nodnamnet för utrullningskonfigurationen. md#installed-synchronization-actions), till exempel contentCopy eller workflow.
    • Typ: cq:RolloutConfig
  4. Lägg till följande egenskaper i den här noden:

    • Namn: jcr:title

      Typ: String
      Värde: En identifierande titel som visas i användargränssnittet.

    • Namn: jcr:description

      Typ: String
      Värde: En valfri beskrivning.

    • Namn: cq:trigger

      Typ: String
      Värde: The Utlösare för utrullning som ska användas. Välj från:

      • rollout
      • modification
      • publish
      • deactivate
  5. Klicka Spara alla.

Lägg till synkroniseringsåtgärder i utrullningskonfigurationen

Utrullningskonfigurationer lagras under konfigurationsnod för utrullning som du har skapat under /apps/msm/<your-project>/rolloutconfigs nod.

Lägg till underordnade noder av typen cq:LiveSyncAction för att lägga till synkroniseringsåtgärder i utrullningskonfigurationen. Ordningen på synkroniseringsåtgärdsnoderna avgör i vilken ordning åtgärderna utförs.

  1. Fortfarande i CRXDE Lite väljer du Konfiguration av utrullning nod.

    Till exempel:
    /apps/msm/myproject/rolloutconfigs/myrolloutconfig

  2. Skapa en nod med följande nodegenskaper:

    • Namn: Synkroniseringsåtgärdens nodnamn.
      Namnet måste vara detsamma som Åtgärdsnamn i tabellen under Synkroniseringsåtgärder, till exempel contentCopy eller workflow.
    • Typ: cq:LiveSyncAction
  3. Lägg till och konfigurera så många noder för synkroniseringsåtgärder som du behöver. Ordna om åtgärdsnoderna så att ordningen matchar den ordning i vilken du vill att de ska visas. Den översta åtgärdsnoden inträffar först.

Skapa och använda en enkel LiveActionFactory-klass

Följ anvisningarna i det här avsnittet för att utveckla en LiveActionFactory och använda den i en utrullningskonfiguration. Processerna använder Maven och Eclipse för att utveckla och driftsätta LiveActionFactory:

  1. Skapa maven-projektet och importera den till Eclipse.
  2. Lägg till beroenden till POM-filen.
  3. Implementera LiveActionFactory inteface och driftsätta OSGi-paketet.
  4. Skapa utrullningskonfigurationen.
  5. Skapa en live-kopia.

Maven-projektet och Java-klassens källkod är tillgängliga i det offentliga Git-arkivet.

KOD PÅ GITHUB

Koden för den här sidan finns på GitHub

Skapa projektet Maven

Följande procedur kräver att du har lagt till adobe-public-profilen i Maven-inställningsfilen.

  1. Öppna en terminal- eller kommandoradssession och ändra katalogen så att den pekar på den plats där projektet ska skapas.

  2. Ange följande kommando:

    mvn archetype:generate -DarchetypeGroupId=com.day.jcr.vault -DarchetypeArtifactId=multimodule-content-package-archetype -DarchetypeVersion=1.0.0 -DarchetypeRepository=adobe-public-releases
    
  3. Ange följande värden vid en interaktiv fråga:

    • groupId: com.adobe.example.msm
    • artifactId: MyLiveActionFactory
    • version: 1.0-SNAPSHOT
    • package: MyPackage
    • appsFolderName: myapp
    • artifactName: MyLiveActionFactory package
    • packageGroup: myPackages
  4. Starta Eclipse och importera projektet Maven.

Lägg till beroenden till POM-filen

Lägg till beroenden så att Eclipse-kompilatorn kan referera till klasserna som används i LiveActionFactory kod.

  1. Öppna filen i Eclipse Project Explorer:

    MyLiveActionFactory/pom.xml

  2. Klicka på pom.xml och leta upp project/dependencyManagement/dependencies -avsnitt.

  3. Lägg till följande XML i dependencyManagement och spara sedan filen.

     <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. Öppna POM-filen för paketet från ProjektutforskarenMyLiveActionFactory-bundle/pom.xml.

  5. Klicka på pom.xml och leta upp avsnittet Projekt/beroenden. Lägg till följande XML i beroendeelementet och spara sedan filen:

     <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>
    

Implementera LiveActionFactory

Följande LiveActionFactory class implements a LiveAction som loggar meddelanden om käll- och målsidor och kopierar cq:lastModifiedBy från källnoden till målnoden. Den aktiva åtgärdens namn är exampleLiveAction.

  1. Högerklicka på knappen MyLiveActionFactory-bundle/src/main/java/com.adobe.example.msm paketera och klicka på Nytt > Klass. För Namn, ange ExampleLiveActionFactory och sedan klicka Slutför.

  2. Öppna ExampleLiveActionFactory.java , ersätter innehållet med följande kod och sparar filen.

    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 {
      }
     }
    }
    
  3. Ändra katalogen till MyLiveActionFactory katalogen (Maven project directory). Ange sedan följande kommando:

    mvn -PautoInstallPackage clean install
    

    AEM error.log filen ska ange att paketet har startats.

    Till exempel: https://localhost:4502/system/console/status-slinglogs.

    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]
    

Skapa exempelkonfigurationen

Skapa den MSM-utrullningskonfiguration som använder LiveActionFactory som du har skapat:

  1. Skapa och konfigurera en Konfiguration av utrullning med standardproceduren - och använda egenskaperna:

    • Titel: Exempelkonfiguration
    • Namn: examplerolloutconfig
    • cq:trigger: publish

Lägg till Live-åtgärden i exempelkonfigurationen för utrullning

Konfigurera den utrullningskonfiguration som du skapade i föregående procedur så att den använder ExampleLiveActionFactory klassen.

  1. Öppna CRXDE Lite, till exempel https://localhost:4502/crx/de.

  2. Skapa följande nod under /apps/msm/rolloutconfigs/examplerolloutconfig/jcr:content:

    • Namn: exampleLiveAction
    • Typ: cq:LiveSyncAction
  3. Klicka Spara alla.

  4. Välj exampleLiveAction nod och lägg till följande egenskap:

    • Namn: repLastModBy
    • Typ: Boolean
    • Värde: true

    Den här egenskapen indikerar för ExampleLiveAction klassen som cq:LastModifiedBy ska replikeras från källan till målnoden.

  5. Klicka Spara alla.

Skapa Live Copy

Skapa en live-kopia på engelska/Products-grenen på referenswebbplatsen för webb.Retail med din rollout-konfiguration:

  • Källa: /content/we-retail/language-masters/en/products

  • Konfiguration av utrullning: Exempelkonfiguration

Aktivera Produkter (på engelska) sidan av källgrenen och observera loggmeddelandena som LiveAction klassen genererar:

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 ***

Ändra språknamn och standardländer

AEM använder en standarduppsättning med språk- och landskoder.

  • Standardspråkkoden är den gemena, tvåbokstavskod som definieras av ISO-639-1.
  • Standardlandskoden är den gemena eller versala tvåbokstavskoden enligt ISO 3166.

MSM använder en lagrad lista med språk- och landskoder för att fastställa namnet på landet som är associerat med namnet på språkversionen av sidan. Du kan ändra följande aspekter av listan om det behövs:

  • Språktitlar
  • Landsnamn
  • Standardländer för språk (för koder som en, de, bland annat)

Språklistan sparas under /libs/wcm/core/resources/languages nod. Varje underordnad nod representerar ett språk eller ett språkområde:

  • Nodnamnet är språkkoden (till exempel en eller de) eller koden för språk_land (till exempel en_us eller de_ch).

  • The language -egenskapen för noden lagrar det fullständiga namnet på kodspråket.

  • The country -egenskapen för noden lagrar det fullständiga namnet på landet för koden.

  • När nodnamnet bara består av en språkkod (till exempel en), egenskapen country är *och ytterligare defaultCountry -egenskapen lagrar koden för det land som ska anges.

chlimage_1-76

Så här ändrar du språk:

  1. Öppna CRXDE Lite i webbläsaren; till exempel https://localhost:4502/crx/de

  2. Välj /apps mapp och klicka på Skapa sedan Skapa mapp.

    Namnge den nya mappen wcm.

  3. Upprepa föregående steg för att skapa /apps/wcm/core mappträd. Skapa en nod av typen sling:Folder in core anropad resources.

  4. Högerklicka på /libs/wcm/core/resources/languages nod och klicka Kopiera.

  5. Högerklicka på /apps/wcm/core/resources mapp och klicka på Klistra in. Ändra de underordnade noderna efter behov.

  6. Klicka Spara alla.

  7. Klicka verktyg, Operationer sedan Webbkonsol. Klicka på OSGi sedan Konfiguration.

  8. Leta reda på och klicka Day CQ WCM Language Manager och ändra värdet för Språklista till /apps/wcm/core/resources/languagesoch sedan klicka Spara.

    chlimage_1-78

Konfigurera MSM-lås på sidegenskaper (pekaktiverat gränssnitt)

När du skapar en anpassad sidegenskap kan du behöva fundera på om den nya egenskapen ska kunna rullas ut till alla live-kopior.

Om till exempel två nya sidegenskaper läggs till:

  • E-postadress:

    • Den här egendomen behöver inte rullas ut eftersom den kommer att vara olika i varje land (eller varumärke osv.).
  • Visuell huvudstil:

    • Projektkravet är att denna egenskap ska rullas ut eftersom den (vanligtvis) är gemensam för alla länder (eller varumärken, osv.).

Då måste du se till att:

  • E-postadress:

  • Visuell huvudstil:

    • Se till att du inte får redigera den här egenskapen i det beröringsaktiverade användargränssnittet om inte arvet avbryts, och att du sedan kan återinstallera arvet; Detta styrs genom att klicka på kedjelänkarna/brutna kedjor som växlar för att ange anslutningsstatus.

Anger om en sidegenskap ska rullas ut och därför styrs arvet av egenskapen dialog, under förutsättning att arvet avbryts/återställs vid redigering:

  • cq-msm-lockable

    • kan användas för objekt i en dialogruta med pekfunktioner

    • skapar kedjelänkssymbolen i dialogrutan

    • tillåter bara redigering om arv avbryts (kedjelänken bryts)

    • gäller endast den första underordnade nivån för resursen

    • Typ: String

    • Värde: innehåller namnet på den aktuella egendomen (och är jämförbart med värdet på egendomen) name; se

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

När cq-msm-lockable har definierats, om kedjan bryts/stängs kommer den att interagera med MSM på följande sätt:

  • om värdet för cq-msm-lockable är:

    • Relativ (t.ex. myProperty eller ./myProperty)

      • den lägger till och tar bort egenskapen från cq:propertyInheritanceCancelled.
    • Absolut (t.ex. /image)

      • om du bryter kedjan avbryts arvet genom att lägga till cq:LiveSyncCancelled blanda till ./image och inställning cq:isCancelledForChildren till true.

      • Om du stänger kedjan återställs arvet.

OBSERVERA

cq-msm-lockable används på den första underordnade nivån för resursen som ska redigeras och den fungerar inte på något djupare nivåöverordnat objekt, oavsett om värdet är definierat som absolut eller relativ.

OBSERVERA

När du återaktiverar arv synkroniseras inte egenskapen för live-kopieringssidan automatiskt med egenskapen source. Du kan begära en synkronisering manuellt om det behövs.

På denna sida