Modèles de fragment de contenu

ATTENTION

L’API AEM GraphQL pour la Diffusion Fragments de contenu est disponible sur demande.

Contactez le support Adobe pour activer l'API pour votre AEM en tant que programme Cloud Service.

Les modèles de fragment de contenu définissent la structure du contenu pour vos fragments de contenu.

Pour utiliser des modèles de fragments de contenu, procédez comme suit :

  1. Activer la fonctionnalité Modèle de fragment de contenu pour votre instance
  2. Créez et configurez vos modèles de fragments de contenu
  3. Activez vos modèles de fragments de contenu à utiliser lors de la création de fragments de contenu pour la création de fragments de contenu.

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

  1. Accédez à Outils, Ressources, puis ouvrez les modèles de fragment de contenu.

  2. Accédez au fichier adapté votre configuration.

  3. Utilisez le bouton Créer pour ouvrir l’assistant.

    ATTENTION
  4. Spécifiez le Titre du modèle. Vous pouvez également ajouter Balises et Description si nécessaire.

    titre et description

  5. Utilisez le bouton Créer pour enregistrer le modèle vide. Un message indique que l’action a réussi. Vous pouvez alors sélectionner Ouvrir pour publier immédiatement le modèle ou Terminé pour revenir à la console.

Définition de votre modèle de fragment de contenu

Le modèle de fragment de contenu définit efficacement la structure des fragments de contenu résultants à l’aide d’une sélection de Types de données. A l’aide de l’éditeur de modèles, vous pouvez ajouter des instances des types de données, puis les configurer pour créer les champs requis :

ATTENTION

La modification d’un modèle de fragment de contenu existant peut avoir un impact sur les fragments dépendants.

  1. Accédez à Outils, Ressources, puis ouvrez les modèles de fragment de contenu.

  2. Accédez au dossier contenant votre modèle de fragment de contenu.

  3. Ouvrez le modèle requis pour l’édition. Utilisez l’action rapide ou sélectionnez le modèle puis l’action dans la barre d’outils.

    Une fois ouvert, l’éditeur de modèles affiche :

    • à gauche : les champs déjà définis
    • à droite : les types de données disponibles pour la création des champs (et les propriétés à utiliser une fois les champs créés).
    REMARQUE

    Lorsqu’un champ est obligatoire, le libellé indiqué dans le volet de gauche est signalé par un astérisque (*).

  4. Pour ajouter un champ

    • Faites glisser un type de données requis vers l’emplacement requis pour un champ.

    • Une fois qu’un champ a été ajouté au modèle, le panneau de droite affiche les propriétés qui peuvent être définies pour ce type de données spécifique. Vous pouvez définir ce qui est obligatoire pour ce champ.
      De nombreuses propriétés s’expliquent d’elles-mêmes. Pour plus d’informations, voir Propriétés.

  5. Pour supprimer un champ

    Sélectionnez le champ, puis cliquez/appuyez sur l’icône représentant une corbeille. Vous serez alors invité à confirmer l’opération.

  6. Ajoutez tous les champs obligatoires et définissez les propriétés connexes, le cas échéant.

  7. Sélectionnez Enregistrer pour conserver la définition.

Types de données

Une sélection de types de données est disponible pour la définition de votre modèle :

  • Une seule ligne de texte
    • Ajouter un ou plusieurs champs d’une seule ligne de texte ; la longueur maximale peut être définie
  • Plusieurs lignes de texte
    • Zone de texte qui peut être de type texte enrichi, texte ordinaire ou annotation
  • Nombre
    • Ajouter un ou plusieurs champs numériques
  • Booléen
    • Ajouter une case à cocher booléenne
  • Date et heure
    • Ajouter une date et/ou une heure
  • Énumération
    • Ajouter un ensemble de cases à cocher, de boutons radio ou de champs déroulants
  • Balises
    • Permet aux auteurs de fragments d’accéder à des zones de balises et de les sélectionner.
  • Référence de contenu

Propriétés

De nombreuses propriétés s’expliquent d’elles-mêmes. Pour certaines propriétés, les détails supplémentaires sont les suivants :

  • Rendu
    en tant queLes différentes options permettant de réaliser/rendre le champ dans un fragment. Cela vous permet souvent de définir si l’auteur verra une seule instance du champ ou s’il sera autorisé à créer plusieurs instances.

  • Libellé
    de champSaisir un
    L’ étiquette du champ génère automatiquement un nom de propriété, qui peut ensuite être mis à jour manuellement si nécessaire.

  • La validation
    ValidationBasic est disponible par des mécanismes tels que la propriété ​Requiredproperty. Certains types de données comportent des champs de validation supplémentaires. Voir Validation pour plus de détails.

  • Pour le type données texte multiligne, il est possible de définir le type par défaut en tant que :

    • Texte enrichi
    • Texte (Markdown)
    • Texte brut

    Si elle n’est pas spécifiée, la valeur par défaut Texte enrichi est utilisée pour ce champ.

    La modification du type par défaut dans un modèle de fragment de contenu prend effet uniquement sur un fragment de contenu existant et lié après l’ouverture et l’enregistrement du fragment dans l’éditeur.

