Dokumentation AEM Självstudiekurser om AEM Självstudiekurs om AEM Headless

Konfigurera AEM för SPA Editor

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gäller:
Experience Manager 6.5
Experience Manager as a Cloud Service

Skapat för:

Nybörjare
Utvecklare

IMPORTANT

SPA-redigeraren har tagits bort för nya projekt. Det stöds fortfarande av Adobe för befintliga projekt, men bör inte användas för nya projekt. De redigerare som rekommenderas för hantering av headless-innehåll i AEM är nu:

Den universella redigeraren för visuell redigering av headless-innehåll.
Innehållsfragmentredigeraren för formulärbaserad redigering av rubrikfritt innehåll.

Även om SPA-kodbasen hanteras utanför AEM krävs ett AEM-projekt för att ställa in kompatibla konfigurations- och innehållskrav. I det här kapitlet beskrivs hur du skapar ett AEM-projekt som innehåller nödvändiga konfigurationer:

AEM WCM Core Components-proxies
AEM Remote SPA Page proxy
AEM Remote SPA-sidmallar
Baslinjesidor för fjärr-SPA AEM
Delprojekt för att definiera SPA till AEM URL-mappningar
Konfigurationsmappar för OSGi

Hämta basprojektet från GitHub

Hämta projektet aem-guides-wknd-graphql från Github.com. Detta kommer att innehålla vissa baslinjefiler som används i det här projektet.

$ mkdir -p ~/Code
$ git clone https://github.com/adobe/aem-guides-wknd-graphql.git
$ cd remote-spa-tutorial

Skapa ett AEM-projekt

Skapa ett AEM-projekt där konfigurationer och baslinjeinnehåll hanteras. Det här projektet genereras i det klonade aem-guides-wknd-graphql-projektets remote-spa-tutorial-mapp.

Använd alltid den senaste versionen av AEM-arkitekturen.

$ cd ~/Code/aem-guides-wknd-graphql/remote-spa-tutorial
$ mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=39 \
 -D aemVersion=cloud \
 -D appTitle="WKND App" \
 -D appId="wknd-app" \
 -D groupId="com.adobe.aem.guides.wkndapp" \
 -D frontendModule="react"
$ mv ~/Code/aem-guides-wknd-graphql/remote-spa-tutorial/wknd-app ~/Code/aem-guides-wknd-graphql/remote-spa-tutorial/com.adobe.aem.guides.wknd-app

_Det sista kommandot byter bara namn på AEM projektmapp så att det är tydligt att det är AEM-projektet och inte ska blandas ihop med fjärr-SPA**

När frontendModule="react" har angetts används inte ui.frontend-projektet för fjärr-SPA-användning. SPA-programmet utvecklas och hanteras externt till AEM och använder endast AEM som innehålls-API. Flaggan frontendModule="react" krävs för projektet, inklusive spa-project AEM Java™-beroenden och konfigurera fjärr-SPA-sidmallar.

AEM Project Archetype genererar följande element som används för att konfigurera AEM för integrering med SPA.

AEM WCM Core Components-proxies på ui.apps/src/.../apps/wknd-app/components
AEM SPA-fjärrsidproxy klockan ui.apps/src/.../apps/wknd-app/components/remotepage
AEM-sidmallar ui.content/src/.../conf/wknd-app/settings/wcm/templates
Delprojekt för att definiera innehållsmappningar vid ui.content/src/...
Baslinjesidor för fjärr-SPA för AEM vid ui.content/src/.../content/wknd-app
OSGi-konfigurationsmappar vid ui.config/src/.../apps/wknd-app/osgiconfig

När basprojektet för AEM har genererats är några justeringar en garanti för att SPA-redigeraren är kompatibel med fjärr-SPA.

Ta bort ui.fronttend-projekt

Eftersom SPA är ett fjärranslutet SPA antar vi att det har utvecklats och administrerats utanför AEM-projektet. Undvik konflikter genom att ta bort projektet ui.frontend från distributionen. Om ui.frontend-projektet inte tas bort läses två SPA-filer in samtidigt i AEM SPA-redigeraren, som är standardvärdet för SPA i ui.frontend -projektet och fjärr-SPA.

Öppna AEM-projektet (~/Code/aem-guides-wknd-graphql/remote-spa-tutorial/com.adobe.aem.guides.wknd-app) i din IDE
Öppna roten pom.xml

Kommentera <module>ui.frontend</module från listan <modules>

code language-none

code language-none
`<modules> <module>all</module> <module>core</module> <!-- <module>ui.frontend</module> --> <module>ui.apps</module> <module>ui.apps.structure</module> <module>ui.config</module> <module>ui.content</module> <module>it.tests</module> <module>dispatcher</module> <module>ui.tests</module> <module>analyse</module> </modules>`

