DocumentatieAEM as a Cloud ServiceHandboek

Het beheer van meerdere sites uitbreiden extending-the-multi-site-manager

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder
  • Ontwikkelaar

Dit document helpt u begrijpen hoe te om de functionaliteit van de Multisite Manager uit te breiden en behandelt de volgende onderwerpen.

  • Meer informatie over de belangrijkste leden van de MSM Java API
  • Creeer een nieuwe synchronisatieactie die in een rollout configuratie kan worden gebruikt
  • De standaardtaal en -landcodes wijzigen
TIP
Deze pagina wordt gemakkelijker begrepen in de context van het document Gebruikend Inhoud opnieuw: De multi Manager van de Plaats.
CAUTION
De beheer van meerdere sites en de bijbehorende API worden gebruikt bij het ontwerpen van een website en zijn daarom alleen bedoeld voor gebruik in een auteursomgeving.

Overzicht van de Java API overview-of-the-java-api

Beheer van meerdere sites bestaat uit de volgende pakketten:

De belangrijkste voorwerpen MSM API in wisselwerking als volgt (zie ook de sectie Gebruikte Termen):

HoofdMSM API voorwerpen

  • Blueprint - A Blueprint (zoals in blauwdrukconfiguratie) specificeert de pagina's waarvan een levend exemplaar inhoud kan erven.

    Vervaging

    • Het gebruik van een blauwdrukconfiguratie ( Blueprint) is optioneel, maar:

      • Het staat de auteur toe om de optie van de Uitvoer op de bron te gebruiken om wijzigingen aan levende exemplaren uitdrukkelijk te duwen die van deze bron erven.
      • Het staat de auteur toe om te gebruiken creeer Plaats, die de gebruiker toestaat om talen gemakkelijk te selecteren en de structuur van het levende exemplaar te vormen.
      • Het bepaalt de standaardrollout configuratie voor om het even welke resulterende levende exemplaren.

  • LiveRelationship - De LiveRelationship geeft de verbinding (relatie) aan tussen een bron in de actieve kopieervertakking en de equivalente bron/blauwdrukbron ervan.

    • De relaties worden gebruikt bij het realiseren van overerving en rollout.

    • LiveRelationship -objecten bieden toegang (verwijzingen) tot de implementatieconfiguraties ( RolloutConfig ), LiveCopy en LiveStatus -objecten die betrekking hebben op de relatie.

    • Er wordt bijvoorbeeld in /content/copy/us een live kopie gemaakt van de bron/blauwdruk op /content/wknd/language-masters . De bronnen /content/wknd/language-masters/en/jcr:content en /content/copy/us/en/jcr:content vormen een relatie.

  • LiveCopy - A LiveCopy houdt de configuratiedetails voor de verhoudingen (LiveRelationship) tussen de levende exemplaarmiddelen en hun bron/blauwdruk middelen.

    • Met de klasse LiveCopy hebt u toegang tot het pad van de pagina, het pad van de bron-/blauwdrukpagina, de rollout-configuraties en of onderliggende pagina's ook in de LiveCopy worden opgenomen.

    • Een LiveCopy knoop wordt gecreeerd telkens als Plaats creeert of Levende Exemplaar wordt gebruikt tot stand brengen.

  • LiveStatus - LiveStatus -objecten bieden toegang tot de runtimestatus van een LiveRelationship . Wordt gebruikt om de synchronisatiestatus van een live kopie te controleren.

  • LiveAction - Een LiveAction is een handeling die wordt uitgevoerd op elke bron die bij de rollout is betrokken.

    • LiveAction s wordt slechts geproduceerd door RolloutConfig s.

  • LiveActionFactory - Een LiveActionFactory maakt LiveAction -object op basis van een LiveAction -configuratie. Configuraties worden opgeslagen als bronnen in de opslagplaats.

  • RolloutConfig - De RolloutConfig bevat een lijst met LiveActions die moet worden gebruikt wanneer deze wordt geactiveerd. LiveCopy erft RolloutConfig en het resultaat is aanwezig in LiveRelationship .

    • Voor het eerst dat een live kopie wordt ingesteld, wordt ook een RolloutConfig gebruikt (die de LiveAction s activeert).

Nieuwe synchronisatiehandeling maken creating-a-new-synchronization-action

U kunt aangepaste synchronisatiehandelingen maken voor gebruik met uw rollout-configuraties. Dit kan nuttig zijn wanneer de geïnstalleerde actiesniet aan uw specifieke toepassingsvereisten voldoen.

Hiertoe maakt u twee klassen:

In LiveActionFactory worden instanties van de klasse LiveAction voor een bepaalde configuratie gemaakt:

  • LiveAction -klassen bevatten de volgende methoden:

    • getName - Retourneert de naam van de handeling

      • De naam wordt gebruikt om naar de actie, bijvoorbeeld, in rollout configuraties te verwijzen.

    • execute - Voert de taken van de handeling uit

  • LiveActionFactory -klassen zijn onder andere de volgende leden:

    • LIVE_ACTION_NAME - Een veld dat de naam van het gekoppelde veld bevat LiveAction

      • Deze naam moet overeenkomen met de waarde die wordt geretourneerd door de methode getName van de klasse LiveAction .

    • createAction - Maakt een instantie van de lus LiveAction

      • De optionele parameter Resource kan worden gebruikt om configuratiegegevens op te geven.

    • createsAction - Retourneert de naam van de gekoppelde LiveAction

De LiveAction Configuration-node openen accessing-the-liveaction-configuration-node

Gebruik het configuratieknooppunt LiveAction in de opslagplaats om informatie op te slaan die het runtimegedrag van de instantie LiveAction beïnvloedt. Het knooppunt in de opslagplaats dat de LiveAction -configuratie opslaat, is tijdens runtime beschikbaar voor het LiveActionFactory -object. Daarom kunt u eigenschappen aan de configuratieknooppunt aan toevoegen en hen in uw LiveActionFactory implementatie gebruiken zoals nodig.

Een LiveAction moet bijvoorbeeld de naam van de auteur van het concept opslaan. Een bezit van de configuratieknoop omvat de bezitsnaam van de blauwdruk pagina die de informatie opslaat. Tijdens runtime haalt LiveAction de eigenschapnaam uit de configuratie op en verkrijgt vervolgens de eigenschapswaarde.

De parameter van de methode LiveActionFactory.createActionis een Resource -object. Dit Resource -object vertegenwoordigt het cq:LiveSyncAction -knooppunt voor deze live actie in de rollout-configuratie.

Zie Creërend een Configuratie van de Outputvoor meer informatie.

Zoals gebruikelijk wanneer het gebruiken van een configuratieknoop, zou u het aan een voorwerp ValueMap moeten aanpassen:

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

Toegang krijgen tot doelknooppunten, Source-knooppunten en de LiveRelationship accessing-target-nodes-source-nodes-and-the-liverelationship

De volgende objecten worden opgegeven als parameters van de methode execute van het object LiveAction :

  • Een Resourcevoorwerp dat de bron van het levende exemplaar vertegenwoordigt

  • Een Resource -object dat het doel van de actieve kopie vertegenwoordigt.

  • Het LiveRelationship-object voor de live kopie

    • De waarde autoSave geeft aan of de LiveAction wijzigingen moet opslaan die in de repository zijn aangebracht
    • De reset -waarde geeft de modus voor het opnieuw instellen van de rollout aan.

Via deze objecten kunt u informatie opvragen over de LiveCopy . U kunt de Resource -objecten ook gebruiken om ResourceResolver -, Session - en Node -objecten te verkrijgen. Deze objecten zijn handig voor het bewerken van inhoud in opslagruimten:

In de eerste regel van de volgende code is de bron het Resource -object van de bronpagina:

ResourceResolver resolver = source.getResourceResolver();
Session session = resolver.adaptTo(javax.jcr.Session.class);
Node sourcenode = source.adaptTo(javax.jcr.Node.class);
NOTE
De Resource argumenten kunnen null of Resources objecten zijn die zich niet aanpassen aan Node -objecten, zoals NonExistingResource-objecten.

Een nieuwe rollout-configuratie maken creating-a-new-rollout-configuration

U kunt een rollout configuratie tot stand brengen wanneer de geïnstalleerde rollout configuraties niet aan uw toepassingsvereisten voldoen twee stappen volgen:

De nieuwe rollout configuratie is dan beschikbaar aan u wanneer het plaatsen van rollout configuraties op een blauwdruk of een levende exemplaarpagina.

TIP
Zie ook de beste praktijken voor het aanpassen van rollouts.

De configuratie van de rollout maken create-the-rollout-configuration

Een rollout-configuratie maken:

  1. Open CRXDE Lite om https://<host>:<port>/crx/de .

  2. Navigeer naar /apps/msm/<your-project>/rolloutconfigs, de aangepaste versie van uw project van /libs/msm/wcm/rolloutconfigs .

    • Als dit uw eerste configuratie is, moet deze /libs tak als malplaatje worden gebruikt om de nieuwe tak onder /apps tot stand te brengen.

  3. Maak onder deze locatie een knooppunt met de volgende eigenschappen:

    • Naam: De knoopnaam van de rollout configuratie, bijvoorbeeld, contentCopy of workflow
    • Type: cq:RolloutConfig

  4. Voeg de volgende eigenschappen toe aan dit knooppunt:

    • Naam: jcr:title

      Type: String
      Waarde: Een identificerende titel die in UI zal verschijnen

    • Naam: jcr:description

      Type: String
      Waarde: Een facultatieve beschrijving.

    • Naam: cq:trigger

      Type: String
      Waarde: De Trigger van de Uitvoerom worden gebruikt

      • rollout
      • modification
      • publish
      • deactivate

  5. Klik sparen allen.

Synchronisatiehandelingen toevoegen aan de configuratie van de rollout add-synchronization-actions-to-the-rollout-configuration

De configuraties van de rollout worden opgeslagen onder de knoop van de rollout configuratiedie u onder de /apps/msm/<your-project>/rolloutconfigs knoop hebt gecreeerd.

Voeg onderliggende knooppunten van het type cq:LiveSyncAction toe om synchronisatiehandelingen toe te voegen aan de rollout-configuratie. De volgorde van de actieknooppunten voor synchronisatie bepaalt de volgorde waarin de acties plaatsvinden.

  1. In CRXDE Lite, selecteer uw 🔗 knoop van de Configuratie van de Output 0} {, bijvoorbeeld, /apps/msm/myproject/rolloutconfigs/myrolloutconfig.

  2. Maak een knooppunt met de volgende knoopeigenschappen:

    • Naam: De knoopnaam van de synchronisatieactie
    • Type: cq:LiveSyncAction

  3. Voeg en vorm zo vele knopen van de synchronisatieactie toe aangezien u vereist.

  4. Wijzig de rangschikking van de actieknoppen zodat de volgorde overeenkomt met de volgorde waarin u deze wilt uitvoeren.

    • Het bovenste actieknooppunt komt eerst voor.

Een eenvoudige LiveActionFactory-klasse maken en gebruiken creating-and-using-a-simple-liveactionfactory-class

Volg de procedures in deze sectie om een LiveActionFactory te ontwikkelen en het in een rollout configuratie te gebruiken. De procedures gebruiken Maven en Eclipse om LiveActionFactory te ontwikkelen en op te stellen:

  1. creeer het geleide projecten voer het in Eclipse in.
  2. voegt gebiedsdelenaan het POM- dossier toe.
  3. voert de LiveActionFactory interfaceuit en stelt de bundel OSGi op.
  4. creeer de rollout configuratie.
  5. creeer het levende exemplaar.

het Gemaakt project en de broncode van de klasse van Javais beschikbaar in de openbare bewaarplaats van het Git.

Maven create-the-maven-project

Voor de volgende procedure is het vereist dat u het adobe-public -profiel hebt toegevoegd aan het Maven-instellingenbestand.

  1. Open een terminal- of opdrachtregelsessie en wijzig de directory om te wijzen naar de locatie waar u het project wilt maken.

  2. Voer de volgende opdracht in:

    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. Geef de volgende waarden op bij interactieve prompt:

    • groupId: com.adobe.example.msm
    • artifactId: MyLiveActionFactory
    • version: 1.0-SNAPSHOT
    • package: MyPackage
    • appsFolderName: myapp
    • artifactName: MyLiveActionFactory package
    • packageGroup: myPackages

  4. De Verduistering van het begin en voeren het Geweven project in.

Afhankelijkheden toevoegen aan het POM-bestand add-dependencies-to-the-pom-file

Voeg gebiedsdelen toe zodat de compiler van de Verduistering de klassen kan van verwijzingen voorzien die in de LiveActionFactory code worden gebruikt.

  1. Open het bestand MyLiveActionFactory/pom.xml in de Eclipse Project Explorer.

  2. Klik in de editor op de tab pom.xml en zoek de sectie project/dependencyManagement/dependencies .

  3. Voeg de volgende XML toe in het dependencyManagement -element en sla het bestand op.

    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. Open het POM- dossier voor de bundel van Ontdekkingsreiziger van het Project bij MyLiveActionFactory-bundle/pom.xml.

  5. Klik in de editor op de tab pom.xml en zoek de sectie project/afhankelijkheden. Voeg de volgende XML binnen het gebiedsdeelelement toe en bewaar dan het dossier:

    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>

LiveActionFactory implementeren implement-liveactionfactory

De volgende LiveActionFactory -klasse implementeert een LiveAction -klasse die berichten over de bron- en doelpagina's registreert, en kopieert de eigenschap cq:lastModifiedBy van het bronknooppunt naar het doelknooppunt. De naam van de live actie is exampleLiveAction .

  1. In de Ontdekkingsreiziger van het Project Eclipse, klik het MyLiveActionFactory-bundle/src/main/java/com.adobe.example.msm pakket met de rechtermuisknop aan en klik Nieuw > Klasse.

  2. Voor de Naam, ga ExampleLiveActionFactory in en klik dan Afwerking.

  3. Open het ExampleLiveActionFactory.java -bestand, vervang de inhoud door de volgende code en sla het bestand op.

    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. Wijzig met de terminal- of opdrachtsessie de map in de map MyLiveActionFactory (de map Maven project). Voer vervolgens de volgende opdracht in:

    code language-shell 
    mvn -PautoInstallPackage clean install

  5. Het AEM error.log -bestand geeft aan dat de bundel is gestart en zichtbaar is in de logbestanden op 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]

De voorbeeldconfiguratie voor rollout maken create-the-example-rollout-configuration

Creeer de MSM rollout configuratie die LiveActionFactory gebruikt die u creeerde:

  1. Creeer en vorm de Configuratie van de a Uitvoer met de standaardproceduregebruikend de eigenschappen:

    • Titel: De Configuratie van de Uitvoer van het voorbeeld
    • Naam: examplerolloutconfig
    • cq:trigger: publish

Voeg de Actieve Actie aan de Configuratie van de Uitvoer van het Voorbeeld toe add-the-live-action-to-the-example-rollout-configuration

Vorm de rollout configuratie die u in de vorige procedure creeerde zodat het de ExampleLiveActionFactory klasse gebruikt.

  1. Open CRXDE Lite.

  2. Maak het volgende knooppunt onder /apps/msm/rolloutconfigs/examplerolloutconfig/jcr:content :

    • Naam: exampleLiveAction
    • Type: cq:LiveSyncAction

  3. Klik sparen allen.

  4. Selecteer het knooppunt exampleLiveAction en voeg een eigenschap toe om aan de klasse ExampleLiveAction aan te geven dat de eigenschap cq:LastModifiedBy moet worden gerepliceerd van de bron naar het doelknooppunt.

    • Naam: repLastModBy
    • Type: Boolean
    • Waarde: true

  5. Klik sparen allen.

Live kopie maken create-the-live-copy

creeer een levend exemplaarvan de Engelse/Producten tak van de WKND verwijzingsplaats gebruikend uw rollout configuratie:

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

  • Configuratie van de Uitvoer: De Configuratie van de Uitvoer van het voorbeeld

Activeer de Produkten (Engelse) pagina van de brontak en neem de logboekberichten waar die de LiveAction klasse produceert:

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

Taalnamen en standaardlanden wijzigen changing-language-names-and-default-countries

AEM gebruikt een standaardset taal- en landcodes.

  • De standaardtaalcode is de tweeletterige code in kleine letters, zoals gedefinieerd door ISO-639-1.
  • De standaardlandcode is de tweelettercode in kleine letters of hoofdletters, zoals gedefinieerd in ISO 3166.

MSM gebruikt een opgeslagen lijst van taal en landcodes om de naam van het land te bepalen dat met de naam van de taalversie van uw pagina wordt geassocieerd. U kunt de volgende aspecten van de lijst indien nodig wijzigen:

  • Taaltitels
  • Landnamen
  • Standaardlanden voor talen (bijvoorbeeld voor codes zoals en en de )

De taallijst wordt opgeslagen onder het knooppunt /libs/wcm/core/resources/languages . Elk onderliggend knooppunt vertegenwoordigt een taal of een taal-land:

  • De naam van het knooppunt is de taalcode (zoals en of de ) of de taalcode (zoals en_us of de_ch ).

  • De eigenschap language van het knooppunt slaat de volledige naam van de taal voor de code op.

  • In de eigenschap country van het knooppunt wordt de volledige naam van het land voor de code opgeslagen.

  • Wanneer de knooppuntnaam alleen uit een taalcode bestaat (zoals en ), is de landeigenschap * en slaat een extra defaultCountry -eigenschap de code van het taal-land op om het land aan te geven dat moet worden gebruikt.

de definitie van de Taal

De talen wijzigen:

  1. Open CRXDE Lite.

  2. Selecteer de /apps omslag en klik creeer, dan creeer Omslag.

  3. Geef de nieuwe map een naam wcm .

  4. Herhaal de vorige stap om de mappenstructuur /apps/wcm/core te maken. Maak een knooppunt van het type sling:Folder in core called resources .

  5. Klik de /libs/wcm/core/resources/languages knoop met de rechtermuisknop aan en klik Exemplaar.

  6. Klik met de rechtermuisknop op de /apps/wcm/core/resources map en klik op Plakken . Wijzig de onderliggende knooppunten naar wens.

  7. Klik sparen allen.

  8. Klik Hulpmiddelen, Verrichtingen toen Console van het Web. Van deze console klik OSGi, toen Configuratie.

  9. Bepaal de plaats en klik {de Manager van de Taal van 0} Dag CQ WCM , en verander de waarde van Lijst van de Taal aan /apps/wcm/core/resources/languages, dan klik sparen .

    {de Manager van de Taal van 0} Dag CQ WCM

MSM-vergrendelingen configureren in pagina-eigenschappen configuring-msm-locks-on-page-properties

Wanneer u een aangepaste pagina-eigenschap maakt, moet u mogelijk overwegen of de nieuwe eigenschap kan worden geïmplementeerd voor live kopieën.

Als bijvoorbeeld twee nieuwe pagina-eigenschappen worden toegevoegd:

  • E-mailadres contactpersoon:

    • Deze eigenschap hoeft niet te worden uitgevoerd, omdat deze in elk land (of merk, enzovoort) anders zal zijn.

  • Belangrijke visuele stijl:

    • Het projectvereiste is dat dit eigendom wordt uitgevoerd zoals het (gewoonlijk) voor alle landen (of merken, enzovoort) gemeenschappelijk is.

Daarna moet u ervoor zorgen dat:

  • E-mailadres contactpersoon:

  • Belangrijke visuele stijl:

    • Zorg ervoor dat u deze eigenschap alleen mag bewerken als overerving is geannuleerd.
    • Zorg er ook voor dat u de overerving opnieuw kunt instellen. Dit wordt gecontroleerd door de ketting/gebroken-ketting verbindingen te klikken die om op de status van de verbinding aan te geven knevels.

Of een pagina-eigenschap moet worden geïmplementeerd en, afhankelijk van het annuleren/opnieuw installeren van overerving tijdens het bewerken, wordt dan gecontroleerd door de dialoogvenster-eigenschap:

  • cq-msm-lockable

    • Hiermee wordt het kettingkoppelingssymbool in het dialoogvenster gemaakt.

    • Dit staat slechts het uitgeven toe als de overerving wordt geannuleerd (ketting-verbinding wordt gebroken).

    • Dit geldt alleen voor het eerste onderliggende niveau van de bron

      • Type: String

      • Waarde: Houdt de naam van het bezit in overweging en is vergelijkbaar met de waarde van het bezit name

        • Zie bijvoorbeeld

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

Wanneer cq-msm-lockable is gedefinieerd, wordt de interactie tussen het verbreken en sluiten van de keten en MSM als volgt uitgevoerd:

  • Als de waarde van cq-msm-lockable is:

    • Relatief (bijvoorbeeld, myProperty of ./myProperty)

      • Als u de keten breekt, wordt de eigenschap toegevoegd en verwijderd uit cq:propertyInheritanceCancelled .

    • Absolute (bijvoorbeeld, /image)

      • Als u de keten breekt, wordt de overerving geannuleerd door de cq:LiveSyncCancelled mix toe te voegen aan ./image en cq:isCancelledForChildren in te stellen op true .

      • Als u de keten sluit, wordt de overerving hersteld.

NOTE
cq-msm-lockable is van toepassing op het eerste onderliggende niveau van de bron die moet worden bewerkt en is niet functioneel op voorouders van een dieper niveau, ongeacht of de waarde als absoluut of relatief is gedefinieerd.
NOTE
Wanneer u overerving opnieuw inschakelt, wordt de pagina-eigenschap voor live kopiëren niet automatisch gesynchroniseerd met de eigenschap source. U kunt handmatig een synchronisatie aanvragen als dit vereist is.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab