Inhoudsfragmenten auteur
In de vorige hoofdstuk, hebt u vijf Content Fragment-modellen gemaakt: Person, Team, Locatie, Adres en Contactinfo. Dit hoofdstuk doorloopt u de stappen om Inhoudsfragmenten tot stand te brengen die op die modellen worden gebaseerd. Ook wordt uitgelegd hoe u mapbeleid kunt maken om te beperken welke modellen van inhoudsfragmenten in de map kunnen worden gebruikt.
Vereisten prerequisites
Dit document is onderdeel van een zelfstudie met meerdere onderdelen. Zorg ervoor dat de vorige hoofdstuk is voltooid voordat u verdergaat met dit hoofdstuk.
Doelstellingen objectives
Leer in dit hoofdstuk hoe te:
- Mappen maken en limieten instellen met behulp van mapbeleid
- Fragmentverwijzingen rechtstreeks maken vanuit de Inhoudsfragmenteditor
- Gegevenstypen Tab, Date en JSON-object gebruiken
- Inhoud- en fragmentverwijzingen invoegen in de teksteditor met meerdere regels
- Meerdere fragmentverwijzingen toevoegen
- Inhoudsfragmenten nesten
Voorbeeldinhoud installeren sample-content
Installeer een AEM pakket dat meerdere mappen en voorbeeldafbeeldingen bevat die worden gebruikt om de zelfstudie te versnellen.
-
Downloaden Advanced-GraphQL-Tutorial-Starter-Package-1.1.zip
-
Navigeer in AEM naar Gereedschappen > Implementatie > Pakketten toegang tot Pakketbeheer.
-
Upload en installeer het pakket (ZIP-bestand) dat u in de vorige stap hebt gedownload.
Mappen maken en limieten instellen met behulp van mapbeleid
Selecteer in de AEM homepage de optie Activa > Bestanden > WKND gedeeld > Engels. Hier ziet u de verschillende categorieën van het Fragment van de Inhoud, met inbegrip van avonturen en Medewerkers.
Mappen maken create-folders
Ga in avonturen map. U ziet dat er al mappen voor teams en locaties zijn gemaakt voor het opslaan van de fragmenten voor teams en locaties.
Creeer een omslag voor de Fragmenten van de Inhoud van Instructeurs die op het Model van het Fragment van de Inhoud van de Persoon gebaseerd zijn.
-
Selecteer op de pagina Adventures de optie Maken > Map in de rechterbovenhoek.
-
Voer in het modaal voor het maken van mappen dat wordt weergegeven "Instructors" in het dialoogvenster Titel veld. Noteer de 's' aan het einde. Titels van de mappen die veel fragmenten bevatten, moeten meervoudig zijn. Selecteren Maken.
U hebt nu een map gemaakt voor de opslag van Adventure-instructeurs.
Limieten instellen met behulp van mapbeleid
AEM kunt u machtigingen en beleid voor de mappen met inhoudsfragmenten definiëren. Door toestemmingen te gebruiken, kunt u slechts bepaalde gebruikers (auteurs) of groepen auteurs toegang tot bepaalde omslagen verlenen. Met behulp van mapbeleid kunt u beperken welke modellen van inhoudsfragmenten auteurs in die mappen kunnen gebruiken. In dit voorbeeld, beperken wij een omslag tot de Persoon en de modellen van Info van het Contact. Een mapbeleid configureren:
-
Selecteer de Instructeurs de map die u hebt gemaakt en selecteer vervolgens Eigenschappen in de bovenste navigatiebalk.
-
Selecteer de Beleid tab, vervolgens de selectie opheffen Overgenomen van /content/dam/wknd-shared. In de Modellen van inhoudsfragmenten op pad toestaan Selecteer het mappictogram.
-
Volg het pad in het dialoogvenster Pad selecteren dat wordt geopend conf > WKND gedeeld. Het model van het Fragmentmodel van de Inhoud van de Persoon, dat in het vorige hoofdstuk wordt gecreeerd, bevat een verwijzing naar het Model van het Fragment van de Fragment van de Inhoud van het Contact van Info. Zowel moeten Person als de modellen van Info van het Contact in de omslag van Instructeurs worden toegestaan om een Fragment van de Inhoud van de Instructeur tot stand te brengen. Selecteren Persoon en Contactinfo en vervolgens op Selecteren het dialoogvenster sluiten.
-
Selecteren Opslaan en sluiten en selecteert u OK in de succesdialoog die wordt weergegeven.
-
U hebt nu een omslagbeleid voor de omslag van Instructeurs gevormd. Ga in Instructeurs map en selecteer Maken > Inhoudsfragment. De enige modellen die u nu kunt selecteren zijn Persoon en Contactinfo.
Inhoudsfragmenten auteur voor instructeurs
Ga in Instructeurs map. Van hier, creëren wij een genestelde omslag om de contactinformatie van de Instructeurs op te slaan.
Voer de stappen uit die in de sectie over mappen maken om een map met de naam "Contactinfo" te maken. De geneste map overerft het mapbeleid van de bovenliggende map. Voel vrij om specifieker beleid te vormen zodat laat de pas gecreëerde omslag slechts het model van Info van het Contact toe worden gebruikt.
Een instructiefragment maken
Laten we vier mensen maken die aan een team van Adventure-instructeurs kunnen worden toegevoegd.
-
Maak in de map Instructors een inhoudsfragment op basis van het Person Content Fragment-model en geef dit de titel "Jacob Wester".
Het nieuwe inhoudsfragment ziet er als volgt uit:
-
Voer de volgende inhoud in de velden in:
- Volledige naam Jacob Wester
- Biografie: Jacob Wester is al tien jaar een wandelende instructeur en heeft er elke minuut van gehouden! Jacob is een avontuurzoeker met talent voor het klimmen en terugpakken van rotsen. Jacob is de winnaar van de beklimmingswedstrijden, waaronder de veetel van de bouldering-wedstrijd. Jacob woont momenteel in Californië.
- Erviteitsniveau instructeur: Expert
- Vaardigheden: Rots beklimmen, surfen, rugzakken
- Beheerdergegevens: Jacob Wester coördineert al drie jaar de opbergprojecten.
-
In de Profielafbeelding , voegt u een inhoudsverwijzing naar een afbeelding toe. Bladeren naar WKND gedeeld > Engels > Medewerkers > jacob_ster.jpg een pad naar de afbeelding maken.
Een fragmentverwijzing maken met de editor voor fragmentfragmenten fragment-reference-from-editor
AEM kunt u een fragmentverwijzing rechtstreeks vanuit de editor voor inhoudsfragmenten maken. Laten we een verwijzing naar de contactgegevens van Jacob maken.
-
Selecteren Nieuw inhoudsfragment onder de Contactinfo veld.
-
De modus Nieuw inhoudsfragment wordt geopend. Volg onder het tabblad Doel selecteren het pad avonturen > Instructeurs en selecteert u het selectievakje naast de Contactinfo map. Selecteren Volgende om door te gaan naar het tabblad Eigenschappen.
-
Voer onder het tabblad Eigenschappen "Contactgegevens van jakob Wester" in het dialoogvenster Titel veld. Selecteren Maken en vervolgens op Openen in de succesdialoog die wordt weergegeven.
Er worden nieuwe velden weergegeven waarmee u het inhoudsfragment Contactinfo kunt bewerken.
-
Voer de volgende inhoud in de velden in:
- Telefoon: 209-888-0000
- E-mail: jwester@wknd.com
Selecteer Opslaan. U hebt nu een fragment met contactinfo-inhoud gemaakt.
-
Om terug naar het Fragment van de Inhoud van de Instructeur te navigeren, selecteer Jacob Wester in de linkerbovenhoek van de editor.
De Contactinfo bevat nu het pad naar het fragment Contactinfo waarnaar wordt verwezen. Dit is een geneste fragmentverwijzing. Het voltooide Fragment van de Inhoud van de Instructeur kijkt als dit:
-
Selecteren Opslaan en sluiten om het inhoudsfragment op te slaan. U hebt nu een nieuw Fragment van de Inhoud van de Instructeur.
Aanvullende fragmenten maken
Volg hetzelfde proces als in het dialoogvenster vorige sectie om drie meer Fragments van de Inhoud van Instructeurs en drie Fragments van de Inhoud van Info van het Contact voor deze Instructeurs tot stand te brengen. Voeg de volgende inhoud in de fragmenten van Instructors toe:
Stacey Roswells
Kumar Selvaraj
Ayo Ogunsede
Laat de Aanvullende informatie veld leeg.
Voeg de volgende informatie toe aan de fragmenten Contactinfo:
U bent nu klaar om een Team te creëren!
Inhoudsfragmenten voor auteur voor locaties
Ga in Locaties map. Hier ziet u twee geneste mappen die al zijn gemaakt: Yosemite National Park en Yosemite Valley Lodge.
Negeer de map Yosemite Valley Lodge voorlopig. Wij keren aan het later in deze sectie terug wanneer wij een plaats creëren die als Basis van het Huis voor ons team van instructeurs dienst doet.
Ga in Nationaal park Yosemite map. Op dit moment bevat het slechts een foto van het Yosemite National Park. Laten we een inhoudsfragment maken met behulp van het Locatie-inhoudsfragmentmodel en dit 'Yosemite National Park' noemen.
Plaatsaanduidingen voor tabbladen
AEM kunt u tabplaceholders gebruiken om verschillende types van inhoud te groeperen en uw Fragments van de Inhoud te maken gemakkelijker te lezen en te beheren. In het vorige hoofdstuk hebt u tabplaatsaanduidingen toegevoegd aan het locatiemodel. Het fragment Locatie-inhoud heeft nu twee tabsecties: Locatiedetails en Locatieadres.
De Locatiedetails bevat de Naam, Beschrijving, Contactinfo, Locatieafbeelding, en Weer na seizoen velden, terwijl de Locatieadres bevat een verwijzing naar een fragment van de Inhoud van het Adres. Op de tabbladen wordt duidelijk aangegeven in welke typen inhoud de inhoud moet worden ingevuld. Het is dus gemakkelijker om inhoud te schrijven.
JSON Object, gegevenstype
De Weer na seizoen Veld is een gegevenstype van het type JSON-object, wat betekent dat het gegevens accepteert in JSON-indeling. Dit gegevenstype is flexibel en kan worden gebruikt voor alle gegevens die u in de inhoud wilt opnemen.
U kunt de veldbeschrijving zien die in het vorige hoofdstuk is gemaakt door de muisaanwijzer op het informatiepictogram rechts van het veld te plaatsen.
In dit geval moeten we het gemiddelde weer voor de locatie opgeven. Voer de volgende gegevens in:
{
"summer": "81 / 89°F",
"fall": "56 / 83°F",
"winter": "46 / 51°F",
"spring": "57 / 71°F"
}
De Weer na seizoen het veld moet er nu als volgt uitzien :
Inhoud toevoegen
Voeg de rest van de inhoud toe aan het fragment Locatie-inhoud om de informatie met GraphQL in het volgende hoofdstuk op te vragen.
-
In de Locatiedetails voert u de volgende informatie in de velden in:
- Naam Nationaal park Yosemite
- Beschrijving: Yosemite National Park bevindt zich in de Sierra Nevada bergen van Californië. Het is beroemd om zijn prachtige watervallen, gigantische sequoia-bomen en iconische weergaven van El Capitan en Half Dome-kliffen. Wandelen en kamperen zijn de beste manieren om Josemite te ervaren. Talloze sporen bieden eindeloze kansen voor avontuur en exploratie.
-
Van de Contactinfo , maakt u een inhoudsfragment op basis van het contactinfo-model en geeft u de titel "Yosemite National Park Contact Info". Volg dezelfde procedure als in de vorige sectie over een fragmentverwijzing maken vanuit de editor en voert u de volgende gegevens in de velden in:
- Telefoon: 209-999-0000
- E-mail: yosemite@wknd.com
-
Van de Locatieafbeelding veld, bladeren naar avonturen > Locaties > Nationaal park Yosemite > yosemite-nationaal park.jpeg een pad naar de afbeelding maken.
Herinner me, in het vorige hoofdstuk dat u de beeldbevestiging vormde, zodat moeten de afmetingen van het beeld van de Plaats minder dan 2560 x 1800 zijn, en zijn dossiergrootte moet minder dan 3 MB zijn.
-
Met alle toegevoegde informatie, Locatiedetails tab ziet er nu als volgt uit:
-
Ga in Locatieadres tab. Van de Adres in het veld, maakt u een Content Fragment met de naam "Yosemite National Park Address" met behulp van het Document Content Fragment Model dat u in het vorige hoofdstuk hebt gemaakt. Volg hetzelfde proces als in de sectie over een fragmentverwijzing maken vanuit de editor en voert u de volgende gegevens in de velden in:
- Adres: 9010 Curry Village Drive
- Plaats: Yosemite Valley
- Staat: CA
- Postcode: 95389
- Land: Verenigde Staten
-
De voltooide Locatieadres Het tabblad van het fragment Yosemite National Park ziet er als volgt uit:
-
Selecteren Opslaan en sluiten.
Nog een fragment maken
-
Ga in Yosemite Valley Lodge map. Maak een inhoudsfragment met het Locatie-inhoudsfragmentmodel en noem dit 'Yosemite Valley Lodge'.
-
In de Locatiedetails voert u de volgende informatie in de velden in:
- Naam: Yosemite Valley Lodge
- Beschrijving: Yosemite Valley Lodge is een centrum voor groepsvergaderingen en allerlei activiteiten, zoals winkelen, dineren, vissen, fietsen en nog veel meer.
-
Van de Contactinfo in het veld, maakt u een inhoudsfragment op basis van het contactinfo-model en geeft u de titel "Contactgegevens drukproef Yosemite" op. Volg hetzelfde proces als in de sectie over een fragmentverwijzing maken vanuit de editor en voer de volgende gegevens in in de velden van het nieuwe inhoudsfragment:
- Telefoon: 209-992-0000
- E-mail: yosemitelodge@wknd.com
Sla het nieuwe inhoudsfragment op.
-
Ga terug naar Yosemite Valley Lodge en ga naar de Locatieadres tab. Van de Adres in het veld, maakt u een Content Fragment met de naam "Yosemite Valley Lodge Address" met behulp van het Document Content Fragment Model dat u in het vorige hoofdstuk hebt gemaakt. Volg hetzelfde proces als in de sectie over een fragmentverwijzing maken vanuit de editor en voert u de volgende gegevens in de velden in:
- Adres: 9006 Yosemite Lodge Drive
- Plaats Nationaal park Yosemite
- Staat: CA
- Postcode: 95389
- Land: Verenigde Staten
Sla het nieuwe inhoudsfragment op.
-
Ga terug naar Yosemite Valley Lodge selecteert u vervolgens Opslaan en sluiten. De Yosemite Valley Lodge De map bevat nu drie Content Fragments: Yosemite Valley Lodge, Yosemite Valley Lodge Contact Info en Yosemite Valley Lodge Address.
Auteur a Team Content Fragment
Bladeren naar mappen Teams > Yosemite-team. U ziet dat de map Yosemite Team momenteel alleen het teamlogo bevat.
Laten we een inhoudsfragment maken met behulp van het model voor het fragment met teaminhoud en dit de titel "Yosemite Team" geven.
Inhoud- en fragmentverwijzingen in de teksteditor met meerdere regels
AEM kunt u inhoud en fragmentverwijzingen rechtstreeks toevoegen aan de teksteditor met meerdere regels en deze later ophalen met GraphQL-query's. Laten we zowel inhoud als fragmentverwijzingen toevoegen aan de Beschrijving veld.
-
Voeg eerst de volgende tekst toe aan de Beschrijving veld: "Het team van professionele avonturiers en wandelende instructeurs die in het nationale park Yosemite werken."
-
Als u een inhoudsverwijzing wilt toevoegen, selecteert u de optie Element invoegen in de werkbalk van de teksteditor met meerdere regels.
-
Selecteer in het modaal dat wordt weergegeven team-yosemite-logo.png en drukken Selecteren.
De inhoudsverwijzing wordt nu toegevoegd aan de Beschrijving veld.
Vergeet niet dat u in het vorige hoofdstuk hebt toegestaan dat fragmentverwijzingen werden toegevoegd aan het dialoogvenster Beschrijving veld. Laten we er een toevoegen.
-
Selecteer de Inhoudsfragment invoegen in de werkbalk van de teksteditor met meerdere regels.
-
Bladeren naar WKND gedeeld > Engels > avonturen > Locaties > Yosemite Valley Lodge > Yosemite Valley Lodge. Druk Selecteren om het inhoudsfragment in te voegen.
De Beschrijving Het veld ziet er nu als volgt uit:
U hebt nu de inhoud en fragmentverwijzingen rechtstreeks toegevoegd aan de teksteditor met meerdere regels.
Gegevenstype datum en tijd
Laten we eens kijken naar het gegevenstype Datum en tijd. Selecteer de Kalender pictogram aan de rechterkant van het Begindatum team om de kalenderweergave te openen.
De datums in het verleden of in de toekomst kunnen worden ingesteld met de pijlen naar voren en naar achteren aan weerszijden van de maand. Laten we zeggen dat het team Yosemite op 24 mei 2016 is opgericht, dus we zullen de datum daarvoor vaststellen.
Meerdere fragmentverwijzingen toevoegen
Laten wij Instructeurs aan de het fragmentverwijzing van de Leden van het Team toevoegen.
-
Selecteren Toevoegen in de Teamleden veld.
-
Selecteer in het nieuwe veld dat wordt weergegeven het mappictogram om het modaal pad selecteren te openen. Bladeren door mappen naar WKND gedeeld > Engels > avonturen > Instructeurs Schakel vervolgens het selectievakje naast johannesbrood. Druk Selecteren het pad opslaan.
-
Selecteer de Toevoegen nog driemaal. Gebruik de nieuwe gebieden om de resterende drie Instructeurs aan het team toe te voegen. De Teamleden het veld ziet er nu als volgt uit :
-
Selecteren Opslaan en sluiten om het Fragment van de Inhoud van het Team te bewaren.
Fragmentverwijzingen toevoegen aan een Adventure Content-fragment
Tot slot voegen onze pas gecreëerde Fragments van de Inhoud aan een Avontuur toe.
-
Navigeren naar avonturen > Yosemite-achtergrondverpakking en opent u het Yosemite Backpackaging Content Fragment. Onder aan het formulier ziet u de drie velden die u in het vorige hoofdstuk hebt gemaakt: Locatie, Instructieteam, en Beheerder.
-
De fragmentverwijzing toevoegen in het dialoogvenster Locatie veld. Het Locatiepad verwijst naar het Yosemite National Park Content Fragment dat u hebt gemaakt:
/content/dam/wknd-shared/en/adventures/locations/yosemite-national-park/yosemite-national-park
. -
De fragmentverwijzing toevoegen in het dialoogvenster Instructieteam veld. De weg van het Team zou het Fragment van de Inhoud van het Team van Yosemite moeten van verwijzingen voorzien dat u creeerde:
/content/dam/wknd-shared/en/adventures/teams/yosemite-team/yosemite-team
. Dit is een geneste fragmentverwijzing. Het fragment van de Inhoud van het Team bevat een verwijzing naar het model van de Persoon dat verwijzingenInfo en de modellen van het Adres van het Contact. Daarom hebt u geneste inhoudsfragmenten drie niveaus omlaag. -
De fragmentverwijzing toevoegen in het dialoogvenster Beheerder veld. Laten we zeggen dat Jacob Wester een beheerder is voor het Yosemite Backpackaging Adventure. Het pad moet leiden naar het Jacob Wester-inhoudsfragment en er als volgt uitzien:
/content/dam/wknd-shared/en/adventures/instructors/jacob-wester
. -
U hebt nu drie fragmentverwijzingen toegevoegd aan een Adventure Content-fragment. De velden zien er als volgt uit:
-
Selecteren Opslaan en sluiten om uw inhoud op te slaan.
Gefeliciteerd!
Gefeliciteerd! U hebt nu inhoudsfragmenten gemaakt op basis van de geavanceerde modellen van inhoudsfragmenten die in het vorige hoofdstuk zijn gemaakt. U hebt ook een mapbeleid gemaakt om te beperken welke modellen van inhoudsfragmenten in een map kunnen worden geselecteerd.
Volgende stappen
In de volgende hoofdstukleert u hoe u geavanceerde GraphQL-query's kunt verzenden met behulp van de GraphiQL Integrated Development Environment (IDE). Met deze query's kunnen we de gegevens bekijken die in dit hoofdstuk zijn gemaakt en deze query's uiteindelijk toevoegen aan de WKND-app.