Actions sur les ensembles d'attributs

La sous-section des attributs se trouve dans les paramètres du projet. Elle contient la liste des attributs, triés par type (s'ouvre dans un nouvel onglet), et un formulaire pour créer de nouveaux attributs.

Création d'ensembles d'attributs

Pour créer un ensemble d'attributs, indiquez le nom de l'attribut, un identifiant unique permettant d'accéder à l'entité et le type d'attribut. Après un clic sur le bouton de création, il apparaît dans la liste générale des attributs.

Modification de la position d'un ensemble d'attributs

Vous pouvez modifier la position des ensembles d'attributs dans la liste générale. Maintenez l'icône de l'attribut à déplacer, puis faites-le glisser. Les modifications sont enregistrées automatiquement.

Modification des ensembles d'attributs

Une fois l'ensemble créé, ajoutez-y les attributs qui contiendront le contenu. Pour passer en mode édition, cliquez sur l'icône d'engrenage de l'attribut choisi. La page d'édition affiche les attributs existants et un formulaire pour en créer de nouveaux. Au-dessus du tableau des attributs, un engrenage permet de choisir les colonnes : voir Engrenage des colonnes.

Pour ajouter un attribut, indiquez son nom et un marqueur unique, puis choisissez le type de données que contiendra le champ. Un ensemble d'attributs peut contenir un nombre illimité d'attributs. Vous pouvez ajouter des validateurs (s'ouvre dans un nouvel onglet) aux attributs de l'ensemble et configurer leurs propriétés spécifiques (s'ouvre dans un nouvel onglet).

Vous pouvez ainsi construire des structures de données liées et mieux contrôler votre projet.

Masquage des ensembles d'attributs

Vous pouvez ajouter des ensembles d'attributs à différentes entités, selon leur type. Par exemple, un ensemble d'attributs de type "Products" peut être lié à n'importe quel produit, et un ensemble "Admins" à l'entité administrateur. Le système indique lui-même quels ensembles d'attributs vous pouvez ajouter à une entité donnée. Si, en cours de projet, vous voulez retirer un ensemble d'attributs de cette liste de suggestions sans le supprimer, utilisez l'icône en forme d'œil.

Vous pouvez ainsi masquer les ensembles devenus obsolètes que vous ne comptez plus utiliser, mais qui sont déjà utilisés dans le projet, ce qui peut rendre leur suppression difficile. Un ensemble masqué reste dans la liste des attributs et peut toujours être modifié.

Masquage d'un attribut

Si vous ne voulez pas utiliser un ou plusieurs attributs d'un ensemble, vous pouvez les masquer. Cliquez sur l'icône en forme d'œil d'un attribut : il est masqué et ne s'affiche plus avec les autres attributs de l'ensemble. L'attribut reste visible dans la liste générale des attributs, mais il n'est pas ajouté lorsque l'ensemble est ajouté à une entité.

Suppression des ensembles d'attributs

Pour supprimer un ensemble d'attributs dont vous n'avez plus besoin, cliquez sur l'icône de corbeille. Confirmez l'action dans la fenêtre contextuelle pour le supprimer.

 

Attributs utilisés

Si un ensemble d'attributs est utilisé dans votre projet, l'icône apparaît à côté de son nom dans la liste, avec l'infobulle « is not available for deletion as it is being used by data ». Cet ensemble ne peut pas être supprimé : le bouton de suppression de sa ligne est indisponible. Cliquez sur l'icône pour ouvrir la fenêtre Attribute Set Usage, qui liste les entités (produits, pages, formulaires, etc.) utilisant l'ensemble.

La modification d'un ensemble utilisé est elle aussi limitée : dans l'éditeur d'attribut, le champ Marker est verrouillé avec le message « Editing is not available as this attribute set is being used », et la case à cocher Templates only est indisponible dans les paramètres de l'ensemble.

Suppression d'un attribut

Dans l'ensemble d'attributs, sélectionnez l'attribut à supprimer et cliquez sur l'icône de suppression .

Attributs utilisés

Contrairement à un ensemble d'attributs, un attribut déjà utilisé dans votre projet peut être supprimé. Il est alors supprimé de toutes les entités qui l'utilisent, avec les données qu'il contient.

Ajout d'attributs

Un ensemble d'attributs qui n'est ajouté à aucune entité ne peut pas être utilisé. Pour pouvoir travailler avec, liez-le à une entité correspondant à son type. Ainsi, un ensemble d'attributs pour les produits doit être lié à un produit, et un ensemble d'attributs pour les administrateurs à l'entité administrateur.

Pour créer ce lien, ouvrez l'entité voulue, puis sa sous-section des attributs. Choisissez un ensemble d'attributs parmi ceux que propose le système : il est ajouté automatiquement. Si la liste est vide, vous n'avez aucun attribut non masqué du type correspondant. Dans ce cas, revenez aux paramètres des attributs et créez-en un.

Dans cet exemple, nous créons un ensemble d'attributs pour les pages, puis nous ouvrons la section des pages, choisissons une page et ouvrons sa section des attributs. Une fois l'ensemble ajouté, ses attributs apparaissent et vous pouvez les remplir. Les valeurs saisies dans ces champs sont liées à la page, et vous pouvez accéder à ce contenu via l'API dans votre projet. Les données saisies dans les attributs peuvent être validées.

Édition des attributs

Pour modifier un attribut d'un ensemble, cliquez sur l'icône d'engrenage dans la colonne Actions de la liste des attributs. La page qui s'ouvre comporte quatre champs :

• Name : nom de l'attribut.
• Marker : identifiant unique permettant d'accéder à l'entité unique de l'attribut.
• Additional fields : ajout de champs supplémentaires. La valeur de l'attribut est dynamique : pour un même attribut, vous pouvez indiquer des valeurs différentes dans différentes pages, blocs, formulaires, événements, etc.. La valeur indiquée dans Additional fields, elle, est statique. Sur la plateforme OneEntry, vous pouvez utiliser Additional fields à différentes fins, par exemple pour ajouter une image servant d'espace réservé (placeholder) à l'attribut ou pour y indiquer des valeurs d'infobulles. Ce qui caractérise ce champ, c'est sa nature statique : la valeur que vous indiquez reste stockée dans l'attribut chaque fois que vous l'utilisez. Vous pouvez ajouter plusieurs champs dans Additional fields. Types disponibles pour leurs valeurs :
  • String
  • Integer
  • Real
  • Float
  • Date and Time
  • Date
  • Time
  • File
  • Image
  • Json
• Validation rules : règles de validation de l'attribut, présentées dans les chapitres suivants. (s'ouvre dans un nouvel onglet)

Modèles d'attributs

Vous pouvez automatiser le choix des attributs à chaque création d'un document. Pour cela, configurez un modèle : 1 - Dans les paramètres de l'attribut, cochez "Templates only", 2 - Ouvrez l'onglet "Templates" du module "Settings" et créez un modèle avec les paramètres nécessaires, 3 - Ouvrez les paramètres de ce modèle et sélectionnez l'ensemble d'attributs configuré précédemment.

Vous pouvez maintenant remplir les attributs de l'ensemble choisi : chaque nouveau document utilisant ce modèle aura d'emblée ces données dans ses attributs.

Pour appliquer le modèle, ouvrez les paramètres du document voulu et choisissez votre modèle dans la liste.

Marqueur en double

Chaque marqueur du système est une valeur unique qui ne doit pas se répéter. Si vous saisissez une valeur qui existe déjà, un message vous signale que ce marqueur existe et vous propose de l'utiliser pour le nouvel attribut.

Si vous acceptez d'utiliser le marqueur existant, le système reprend automatiquement tous les paramètres de l'attribut (nom, validateurs, champs supplémentaires, etc.), ce qui simplifie ensuite la recherche dans les documents.