Présentation

La page Modèle de données (accessible via Administration > Système > Modèle de données) est l'outil central pour gérer l'export, l'import et consulter l'historique des opérations effectuées sur votre modèle de données.

Le modèle de données est le squelette de votre PIM : il définit comment vos informations produits sont organisées, quels attributs existent, comment les entités sont reliées entre elles. Gérer cette structure via l'import/export permet de la dupliquer, de la sauvegarder et de l'implémenter.

En un seul fichier .xlsx, vous pouvez importer ou exporter la structure entière de votre contenu Quable PIM, incluant :

les langues de données — les langues utilisées pour la saisie et la traduction des informations produits ;
les types de documents et attributs — la structure et l'organisation de vos fiches produits ;
les jeux d'attributs — les regroupements d'attributs pour différents types de documents ;
les types de liaison — les relations entre vos types de documents ;
les attributs des variants, des classifications, des médias et des liaisons.

⚠️
Action irréversible
L'import d'un modèle de données supprime définitivement la structure existante. Exportez toujours votre modèle avant toute opération de modification ou de réinitialisation.

Droits utilisateurs

L'accès à la page Système > Modèle de données est soumis aux permissions configurées dans les Rôles utilisateurs.

Permission requise	Ce qu'elle permet
Administration > Voir	Accéder à toutes les sections de l'administration, dont la section Système. Sans cette permission, la page n'est pas visible.

Les actions d'import et d'export du modèle de données ne disposent pas de permissions granulaires distinctes dans le tableau des permissions : elles sont accessibles à tout utilisateur ayant la permission Administration > Voir attribuée à son rôle.

En pratique, seuls les administrateurs Quable devraient disposer de cette permission. La manipulation du modèle de données est une opération technique à fort impact : une erreur peut supprimer définitivement la structure de l'ensemble du PIM et toutes les données associées.

📘
Bonne pratique
Limitez l'accès à cette page aux administrateurs techniques responsables de la configuration du PIM. Pour les profils contributeurs, traducteurs ou studios médias, cette section doit rester inaccessible.

Export du modèle de données

L'export vous permet de récupérer une copie de la structure actuelle de votre PIM sous forme de fichier .xlsx. Les cas d'usage typiques sont :

