Rendering e consegna

NOTA

Adobe consiglia di utilizzare l’editor di SPA per i progetti che richiedono il rendering lato client basato sul framework di un’applicazione a pagina singola (ad esempio, React). Per saperne di più.

Il rendering dei contenuti AEM può essere facilmente eseguito tramite Servlet predefiniti Sling rendering JSON e altri formati.

I moduli di rendering preconfigurati generalmente passano all’archivio e restituiscono il contenuto così com’è.

AEM, tramite Sling, supporta anche lo sviluppo e la distribuzione di moduli di rendering sling personalizzati per assumere il controllo completo dello schema e del contenuto renderizzati.

I renderer predefiniti di Content Services colmano il divario tra i valori predefiniti Sling e lo sviluppo personalizzato preconfigurati che consentono di personalizzare e controllare molti aspetti dei contenuti renderizzati senza sviluppo.

Il diagramma seguente illustra il rendering dei servizi di contenuti.

chlimage_1-15

Richiesta di JSON

Utilizzo <resource.caas span="" id="1" translate="no" />.[<export-config span="" id="0" translate="no" />.][<export-config span="" id="0" translate="no" />.json per richiedere JSON.]

RISORSA una risorsa entità sotto /content/entity
o
una risorsa contenuto sotto /content
EXPORT-CONFIG

FACOLTATIVO

configurazione di esportazione trovata in /apps/mobileapps/caas/exportConfigs/EXPORT-CONFIG

Se omesso, verrà applicata la configurazione di esportazione predefinita

DEPTH-INT FACOLTATIVO

ricorsività di profondità per il rendering di elementi figlio come utilizzato nel rendering Sling

Creazione di configurazioni di esportazione

È possibile creare configurazioni di esportazione per personalizzare il rendering JSON.

Puoi creare un nodo di configurazione in /apps/mobileapps/caas/exportConfigs.

Nome nodo Nome della configurazione (per il selettore di rendering)
jcr:primaryType nt:unstructured

La tabella seguente mostra le proprietà di Export Configs:

Nome Tipo Predefinito (se, non impostato) Valore Descrizione
includeComponents Stringa[] include tutto sling:resourceType escludere i dettagli dei nodi con sling:resourceType specificato dall'esportazione JSON
excludeComponents Stringa[] escludere nulla sling:resourceType includere i dettagli solo per i nodi con sling:resourceType specificato dall'esportazione JSON
excludePropertyPrefixes Stringa[] escludere nulla Prefissi di proprietà escludere le proprietà che iniziano con prefissi specificati dall’esportazione JSON
excludeProperties Stringa[] escludere nulla Nomi di proprietà escludere proprietà specificate dall’esportazione JSON
includeProperties Stringa[] include tutto Nomi di proprietà

if excludePropertyPrefixes impostato
include proprietà specificate nonostante la corrispondenza con il prefisso che viene escluso,

else (escludi proprietà ignorate) include solo queste proprietà
includeChildren Stringa[] include tutto nomi figli escludere elementi figlio specifici dall’esportazione JSON
excludeChildren Stringa[]

 escludere nulla nomi figli includere solo elementi figlio specificati dall’esportazione JSON, escludi altri
rinominareProperties Stringa[]

 rinomina nulla <actual_property_name>,<replacement_property_name> rinominare le proprietà utilizzando sostituzioni

Sovrascrittura dell'esportazione del tipo di risorsa

Crea un nodo di configurazione in /apps/mobileapps/caas/exportConfigs.

name resourceTypeOverrides
jcr:primaryType nt:unstructured

Nella tabella seguente sono illustrate le proprietà:

Nome Tipo Predefinito (se, non impostato) Valore Descrizione
<SELECTOR_TO_INC> Stringa[] - sling:resourceType Per i seguenti tipi di risorse sling, non restituire l'esportazione json predefinita CaaS.
Restituisci un’esportazione json del cliente eseguendo il rendering della risorsa come;
<resource>.<selector_to_inc>.json

Configurazioni di esportazione di Content Services esistenti

Content Services include due configurazioni di esportazione:

  • predefinito (nessuna configurazione specificata)
  • pagina (per eseguire il rendering delle pagine del sito)

Configurazione esportazione predefinita

La configurazione di esportazione predefinita di Content Services viene applicata se una configurazione è specificata nell’URI richiesto.

<resource>.caas[.<depth-int>].json

Nome Valore
excludeProperties
excludePropertyPrefixes jcr:,sling:,cq:,oak:,pge-
includeProperties jcr:text,text
jcr:title,title
jcr:description,description
jcr:lastModified,lastModified
cq:tags,tags
cq:lastModified,lastModified
includeComponents
excludeComponents
includeChildren
excludeChildren
Sovrapposizioni JSON Sling foundation/components/image
wcm/foundation/components/image
mobileapps/caas/components/data/contentReference
mobileapps/caas/components/data/assetlist

Configurazione esportazione pagina

Questa configurazione estende l'impostazione predefinita per includere il raggruppamento di elementi secondari sotto un nodo figlio.

<site_page>.caas.page[.<depth-int>].json

Risorse aggiuntive

Consulta le risorse riportate di seguito per ulteriori argomenti in Content Services:

In questa pagina