Profils d'exports

Vous exportez fréquemment le même type de fichier ? Enregistrez vos préférences !

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.

2880

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:

795
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ée. 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.
2880
  • 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 :

2464

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 :

InformationDescriptionObligatoire
NomLe nom du profil d'export.Oui
DescriptionEntrez un texte pour décrire le profil d'export.Non
Type d'objetLe type d'objet à utiliser pour l'exportation. Valeurs possibles:



ObjetLorsque sélectionnéComportement d'exportation
MédiasUne option obligatoire pour spécifier le canal apparaît.Tous les médias et leurs attributs.

Contenu du fichier par défaut :
  • 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
ChannelUne option obligatoire pour spécifier le canal apparaît.Tout le contenu du canal sélectionné.

Contenu du fichier par défaut :
  • code_catalogue
  • code_classification
  • code_document

ClassificationUne 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.

Contenu du fichier par défaut :
  • classification_parent_code
  • classification_code
  • date_créée
  • date_modifiée
  • catalogue
  • tree_left
  • tree_right
  • quable_classification_name
DocumentUne option obligatoire pour spécifier le type de document apparaît. Tous les documents du type sélectionné.

Contenu du fichier par défaut :
  • code_de_classification
  • code_de_document
  • date_créée
  • date_modifiée
LiensUne option obligatoire pour spécifier le type de liaison apparaît.Tout le contenu du type de liaison sélectionné.

Contenu du fichier par défaut :
  • source_code
  • target_code
  • date_created
  • date_modified
  • sequence
Liste de valeurs -Toutes les valeurs prédéfinies de tous les attributs.

Contenu du fichier par défaut :
  • code_attribut
  • code_valeur
  • label_valeur
  • date_créée
  • date_modifiée
Variants - Tous les variants et toutes leurs valeurs.

Contenu du fichier par défaut :
  • sku_code
  • document_code
  • date_créée
  • date_modifiée
  • quable_sku_name
Oui
LanguesLa langue des données à exporter.

Note : 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).

Exemple
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).
Oui
Export avec des colonnes héritéesDé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é.
  • Activated - les données sont exportées avec le contenu hérité (le cas échéant).
Oui

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
2230


Nombre maximal de lignes : 200 000

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)
2310


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 la liaison Remplir avec les valeurs par défaut pour sélectionner automatiquement les paramètres par défaut) :

    ParametreDescriptionValeurs possibles
    Séparateur de colonnesLe 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-0621 12:00:00
    Espace (défaut)
    Identificateur de chaîneLe caractère utilisé pour indiquer le début et la fin d'une valeur de données.Guillemets (défaut),
    Apostrophe
    Format de dateLe 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 multiplesLe caractère utilisé pour séparer des valeurs multiples.Barre verticale (défaut)
    Format de nombreLe format utilisé pour les chiffres dans le fichier d'export.00.00 (défaut),
    00,00
    Données pour les attributs listesPour chaque attributs 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.

Filtres

🚧

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

❗️

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 concernés les attributs, complétudes, tags et worfklows.
  • 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] (doc:reference-de-loperateur-de-filtres).

Jointures

Cette option vous permet de créer un fichier résultant de la concaténation de plusieurs fichiers exportables par votre PIM. Aussi, 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 vous proposant 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é, 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és 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 alors 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] et [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; S.jpg] ; [jupe-rouge ; pictJR2; S.jpg][jupe-rouge ; pictJR1; M.jpg][jupe-rouge ; pictJR2; M.jpg][jupe-rouge ; pictJR1. l.jpg][jupe-rouge ; pictJR2; L.jpg]

🚧

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'import correspondent au contenu de votre Quable PIM.

2546

❗️

Attention

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

🚧

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

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

2308

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.

1502

🚧

Les attributs d'objet soulignés en orange sont obligatoires. Un export ne peut pas être lancée 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 la liaison 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.

2880

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

  • Nom
  • Description
  • Export avec colonnes héritées
  • 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 la liaison 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.

1036

❗️

Attention

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