📘

Objectifs pédagogiques

• Comprendre le rôle des attributs dans la structure des fiches produits.
• Savoir créer, organiser et gérer les niveaux hiérarchiques des fiches produits.
• Apprendre à ajouter et paramétrer des attributs en tenant compte des besoins métier et des bonnes pratiques.

---

Présentation

Dans le PIM , les attributs de la fiche produit portent toutes les informations essentielles : chaque attribut correspond à une donnée spécifique associée au produit. Cela peut être une caractéristique technique (poids, dimensions, matériau), un contenu marketing (description, images, vidéos) ou une information spécifiques à un canal de vente (SKU, délais de livraison).

L’organisation des attributs dans des structures logiques (onglets, rubriques, sections) est essentielle pour optimiser la navigation et la productivité des utilisateurs du PIM. Une fiche produit bien structurée permet aux équipes de trouver rapidement les informations, d’éviter les erreurs et de maintenir une qualité de données constante.

Les attributs sont donc la base de la fiche produit : ils définissent les caractéristiques d'un produit et servent de structure pour stocker ses informations. Leur création et leur organisation garantissent la centralisation des données et la performance de votre PIM Quable. Nous allons à présent voir pas à pas comment :

• Créer un nouveau type de document pour les fiches produits,
• Organiser ses niveaux hiérarchiques (onglets, sections, rubriques)
• Créer et gérer les attributs portés par la fiche produit.

Suivez ces instructions pour structurer efficacement vos données au sein des fiches produits.

👍🏼

Bon à savoir

Dans ce cours, les termes "document" et "fiche produit" désignent le même objet. Une fiche produit est un document avec type de document spécifique, défini par l'administrateur.

---

Créer un nouveau type de document

Accéder à la page Attributs :

• Rendez-vous dans le menu d’administration et aller à la page Modèle de données > Attributs.
  
• Assurez vous de sélectionner le type d’objet document,

Créer un nouveau type de document :

• Cliquez sur Ajouter un type de document en haut du panneau de droite.
  
• Remplissez le formulaire :
  • Nom (obligatoire) : Entrez un nom explicite pour identifier ce type de document,
  • Code (obligatoire) : Généré automatiquement ou modifiable selon les règles de nommage,
  • Abréviation (obligatoire) : choisissez en 2 lettres,
  • Description (facultatif) : Ajoutez une description du type de document,
  • Variants (obligatoire) : ce type de document va-t-il porter des variants ?
    
• Sauvegarder : cliquez sur Ajouter pour enregistrer le nouveau type de document.

👍🏼

Bon à savoir

• Simplifiez les noms de vos types de documents : utilisez des noms explicites pour vos types de documents,
• Anticipez les besoins futurs : prenez le temps de contrôler et de valider sa structure avant sa mise en production.

---

Créer et paramétrer les niveaux

Les niveaux hiérarchiques permettent de structurer vos documents en onglets, rubriques, sections.

Ces niveaux se retrouvent présentés ainsi sur la fiche produit :

• Dans cette illustration :
  • COLOR_REFERENCE = Onglet [Niveau 1]
  • Informations = Rubrique [Niveau 2]
  • GÉNÉRAL = Section [Niveau 3]

Accéder à la hiérarchie du type de document :

• Sélectionnez le type de document créé dans la liste déroulante.
  

Ajouter des niveaux :

• Cliquez sur le bouton Ajouter un [onglet / rubrique / section / attribut] à l’endroit souhaité dans l’arborescence :

Selon le niveau sur lequel vous vous situez, le bouton Ajouter propose différentes options :

• Niveau 0 : Définit le type de document. Le sélectionner permet d’ajouter un onglet de niveau 1.
• Niveau 1 : Définit un onglet principal. Le sélectionner permet d’ajouter une rubrique de niveau 2.
• Niveau 2 : Définit une rubrique au sein de l’onglet. Le sélectionner permet d’ajouter une section de niveau 3.
• Niveau 3 : Définit une section au sein de la rubrique. Le sélectionner permet d’ajouter des attributs.
• Niveau 4 : Définit les attributs.
  

Configurer les propriétés de chaque niveau :

• Nom : Définissez un nom clair,
• Code : Assurez-vous qu’il respecte les règles de nommage (seuls les lettres, chiffres, underscore et tirets uniquement sont autorisés),
• Réorganiser les niveaux : Opérer par glisser-déposer sur un niveau pour modifier sa position.

👍🏼

Bon à savoir

• Les 5 niveaux hiérarchiques sont obligatoires et les attributs seront toujours disposés au dernier niveau le plus bas.
• Structurez les niveaux selon les besoins métiers : placez les informations les plus utilisées dans les premiers onglets ou sections pour réduire le temps de recherche et améliorer l'expérience utilisateur.
• Évitez d'inclure trop d'attributs dans une seule section : cela risque de ralentir le chargement et de rendre l'interface confuse. Créez des sous-sections pour mieux organiser les données.
• Utilisez des codes hiérarchiques cohérents lorsque vous nommez vos niveaux avec une convention de nommage claire.

---

Créer et gérer des attributs

Les attributs définissent les données spécifiques contenues dans vos documents.

Ajouter un attribut

