La page Profils d'export est l'endroit où vous pouvez définir et gérer les profils pour vos exports Quable PIM. La page comprend une brève description de la fonctionnalité, un lien vers cette page de documentation et une liste des profils d'export existants, le cas échéant.

Si aucun profil d'export n'a encore été créé, un bouton Créer un profil s'affiche à la fois dans la section Profils d'export actuels et dans le coin supérieur droit de la page.
Si des profils d'export ont déjà été créés, une liste s'affiche avec : le Nom du profil, le Type de données du profil, le Format du fichier (CSV ou XLSX), une indication si l'attribut Mapping est utilisé, les données Langues, et si le profil est pour les exports Distant. Le bouton Créer un profil s'affiche uniquement dans le coin supérieur droit de la page.

A la fin de chaque ligne d'un profil d'export se trouvent des icônes pour Editer ou Supprimer le profil, ainsi que Plus d'actions. En cliquant sur Plus d'actions, on affiche :

Lorsque vous cliquez :

Initier un export de données - La page Journal d'activité s'affiche en indiquant qu'un export du type de données du profil sélectionné a été lancé. Vous pouvez cliquer sur Fichier pour télécharger le fichier d'export ou Plus d'informations pour voir combien d'éléments ont été exportés.
Initier un export de données pour la locale actuelle - Un fichier CSV est téléchargé avec des données dans la langue de données actuelle pour le profil sélectionné.

Création de profils

Pour créer un profil d'export, cliquez sur le bouton Créer un profil d'export. Le formulaire Créer un profil d'export s'affiche :

Le formulaire est divisé en trois sections : Identité du profil, Format du fichier d'export, et Mapping. Ces sections sont décrites en détail ci-dessous. Lorsque vous avez rempli les sections, cliquez sur le bouton Créer pour enregistrer le profil.

Identité du profil

Cette section est utilisée pour distinguer chaque profil d'export et ses paramètres.

Saisissez les informations suivantes :

Information	Description	Obligatoire
Nom	Le nom du profil d'export.	Oui
Description	Entrez un texte pour décrire le profil d'export.	Non
Type d'objet	Le type d'objet à utiliser pour l'exportation. Voir le tableau Types d'objet ci-dessous.	Oui
Langues	La langue des données à exporter. Seul le contenu des attributs dans la ou les langues désignées sera exporté, cependant les attributs qui ne peuvent pas être traduits sont pris en considération (par exemple, les chiffres).	Oui
Export avec des colonnes héritées	Définit l'action à entreprendre pour les données définies avec un héritage de langue. Lorsque des héritages linguistiques sont définis, le contenu incomplet dans la langue exportée est automatiquement remplacé par le contenu correspondant dans la langue des données. Valeurs possibles : Disabled (les données sont exportées sans contenu hérité) ou Activated (les données sont exportées avec le contenu hérité, le cas échéant).	Oui
Exporter les produits modifiés au cours des derniers	Limite l'export aux produits créés ou modifiés pendant une période glissante, recalculée à chaque export. Saisissez un nombre entier (minimum 1), puis choisissez une Unité : Heures, Jours, Semaines, Mois ou Années. Laissez le champ vide pour exporter tous les produits. Disponible pour le type d'objet Document, une fois un type de document sélectionné. Voir Exporter uniquement les produits modifiés récemment.	Non

📘
Exemple pour le champ Langues
Votre langue désignée est le français et vos données d'export comprennent du contenu en français et dans une autre langue. Seules les données en français sont exportées, ainsi que tous les attributs qui ne peuvent pas être traduits (par exemple, un attribut prix avec une valeur nombre).

Types d'objet

Objet	Lorsque sélectionné	Comportement d'exportation	Contenu du fichier par défaut
Médias	Une option obligatoire pour spécifier le canal apparaît.	Tous les médias et leurs attributs.	`code_de_classification_média`, `code_média`, `nom_média`, `url`, `external`, `date_créée`, `date_modifiée`, `nom_de_film original`, `checksum`, `type_mime`, `thumbnail_url`
Channel	Une option obligatoire pour spécifier le canal apparaît.	Tout le contenu du canal sélectionné.	`code_catalogue`, `code_classification`, `code_document`
Classification	Une option obligatoire pour spécifier un canal apparaît.	La structure hiérarchique de la classification des documents ou de la classification des médias ou bien d'un canal de diffusion.	`classification_parent_code`, `classification_code`, `date_créée`, `date_modifiée`, `catalogue`, `tree_left`, `tree_right`, `quable_classification_name`
Document	Une option obligatoire pour spécifier le type de document apparaît.	Tous les documents du type sélectionné.	`code_de_classification`, `code_de_document`, `date_créée`, `date_modifiée`
Liens	Une option obligatoire pour spécifier le type de liaison apparaît.	Tout le contenu du type de liaison sélectionné.	`source_code`, `target_code`, `date_created`, `date_modified`, `sequence`
Liste de valeurs	-	Toutes les valeurs prédéfinies de tous les attributs.	`code_attribut`, `code_valeur`, `label_valeur`, `date_créée`, `date_modifiée`
Variants	-	Tous les variants et toutes leurs valeurs.	`sku_code`, `document_code`, `date_créée`, `date_modifiée`, `quable_sku_name`

