Définition de modèles de fragment de contenu

Dans ce chapitre, apprenez à modéliser du contenu et à créer un schéma avec Modèles de fragment de contenu. Vous découvrirez les différents types de données qui peuvent être utilisés pour définir un schéma dans le cadre du modèle.

Dans ce chapitre, deux modèles simples seront créés, Équipe et Personne. Le Équipe Le modèle de données a un nom, un nom court et une description, et fait référence au Personne modèle de données, qui comprend le nom complet, les détails biographiques, l’image de profil et la liste des métiers.

Vous êtes également invité à créer votre propre modèle en suivant les étapes de base et à ajuster les étapes respectives telles que les requêtes GraphQL et le code de l’application React, ou à suivre simplement les étapes décrites dans ces chapitres.

Prérequis

Il s’agit d’un tutoriel en plusieurs parties qui suppose qu’un AEM environnement de création est disponible

Objectifs

  • Créez un modèle de fragment de contenu.
  • Identifiez les types de données disponibles et les options de validation pour la création de modèles.
  • Comprendre comment le modèle de fragment de contenu définit both le schéma de données et le modèle de création d’un fragment de contenu.

Création d’une configuration de projet

Une configuration de projet contient tous les modèles de fragment de contenu associés à un projet particulier et permet d’organiser les modèles. Au moins un projet doit être créé before création d’un modèle de fragment de contenu.

  1. Connexion à l’AEM Auteur environnement (ex. https://author-pYYYY-eXXXX.adobeaemcloud.com/)

  2. Dans l’écran AEM Démarrer, accédez à Outils > Général > Explorateur de configuration.

    Accédez à l’explorateur de configurations

  3. Cliquez sur Créer.

  4. Dans la boîte de dialogue qui s’affiche, saisissez :

    • Titre* : Mon projet
    • Nom* : my-project (préférez utiliser toutes les minuscules avec des tirets pour séparer les mots. Cette chaîne influera sur le point d’entrée GraphQL unique sur lequel les applications clientes effectueront des requêtes.)
    • Vérifier Modèles de fragment de contenu
    • Vérifier Requêtes persistantes GraphQL

    Ma configuration de projet

Créer des modèles de fragment de contenu

Créez ensuite deux modèles pour un Équipe et un Personne.

Création d’un modèle de personne

Créez un modèle pour un Personne, qui est le modèle de données représentant une personne faisant partie d’une équipe.

  1. Dans l’écran AEM Démarrer, accédez à Outils > Général > Modèles de fragment de contenu.

    Accès aux modèles de fragment de contenu

  2. Accédez au Mon projet dossier.

  3. Appuyer Créer dans le coin supérieur droit pour afficher le Créer un modèle assistant.

  4. Pour Titre du modèle enter : Personne et appuyez sur Créer.

    Appuyer Ouvrir dans la boîte de dialogue qui s’affiche, pour ouvrir le modèle nouvellement créé.

  5. Faites glisser et déposez un Texte sur une seule ligne sur le panneau principal. Renseignez les propriétés suivantes sur le Propriétés tab :

    • Libellé du champ: Nom complet
    • Nom de la propriété: fullName
    • Vérifier Obligatoire

    Champ de propriété Full Name

    Le Nom de la propriété définit le nom de la propriété qui est conservée dans AEM. Le Nom de la propriété définit également la variable key nom de cette propriété dans le cadre du schéma de données. Ceci key sera utilisé lorsque les données de fragment de contenu sont exposées via les API GraphQL.

  6. Appuyez sur le bouton Types de données et effectuez un glisser-déposer d’un élément Texte multi-lignes sous le champ Nom complet champ . Renseignez les propriétés suivantes :

    • Libellé du champ: Biographie
    • Nom de la propriété: biographyText
    • Type par défaut: Texte enrichi
  7. Cliquez sur le bouton Types de données et effectuez un glisser-déposer d’un élément Référence de contenu champ . Renseignez les propriétés suivantes :

    • Libellé du champ: Image de profil
    • Nom de la propriété: profilePicture
    • Chemin racine: /content/dam

    Lors de la configuration de la variable Chemin racine vous pouvez cliquer sur le bouton folder pour afficher un modal afin de sélectionner le chemin. Cela permet de restreindre les dossiers que les auteurs peuvent utiliser pour renseigner le chemin. /content/dam est la racine dans laquelle sont stockées toutes les ressources AEM (images, vidéos et autres fragments de contenu).

  8. Ajoutez une validation au Référence d’image de sorte que seuls les types de contenu de Images peut être utilisé pour remplir le champ.

    Limitation aux images

  9. Cliquez sur le bouton Types de données et effectuez un glisser-déposer d’un élément Énumération type de données sous le Référence d’image champ . Renseignez les propriétés suivantes :

    • Render As: Cases à cocher
    • Libellé du champ: Profession
    • Nom de la propriété: occupation
  10. Ajouter plusieurs Options en utilisant la variable Ajouter une option bouton . Utiliser la même valeur pour Étiquette d’option et Valeur de l’option:

    Artiste, Influenceur, Photographe, Voyageur, Écrivain, YouTuber

  11. La finale Personne modèle doit se présenter comme suit :

    Modèle de personne final

  12. Cliquez sur Enregistrer pour enregistrer les modifications.

Création du modèle d’équipe

Créez un modèle pour un Équipe, qui est le modèle de données d’une équipe de personnes. Le modèle d’équipe fait référence au modèle Personne pour représenter les membres de l’équipe.

  1. Dans le Mon projet dossier, appuyez sur Créer dans le coin supérieur droit pour afficher le Créer un modèle assistant.

  2. Pour Titre du modèle enter : Équipe et appuyez sur Créer.

    Appuyer Ouvrir dans la boîte de dialogue qui s’affiche, pour ouvrir le modèle nouvellement créé.

  3. Faites glisser et déposez un Texte sur une seule ligne sur le panneau principal. Renseignez les propriétés suivantes sur le Propriétés tab :

    • Libellé du champ: Titre
    • Nom de la propriété: title
    • Vérifier Obligatoire
  4. Appuyez sur le bouton Types de données et effectuez un glisser-déposer d’un élément Texte sur une seule ligne sur le panneau principal. Renseignez les propriétés suivantes sur le Propriétés tab :

    • Libellé du champ: Nom court
    • Nom de la propriété: shortName
    • Vérifier Obligatoire
    • Vérifier Unique
    • Sous Type de validation > choisissez Personnalisé
    • Sous Regex de validation personnalisé > entrer ^[a-z0-9\-_]{5,40}$ : cette opération garantit que seules les valeurs alphanumériques en minuscules et les tirets compris entre 5 et 40 caractères peuvent être saisis.

    Le shortName nous offre un moyen d’interroger une équipe en fonction d’un chemin raccourci. Le Unique garantit que la valeur sera toujours unique par fragment de contenu de ce modèle.

  5. Appuyez sur le bouton Types de données et effectuez un glisser-déposer d’un élément Texte multi-lignes sous le champ Nom court champ . Renseignez les propriétés suivantes :

    • Libellé du champ: Description
    • Nom de la propriété: description
    • Type par défaut: Texte enrichi
  6. Cliquez sur le bouton Types de données et effectuez un glisser-déposer d’un élément Référence de fragment champ . Renseignez les propriétés suivantes :

    • Render As: Champ multiple
    • Libellé du champ: Membres de l’équipe
    • Nom de la propriété: teamMembers
    • Modèles de fragment de contenu autorisés: Utilisez l’icône de dossier pour sélectionner la variable Personne modèle.
  7. La finale Équipe modèle doit se présenter comme suit :

    Modèle d’équipe final

  8. Cliquez sur Enregistrer pour enregistrer les modifications.

  9. Vous devez maintenant utiliser deux modèles :

    Deux modèles

Publication des modèles de configuration de projet et de fragment de contenu

Lors de la révision et de la vérification, publiez la variable Project Configuration & Content Fragment Model

  1. Dans l’écran AEM Démarrer, accédez à Outils > Général > Explorateur de configuration.

  2. Cochez la case en regard de Mon projet et appuyez sur Publier

    Publier la configuration du projet

  3. Dans l’écran AEM Démarrer, accédez à Outils > Général > Modèles de fragment de contenu.

  4. Accédez au Mon projet dossier.

  5. Appuyer Personne et Équipe modèles et appuyez sur Publier

    Publication de modèles de fragment de contenu

Félicitations !

Félicitations, vous venez de créer vos premiers modèles de fragments de contenu !

Étapes suivantes

Dans le chapitre suivant, Création de modèles de fragment de contenu, vous allez créer et modifier un fragment de contenu en fonction d’un modèle de fragment de contenu. Vous apprendrez également à créer des variantes de fragments de contenu.

Documentation connexe

Sur cette page