Chapitre 2 - Utilisation de modèles de fragment de contenu

Les modèles de fragment de contenu AEM définissent des schémas de contenu qui peuvent être utilisés pour modéliser la création de contenu brut par les créateurs et créatrices AEM. Cette approche est similaire à la génération de modèles automatique ou à la création basée sur des formulaires. Le concept clé avec les fragments de contenu est que le contenu créé est indépendant de la présentation, c’est-à-dire qu’il est destiné à une utilisation multicanal où l’application consommatrice, qu’il s’agisse d’AEM, d’une application d’une seule page ou d’une application mobile, contrôle la manière dont le contenu s’affiche pour l’utilisateur et l’utilisatrice.

La principale préoccupation du fragment de contenu est de garantir que :

  1. Le contenu correct est collecté auprès du créateur ou de la créatrice.
  2. Le contenu peut être exposé dans un format structuré et bien compris des applications consommatrices.

Ce chapitre traite de l’activation et de la définition des modèles de fragments de contenu utilisés pour définir une structure de données normalisée et une interface de création pour la modélisation et la création d’« événements ».

Activer les modèles de fragment de contenu

Les modèles de fragment de contenu doivent être activés via le navigateur de configuration d’AEM.

Si les modèles de fragment de contenu ne sont pas activés pour une configuration, le bouton Créer > Fragment de contenu ne s’affichera pas pour la configuration AEM appropriée.

