DocumentatieAEM 6.5Handboek

Configuraties van Cloud Servicen cloud-service-configurations

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar

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 concepts

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

  • De diensten/de Adapters worden gebruikt om de configuraties terug te winnen.
  • Configuraties (bijvoorbeeld eigenschappen/alinea's) worden overgeërfd van de bovenliggende elementen.
  • Verwezen van analytische knooppunten naar pad.
  • Gemakkelijk uitbreidbaar.
  • Heeft de flexibiliteit om voor complexere configuraties, zoals Adobe Analyticste behandelen.
  • Steun voor gebiedsdelen (bijvoorbeeld, Adobe Analyticsplugins vereist een Adobe Analyticsconfiguratie).

Structuur structure

Het basispad van de configuraties is:

/etc/cloudservices.

Voor elk type configuratie, worden een malplaatje en een component verstrekt. Dit maakt het mogelijk om configuratiesjablonen te hebben die aan de meeste behoeften kunnen voldoen nadat ze zijn aangepast.

Om een configuratie voor de nieuwe diensten te verstrekken, doe het volgende:

  • Servicepagina maken in

    /etc/cloudservices

  • Onder deze regel:

    • een configuratiesjabloon
    • een configuratiecomponent

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

cq/cloudserviceconfigs/templates/configpage

of basiscomponent

cq/cloudserviceconfigs/components/configpage

De dienstverlener zou ook de de dienstpagina moeten verstrekken:

/etc/cloudservices/<service-name>

Sjabloon template

Uw sjabloon breidt de basissjabloon uit:

cq/cloudserviceconfigs/templates/configpage

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 components

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>

Content Model content-model

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 zijn gedefinieerd, moeten rechtstreeks in de jcr:node worden opgeslagen.
  • Dynamische elementen (met 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 api

Voor verwijzingsdocumentatie op API, zie com.day.cq.wcm.webservicesupport.

AEM integratie aem-integration

De beschikbare diensten zijn vermeld in het Cloud Servicen lusje van de dialoog van de Eigenschappen van de Pagina (van om het even welke pagina die van foundation/components/page of wcm/mobile/components/page erft).

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

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 hebben in de eigenschapsnaam. Voor het veld password wordt de naam geschreven als:

password@Encrypted

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

NOTE
Dit is vergelijkbaar met de standaard [SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html) -annotaties.
NOTE
Standaard versleutelen de EcryptionPostProcessor alleen POST -verzoeken die aan /etc/cloudservices zijn gedaan.

Aanvullende eigenschappen voor servicepagina jcr:inhoudsknooppunten additional-properties-for-service-page-jcr-content-nodes

Eigenschap
Beschrijving
componentReference
Verwijzingspad naar een component die automatisch op de pagina moet worden opgenomen.
Deze wordt gebruikt voor extra functionaliteit en JS-insluitingen.
Dit omvat de component op de pagina waar
cq/cloudserviceconfigs/components/servicecomponents
is opgenomen (normaal vóór de body -tag).
Voor het geval dat Adobe Analytics en Adobe Target dit doen, gebruiken wij dit om extra functionaliteit, zoals de vraag van JavaScript te omvatten om bezoekersgedrag 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 use-cases

Deze services worden standaard geleverd:

NOTE
Zie ook Creërend een Cloud Service van de Douane.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2