<modules>
    <module>all</module>
    <module>core</module>

    <!-- <module>ui.frontend</module> -->

    <module>ui.apps</module>
    <module>ui.apps.structure</module>
    <module>ui.config</module>
    <module>ui.content</module>
    <module>it.tests</module>
    <module>dispatcher</module>
    <module>ui.tests</module>
    <module>analyse</module>
</modules>

Filen pom.xml ska se ut så här:

Ta bort ui.front-modulen från reaktorrummet

Öppna ui.apps/pom.xml

Kommentera <dependency> på <artifactId>wknd-app.ui.frontend</artifactId>

code language-none

code language-none
`<dependencies> <!-- Remote SPA project will provide all frontend resources <dependency> <groupId>com.adobe.aem.guides.wkndapp</groupId> <artifactId>wknd-app.ui.frontend</artifactId> <version>${project.version}</version> <type>zip</type> </dependency> --> </dependencies>`

<dependencies>

    <!-- Remote SPA project will provide all frontend resources
    <dependency>
        <groupId>com.adobe.aem.guides.wkndapp</groupId>
        <artifactId>wknd-app.ui.frontend</artifactId>
        <version>${project.version}</version>
        <type>zip</type>
    </dependency>
    -->
</dependencies>

Filen ui.apps/pom.xml ska se ut så här:

Ta bort ui.front-beroenden från ui.apps

Om AEM-projektet skapades före dessa ändringar tar du manuellt bort det ui.frontend genererade klientbiblioteket från ui.apps-projektet på ui.apps/src/main/content/jcr_root/apps/wknd-app/clientlibs/clientlib-react.

AEM innehållsmappning

För att AEM ska kunna läsa in fjärr-SPA i SPA-redigeraren måste mappningar skapas mellan SPA-rutterna och de AEM-sidor som används för att öppna och redigera innehåll.

Vikten av den här konfigurationen utforskas senare.

Mappningen kan utföras med Sling Mapping som definieras i /etc/map.

Öppna delprojektet ui.content i den integrerade utvecklingsmiljön
Navigera till src/main/content/jcr_root
Skapa en mapp etc
Skapa en mapp map i etc
Skapa en mapp http i map

I http skapar du en fil .content.xml med innehållet:

code language-none

code language-none
`<?xml version="1.0" encoding="UTF-8"?> <jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0" jcr:primaryType="sling:Mapping"> <localhost_any/> </jcr:root>`

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
    jcr:primaryType="sling:Mapping">
    <localhost_any/>
</jcr:root>

Skapa en mapp localhost_any i http

I localhost_any skapar du en fil .content.xml med innehållet:

code language-none

code language-none
`<?xml version="1.0" encoding="UTF-8"?> <jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0" jcr:primaryType="sling:Mapping" sling:match="localhost\\.\\d+"> <wknd-app-routes-adventure/> </jcr:root>`

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
    jcr:primaryType="sling:Mapping"
    sling:match="localhost\\.\\d+">
    <wknd-app-routes-adventure/>
</jcr:root>

Skapa en mapp wknd-app-routes-adventure i localhost_any

I wknd-app-routes-adventure skapar du en fil .content.xml med innehållet:

code language-none

code language-none
<?xml version="1.0" encoding="UTF-8"?> <!-- The 'wknd-app-routes-adventure' mapping, maps requests to the SPA's adventure route to it's corresponding page in AEM at /content/wknd-app/us/en/home/adventure/xxx. Note the adventure AEM pages are created directly in AEM. --> <jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0" jcr:primaryType="sling:Mapping" sling:match="adventure:.*/([^/]+)/?$" sling:internalRedirect="/content/wknd-app/us/en/home/adventure/$1"/>

<?xml version="1.0" encoding="UTF-8"?>

<!--
The 'wknd-app-routes-adventure' mapping, maps requests to the SPA's adventure route
to it's corresponding page in AEM at /content/wknd-app/us/en/home/adventure/xxx.

Note the adventure AEM pages are created directly in AEM.
-->

<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
    jcr:primaryType="sling:Mapping"
    sling:match="adventure:.*/([^/]+)/?$"
    sling:internalRedirect="/content/wknd-app/us/en/home/adventure/$1"/>

Lägg till mappningsnoderna i ui.content/src/main/content/META-INF/vault/filter.xml i de som ingår i AEM-paketet.

code language-none

code language-none
`<?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/conf/wknd-app" mode="merge"/> <filter root="/content/wknd-app" mode="merge"/> <filter root="/content/dam/wknd-app/asset.jpg" mode="merge"/> <filter root="/content/experience-fragments/wknd-app" mode="merge"/> <!-- Add the Sling Mapping rules for the WKND App --> <filter root="/etc/map" mode="merge"/> </workspaceFilter>`