Sauvegarder votre modèle avant une modification importante ou une réinitialisation ;
Documenter la structure de votre PIM pour vos équipes ou vos partenaires intégrateurs ;
Dupliquer une structure vers une autre instance (ex. : passer d'un environnement de recette à la production) ;
Auditer ou faire évoluer le modèle en dehors du PIM avant de le réimporter.

Procédure d'export

Depuis le menu d'administration, allez dans Système > Modèle de données.
Cliquez sur le bouton Exporter le data-model.

Le traitement se lance en arrière-plan. Une fois terminé, le fichier .xlsx est disponible dans la fenêtre d'historique en bas de la page.
Cliquez sur le boutonTélécharger en fin de ligne pour récupérer le fichier sur votre ordinateur.

📘
Bon à savoir
L'export ne modifie en rien votre instance. C'est une opération sans risque.

Import du modèle de données

L'import vous permet de charger une structure de données dans votre instance Quable PIM à partir d'un fichier .xlsx conforme au format Quable. Les cas d'usage typiques sont :

Initialiser une nouvelle instance avec un modèle préparé en amont ;
Restaurer un modèle après une réinitialisation ;
Appliquer une évolution structurelle préparée en dehors du PIM.

❗
Action irréversible
L'import d'un modèle de données supprime définitivement la structure existante de votre instance avant de charger la nouvelle. Toutes les données produits, médias et paramétrages associés à l'ancienne structure sont perdus. Cette action ne peut pas être annulée.

Avant tout import, exportez et sauvegardez le modèle existant sur votre poste.

Procédure d'import

Depuis le menu d'administration, allez dans Système > Modèle de données.
Cliquez sur Importer le data-model.

Une fenêtre d'avertissement Réinitialisation des données et du modèle de données s'affiche. Lisez-la attentivement.

Confirmez votre intention en saisissant le texte de validation requis dans la boîte de dialogue.
Cliquez sur Réinitialiser pour lancer la suppression de l'existant (cette étape peut prendre quelques minutes).
Une fois la suppression terminée, une fenêtre s'ouvre pour sélectionner le fichier .xlsx à importer.
Cochez l'option Écraser les fichiers ayant le même nom si nécessaire.
Cliquez sur Démarrer pour lancer l'import.

Le bouton Annuler devient actif après le démarrage de l'import, ce qui vous permet d'interrompre le processus si nécessaire. Cliquez sur Supprimer tout pour vider la file, ou sur Fermer pour abandonner.

Deux situations à distinguer

Instance sans modèle de données

Si votre PIM n'a pas encore de modèle de données défini (instance vierge ou après réinitialisation complète), un avertissement vous informe que l'import va supprimer les paramètres et objets par défaut. La procédure reste la même : confirmez, puis sélectionnez votre fichier.

Instance avec un modèle existant

Si votre PIM contient déjà un modèle de données, l'import remplacera intégralement la structure en place — y compris tous les types de documents, attributs, jeux d'attributs, types de liaison, et les données associées. La saisie du message de confirmation est obligatoire avant que le bouton Réinitialiser soit actif.

👍
Après l'import
Une fois le modèle de données importé avec succès, vous pouvez commencer à importer vos données produits via Flux de données > Imports.

Format du fichier DataModel

Le fichier .xlsx est organisé en plusieurs feuilles, chacune correspondant à une entité de la structure.

Le fichier .xlsx utilisé à l'import doit respecter strictement la structure attendue par Quable PIM : noms des feuilles, intitulés des colonnes, valeurs acceptées. Le plus simple pour obtenir un fichier conforme est de partir d'un export réalisé depuis une instance Quable, et de le modifier.

Feuille LANGUES

Liste toutes les langues de données actives sur l'instance.

Colonne	Description
Nom	Nom de la langue de données
Culture	Code locale (ex. : `fr_FR`, `en_US`)
Défaut	`TRUE` si c'est la langue principale de saisie, `FALSE` sinon

Feuille Types de Documents

Liste tous les types de documents (= fiches produits).

Colonne	Description
Code	Identifiant unique du type de document
Entity	Toujours `Article`
Sku	`TRUE` si le type utilise des variants
Default	`TRUE` si c'est le type de document principal

Feuille Jeux de champs

Liste tous les jeux d'attributs.

Colonne	Description
Code	Identifiant unique du jeu d'attributs
Name	Nom du jeu d'attributs
Document Type	Type de document auquel le jeu est rattaché

Feuilles par type de document

🚧
Important
Il devra être créé une feuille pour chaque type de document défini.

Chaque feuille liste l'ensemble des attributs du type de document correspondant, avec leurs propriétés complètes : nom, code, type, caractère obligatoire, organisation hiérarchique dans l'interface (onglets, sections, groupes), filtrabilité, visibilité, editabilité, etc.

Colonne	Description
Source	Imports - Vous devez saisir la source originale des données (e.g., ERP, PIM, etc.). Exports - Le code interne de Quable pour l'attribut est utilisé.
Document Type	Le nom du type de document.
Field Name	Le nom de l'attribut.
Field Code	L'identifiant unique de l'attribut.
Mandatory	Indique si l'attribut est obligatoire ou optionnel : `TRUE` L'attribut est obligatoire, `FALSE` L'attribut est optionnel.
Field Type	Indique le type de l'attribut.
Attribute Set	Indique le ou les ensembles d'attributs auxquels l'attribut appartient. Si l'attribut appartient à plus d'un jeu d'attributs, des virgules sont utilisées pour séparer chaque jeu d'attributs.
Help Text	Inclut le texte ajouté dans la propriété Texte d'aide de l'attribut.
Field Length	Indique le nombre maximal de caractères autorisés dans la propriété Nombre maximal de caractères acceptés de l'attribut. Zones de saisie de texte uniquement.
Decimal Length	Définit le nombre de décimales. Types d'attributs décimaux uniquement.
Main Tab Sequence	Indique la position de l'attribut dans la première section du premier onglet du document nnées](doc:modèle-de-donnédoc:objets-et-attributs#hiérarchie-des-documents).
Main Tab (level 1)	Le nom du premier onglet du type de document (2ème niveau hiérarchique).
Field Tab Sequence	Indique la position de l'attribut dans la deuxième section du premier onglet du document (4e niveau hiérarchique).
Field Tab (level 2)	Le nom de la deuxième section du type de document (3e niveau hiérarchique).
Field Group Sequence	Indique la position de l'attribut dans le groupe d'attributs de la section (4e niveau hiérarchique).
Field Group (level 3)	Le nom du groupe d'attributs de la section (4e niveau hiérarchique).
Validator (Regex)	Cette colonne doit toujours être vide.
Searchable	Cette propriété n'est plus utilisée. Vous pouvez mettre `FALSE` sur chaque cellule.
Filterable	Indique si la propriété Filtrable (recherche) de l'attribut est activée : `TRUE` L'attribut peut être utilisé comme un filtre dans les recherches. `FALSE` L'attribut ne peut pas être utilisé comme un filtre dans les recherches.
Visible	Indique si la propriété Visible (interne) de l'attribut est activée : `TRUE` L'attribut est visible. `FALSE` L'attribut n'est pas visible.
Writable	Indique si la propriété Editable (interne) de l'attribut est activée : `TRUE` L'attribut peut être modifié. `FALSE` L'attribut ne peut pas être modifié.

Feuille Sku - Champs

Liste tous les attributs des variants, avec leurs propriétés.

Colonne	Description
Source	Imports - Vous devez saisir la source originale des données (e.g., ERP, PIM, etc.). Exports - Cette colonne est vide.
Field Name	Le nom de l'attribut.
Field Code	L'identifiant unique de l'attribut.
Mandatory	Indique si l'attribut est obligatoire ou facultatif : `TRUE` - L'attribut est obligatoire. `FALSE` - L'attribut est facultatif.
Field Type	Indique le type de l'attribut.
Help Text	Inclut le texte ajouté dans la propriété Texte d'aide de l'attribut.
Field Length	Indique le nombre maximal de caractères autorisés dans la propriété Nombre maximal de caractères acceptés de l'attribut. Zones de saisie de texte uniquement.
Decimal Length	Définit le nombre de décimales. Types d'attributs décimaux uniquement.
Field Group	Le nom du groupe d'attributs de la variante (4e niveau hiérarchique).
Validator (Regex)	Cette colonne doit toujours être vide.
Searchable	Cette propriété n'est plus utilisée. Vous pouvez mettre `FALSE` sur chaque cellule.
Filterable	Indique si la propriété Filterable (search) de l'attribut est activée : `TRUE` - L'attribut peut être utilisé comme un filtre dans les recherches. `FALSE` - L'attribut ne peut pas être utilisé comme un filtre dans les recherches.
Visible	Indique si la propriété Visible (internal) de l'attribut est activée : `TRUE` - L'attribut est visible. `FALSE` - L'attribut n'est pas visible.
Writable	Indique si la propriété Editable de l'attribut est activée : `TRUE` - L'attribut peut être modifié. `FALSE` - L'attribut ne peut pas être modifié.

Feuille Classification

Liste tous les attributs des classifications, avec leur organisation et leurs propriétés.

Colonne	Description
Source	Imports - Vous devez saisir la source originale des données (e.g., ERP, PIM, etc.). Exports - Cette colonne est vide.
Document Type	L'identifiant unique de la classification.
Field Name	Le nom de l'attribut.
Field Code	L'identifiant unique de l'attribut.
Mandatory	Indique si l'attribut est obligatoire ou optionnel : `TRUE` - L'attribut est obligatoire. `FALSE` - L'attribut est optionnel.
Field Type	Indique le type de l'attribut.
Attribute Set	Indique le ou les ensembles d'attributs auxquels l'attribut appartient. Si l'attribut appartient à plus d'un jeu d'attributs, des virgules sont utilisées pour séparer chaque jeu d'attributs.
Help Text	Inclut le texte ajouté dans la propriété Texte d'aide de l'attribut.
Field Length	Indique le nombre maximal de caractères autorisés dans la propriété Nombre maximal de caractères acceptés de l'attribut. Zones de saisie de texte uniquement.
Decimal Length	Définit le nombre de décimales. Types d'attributs décimaux uniquement.
Main Tab Sequence	Indique la position de l'attribut dans la première section du premier onglet du document nnées](doc:modèle-de-donnédoc:objets-et-attributs#hiérarchie-des-documents).
Main Tab (level 1)	Le nom du premier onglet du type de document (2ème niveau hiérarchique).
Field Tab Sequence	Indique la position de l'attribut dans la deuxième section du premier onglet du document (4e niveau hiérarchique).
Field Tab (level 2)	Le nom de la deuxième section du type de document (3e niveau hiérarchique).
Field Group Sequence	Indique la position de l'attribut dans le groupe d'attributs de la section (4e niveau hiérarchique).
Field Group (level 3)	Le nom du groupe d'attributs de la section (4e niveau hiérarchique).
Validator (Regex)	Cette colonne doit toujours être vide.
Searchable	Cette propriété n'est plus utilisée. Vous pouvez mettre `FALSE` sur chaque cellule.
Filterable	Indique si la propriété Filtrable (recherche) de l'attribut est activée : `TRUE` - L'attribut peut être utilisé comme un filtre dans les recherches. `FALSE` - L'attribut ne peut pas être utilisé comme un filtre dans les recherches.
Visible	Indique si la propriété Visible (interne) de l'attribut est activée : `TRUE` - L'attribut est visible. `FALSE` -L'attribut n'est pas visible.
Writable	Indique si la propriété Editable (interne) de l'attribut est activée : `TRUE` - L'attribut peut être modifié. `FALSE` - L'attribut ne peut pas être modifié.

Feuille XObject Types

Liste tous les types de liaison définis entre les entités du PIM.

Colonne	Description
Source	Imports - Vous devez saisir la source originale des données (e.g., ERP, PIM, etc.). Exports - Cette colonne est vide.
Name	Le nom du type de liaison.
Code	L'identifiant unique du type de liaison.
Owner	Ceci indique l'objet parent du type de liaison. Celui-ci est toujours identifié comme un Article.
OwnerDocType	Le page *Modèle de données du type de liaison (doc:liaisons#sélectionner-le-type-de-liaison).
Target	Identifie l'dèle de donnée du type de liaison (doc:liaisons#sélectionner-le-type-de-liaison) : document (Article) or médias (DamMedia)
TargetDocType	Si l'objet enfant est un document, ceci identifie le type de document.
Maximum	Le nombre maximum de liaisons autorisées par le type de liaison.

Feuille XObject Types - Champs

Liste tous les attributs associés aux types de liaison.

Colonne	Description
Source	Imports - Vous devez saisir la source originale des données (e.g., ERP, PIM, etc.). Exports - Cette colonne est vide.
XObject Type	L'identifiant unique du type de liaison.
Field Name	Le nom de l'attribut.
Field Code	L'identifiant unique de l'attribut.
Mandatory	Indique si l'attribut est obligatoire ou optionnel : `TRUE` - L'attribut est obligatoire. `FALSE` - L'attribut est optionnel.
Field Type	Indique le type de l'attribut.
Help Text	Inclut le texte ajouté dans la propriété Texte d'aide de l'attribut.
Field Length	Indique le nombre maximal de caractères autorisés dans la propriété Nombre maximal de caractères acceptés de l'attribut. Zones de saisie de texte uniquement.
Decimal Length	Définit le nombre de décimales. Types d'attributs décimaux uniquement.
Main Tab Sequence	Indique la position de l'attribut dans la première section du premier onglet du document nnées](doc:modèle-de-donnédoc:objets-et-attributs#hiérarchie-des-documents).
Main Tab (level 1)	Le nom du premier onglet du type de document (2ème niveau hiérarchique).
Field Tab Sequence	Indique la position de l'attribut dans la deuxième section du premier onglet du document (4e niveau hiérarchique).
Field Tab (level 2)	Le nom de la deuxième section du type de document (3e niveau hiérarchique).
Field Group Sequence	Indique la position de l'attribut dans le groupe d'attributs de la section (4e niveau hiérarchique).
Field Group (level 3)	Le nom du groupe d'attributs de la section (4e niveau hiérarchique).
Validator (Regex)	Cette colonne doit toujours être vide.
Searchable	Cette propriété n'est plus utilisée. Vous pouvez mettre `FALSE` sur chaque cellule.
Filterable	Indique si la propriété Filtrable (recherche) de l'attribut est activée : `TRUE` - L'attribut peut être utilisé comme un filtre dans les recherches. `FALSE` - L'attribut ne peut pas être utilisé comme un filtre dans les recherches.
Visible	Indique si la propriété Visible (interne) de l'attribut est activée : `TRUE` - L'attribut est visible. `FALSE` - L'attribut n'est pas visible.
Writable	Indique si la propriété Editable (interne) de l'attribut est activée : `TRUE` - L'attribut peut être modifié. `FALSE` - L'attribut ne peut pas être modifié.

Feuille Médias

Liste tous les attributs des fiches médias.

Colonne	Description
Source	Imports - Vous devez saisir la source originale des données (e.g., ERP, PIM, etc.). Exports - Cette colonne est vide.
Field Name	Le nom de l'attribut.
Field Code	L'identifiant unique de l'attribut.
Mandatory	Indique si l'attribut est obligatoire ou optionnel : `TRUE` - L'attribut est obligatoire. `FALSE` - L'attribut est optionnel.
Field Type	Indique le type de l'attribut.
Help Text	Inclut le texte ajouté dans la propriété Texte d'aide de l'attribut.
Field Length	Indique le nombre maximal de caractères autorisés dans la propriété Nombre maximal de caractères acceptés de l'attribut. Zones de saisie de texte uniquement.
Decimal Length	Définit le nombre de décimales. Types d'attributs décimaux uniquement.
Field Group	Indique la position de l'attribut dans le groupe d'attributs de la section (4e niveau hiérarchique).
Validator (Regex)	Cette colonne doit toujours être vide.
Searchable	Cette propriété n'est plus utilisée. Vous pouvez mettre `FALSE` sur chaque cellule.
Filterable	Indique si la propriété Filtrable (recherche) de l'attribut est activée : `TRUE` - L'attribut peut être utilisé comme un filtre dans les recherches. `FALSE` - L'attribut ne peut pas être utilisé comme un filtre dans les recherches.
Visible	Indique si la propriété Visible (interne) de l'attribut est activée : `TRUE` - L'attribut est visible. `FALSE` - L'attribut n'est pas visible.
Writable	Indique si la propriété Editable (interne) de l'attribut est activée : `TRUE` - L'attribut peut être modifié. `FALSE` - L'attribut ne peut pas être modifié.

Feuille Validators

Référence technique des types d'attributs disponibles dans Quable PIM et de leurs valeurs acceptées (types EAV, valeurs booléennes, codes locales). Cette feuille est en lecture seule — elle ne doit pas être modifiée.

Colonne	Description
EAV Field Types	Types d'attributs disponibles. Valeurs disponibles : Textfield No translate Textfield Textarea Textarea HTML Integer Decimal Date Boolean Select (Predefined values) Multiselect (Predefined values) Tag (Predefined values)
Boolean	Les valeurs binaires des options: `TRUE` - 1 `FALSE` -0
Locales	Identifie les locales disponibles. The complete list of available locales is available here.

Colonne

Description

EAV Field Types

Types d'attributs disponibles.

Valeurs disponibles :

Textfield No translate
Textfield
Textarea
Textarea HTML
Integer
Decimal

Date
Boolean
Select (Predefined values)
Multiselect (Predefined values)
Tag (Predefined values)

Boolean

Les valeurs binaires des options:

TRUE - 1 FALSE -0

Locales

Identifie les locales disponibles.

The complete list of available locales is available here.

Les principaux points de vigilance

La colonne Source est obligatoire à l'import (indiquez l'origine des données, ex. : ERP, PIM). À l'export, cette colonne est vide ou renseignée automatiquement.
Les valeurs booléennes sont exprimées en TRUE / FALSE (et non 1 / 0).
La colonne Validator (Regex) doit toujours rester vide.
La colonne Searchable n'est plus utilisée — renseignez FALSE dans toutes les cellules.
La feuille Validators est une référence technique, ne la modifiez pas.

Historique des opérations

Suivi de l'export

Chaque export du modèle de données génère un fichier .xlsx qui est conservé dans la page Administration > Système > Modèle de données dans la section historique. Cette section constitue l'historique des fichiers exportés disponibles sur votre instance.

Sur cette page, pour chaque export vous pouvez Télécharger le fichier .xlsx sur votre ordinateur ;

📘
Bon à savoir
Pensez à télécharger et archiver les exports importants sur votre poste. Les fichiers disponibles dans Téléchargements ne sont pas une sauvegarde permanente.

Pages associées

Attributs — Créer et gérer les attributs de vos types de documents
Jeux d'attributs — Regrouper les attributs par jeux
Types de liaison — Définir les relations entre entités
Langues de données — Gérer les langues de saisie
Réinitialisation — Réinitialiser les données, le modèle ou l'instance complète
Rôles et permissions — Configurer les droits d'accès des utilisateurs
Tableau des permissions — Référence complète des permissions disponibles