DocumentatieAEM 6.5Handboek

De Universal Editor universal-editor

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Van toepassing op:
  • Experience Manager 6.5

Gemaakt voor:

  • Ontwikkelaar

Leer meer over de flexibiliteit van de Universal Editor en hoe deze uw ervaringen zonder kop kan helpen gebruiken met AEM 6.5.

Overzicht overview

De Universal Editor is een veelzijdige visuele editor die deel uitmaakt van Adobe Experience Manager Sites. Auteurs kunnen hiermee 'what-you-see-is-what-you-get' (WYSIWYG)-bewerkingen uitvoeren voor een headless experience.

  • Auteurs profiteren van de flexibiliteit van de Universal Editor, omdat deze ondersteuning biedt voor dezelfde visuele bewerking voor alle vormen van inhoud zonder kop in AEM.
  • Ontwikkelaars profiteren van de veelzijdigheid van de Universal Editor, omdat deze ook werkelijke ontkoppeling van de implementatie ondersteunt. Het stelt ontwikkelaars in staat om vrijwel elk kader of elke architectuur van hun keuze te gebruiken, zonder SDK- of technologiebeperkingen op te leggen.

Gelieve te zien de documentatie van AEM as a Cloud Service op de Universele Redacteurvoor meer detail.

Architectuur architecture

De Universal Editor is een service die in combinatie met AEM werkt om inhoud zonder kop te schrijven.

  • De Universal Editor wordt gehost op https://experience.adobe.com/#/aem/editor/canvas en kan pagina's bewerken die zijn weergegeven door AEM 6.5.
  • De AEM-pagina wordt gelezen door de Universal Editor via de verzender van de AEM-auteur-instantie.
  • De Universal Editor Service, die wordt uitgevoerd op dezelfde host als de Dispatcher, schrijft de wijzigingen terug naar de AEM-auteurinstantie.

stroom van de Auteur gebruikend de Universele Redacteur

Vereisten requirements

De Universal Editor wordt ondersteund door:

  • AEM 6.5 (servicepack 21 of 22 plus een functiepakket)
    • Zowel on-premisse als AMS hosting worden gesteund.
  • AEM as a Cloud Service(versie 2023.8.13099 of hoger)

Dit document is gericht op AEM 6.5-ondersteuning van de Universal Editor.

Instellen setup

Als u de Universal Editor wilt testen, moet u:

  1. Werk uw AEM-ontwerpinstantie bij en configureer deze.
  2. Stel een lokale Universal Editor-service in.
  3. Pas de verzender aan om de Universal Editor Service toe te staan.

Zodra u de opstelling hebt voltooid, kunt u instrument uw toepassingen om de Universele Redacteur te gebruiken.

AEM bijwerken update-aem

Servicepack 21 of 22 en een functiepakket voor AEM zijn vereist om de Universal Editor met AEM 6.5 te kunnen gebruiken.

Nieuwste Service Pack toepassen latest

Zorg ervoor dat u minstens de dienstpak 21 of 22 voor AEM 6.5 in werking stelt. U kunt het recentste de dienstpak van Distributie van de Software downloaden.

Universal Editor-functiepakket installeren feature-pack

Installeer het Universele Pak van de Eigenschap van de Redacteur voor AEM 6.5 beschikbaar op de Distributie van de Software.

Als u reeds de dienstpak 23 of hoger in werking stelt, is het eigenschappak niet noodzakelijk.

Services configureren configure-services

Het eigenschappak installeert een aantal nieuwe pakketten waarvoor extra configuratie nodig is.

Stel het kenmerk SameSite in voor het cookie login-token . samesite-attribute

  1. Open de Manager van de Configuratie.
    • http://<host>:<port>/system/console/configMgr
  2. Bepaal de plaats van Adobe granite Symbolische Handler van de Authentificatie in de lijst en klik Verandering de configuratiewaarden.
  3. In de dialoog, verander het attribuut SameSite voor login-symbolische koekjeswaarde (token.samesite.cookie.attr) in Partitioned.
  4. Klik sparen.