<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
    <filter root="/conf/wknd-app" mode="merge"/>
    <filter root="/content/wknd-app" mode="merge"/>
    <filter root="/content/dam/wknd-app/asset.jpg" mode="merge"/>
    <filter root="/content/experience-fragments/wknd-app" mode="merge"/>

    <!-- Add the Sling Mapping rules for the WKND App -->
    <filter root="/etc/map" mode="merge"/>
</workspaceFilter>

Mappstrukturen och .context.xml filer ska se ut så här:

Kopplingsmappning

Filen filter.xml ska se ut så här:

Kopplingsmappning

När nu AEM-projektet distribueras inkluderas dessa konfigurationer automatiskt.

Samlingsmappningseffekterna som AEM kör på http och localhost, så det finns bara stöd för lokal utveckling. Vid distribution till AEM as a Cloud Service måste liknande kopplingsmappningar läggas till för målet https och för rätt AEM as a Cloud Service-domän/domäner. Mer information finns i Dokumentation om kopplingsmappning .

Konfigurera sedan AEM att skydda innehållet så att endast denna SPA kan komma åt AEM-innehållet. Konfigurera resursdelning mellan ursprung i AEM.

Öppna ui.config Maven-delprojektet i din utvecklingsmiljö
Navigera src/main/content/jcr_root/apps/wknd-app/osgiconfig/config
Skapa en fil med namnet com.adobe.granite.cors.impl.CORSPolicyImpl~wknd-app_remote-spa.cfg.json

Lägg till följande i filen:

code language-none

code language-none
`{ "supportscredentials":true, "exposedheaders":[ "" ], "supportedmethods":[ "GET", "HEAD", "POST", "OPTIONS" ], "alloworigin":[ "https://external-hosted-app", "localhost:3000" ], "maxage:Integer":1800, "alloworiginregexp":[ "." ], "allowedpaths":[ "." ], "supportedheaders":[ "Origin", "Accept", "X-Requested-With", "Content-Type", "Access-Control-Request-Method", "Access-Control-Request-Headers", "authorization" ] }`

{
    "supportscredentials":true,
    "exposedheaders":[
        ""
    ],
    "supportedmethods":[
        "GET",
        "HEAD",
        "POST",
        "OPTIONS"
    ],
    "alloworigin":[
        "https://external-hosted-app", "localhost:3000"
    ],
    "maxage:Integer":1800,
    "alloworiginregexp":[
        ".*"
    ],
    "allowedpaths":[
        ".*"
    ],
    "supportedheaders":[
        "Origin",
        "Accept",
        "X-Requested-With",
        "Content-Type",
        "Access-Control-Request-Method",
        "Access-Control-Request-Headers",
        "authorization"
    ]
}

Filen com.adobe.granite.cors.impl.CORSPolicyImpl~wknd-app_remote-spa.cfg.json ska se ut så här:

CORS-konfiguration för SPA-redigeraren

Nyckelkonfigurationselementen är:

alloworigin anger vilka värdar som tillåts hämta innehåll från AEM.
- localhost:3000 har lagts till som stöd för SPA som körs lokalt
- https://external-hosted-app fungerar som en platshållare som ska ersättas med den domän som fjärr-SPA finns på.
allowedpaths anger vilka sökvägar i AEM som omfattas av den här CORS-konfigurationen. Som standard tillåts åtkomst till allt innehåll i AEM, men detta kan endast omfatta de specifika sökvägar som SPA kan komma åt, till exempel: /content/wknd-app.

Ange AEM Page som fjärr-SPA-sidmall

AEM Project Archetype genererar ett projekt som är utformat för AEM-integrering med en fjärr-SPA, men som kräver en liten men viktig justering av den automatiskt genererade AEM-sidstrukturen. Typen för den automatiskt genererade AEM-sidan måste ändras till fjärr-SPA-sidan i stället för till en SPA-sida.

Öppna delprojektet ui.content i din utvecklingsmiljö
Öppna för src/main/content/jcr_root/content/wknd-app/us/en/home/.content.xml

Uppdatera .content.xml-filen med:

code language-xml

code language-xml
<?xml version="1.0" encoding="UTF-8"?> <jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:cq="http://www.day.com/jcr/cq/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0" jcr:primaryType="cq:Page"> <jcr:content cq:template="/conf/wknd-app/settings/wcm/templates/spa-remote-page" jcr:primaryType="cq:PageContent" jcr:title="WKND App Home Page" sling:resourceType="wknd-app/components/remotepage"> <root jcr:primaryType="nt:unstructured" sling:resourceType="wcm/foundation/components/responsivegrid"> <responsivegrid jcr:primaryType="nt:unstructured" sling:resourceType="wcm/foundation/components/responsivegrid"> <text jcr:primaryType="nt:unstructured" sling:resourceType="wknd-app/components/text" text="<p>Hello World!</p>" textIsRich="true"> <cq:responsive jcr:primaryType="nt:unstructured"/> </text> </responsivegrid> </root> </jcr:content> </jcr:root>

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:cq="http://www.day.com/jcr/cq/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
        jcr:primaryType="cq:Page">
    <jcr:content
        cq:template="/conf/wknd-app/settings/wcm/templates/spa-remote-page"
        jcr:primaryType="cq:PageContent"
        jcr:title="WKND App Home Page"
        sling:resourceType="wknd-app/components/remotepage">
        <root
            jcr:primaryType="nt:unstructured"
            sling:resourceType="wcm/foundation/components/responsivegrid">
            <responsivegrid
                jcr:primaryType="nt:unstructured"
                sling:resourceType="wcm/foundation/components/responsivegrid">
                <text
                    jcr:primaryType="nt:unstructured"
                    sling:resourceType="wknd-app/components/text"
                    text="&lt;p>Hello World!&lt;/p>"
                    textIsRich="true">
                    <cq:responsive jcr:primaryType="nt:unstructured"/>
                </text>
            </responsivegrid>
        </root>
    </jcr:content>
</jcr:root>

De viktigaste ändringarna är uppdateringar av noden jcr:content:

cq:template till /conf/wknd-app/settings/wcm/templates/spa-remote-page
sling:resourceType till wknd-app/components/remotepage

Filen src/main/content/jcr_root/content/wknd-app/us/en/home/.content.xml ska se ut så här:

Home page.content.xml updates

Dessa ändringar gör att den här sidan, som fungerar som SPA-roten i AEM, kan läsa in fjärr-SPA i SPA-redigeraren.

NOTE

Om det här projektet tidigare har distribuerats till AEM ska du ta bort AEM-sidan som Sites > WKND App > us > en > WKND App Home Page eftersom ui.content -projektet är inställt på merge -noder i stället för update .

Den här sidan kan också tas bort och återskapas som en fjärr-SPA-sida i AEM, men eftersom den här sidan skapas automatiskt i projektet ui.content är det bäst att uppdatera den i kodbasen.

Distribuera AEM Project till AEM SDK

Kontrollera att tjänsten AEM Author körs på port 4502
Navigera från kommandoraden till roten i AEM Maven-projektet

Använd Maven för att distribuera projektet till AEM SDK Author Service

code language-none
`$ mvn clean install -PautoInstallSinglePackage`

mvn ren installation -PautoInstallSinglePackage

Konfigurera AEM-rotsidan

När AEM Project är driftsatt finns det ett sista steg för att förbereda SPA Editor för att läsa in vår fjärr-SPA. I AEM markerar du den AEM-sida som motsvarar SPA-roten, /content/wknd-app/us/en/home, som genereras av AEM Project Archetype.

Logga in på AEM Author
Navigera till Sites > WKND App > us > en
Markera WKND-appens hemsida och tryck på Egenskaper
Navigera till fliken SPA
Fyll i Remote SPA-konfigurationen
1. URL för SPA-värd: http://localhost:3000
  1. URL:en till fjärr-SPA:ns rot
Tryck på Spara och stäng

Kom ihåg att vi har ändrat den här sidans typ till typen för en fjärr-SPA-sida, vilket gör att vi kan se fliken SPA i dess Sidegenskaper.

Den här konfigurationen måste bara anges på den AEM-sida som motsvarar SPA-roten. Alla AEM-sidor under den här sidan ärver värdet.

Grattis

Du har nu förberett AEM-konfigurationer och driftsatt dem hos din lokala AEM-författare! Nu kan du:

Ta bort den SPA som genererats av AEM Project Archetype genom att kommentera bort beroendena i ui.frontend
Lägg till avskiljningsmappningar i AEM som mappar SPA-vägar till resurser i AEM
Ställ in AEM säkerhetspolicyer för resursdelning mellan ursprung som tillåter fjärr-SPA att använda innehåll från AEM
Distribuera AEM-projektet till din lokala AEM SDK Author-tjänst
Markera en AEM-sida som fjärr-SPA-roten med hjälp av egenskapen SPA-värd-URL

Nästa steg

Med AEM konfigurerat kan vi fokusera på att starta fjärr-SPA med stöd för redigerbara områden med AEM SPA Editor!

recommendation-more-help

e25b6834-e87f-4ff3-ba56-4cd16cdfdec4

Konfigurera AEM för SPA Editor

Hämta basprojektet från GitHub

Skapa ett AEM-projekt

Ta bort ui.fronttend-projekt

AEM innehållsmappning

Cross-Origin Resource Sharing - säkerhetsprinciper

Ange AEM Page som fjärr-SPA-sidmall

Distribuera AEM Project till AEM SDK

Konfigurera AEM-rotsidan

Grattis

Nästa steg