Validation

Divers types de données incluent désormais la possibilité de définir les exigences de validation pour le moment où le contenu est saisi dans le fragment résultant :

  • Une seule ligne de texte
    • Comparaison avec un regex prédéfini.
  • Nombre
    • Recherchez des valeurs spécifiques.

Activation ou désactivation d'un modèle de fragment de contenu

Pour un contrôle total de l’utilisation de vos modèles de fragments de contenu, ils disposent d’un état que vous pouvez définir.

Activation d’un modèle de fragment de contenu

Une fois qu'un modèle a été créé, il doit être activé afin qu'il :

  • Est disponible pour la sélection lors de la création d’un fragment de contenu.
  • Peut être référencé à partir d’un modèle de fragment de contenu.
  • est disponible pour GraphQL ; le schéma est donc généré.

Pour activer un modèle marqué comme :

  • Version préliminaire : mew (jamais activé).
  • Désactivé : a été spécifiquement désactivé.

Vous utilisez l'option Activer de l'une des manières suivantes :

  • La barre d'outils supérieure, lorsque le modèle requis est sélectionné.
  • Action rapide correspondante (placez le pointeur de la souris sur le modèle requis).

Activation d'un modèle Brouillon ou Désactivé

Désactivation d’un modèle de fragment de contenu

Un modèle peut également être désactivé afin que :

  • Le modèle n’est plus disponible comme base pour la création de nouveaux fragments de contenu.
  • Toutefois:
    • Le schéma GraphQL continue à être généré et peut toujours être interrogé (afin d’éviter d’affecter l’API JSON).
    • Tout fragment de contenu basé sur le modèle peut toujours être interrogé et renvoyé à partir du point de terminaison GraphQL.
  • Le modèle ne peut plus être référencé, mais les références existantes sont conservées intactes et peuvent toujours être interrogées et renvoyées à partir du point de terminaison GraphQL.

Pour désactiver un modèle marqué comme Activé, utilisez l'option Désactiver de l'une des deux options suivantes :

  • La barre d'outils supérieure, lorsque le modèle requis est sélectionné.
  • Action rapide correspondante (placez le pointeur de la souris sur le modèle requis).

Désactiver un modèle activé

Suppression d’un modèle de fragment de contenu

ATTENTION

La suppression d’un modèle de fragment de contenu peut avoir un impact sur les fragments dépendants.

Pour supprimer un modèle de fragment de contenu :

  1. Accédez à Outils, Ressources, puis ouvrez les modèles de fragment de contenu.

  2. Accédez au dossier contenant votre modèle de fragment de contenu.

  3. Sélectionnez votre modèle, puis utilisez l’option de suppression de la barre d’outils.

    REMARQUE

    Si le modèle est référencé, un avertissement s’affiche. Prenez alors les mesures qui s’imposent.

Publication d’un modèle de fragment de contenu

Les modèles de fragment de contenu doivent être publiés avant ou pendant la publication des fragments de contenu dépendants.

Pour publier un modèle de fragment de contenu :

  1. Accédez à Outils, Ressources, puis ouvrez les modèles de fragment de contenu.

  2. Accédez au dossier contenant votre modèle de fragment de contenu.

  3. Sélectionnez votre modèle, puis l’option de publication dans la barre d’outils.
    L'état publié sera indiqué dans la console.

    REMARQUE

    Si vous publiez un fragment de contenu pour lequel le modèle n’a pas encore été publié, une liste de sélection indique cela, ainsi que le fait que le modèle sera publié avec le fragment.

Annulation de la publication d'un modèle de fragment de contenu

Les modèles de fragments de contenu peuvent être annulés s’ils ne sont référencés par aucun fragment.

Pour annuler la publication d’un modèle de fragment de contenu :

  1. Accédez à Outils, Ressources, puis ouvrez les modèles de fragment de contenu.

  2. Accédez au dossier contenant votre modèle de fragment de contenu.

  3. Sélectionnez votre modèle, puis Annuler la publication dans la barre d’outils.
    L'état publié sera indiqué dans la console.

Sur cette page