Exporter uniquement les produits modifiés récemment

Par défaut, un export contient tous les produits du type sélectionné. Le champ "Exporter les produits modifiés au cours de" limite l'export aux produits qui ont changé récemment. Vous n'avez pas besoin d'écrire de filtre JSON ni de développer un script spécifique.

🚧
Conditions d'affichage
Ce champ est proposé uniquement lorsque le type d'objet est Produit et qu'un type de document est sélectionné. Vous devez disposer des droits d'accès aux exports.

Paramétrer la période

Dans la section Identité du profil, repérez le champ Exporter les produits modifiés au cours des derniers, en bas de la section.
Saisissez un nombre entier supérieur ou égal à 1 (par exemple 7).
Dans la liste Unité, sélectionnez Heures, Jours, Semaines, Mois ou Années.

Le nombre et l'unité vont ensemble : si vous n'en remplissez qu'un, l'enregistrement est bloqué. Pour exporter à nouveau tous les produits, videz les deux parties et enregistrez.

Comment la période est calculée

La période est glissante : elle est recalculée à chaque export. Avec 7 Jours, l'export contient les produits dont la date de modification est postérieure au moment du lancement moins 7 jours.
Les produits créés pendant la période sont exportés, même s'ils n'ont pas été modifiés depuis.
Le filtre s'applique quelles que soient les colonnes exportées : que la date de modification figure dans le fichier ou non, et qu'elle soit renommée ou non dans le mapping.
Le filtre s'applique à tous les lancements du profil : export manuel, export planifié et export lancé via l'API.

📘
Exemple
Un export est lancé le 13 novembre à 10 h avec le réglage 7 Jours :

un produit modifié le 10 novembre est exporté ;

un produit modifié le 1er novembre n'est pas exporté ;

un produit créé le 12 novembre, jamais modifié depuis, est exporté.

Avec le réglage 12 Heures, un produit modifié à 8 h le même jour est exporté. Un produit modifié la veille au matin ne l'est pas.

👍
Astuce : export planifié incrémental
Pour un export planifié, choisissez une période au moins égale à l'intervalle entre deux exécutions. Par exemple, pour un export quotidien, une période de 1 Jour couvre les modifications depuis l'exécution précédente. Une période légèrement plus longue (par exemple 25 Heures) vous laisse une marge en cas de décalage d'exécution. Votre système cible doit alors savoir mettre à jour un produit déjà reçu.

🚧
Limites

Le filtre se base sur la date de modification du produit.

Les produits supprimés n'apparaissent pas dans l'export : ce filtre ne permet pas de transmettre les suppressions au système cible.

Ce champ est indépendant des Filtres avancés (JSON). Il n'apparaît pas dans le JSON. Voir la section Filtres.

Format du fichier d'export

Cette section est utilisée pour spécifier le format et les paramètres (le cas échéant) de votre fichier d'export. Deux options sont disponibles : XLSX et CSV (défaut).

XLSX

Nombre maximal de lignes : 200 000
Nombre maximal de caractères par cellule : 32 767

Pour exporter des fichiers .xlsx, les paramètres standards sont utilisés. Vous n'avez pas besoin de spécifier de paramètres.

CSV (défaut)

Nombre maximal de lignes : 200 000

Pour les fichiers .csv, vous avez deux options pour les paramètres :

Standard - Les paramètres standards sont utilisés. Vous n'avez pas besoin de spécifier de paramètres.
Personnalisé - Vous devez spécifier les paramètres suivants (vous pouvez cliquer sur le lien Remplir avec les valeurs par défaut pour sélectionner automatiquement les paramètres par défaut) :

