Utöka Multi Site Manager extending-the-multi-site-manager

Det här dokumentet hjälper dig att förstå hur du kan utöka funktionaliteten för Multi Site Manager och omfattar följande ämnen.

  • 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
TIP
Den här sidan är lättare att förstå i sammanhanget för dokumentet Återanvända innehåll: Multi Site Manager.
CAUTION
Multi Site Manager och dess API används vid utvecklingen av en webbplats och är därför endast avsedda att användas i en författarmiljö.

Översikt över Java API overview-of-the-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 avsnittet Använda villkor):

Huvudobjekt för MSM API

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

    Utskrift

    • Det är valfritt att använda en ritningskonfiguration ( Blueprint), men:

      • Det gör att författaren kan använda alternativet Rollout i källan för att uttryckligen skicka ändringar till live-kopior som ärver från den här källan.
      • Det gör att författaren kan använda Skapa plats, vilket gör att användaren enkelt kan välja språk och konfigurera strukturen för live-kopian.
      • Den definierar standardkonfigurationen för utrullning för alla resulterande live-kopior.
  • LiveRelationship - LiveRelationship anger anslutningen (relationen) mellan en resurs i livekopiegrenen och dess motsvarande källa/rityta.

    • Relationerna används vid arv och utrullning.

    • LiveRelationship-objekt ger åtkomst (referenser) till rollout-konfigurationerna ( RolloutConfig), LiveCopy och LiveStatus-objekt som är relaterade till relationen.

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

  • LiveCopy - En LiveCopy innehåller konfigurationsinformation för relationerna (LiveRelationship) mellan live-kopieresurserna och deras käll-/planerarresurser.

    • Använd klassen LiveCopy 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.

    • En LiveCopy-nod skapas varje gång Skapa plats eller Skapa Live-kopia används.

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

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

    • LiveAction genereras bara av RolloutConfigs.
  • LiveActionFactory - En LiveActionFactory skapar LiveAction objekt som tilldelats en LiveAction-konfiguration. Konfigurationer lagras som resurser i databasen.

  • RolloutConfig - RolloutConfig innehåller en lista med LiveActions som ska användas när den aktiveras. 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 LiveAction).

Skapa en ny synkroniseringsåtgärd creating-a-new-synchronization-action

Du kan skapa anpassade synkroniseringsåtgärder som du kan använda med dina utrullningskonfigurationer. Detta kan vara användbart när de installerade åtgärderna inte uppfyller dina specifika programkrav.

Skapa då två klasser:

LiveActionFactory skapar instanser av klassen LiveAction för en given konfiguration:

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

    • getName - Returnerar åtgärdens namn

      • Namnet används för att referera till åtgärden, till exempel i utrullningskonfigurationer.
    • execute - Utför åtgärderna

  • LiveActionFactory-klasser innehåller följande medlemmar:

    • LIVE_ACTION_NAME - Ett fält som innehåller namnet på den associerade LiveAction

      • Det här namnet måste sammanfalla med värdet som returneras av metoden getName i klassen LiveAction.
    • createAction - Skapar en instans av LiveAction

      • Den valfria parametern Resource kan användas för att tillhandahålla konfigurationsinformation.
    • createsAction - Returnerar namnet på associerad LiveAction

Åtkomst till konfigurationsnoden för LiveAction accessing-the-liveaction-configuration-node

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

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

Parametern för metoden LiveActionFactory.createAction är ett Resource-objekt. Det här Resource-objektet representerar cq:LiveSyncAction-noden för den här live-åtgärden i rollout-konfigurationen.

Mer information finns i Skapa en utrullningskonfiguration.

Som vanligt när du använder en konfigurationsnod bör du anpassa den till ett 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, Source-noder och LiveRelationship accessing-target-nodes-source-nodes-and-the-liverelationship

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

  • Ett Resource-objekt som representerar källan för live-kopian

  • Ett Resource-objekt som representerar målet för live-kopian.

  • Objektet LiveRelationship för den aktiva kopian

    • Värdet autoSave anger om LiveAction ska spara ändringar som görs i databasen
    • Värdet reset anger återställningsläget för utrullning.

Från dessa objekt kan du få information om LiveCopy. Du kan också använda objekten Resource för att hämta objekten ResourceResolver, Session och Node. 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-objektet på källsidan:

ResourceResolver resolver = source.getResourceResolver();
Session session = resolver.adaptTo(javax.jcr.Session.class);
Node sourcenode = source.adaptTo(javax.jcr.Node.class);
NOTE
Resource-argumenten kan vara null- eller Resources-objekt som inte anpassar sig till Node-objekt, till exempel NonExistingResource-objekt.

Skapa en ny utrullningskonfiguration creating-a-new-rollout-configuration

Du kan skapa en utrullningskonfiguration om de installerade utrullningskonfigurationerna inte uppfyller dina programkrav i två steg:

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 create-the-rollout-configuration

Så här skapar du en utrullningskonfiguration:

  1. Öppna CRXDE Lite på https://<host>:<port>/crx/de.

  2. Navigera till /apps/msm/<your-project>/rolloutconfigs, projektets anpassade version av /libs/msm/wcm/rolloutconfigs.

    • Om det här är din första konfiguration måste den här /libs-grenen användas som mall för att skapa den nya grenen under /apps.
  3. Skapa en nod med följande egenskaper under den här platsen:

    • Namn: Nodnamnet för utrullningskonfigurationen, 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: Utlösaren för utrullning ska användas

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

Lägg till synkroniseringsåtgärder i utrullningskonfigurationen add-synchronization-actions-to-the-rollout-configuration