Verwijder de optie SAMEORIGIN Kopteksten X-Frame. sameorigin

  1. Open de Manager van de Configuratie.
    • http://<host>:<port>/system/console/configMgr
  2. Bepaal de plaats Apache Sling HoofdServlet in de lijst en klik geef de configuratiewaarden uit.
  3. Schrap de X-Frame-Options=SAMEORIGIN waarde van het Extra attribuut van de reactiekopballen (sling.additional.response.headers) als het bestaat.
  4. Klik sparen.

Configureer de Adobe Granite Query Parameter Authentication Handler. query-parameter

  1. Open de Manager van de Configuratie.
    • http://<host>:<port>/system/console/configMgr
  2. Bepaal de plaats van de Verantwoorder van de Authentificatie van de Vraag van Adobe Granite in de lijst en klik geef de configuratiewaarden uit.
  3. Op het Pad gebied (path), voeg / toe om toe te laten.
    • Een lege waarde maakt de authentificatiemanager onbruikbaar.
  4. Klik sparen.

Definieer voor welke inhoudspaden of sling:resourceTypes de universele editor moet worden geopend. paths

  1. Open de Manager van de Configuratie.

    • http://<host>:<port>/system/console/configMgr

  2. Bepaal de plaats van Universele Dienst URL van de Redacteur in de lijst en klik geef de configuratiewaarden uit.

  3. Definieer voor welke inhoudspaden of sling:resourceTypes de universele editor moet worden geopend.

    • Op het Universele gebied van de Toewijzing van de Redacteur die opent, verstrek de wegen waarvoor de Universele Redacteur wordt geopend.
    • In Sling:resourceTypes die door Universeel gebied van de Redacteur zal worden geopend, verstrek een lijst van middelen die direct door de Universele Redacteur worden geopend.

  4. Klik sparen.

  5. Controleer uw externalizer configuratieen zorg bij een minimum u de lokale, auteur, en publiceer milieu's hebt die zoals in het volgende voorbeeld worden geplaatst.

    code language-text 
    "local $[env:AEM_EXTERNALIZER_LOCAL;default=http://localhost:4502]",
"author $[env:AEM_EXTERNALIZER_AUTHOR;default=http://localhost:4502]",
"publish $[env:AEM_EXTERNALIZER_PUBLISH;default=http://localhost:4503]"

Zodra deze configuratiestappen volledig zijn, zal AEM de Universele Redacteur voor pagina's in de volgende orde openen.

  1. AEM controleert de toewijzingen onder Universal Editor Opening Mapping en als de inhoud zich onder de aldaar gedefinieerde paden bevindt, wordt de Universal Editor geopend.
  2. Voor inhoud niet onder wegen die in Universal Editor Opening Mapping worden bepaald, controleert AEM als resourceType van de inhoud die in worden bepaald Sling aanpast:resourceTypes die door Universele Redacteur zullen worden geopend en als de inhoud één van die types aanpast, wordt de Universele Redacteur voor het bij ${author}${path}.html geopend.
  3. Anders opent AEM de Pagina-editor.

De volgende variabelen zijn beschikbaar om uw toewijzingen onder Universal Editor Opening Mapping te bepalen.

  • path: Inhoudspad van de bron die moet worden geopend
  • localhost: ExternalAlizer-item voor localhost zonder schema, bijvoorbeeld localhost:4502
  • author: ExternalAlizer-item voor auteur zonder schema, bijvoorbeeld localhost:4502
  • publish: ExternalAlizer-item voor publiceren zonder schema, bijvoorbeeld localhost:4503
  • preview: ExternalAlizer-item voor voorvertoning zonder schema, bijvoorbeeld localhost:4504
  • env: prod, stage dev op basis van de gedefinieerde uitvoeringsmodi voor Verschuiven
  • token: Zoektoken vereist voor de QueryTokenAuthenticationHandler

Voorbeeldtoewijzingen:

  • Open alle pagina's onder /content/foo op de AEM-auteur:

    • /content/foo:${author}${path}.html?login-token=${token}
    • Dit leidt tot het openen van https://localhost:4502/content/foo/x.html?login-token=<token>

  • Open alle pagina's onder /content/bar op een externe NextJS-server, waarbij alle variabelen als informatie worden opgegeven

    • /content/bar:nextjs.server${path}?env=${env}&author=https://${author}&publish=https://${publish}&login-token=${token}
    • Dit leidt tot het openen van https://nextjs.server/content/bar/x?env=prod&author=https://localhost:4502&publish=https://localhost:4503&login-token=<token>

Universal Editor-service instellen set-up-ue

Met AEM bijgewerkt en geconfigureerd kunt u een lokale Universal Editor-service instellen voor uw eigen lokale ontwikkeling en tests.

  1. Installeer Node.js versie >=20.

  2. De download en unpack de recentste Universele Dienst van de Redacteur van Distributie van de Software

  3. Configureer Universal Editor Service via omgevingsvariabelen of .env -bestand.

  4. Uitvoeren universal-editor-service.cjs

Dispatcher bijwerken update-dispatcher

Met gevormde AEM en een lokale Universele dienst die van de Redacteur in werking stellen, zult u een omgekeerde volmacht voor de nieuwe dienst in de dispatcher moeten toestaan.

  1. Pas het hostbestand van de auteurinstantie aan om een reverse-proxy op te nemen.

    code language-html 
    <IfModule mod_proxy.c>
 ProxyPass "/universal-editor" "http://localhost:8080"
 ProxyPassReverse "/universal-editor" "http://localhost:8080"
</IfModule>
    note note
    NOTE
    8080 is de standaardpoort. Als u dit gebruikend de UES_PORT parameter in uw .env dossier veranderde,u moet de havenwaarde hier dienovereenkomstig aanpassen.

  2. Start Apache opnieuw.

Uw app Instrument instrumentation

Als AEM is bijgewerkt en een lokale Universal Editor-service wordt uitgevoerd, kunt u inhoud zonder kop gaan bewerken met de Universal Editor.

Uw app moet echter van instrumenten zijn voorzien om te kunnen profiteren van de Universal Editor. Hierbij moeten metatags worden opgenomen om de editor op te geven hoe en waar de inhoud moet blijven bestaan. De details van deze instrumentatie zijn beschikbaar in de Universele documentatie van de Redacteur voor AEM as a Cloud Service.

Let op: wanneer u documentatie voor de Universal Editor met AEM as a Cloud Service volgt, gelden de volgende wijzigingen wanneer u deze gebruikt met AEM 6.5.

  • Het protocol in de metatag moet aem65 in plaats van aem zijn.

    code language-html 
    <meta name="urn:adobe:aue:system:aemconnection" content={`aem65:${getAuthorHost()}`}/>

  • Het universele eindpunt van de Dienst van de Redacteur moet via een metatag worden aangekondigd.

    code language-html 
    <meta name="urn:adobe:aue:config:service" content={`${getAuthorHost()}/universal-editor`}/>

  • In de sectie plugins van de componentdefinitie moet aem65 worden gebruikt in plaats van aem .

TIP
Voor een uitvoerige gids voor ontwikkelaars die met de Universele Redacteur beginnen, te zien gelieve het document Universele Overzicht van de Redacteur voor de Ontwikkelaars van AEMin de documentatie van AEM as a Cloud Service terwijl het houden van de noodzakelijke veranderingen nodig voor AEM 6.5 steun zoals vermeld in deze sectie.

Verschillen tussen AEM 6.5 en AEM as a Cloud Service differences

De Universal Editor in AEM 6.5 werkt in grote lijnen hetzelfde als in AEM as a Cloud Service, inclusief de gebruikersinterface en een groot deel van de installatie. Er zijn echter verschillen die moeten worden opgemerkt.

  • De Universele Redacteur in 6.5 steunt slechts de hoofdloze gebruikcase.
  • De opstelling van de Universele Redacteur varieert lichtjes voor 6.5 ( zoals diein het huidige document wordt beschreven).
  • De Universal Editor in 6.5 gebruikt een andere elementkiezer en een andere contentfragmentkiezer dan AEM as a Cloud Service.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2