Paramètre	Description	Valeurs possibles
Séparateur de colonnes	Le caractère utilisé pour séparer les attributs dans le fichier d'export.	Virgule, Point virgule (défaut), Tabulation
Séparateur de dates	Le caractère utilisé pour séparer les valeurs de date et d'heure dans le fichier d'export. Exemple : `2021-06-21 12:00:00`	Espace (défaut)
Identificateur de chaîne	Le caractère utilisé pour indiquer le début et la fin d'une valeur de données.	Guillemets (défaut), Apostrophe
Format de date	Le format utilisé pour les dates dans le fichier d'export.	aaaa/mm/jj, jj/mm/aaaa (défaut)
Format d'heure	Le format utilisé pour les heures dans le fichier d'export.	hh:mm.ss (défaut)
Séparateur de valeurs multiples	Le caractère utilisé pour séparer des valeurs multiples.	Barre verticale (défaut)
Format de nombre	Le format utilisé pour les chiffres dans le fichier d'export.	00.00 (défaut), 00,00
Données pour les attributs listes	Pour chaque attribut de type "Liste", ajouter une colonne pour les libellés et/ou les descriptions de ces attributs.	Descriptions, Valeurs

📘
Une nouvelle fonctionnalité est disponible dans vos exports CSV !

Dans les exports CSV personnalisés, vous trouvez une nouvelle option "Données pour les attributs listes" qui vous permet d'ajouter au fichier à exporter : une à deux colonnes par langue sélectionnée, pour chaque attribut "Liste" du type d'objet choisi, affichant les libellés et/ou les descriptions.

Notez que cette fonctionnalité n'est pas disponible pour les exports au format .xlsx (Excel).

Filtres

🚧
Disponibilité
Disponible uniquement pour les objets document, une fois qu'un type de document est sélectionné.

Cette section permet de spécifier des filtres pour les données à exporter. Deux options sont disponibles :

Pas de filtre (défaut) : Toutes les données du type d'objet sélectionné sont exportées sans aucun filtrage.
Filtres avancés

❗️
Fonctionnalité expérimentale
Cette fonctionnalité est expérimentale et n'est conseillée que pour les utilisateurs avancés ayant des compétences en JSON. Quable ne fournit pas de support pour son utilisation, pour le moment.

Dans le champ acceptant du JSON, entrez vos filtres.

Les filtres peuvent concerner les attributs, complétudes, tags et workflows.
La syntaxe JSON est vérifiée, mais la véracité des filtres ne l'est pas.
Les filtres fonctionnent en combinaison pour créer une instruction ET.
Les instructions OU conditionnelles ne sont pas prises en charge.
Si un mapping est utilisé, les clés de votre filtre doivent correspondre aux noms des attributs mappés.

[
	{
		"column": "document_code",
		"operator": "!=",
		"value": "DOCUMENT_1234"
	},
	{
		"column": "attribute_set_code",
		"operator": "==",
		"value": null
	},
	{
		"column": "completeness_website (en_GB)",
		"operator": ">",
		"value": "0.80"
	}
]

Vous pouvez trouver des informations sur les opérateurs de filtre ici.

📘
Filtres avancés et période de modification
Pour limiter l'export aux produits modifiés récemment, utilisez de préférence le champ Exporter les produits modifiés au cours des derniers de la section Identité du profil, sans écrire de JSON.
Si vous combinez ce champ avec des filtres avancés, les deux s'appliquent : un produit est exporté uniquement s'il respecte à la fois la période et les filtres JSON.

Jointures

Cette option vous permet de créer un fichier résultant de la concaténation de plusieurs fichiers exportables par votre PIM. En utilisant cette option, vous exporterez toutes les informations du type de Documents sélectionné précédemment, ainsi que toutes celles des fichiers de ses objets liés (Assets, Variants et les types de Documents enfants).

Pour cela, placez le switch sur ON :

Un encart s'ouvre et vous propose les types de liaisons disponibles pour chaque type d'objet (Documents, Assets, Variants) que vous pouvez joindre.
Sélectionnez jusqu'à 3 types d'objets à joindre et lancez votre export.
Une fois la génération et le téléchargement terminés, vous retrouvez l'ensemble des colonnes des objets sélectionnés ainsi que celles des liaisons entre ces objets.

N.B. : Pour éviter les colonnes de même nom dans le cas des documents liés, les colonnes des fichiers joints sont préfixées par {linkTypeCode}_.