• Sélectionner un niveau : Dans l’arborescence, cliquez sur le dernier niveau (c'est à dire un niveau 3 section) de la hiérarchie où vous souhaitez ajouter un attribut.

• Ajouter un attribut : Cliquez sur Ajouter un attribut dans le panneau de droite.

• Configurer l’attribut :

  
  • Nom (obligatoire): Nom explicite de l’attribut.
  • Code (obligatoire): Généré automatiquement ou modifié. Le code doit être unique (doublons interdits)
  • Type d’attribut (obligatoire): Choisissez parmi les types disponibles (texte, date, case à cocher, etc.).
  • Description (facultatif) : Ajoutez une description de l'attribut,

• Propriétés optionnelles :

  
  • Données principales : rend l’attribut visible dans le header de la fiche produit
  
  • Obligatoire : rendre l’attribut indispensable pour permettre la sauvegarde. L'attribut est identifiable sur la fiche produit par un astérisque à proximité du libellé.
  
  • Utilisable dans les filtres de recherche : pour exploiter les données de l’attribut dans les filtres de la recherche avancée et dans les widgets.
  • Modifiable dans le PIM : l’attribut peut être modifié sur la fiche produit. Si n'est pas coché, le champ est grisé sur la fiche produit.
  
  • Visible dans le PIM : l’attribut est affiché et visible sur la fiche produit

• Enregistrer : Cliquez sur Ajouter pour valider.

👍🏼

Bon à savoir

Localisation : Traduisez le libellé de l’attribut dans plusieurs langues si nécessaire en utilisant la fonction localisation

👍🏼

Bon à savoir

• Choisissez des types d'attributs adaptés qui correspondent au format attendu (par exemple, utilisez Entier pour une quantité, Texte localisé pour des textes traduits).
• Évitez les attributs inutiles pour limiter la complexité de gestion des données. Assurez-vous que chaque attribut sert un besoin précis et est utilisé dans vos processus métier.
• Ajoutez des textes d’aide pour les attributs complexes ou spécifiques, cela permet aux utilisateurs de mieux comprendre leur rôle sans besoin d’accéder à la documentation.
• Vérifiez les droits d’accès aux attributs : Certains attributs sensibles (ex. : prix, codes confidentiels) peuvent nécessiter une visibilité limitée. Certains attributs seront par conséquent visible ou invisible selon les droits spécifiques accordés aux utilisateurs. Pour plus d'informations, voir Gérer les droits d'accès des utilisateurs

Modifier ou supprimer un attribut

• Pour effectuer des modifications :
  • Sélectionnez l’attribut dans l’arborescence
  • Modifiez ses propriétés dans le panneau de droite.
  • Cliquez sur Modifier pour valider.

👍🏼

Bon à savoir

• Le code et le type d’attribut sont définitifs et ne peuvent être modifiés après création.
• Les attributs <document_type_code>_name et <document_type_code>_description ne doivent être supprimés, mais vous pouvez les masquer en désactivant l'option "visible dans le PIM".

• Pour supprimer l’attribut :
  • Sélectionnez l’attribut dans l’arborescence
  • Cliquez sur les 3 points en haut à droite ⁝ dans le panneau de droite,
  • Cliquez sur Supprimer l’attribut pour le retirer.
    

❗️ Action irréversible : La suppression retire définitivement l’attribut du type de document, ainsi que les valeurs portées par l’attribut sur les fiches produit.

---

Conseils pratiques

• Organisation : Utilisez des noms explicites pour faciliter la navigation et l’identification des données sur une fiche produit.
• Règles de création de code : Ne pas utiliser de caractères spéciaux interdits (pour rappel seuls les lettres, chiffres, underscore et tirets sont autorisés) pour éviter les conflits.
• Limites : Respectez les plafonds :
  • 10 000 attributs max sur un PIM,
  • 2 000 attributs par type de document.
• Documentation : La réussite du déploiement d’un PIM passe par une maîtrise des processus de gestion des données. Consultez la documentation fonctionnelle pour des informations détaillées sur les attributs : Documentation Quable.
• Utiliser la barre de recherche en haut de la page Attributs pour identifier rapidement un attribut dans votre structure de données.

---

📘

En résumé

Créer un nouveau type de document

• Accédez à Modèle de données > Attributs pour créer un type de document.
• Remplissez un formulaire (nom, code, description, etc.) et sauvegardez.

Organiser les niveaux hiérarchiques

• Structurez les fiches en onglets (niveau 1), rubriques (niveau 2), et sections (niveau 3).
• Configurez et réorganisez ces niveaux via glisser-déposer.
• Respectez des conventions de nommage claires et limitez les sections trop chargées.

Créer et gérer des attributs

• Ajoutez des attributs dans une section (niveau 3) d'une fiche produit.
• Configurez chaque attribut (nom, type, visibilité, localisation, etc).
• Évitez les attributs inutiles et respectez les plafonds (2 000 attributs max par type de document).

Modifier ou supprimer des attributs

• Les modifications sont possibles a posteriori, sauf pour le code et le type d'attribut.
• La suppression d’un attribut est irréversible et efface les données associées.

Bonnes pratiques

• Simplifiez la navigation en organisant les données selon les besoins métiers et en plaçant les informations clés dans les premiers onglets.
• Vérifiez les droits d’accès aux attributs sensibles pour éviter les erreurs ou les fuites de données.

---

Chapitre suivant

Maintenant que vous savez créer et gérer la structure des fiches produits, découvrons ensemble comment Créer et gérer les jeux d'attributs.