Configuraties van Cloud Servicen cloud-service-configurations
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:
- 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 te behandelen Adobe Analytics.
- Ondersteuning van afhankelijkheden (bv. Adobe Analytics plug-ins hebben een Adobe Analytics configuratie).
Structuur structure
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
uit het 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
en een resourceType
dat 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>
Inhoudsmodel 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, gedefinieerd in een dialoogvenster, moeten worden opgeslagen op het tabblad
jcr:node
rechtstreeks. - Dynamische elementen (gebruiken
parsys
ofiparsys
) gebruikt u 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
Zie voor documentatie over de API com.day.cq.wcm.webservicesSupport.
AEM integratie aem-integration
Beschikbare services worden vermeld in de Cloud Services tabblad 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 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 hebben @Encrypted
in de naam van de eigenschap; d.w.z. voor de password
in het veld zou de naam worden geschreven als:
password@Encrypted
De eigenschap wordt dan automatisch gecodeerd (met de opdracht CryptoSupport
door de EncryptionPostProcessor
.
[SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html)
annotaties.EcryptionPostProcessor
alleen versleutelen POST
verzoeken aan /etc/cloudservices
.Aanvullende eigenschappen voor servicepagina jcr:inhoudsknooppunten additional-properties-for-service-page-jcr-content-nodes
Gevallen gebruiken use-cases
Deze services worden standaard geleverd:
- Fragmenten voor Beheer (Google, WebTrends enz.)
- Adobe Analytics
- &Doel testen
- Dynamic Media