📘
Exemple
Disons que j'exporte le type de Document "Produit" qui n'a qu'un seul document ayant pour code "jupe-rouge", lié par le type de liaisons "Photo" à 2 médias "pictJR1.jpg" et "pictJR2.jpg" et disposant de 3 variants "S", "M" et "L" :

En faisant un export simple sans jointure, j'aurai toutes les colonnes habituelles pour ce type de document et j'aurai 1 ligne : [jupe-rouge].

En faisant une jointure avec "Photo", j'aurai toutes les colonnes de ce type de document + toutes les colonnes des Assets et j'aurai alors 2 lignes : [jupe-rouge ; pictJR1.jpg] ; [jupe-rouge ; pictJR2.jpg]. Cela m'évite donc de faire 3 exports : un export DOC + un export Asset + un export LinkType 'Doc->Photo'.

En faisant une jointure avec "Photo" et "Variants", j'aurai toutes les colonnes de ce type de document + toutes les colonnes des Assets + celles des Variants et j'aurai alors 6 lignes : [jupe-rouge ; pictJR1.jpg ; S] ; [jupe-rouge ; pictJR1.jpg ; M] ; [jupe-rouge ; pictJR1.jpg ; L] ; [jupe-rouge ; pictJR2.jpg ; S] ; [jupe-rouge ; pictJR2.jpg ; M] ; [jupe-rouge ; pictJR2.jpg ; L].

🚧
Limites de la fonctionnalité

Vous ne pouvez joindre que des fichiers des types d'objets enfants au type de document sélectionné.

Vous pouvez sélectionner jusqu'à 3 types d'objet à joindre maximum.

Les jointures "multi-niveaux" ne sont actuellement pas disponibles.

En sélectionnant cette option, l'option de mapping n'est plus disponible.

En sélectionnant cette option, votre fichier sera limité à 500 000 lignes.

Mapping

Cette section vous permet de spécifier quelles colonnes de votre fichier d'export correspondent au contenu de votre Quable PIM.

❗️
Attention
Lorsque le mapping est activé, seules les colonnes mappées sont prises en compte et exportées.

🚧
Compatibilité
L'option "Mapping" n'est pas compatible avec l'option "Jointures" pour le moment.

L'activation de l'option de mapping ouvre la section :

La section étendue est divisée en trois colonnes :

Attributs de l'objet - Cette colonne contient tous les attributs disponibles pour le type d'objet sélectionné.
Attributs du PIM - Cette colonne est utilisée pour désigner l'attribut du PIM qui correspond à la colonne de fichier.
Colonnes du fichier - Cette colonne est utilisée pour identifier les colonnes de votre fichier d'export.

Pour faire correspondre votre fichier d'export à votre contenu Quable PIM, sélectionnez des attributs dans la colonne Attributs de l'objet et faites-les glisser / déposer dans la zone située sous Attributs du PIM -> Colonnes du fichier.

🚧
Attributs obligatoires
Les attributs d'objet soulignés en orange sont obligatoires. Un export ne peut pas être lancé s'ils ne sont pas sélectionnés.

A ce stade, vous pouvez :

modifier les titres des attributs sous Colonnes du fichier afin qu'ils correspondent aux titres souhaités des colonnes de votre fichier d'export ;
modifier la position des attributs dans l'ordre souhaité des colonnes du fichier exporté.

Une fois que vous avez saisi toutes les informations relatives à un nouveau profil d'export, cliquez sur le bouton Créer pour enregistrer vos modifications ou sur le lien Retourner (en haut du formulaire) pour revenir à la page Profils d'exports sans enregistrer le nouveau profil d'export.

Modifier les profils

Vous pouvez modifier un profil d'export en le sélectionnant dans la liste Profils d'export existants et en cliquant sur son icône Modifier.

La page Modifier un profil d'export s'affiche. Vous pouvez modifier les éléments suivants :

Nom
Description
Export avec colonnes héritées
Exporter les produits modifiés au cours des derniers
Paramètres du format du fichier d'export (le format du fichier ne peut pas être modifié)
Mapping

Lorsque vous avez terminé vos modifications, cliquez sur le bouton Sauvegarder pour enregistrer vos modifications ou sur le lien Retour (en haut du formulaire) pour revenir à la page Profils d'exports sans enregistrer les modifications.

Supprimer des profils

Pour supprimer un profil d'export, cliquez sur l'icône Supprimer sur la page Profils d'exports. Une boîte de dialogue s'affiche pour annuler ou confirmer la suppression.

❗️
Attention
Cette action est irréversible. Une fois qu'un profil d'export a été supprimé, il ne peut pas être récupéré.