Aller au contenu principal

Introduction

Les attributs sont une entité qui permet de configurer la structure de votre application. Grâce à eux, vous pouvez atteindre une flexibilité maximale et vous débarrasser du code en dur.

Les ensembles d'attributs ressemblent à une collection de propriétés dont vous pouvez gérer les valeurs via le panneau d'administration. Ils diffèrent par le type de liaison à différentes entités. Vous pouvez en savoir plus sur les types dans la section "Types".

Un ensemble d'attributs forme la structure des données qui peuvent ensuite être utilisées dans votre projet. Par exemple, pour un produit, vous pouvez définir que sa structure doit contenir un nom, une image, un prix et une description textuelle. En même temps, la structure d'un article de blog peut contenir un texte avec un titre et un ensemble d'images.

Certains attributs peuvent avoir une structure similaire et être utilisés dans différentes entités, ce qui vous permet de réutiliser des ensembles d'attributs pour différentes entités.

Structure

Chaque ensemble d'attributs contient une collection d'attributs personnalisables qui stockent le contenu de votre projet. Vous pouvez gérer ces attributs depuis le système de gestion. C'est pratique, car vous n'avez plus besoin de modifier le code de l'application pour changer votre projet. Il vous suffit d'extraire tous les éléments de contenu qui peuvent être modifiés dans des attributs.

Marqueurs

Les marqueurs ne peuvent pas contenir d'espaces et ne peuvent pas commencer par un chiffre. Si vous essayez d'entrer des valeurs incorrectes dans le champ du marqueur, le système ignorera l'entrée.

Nom

Pour vous faciliter la tâche, chaque attribut a un paramètre de nom obligatoire, qui est une chaîne non unique. Nommez les attributs de manière à ce qu'il vous soit facile de travailler avec eux.

Marqueur

En tant qu'identifiant, chaque attribut possède un paramètre obligatoire - "marqueur", qui est une chaîne unique. Le marqueur est également utilisé comme clé pour accéder aux attributs dans le code de votre projet. Gardez cela à l'esprit lors de la définition du marqueur de l'attribut, afin d'éviter les conflits de syntaxe.

Type de données

Choisissez le type de données pour chaque champ d'attribut qu'il stockera.

Les types de données peuvent être les suivants :

  • Chaîne : Texte simple, par exemple, "Bonjour, le monde !".
  • Texte : Texte plus long, souvent formaté, par exemple, un article ou une lettre.
  • Texte avec titre : Texte avec un titre, qui peut être utilisé pour désigner un sujet ou une catégorie.
  • Entier : Nombre entier, par exemple, 5, 100, -2.
  • Nombre à virgule flottante : Type de données pour les nombres à virgule flottante, qui peuvent avoir une partie décimale, par exemple 3.14, 1.5, -0.25.
  • Nombre réel : Identique à Float, mais avec une précision plus élevée.
  • Date et heure : Combinaison de date et d'heure, par exemple, 2023-10-27 10:00:00.
  • Date : Date, par exemple, 2023-10-27.
  • Heure : Heure, par exemple, 10:00:00.
  • Fichier : Tout fichier sur votre ordinateur, par exemple, un document, une image, de la musique.
  • Image : Image, par exemple, une photo, un dessin.
  • Groupe d'images : Collection d'images, par exemple, un album photo.
  • Interrupteur : Bouton de sélection, dont vous ne pouvez choisir qu'une seule option.
  • Liste : Liste d'éléments, par exemple, une liste de tailles de produits.
  • Entité : Entité représentant un objet du monde réel, par exemple, une personne, un lieu, une organisation.
  • JSON : Stocke des données au format JSON.
  • Intervalle de temps : Calendrier pour créer, planifier et gérer des intervalles de temps.

L'interface de saisie de contenu correspondra au type de données choisi pour chaque champ d'attribut.

Ensemble d'attributs système

Un ensemble d'attributs système distinct peut être créé. Il n'est associé à aucune collection et permet de stocker des données arbitraires en son sein. Pour remplir l'ensemble d'attributs système, allez sur la page d'édition de l'ensemble.

Possibilités

Vous pouvez ajouter des validateurs pour les attributs. Cette mécanique est examinée plus en détail dans la section "Validateurs".

Attributs

Si un ensemble d'attributs est utilisé par plusieurs entités, il faut être prudent lors de la modification des attributs de cet ensemble. Ainsi, si vous supprimez l'un des attributs, cet attribut sera supprimé partout où il est utilisé, avec son contenu. Si vous ajoutez un nouvel attribut à l'ensemble, cet attribut sera également ajouté partout où cet ensemble d'attributs est utilisé.