NOTE
Les configurations AEM représentent un ensemble de configurations clientes basées sur le contexte stocké sous /conf. En règle générale, les configurations AEM sont corrélées à un site web particulier géré dans AEM Sites ou à une unité opérationnelle responsable d’un sous-ensemble de contenu (ressources, pages, etc.) dans AEM.
Pour qu’une configuration affecte une hiérarchie de contenu, elle doit être référencée via la propriété cq:conf sur cette hiérarchie de contenu. (Cela est réalisé pour la configuration WKND Mobile à l’étape 5 ci-dessous).
Lorsque la configuration global est utilisée, elle s’applique à tout le contenu, et cq:conf ne doit pas être défini.
Pour plus d’informations, consultez la documentation relative au Navigateur de configurations.
  1. Connectez-vous au service de création d’AEM en tant qu’utilisateur ou utilisatrice avec les autorisations appropriées pour modifier la configuration concernée.

    • Pour ce tutoriel, l’utilisateur ou utilisatrice admin peut être utilisée.
  2. Accédez à Outil > Général > Navigateur de configuration.

  3. Appuyez sur l’icône de dossier en regard de WKND Mobile pour sélectionner, puis appuyez sur le bouton Modifier en haut à gauche.

  4. Sélectionnez Modèles de fragment de contenu, puis appuyez sur Enregistrer et fermer en haut à droite.

    Cela active les modèles de fragment de contenu sur les arborescences de contenu du dossier de ressources où la propriété WKND Mobile est appliquée.

    note note
    NOTE
    Cette modification de configuration n’est pas réversible à partir de l’IU web Configuration AEM. Pour annuler cette configuration :
    code language-none
    1. Ouvrez [CRXDE Lite](http://localhost:4502/crx/de).
    1. Accédez à `/conf/wknd-mobile/settings/dam/cfm`.
    1. Supprimez le nœud `models`.
    
    Tous les modèles de fragment de contenu existants créés sous cette configuration sont supprimés, et leurs définitions sont stockées sous /conf/wknd-mobile/settings/dam/cfm/models.
  5. Appliquez la configuration WKND Mobile au WKND Mobiledossier de ressources pour permettre la création de fragments de contenu à partir de modèles de fragment de contenu dans cette hiérarchie de dossier de ressources :

    1. Accédez à AEM > Ressources > Fichiers.
    2. Sélectionnez le dossier WKND mobile.
    3. Appuyez sur le bouton Propriétés dans la barre d’actions supérieure pour ouvrir Propriétés du dossier.
    4. Dans Propriétés du dossier, appuyez sur l’onglet Services cloud.
    5. Vérifiez que le champ Configuration du cloud est défini sur /conf/wknd-mobile.
    6. Appuyez sur Enregistrer et fermer dans le coin supérieur droit pour conserver les modifications.
WARNING
Les modèles de fragment de contenu ont été déplacés de Outils > Ressources vers Outils > Général.

Comprendre le modèle de fragment de contenu à créer

Avant de définir notre modèle de fragment de contenu, examinons l’expérience que nous allons créer pour nous assurer que nous capturons tous les points de données nécessaires. Pour ce faire, nous allons vérifier la conception des applications mobiles et mapper les éléments de conception au contenu à collecter.

Nous pouvons répertorier les points de données qui définissent un événement comme suit :

Création d’un modèle de fragment de contenu

Avec le mappage, nous pouvons définir le fragment de contenu utilisé pour collecter et exposer à terme les données d’événement.

Création d’un modèle de fragment de contenu

  1. Accédez à Outils > Général > Modèles de fragment de contenu.
  2. Appuyez sur le dossier WKND Mobile pour l’ouvrir.
  3. Appuyez sur Créer pour ouvrir l’assistant de création d’un modèle de fragment de contenu.
  4. Saisissez Event comme Titre du modèle (description facultative) et appuyez sur Créer pour enregistrer.

Définition de la structure du modèle de fragment de contenu

  1. Accédez à Outils > Général > Modèles de fragment de contenu >WKND.

  2. Sélectionnez le Event modèle de fragment de contenu et cliquez sur Modifier dans la barre d’action du haut.

  3. À partir de l’onglet de droite Types de données, faites glisser la Saisie de texte sur une seule ligne dans la zone de dépôt de gauche pour définir le champ Question.

  4. Veillez à ce que la nouvelle Saisie de texte sur une seule ligne soit sélectionnée à gauche, et que l’onglet Propriétés soit sélectionné à droite. Renseignez les champs Propriétés comme suit :

    • Rendre en tant que : textfield.
    • Libellé du champ : Event Title.
    • Nom de la propriété : eventTitle.
    • Longueur maximale : 25
    • Obligatoire : Yes.

Répétez ces étapes en utilisant les définitions d’entrée définies ci-dessous pour créer le reste du modèle de fragment de contenu d’événement.

NOTE
Le champ Nom de la propriété DOIT correspondre exactement, car l’application Android est programmée pour saisir ces noms.

Description d’événement

  • Type de données : Multi-line text.
  • Libellé du champ : Event Description.
  • Nom de la propriété : eventDescription.
  • Type par défaut : Rich text.

Date et heure de l’évènement

  • Type de données : Date and time.
  • Libellé du champ : Event Date and Time.
  • Nom de la propriété : eventDateAndTime.
  • Obligatoire : Yes.

Type d’événement

  • Type de données : Enumeration.
  • Libellé du champ : Event Type.
  • Nom de la propriété : eventType.
  • Options : Art,Music,Performance,Photography.

Prix du billet

  • Type de données : Number.
  • Rendre en tant que : numberfield.
  • Libellé du champ : Ticket Price.
  • Nom de la propriété : eventPrice.
  • Type : Integer.
  • Obligatoire : Yes.

Image d’événement

  • Type de données : Content Reference.
  • Rendre en tant que : contentreference.
  • Libellé du champ : Event Image.
  • Nom de la propriété : eventImage.
  • Chemin d’accès racine : /content/dam/wknd-mobile/images.
  • Obligatoire : Yes.

Nom du lieu

  • Type de données : Single-line text.
  • Rendre en tant que : textfield.
  • Libellé du champ : Venue Name.
  • Nom de la propriété : venueName.
  • Longueur maximale : 20
  • Obligatoire : Yes.

Ville du lieu

  • Type de données : Enumeration.
  • Libellé du champ : Venue City.
  • Nom de la propriété : venueCity.
  • Options : Basel,London,Los Angeles,Paris,New York,Tokyo.
NOTE
Le Nom de la propriété désigne à la fois le nom de la propriété JCR où cette valeur est stockée ainsi que la clé dans le fichier JSON. Il doit s’agir d’un nom sémantique qui ne changera pas au cours de la durée de vie du modèle de fragment de contenu.

Après avoir créé le modèle de fragment de contenu, vous devez obtenir une définition qui ressemble à celle-ci :

Modèle de fragment de contenu d’événement

Étape suivante

Si vous le souhaitez, vous pouvez installer le package de contenu com.adobe.aem.guides.wknd-mobile.content.chapter-2.zip sur l’instance de création AEM via le gestionnaire de modules d’AEM. Ce package contient les configurations et le contenu décrits dans cette partie du tutoriel.

recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4