Doelstellingen

Deze zelfstudie behandelt de volgende onderwerpen:

  • Maak modellen van inhoudsfragmenten met behulp van validatieregels en meer geavanceerde gegevenstypen, zoals tijdelijke aanduidingen voor tabbladen, geneste fragmentverwijzingen, JSON-objecten en gegevenstypen voor datum en tijd.
  • Inhoudsfragmenten schrijven terwijl u werkt met geneste inhoud en fragmentverwijzingen, en mapbeleid configureren voor governance voor het schrijven van inhoud.
  • Ontdek de AEM GraphQL API-mogelijkheden met behulp van GraphQL-query's met variabelen en instructies.
  • Blijft GraphQL vragen met parameters in AEM en leer hoe te om cache-controle parameters met persisted query's te gebruiken.
  • Integreer aanvragen voor doorlopende query's in de voorbeeldtoepassing WKND GraphQL React met de AEM Headless JavaScript SDK.

Geavanceerde concepten van AEM Headless-overzicht

De volgende video biedt een overzicht op hoog niveau van de concepten die in deze zelfstudie worden behandeld. De zelfstudie bevat het definiëren van modellen van inhoudsfragmenten met meer geavanceerde gegevenstypen, het nesten van inhoudsfragmenten en het voortduren van GraphQL-query's in AEM.

CAUTION
In deze video (2:25) wordt gesproken over het installeren van de GraphiQL-query-editor via Package Manager om GraphQL-query's te verkennen. Nochtans in nieuwere versies van AEM als Cloud Service wordt de ingebouwde Ontdekkingsreiziger GraphiQL verstrekt, zodat wordt de pakketinstallatie niet vereist. Zie Gebruikend GrahiQL windevoor meer informatie.

Projectinstelling

Het project van de Plaats WKND heeft alle noodzakelijke configuraties, zodat kunt u het leerprogramma beginnen net nadat u de snelle opstellingvoltooit. In deze sectie worden alleen enkele belangrijke stappen beschreven die u kunt gebruiken bij het maken van uw eigen AEM Headless-project.

Bestaande configuratie controleren

De eerste stap naar het starten van elk nieuw project in AEM is het maken van de configuratie ervan als werkruimte en het maken van GraphQL API-eindpunten. Om een configuratie te herzien of tot stand te brengen, navigeer aan Hulpmiddelen > Algemeen > Browser van de Configuratie.

ga aan Browser van de Configuratie

Let erop dat de configuratie van de WKND Shared -site al is gemaakt voor de zelfstudie. Om een configuratie voor uw eigen project tot stand te brengen, creeert de uitgezochte ​in de hoger-juiste hoek en voltooit de vorm in Create de modale van de Configuratie die verschijnt.

Overzicht WKND Gedeelde Configuratie

GraphQL API-eindpunten controleren

Vervolgens moet u API-eindpunten configureren om GraphQL-query's te verzenden. Om bestaande eindpunten te herzien of te creëren, navigeer aan Hulpmiddelen > Algemeen > GraphQL.

vorm eindpunten

Let op: WKND Shared Endpoint is al gemaakt. Om een eindpunt voor uw project tot stand te brengen, creeer ​in de hoger-juiste hoek en volg het werkschema.

Gedeeld Eindpunt van het Overzicht WKND

NOTE
Na het bewaren van het eindpunt, zult u een modaal over het bezoeken van de Console van de Veiligheid zien, die u toestaat om veiligheidsmontages aan te passen als u wenst om toegang tot het eindpunt te vormen. De toestemmingen van de veiligheid zelf zijn buiten het werkingsgebied van dit leerprogramma, echter. Voor meer informatie, verwijs naar de documentatie van AEM.

WKND-inhoudsstructuur en taalhoofdmap controleren

Een goed gedefinieerde inhoudsstructuur is essentieel voor het succes van de AEM-implementatie zonder kop. Dit is handig voor schaalbaarheid, bruikbaarheid en toegangsbeheer van uw inhoud.

Een hoofdmap voor de taal is een map met als naam de ISO-taalcode EN FR. Het AEM-vertaalbeheersysteem gebruikt deze mappen om de primaire taal van uw inhoud en talen voor het vertalen van inhoud te definiëren.

Ga naar Navigatie > Assets > Dossiers.

ga aan Dossiers

Navigeer in de Gedeelde WKND omslag. Neem de map waar met de titel "Engels" en de naam "EN". Deze map is de hoofdmap van de taal voor het WKND-siteproject.

Engelse omslag

Voor uw eigen project, creeer een omslag van de taalwortel binnen uw configuratie. Zie de sectie op het creëren van omslagenvoor meer details.

Een configuratie toewijzen aan de geneste map

Tot slot moet u de configuratie van uw project aan de omslag van de taalwortel toewijzen. Deze toewijzing laat de verwezenlijking van de Fragmenten van de Inhoud toe die op de Modellen worden gebaseerd van het Fragment van de Inhoud in de configuratie van uw project wordt bepaald.

Om de omslag van de taalwortel aan de configuratie toe te wijzen, selecteer de omslag, dan selecteer Eigenschappen in de hoogste navigatiebar.

Uitgezochte Eigenschappen

Daarna, navigeer aan het lusje van de Diensten van de Wolk en selecteer het omslagpictogram op het gebied van de Configuratie van de Wolk.

Configuratie van de Wolk

In modaal die verschijnt, selecteer uw eerder gecreeerde configuratie om de taalwortelomslag aan het toe te wijzen.

Aanbevolen procedures

Hier volgt een overzicht van aanbevolen procedures voor het maken van uw eigen project in AEM:

  • De maphiërarchie moet zijn gebaseerd op lokalisatie en vertaling. Met andere woorden, taalmappen moeten in configuratiemappen worden genest, zodat de inhoud in die configuratiemappen gemakkelijk kan worden vertaald.
  • De maphiërarchie moet vlak en eenvoudig worden gehouden. Vermijd het later verplaatsen of hernoemen van mappen en fragmenten, vooral na publicatie voor live gebruik, omdat paden worden gewijzigd die fragmentverwijzingen en GraphQL-query's kunnen beïnvloeden.

Starter- en oplossingspakketten

Twee AEM pakketten zijn beschikbaar en kunnen via de Manager van het Pakketworden geïnstalleerd

Het Reageer App - Geavanceerde Leerprogramma - WKND avonturenproject is beschikbaar om de steekproeftoepassing te herzien en te onderzoeken. Deze voorbeeldtoepassing haalt de inhoud van AEM op door de voortgezette GraphQL-query's aan te roepen en rendert deze in een meeslepende ervaring.

Aan de slag

Ga als volgt te werk om aan de slag te gaan met deze geavanceerde zelfstudie:

  1. Opstelling een ontwikkelomgeving gebruikend AEM as a Cloud Service.
  2. Begin het leerlingshoofdstuk op creeer de Modellen van het Fragment van de Inhoud.