DocumentazioneAEM 6.4Guida allo sviluppo

Configurazioni Cloud Service cloud-service-configurations

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Le configurazioni sono progettate per fornire la logica e la struttura per l’archiviazione delle configurazioni del servizio.

Puoi estendere le istanze esistenti per creare configurazioni personalizzate.

Concetti concepts

I principi utilizzati nello sviluppo delle configurazioni sono stati basati sui seguenti concetti:

  • I servizi/adattatori vengono utilizzati per recuperare le configurazioni.
  • Le configurazioni (ad esempio proprietà/paragrafi) sono ereditate dalle padre.
  • A cui si fa riferimento dai nodi di analisi per percorso.
  • Facilmente estensibile.
  • Dispone della flessibilità necessaria per gestire configurazioni più complesse, come Adobe Analytics.
  • Supporto delle dipendenze (ad esempio Adobe Analytics i plugin hanno bisogno di un Adobe Analytics configurazione).

Struttura structure

Il percorso di base delle configurazioni è:

/etc/cloudservices.

Per ogni tipo di configurazione verranno forniti un modello e un componente, che consentono di disporre di modelli di configurazione in grado di soddisfare le esigenze più specifiche dopo la personalizzazione.

Per fornire una configurazione per un nuovo servizio è necessario:

  • creare una pagina di servizio in

    /etc/cloudservices

  • in questo caso:

    • un modello di configurazione
    • un componente di configurazione

Il modello e il componente devono ereditare il sling:resourceSuperType dal modello di base:

cq/cloudserviceconfigs/templates/configpage

o componente di base

cq/cloudserviceconfigs/components/configpage

Il fornitore di servizi deve inoltre fornire la pagina del servizio:

/etc/cloudservices/<service-name>

Modello template

Il modello estenderà il modello di base:

cq/cloudserviceconfigs/templates/configpage

e definire un resourceType che punta al componente personalizzato.

/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

Componenti components

Il componente deve estendere il componente di base:

cq/cloudserviceconfigs/templates/configpage

/libs/cq/analytics/components/sitecatalystpage

/libs/cq/analytics/components/generictrackerpage

Dopo aver impostato il modello e il componente, puoi aggiungere la configurazione aggiungendo le sottopagine in:

/etc/cloudservices/<service-name>

Modello di contenuto content-model

Il modello di contenuto viene memorizzato come cq:Page in:

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

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

Le configurazioni sono memorizzate sotto il sottonodo jcr:content.

  • Le proprietà fisse, definite in una finestra di dialogo, devono essere memorizzate in jcr:node direttamente.
  • Elementi dinamici (utilizzando parsys o iparsys) utilizza un sottonodo per memorizzare i dati del componente.
/etc/cloudservices/service/config/jcr:content as nt:unstructured
propertyname
*
par/component/ as cq:Component
propertyname
*

API api

Per la documentazione di riferimento sull'API consulta com.day.cq.wcm.webservicesupport.

Integrazione AEM aem-integration

I servizi disponibili sono elencati nella sezione Cloud Services della scheda Proprietà pagina finestra di dialogo (di qualsiasi pagina che eredita da foundation/components/page o wcm/mobile/components/page).

La scheda fornisce inoltre:

  • un collegamento alla posizione in cui è possibile abilitare il servizio
  • scegli una configurazione (sottonodo del servizio) da un campo percorso

Crittografia della password password-encryption

Quando si memorizzano le credenziali utente per il servizio, tutte le password devono essere crittografate.

A tal fine, è possibile aggiungere un campo modulo nascosto. Questo campo deve contenere l’annotazione @Encrypted nel nome della proprietà; vale a dire per password il nome viene scritto come segue:

password@Encrypted

La proprietà viene quindi crittografata automaticamente (utilizzando CryptoSupport dal EncryptionPostProcessor.

NOTE
È simile allo standard [SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html) annotazioni.
NOTE
Per impostazione predefinita, EcryptionPostProcessor crittografa solo POST richieste presentate /etc/cloudservices.

Proprietà aggiuntive per i nodi jcr:content della pagina del servizio additional-properties-for-service-page-jcr-content-nodes

Proprietà
Descrizione
componentReference
Percorso di riferimento per un componente da includere automaticamente nella pagina.
Viene utilizzato per funzionalità aggiuntive e inclusioni JS.
Questo include il componente nella pagina in cui
cq/cloudserviceconfigs/components/servicecomponents
è incluso (normalmente prima del body tag).
Nel caso di Analytics e Target, lo utilizziamo per includere funzionalità aggiuntive, come le chiamate JavaScript per tenere traccia del comportamento dei visitatori.
descrizione
Breve descrizione del servizio.
descriptionExtended
Descrizione estesa del servizio.
classificazione
Classificazione del servizio da utilizzare negli elenchi.
selectableChildren
Filtro per la visualizzazione delle configurazioni nella finestra di dialogo delle proprietà della pagina.
serviceUrl
URL del sito web del servizio.
serviceUrlLabel
Etichetta per l’URL del servizio.
thumbnailPath
Percorso della miniatura del servizio.
visibile
Visibilità nella finestra di dialogo delle proprietà della pagina; visibile per impostazione predefinita (facoltativo)

Casi d'uso use-cases

Questi servizi sono forniti per impostazione predefinita:

NOTE
Vedi anche Creazione di un Cloud Service personalizzato.
recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e