Mappatura percorsi per Edge Delivery Services path-mapping
Scopri come mappare i percorsi di pagina utilizzati nell’istanza di authoring AEM sui percorsi di pagina pubblici utilizzati sul sito web e controllare quali contenuti vengono pubblicati nei Edge Delivery Services.
Panoramica overview
Per poter creare contenuti WYSIWYG utilizzando l’AEM e pubblicarli in Edge Delivery Services, devi impostare la mappatura del percorso del progetto. Questa mappatura ha due scopi.
- Mappa e crea una relazione tra i percorsi di pagina utilizzati nell’istanza di authoring AEM e i percorsi di pagina pubblici utilizzati sul sito web.
- Controlla il contenuto (pagine, fogli, risorse, ecc.) vengono pubblicati in Edge Delivery Services.
La mappatura del percorso deve essere configurata per ogni progetto singolarmente e in base al contenuto e alla struttura URL del progetto. Viene utilizzato dall'AEM durante la pubblicazione dei contenuti e durante la modifica dei contenuti nell'Editor universale.
Formato di configurazione configuration-format
Il formato della configurazione di mappatura percorso contiene due sezioni (mappings
e includes
) simili all'esempio seguente.
{
"mappings": [
"/content/aem-boilerplate/:/",
"/content/aem-boilerplate/configuration:/.helix/config.json"
],
"includes:" [
"/content/aem-boilerplate/"
]
}
mappature mappings
La configurazione mappings
contiene un array di percorsi interni (nell'istanza di authoring AEM) e percorsi URL esterni (nel sito Web pubblico).
Il formato è <internal paths>:<external path>
. In genere è costituito da un minimo di due voci.
- La prima voce dell’esempio è la mappatura del percorso delle pagine del sito web.
- La seconda voce controlla la mappatura di
.helix/config.json
alla pagina del foglio di calcolo corrispondente nell'archivio di creazione AEM.
In questo esempio, tutte le pagine archiviate in /content/aem-boilerplate/...
saranno accessibili pubblicamente sul sito dei Edge Delivery Services direttamente in https://main--my-site--org.aem.live/....
.
.json
URL API sui Edge Delivery Services. A questo scopo, devono essere elencati singolarmente nella configurazione di mappatura.include includes
La configurazione includes
controlla quali percorsi di contenuto vengono effettivamente replicati nei Edge Delivery Services. Può contenere anche qualsiasi array di percorsi e in genere contiene la pagina principale di livello superiore dei siti.
Assets utilizzato nelle pagine di Edge Delivery Services viene in genere pubblicato insieme alla pagina web. Vengono esportati automaticamente dall’istanza di authoring AEM ai Edge Delivery Services.
includes
della configurazione./content/dam/my-site/documents
contenente un set di PDF deve essere accessibile al pubblico tramite /assets/...
, è necessario aggiungere una voce alla sezione includes
della configurazione.Come configurare how-to-configure
Le mappature dei percorsi possono essere configurate in uno dei due modi seguenti, a seconda della configurazione del progetto.
-
Se il progetto è configurato per
aem.live
e utilizza il servizio di configurazione per le configurazioni centralizzate, il mapping dei percorsi per ogni sito viene configurato tramite questo servizio di configurazione.- Di seguito è riportato un esempio di richiesta cURL per configurare le mappature dei percorsi.
code language-text curl --request POST \ --url https://admin.hlx.page/config/{org}/sites/{site}/public.json \ --header 'Content-Type: application/json' \ --header 'x-auth-token: ......' \ --data '{ "paths": { "mappings": [ "/content/aem-boilerplate/:/", "/content/aem-boilerplate/configuration:/.helix/config.json" ], "includes": [ "/content/aem-boilerplate/" ] } }'
-
Se il progetto non utilizza il servizio di configurazione, il mapping dei percorsi viene configurato tramite un file
paths.json
nell'archivio GitHub dei progetti.- Vedi
https://github.com/adobe-rnd/aem-boilerplate-xwalk/blob/main/paths.json
per un esempio.
- Vedi
In entrambi i casi, una volta configurate le mappature dei percorsi, è possibile controllare la configurazione tramite l'URL di configurazione accessibile al pubblico https://<branch>--<site>--<org>.aem.page/config.json
.