Utrullningskonfigurationer lagras under den rollout-konfigurationsnod som du har skapat under noden /apps/msm/<your-project>/rolloutconfigs.

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

  1. I CRXDE Lite väljer du noden Utgående konfiguration, till exempel /apps/msm/myproject/rolloutconfigs/myrolloutconfig.

  2. Skapa en nod med följande nodegenskaper:

    • Namn: Nodnamnet för synkroniseringsåtgärden
      • Namnet måste vara detsamma som åtgärdsnamnet 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.

  4. 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 creating-and-using-a-simple-liveactionfactory-class

Följ anvisningarna i det här avsnittet för att utveckla en LiveActionFactory och använda den i en utrullningskonfiguration. I procedurerna används Maven och Eclipse för att utveckla och distribuera LiveActionFactory:

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

Skapa projektet Maven create-the-maven-project

Följande procedur kräver att du har lagt till profilen adobe-public 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:

    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. 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 Maven-projektet.

Lägg till beroenden till POM-filen add-dependencies-to-the-pom-file

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

  1. Öppna filen MyLiveActionFactory/pom.xml i Eclipse Project Explorer.

  2. Klicka på fliken pom.xml i redigeraren och leta upp avsnittet project/dependencyManagement/dependencies.

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

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

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

    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>
    

Implementera LiveActionFactory implement-liveactionfactory

Följande LiveActionFactory-klass implementerar en LiveAction som loggar meddelanden om käll- och målsidorna och kopierar egenskapen cq:lastModifiedBy från källnoden till målnoden. Den aktiva åtgärdens namn är exampleLiveAction.

  1. Högerklicka på paketet MyLiveActionFactory-bundle/src/main/java/com.adobe.example.msm i Eclipse Project Explorer och klicka på New > Class.

  2. Ange ExampleLiveActionFactory som namn och klicka sedan på Slutför.

  3. Öppna filen ExampleLiveActionFactory.java, ersätt innehållet med följande kod och spara filen.

    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. Använd terminal- eller kommandosessionen för att ändra katalogen till katalogen MyLiveActionFactory (Maven-projektkatalogen). Ange sedan följande kommando:

    code language-shell
    mvn -PautoInstallPackage clean install
    
  5. AEM error.log-filen ska ange att paketet har startats, vilket visas i loggarna på 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]
    

Skapa exempelkonfigurationen create-the-example-rollout-configuration

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

  1. Skapa och konfigurera en utrullningskonfiguration med standardproceduren med hjälp av egenskaperna:

    • Titel: Exempel på konfiguration för utrullning
    • Namn: exampleLoutconfig
    • cq:trigger: publish

Lägg till Live-åtgärden i exempelkonfigurationen för utrullning add-the-live-action-to-the-example-rollout-configuration

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

  1. Öppna CRXDE Lite.

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

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

  4. Markera noden exampleLiveAction och lägg till en egenskap som anger för klassen ExampleLiveAction att egenskapen cq:LastModifiedBy ska replikeras från källan till målnoden.

    • Namn: repLastModBy
    • Typ: Boolean
    • Värde: true
  5. Klicka på Spara alla.

Skapa Live Copy create-the-live-copy

Skapa en live-kopia av den engelska/produktgrenen på WKND-referensplatsen med din rollout-konfiguration:

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

  • Konfiguration för utrullning: Exempel på konfiguration för utrullning

Aktivera sidan Produkter (engelska) i källgrenen och observera de loggmeddelanden som genereras av klassen 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 ***

Ändra språknamn och standardländer changing-language-names-and-default-countries

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

  • Standardspråkkoden är den gemena tvåbokstavskoden enligt 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 delar av listan om det behövs:

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

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

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

  • Egenskapen language för noden lagrar det fullständiga namnet på språket för koden.

  • Egenskapen country 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) är egenskapen country * och ytterligare en defaultCountry-egenskap lagrar koden för det språklandet som anger vilket land som ska användas.

Språkdefinition

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

  1. Öppna CRXDE Lite.

  2. Markera mappen /apps, klicka på Skapa och sedan på Skapa mapp.

  3. Namnge den nya mappen wcm.

  4. Upprepa föregående steg för att skapa mappträdet /apps/wcm/core. Skapa en nod av typen sling:Folder i core med namnet resources.

  5. Högerklicka på noden /libs/wcm/core/resources/languages och klicka på Kopiera.

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

  7. Klicka på Spara alla.

  8. Klicka på Verktyg, Åtgärder och sedan på Webbkonsol. Från den här konsolen klickar du på OSGi och sedan på Konfiguration.

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

    Day CQ WCM Language Manager

Konfigurera MSM-lås på sidegenskaper configuring-msm-locks-on-page-properties

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 lanseras eftersom den kommer att vara olika i varje land (eller varumärke osv.).
  • Visuell huvudstil:

    • Projektkravet är att den här egenskapen 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 om inte arvet avbryts.
    • Se även till att du sedan kan återskapa arv. 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

    • Då skapas kedjelänkssymbolen i dialogrutan.

    • Detta tillåter bara redigering om arvet avbryts (kedjelänken bryts).

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

      • Typ: String

      • Värde: Innehåller namnet på den aktuella egenskapen och är jämförbart med värdet för egenskapen name

        • Se till exempel

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

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

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

    • Relativ (till exempel myProperty eller ./myProperty)

      • Om kedjan bryts läggs egenskapen till och tas bort från cq:propertyInheritanceCancelled.
    • Absolut (till exempel /image)

      • Om kedjan bryts avbryts arvet genom att cq:LiveSyncCancelled-blandningen läggs till i ./image och cq:isCancelledForChildren ställs in på true.

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

NOTE
cq-msm-lockable gäller för den första underordnade nivån för resursen som ska redigeras och den fungerar inte på något djupare överordnat nivå, oavsett om värdet är definierat som absolut eller relativ.
NOTE
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.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab