Configuraties van Cloud Servicen

Configuraties zijn ontworpen om de logica en structuur te bieden voor het opslaan van serviceconfiguraties.

U kunt de bestaande instanties uitbreiden om uw eigen configuraties tot stand te brengen.

Concepten

De beginselen die bij de ontwikkeling van de configuraties worden gebruikt, zijn gebaseerd op de volgende concepten:

  • Services/adapters worden gebruikt om de configuratie(s) op te halen.
  • Configuraties (bijvoorbeeld eigenschappen/alinea's) worden overgenomen van de bovenliggende elementen.
  • Verwezen van analytische node(s) per pad.
  • Gemakkelijk uitbreidbaar.
  • Heeft de flexibiliteit om voor complexere configuraties, zoals Adobe Analytics te behandelen.
  • Ondersteuning van afhankelijkheden (bv. Adobe Analytics-plug-ins hebben een Adobe Analytics-configuratie nodig).

Structuur

Het basispad van de configuraties is:

/etc/cloudservices.

Voor elk type van configuratie zullen een malplaatje en een component worden verstrekt.Dit maakt het mogelijk om configuratiemalplaatjes te hebben die aan de meeste behoeften kunnen voldoen nadat wordt aangepast.

Om een configuratie voor de nieuwe diensten te verstrekken moet u:

  • een servicepagina maken in

    /etc/cloudservices

  • in dit verband :

    • een configuratiesjabloon
    • een configuratiecomponent

De sjabloon en component moeten de sling:resourceSuperType van de basissjabloon overnemen:

cq/cloudserviceconfigs/templates/configpage

of basiscomponent

cq/cloudserviceconfigs/components/configpage

De dienstverlener zou ook de de dienstpagina moeten verstrekken:

/etc/cloudservices/<service-name>

Sjabloonmodel

Uw sjabloon breidt de basissjabloon uit:

cq/cloudserviceconfigs/templates/configpage

en definieer een resourceType die naar de aangepaste component wijst.

/libs/cq/analytics/templates/sitecatalyst
sling:resourceSuperType = cq/cloudserviceconfigs/templates/configpage
allowedChildren = /libs/cq/analytics/templates/sitecatalyst
allowedPaths = /etc/cloudservices/analytics/*, /etc/cloudservices/analytics/.*
componentReference = cq/analytics/components/sitecatalyst
jcr:content/
cq:designPath = /etc/designs/cloudservices
sling:resourceType = cq/analytics/components/sitecatalystpage

/libs/cq/analytics/templates/generictracker
sling:resourceSuperType = cq/cloudservices/templates/configpage
allowedChildren = /libs/cq/analytics/templates/generictracker
allowedPaths = /etc/cloudservices/analytics/*, /etc/cloudservices/analytics/.*
jcr:content/
cq:designPath = /etc/designs/cloudservices
sling:resourceType = cq/analytics/components/generictrackerpage

Onderdelen

De component moet de basiscomponent uitbreiden:

cq/cloudserviceconfigs/templates/configpage

/libs/cq/analytics/components/sitecatalystpage

/libs/cq/analytics/components/generictrackerpage

Nadat u de sjabloon en de component hebt ingesteld, kunt u de configuratie toevoegen door subpagina's toe te voegen onder:

/etc/cloudservices/<service-name>

Inhoudsmodel

Het inhoudsmodel wordt opgeslagen als cq:Page onder:

/etc/cloudservices/<service-name>(/*)

/etc/cloudservices
/etc/cloudservices/service-name
/etc/cloudservices/service-name/config
/etc/cloudservices/service-name/config/inherited-config

De configuraties worden opgeslagen onder het subknooppunt jcr:content.

  • Vaste eigenschappen, die in een dialoogvenster worden gedefinieerd, moeten direct op jcr:node worden opgeslagen.
  • Dynamische elementen (met behulp van parsys of iparsys) gebruiken een subknooppunt om de componentgegevens op te slaan.
/etc/cloudservices/service/config/jcr:content as nt:unstructured
propertyname
*
par/component/ as cq:Component
propertyname
*

API

Zie com.day.cq.wcm.webservicesupport voor referentiedocumentatie over de API.

AEM integratie

Beschikbare services worden vermeld op het tabblad Cloud Services van het dialoogvenster Pagina-eigenschappen (van elke pagina die overerft van foundation/components/page of wcm/mobile/components/page).

Het tabblad bevat ook:

  • een koppeling naar de locatie waar u de service kunt inschakelen
  • Kies een configuratie (subknooppunt van de service) in een padveld

Wachtwoordversleuteling

Wanneer het opslaan van gebruikersgeloofsbrieven voor de dienst, zouden alle wachtwoorden moeten worden gecodeerd.

U kunt dit bereiken door een verborgen formulierveld toe te voegen. Dit veld moet de annotatie @Encrypted in de naam van de eigenschap hebben. Voor het veld password wordt de naam als volgt geschreven:

password@Encrypted

De eigenschap wordt vervolgens automatisch gecodeerd (met de CryptoSupport-service) door EncryptionPostProcessor.

OPMERKING

Dit is vergelijkbaar met de standaardannotaties [SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html).

OPMERKING

Standaard versleutelt EcryptionPostProcessor alleen POST-verzoeken die aan /etc/cloudservices zijn gedaan.

Aanvullende eigenschappen voor servicepagina jcr:inhoudsknooppunten

Eigenschap Beschrijving
componentReference Verwijzingspad naar een component die automatisch op de pagina moet worden opgenomen.
Dit wordt gebruikt voor extra functionaliteit en JS inbegrepen.
Dit omvat de component op de pagina
cq/cloudserviceconfigs/components/servicecomponents
waar (normaal vóór de body markering) inbegrepen is.
Voor het geval dat Analytics en Target dit gebruiken om extra functionaliteit op te nemen, zoals JavaScript-aanroepen om het gedrag van bezoekers te volgen.
beschrijving Korte beschrijving van de service.
descriptionExtended Uitgebreide beschrijving van de service.
rangschikking Servicerangschikking voor gebruik in aanbiedingen.
selectableChildren Filter voor het weergeven van configuraties in het dialoogvenster Pagina-eigenschappen.
serviceUrl URL naar servicewebsite.
serviceUrlLabel Label voor service-URL.
miniatuurPath Pad naar miniatuur voor service.
visible Zichtbaarheid in dialoogvenster Pagina-eigenschappen standaard zichtbaar (optioneel)

Gevallen gebruiken

Deze services worden standaard geleverd:

Op deze pagina