Lancer un export

A vos marques, prêts, partez !

La page Lancer un export vous permet de définir et de gérer les paramètres d'export de votre contenu Quable PIM.

2880

La page est divisée en quatre sections: :

  • Profil - Utilisation avec ou sans profil d'export
  • Format du fichier d'export - Le format du fichier d'export
  • Destination du fichier - Emplacement du fichier exporté
  • Mapping - Instructions pour définir votre contenu Quable PIM à exporter

Lorsque vous avez rempli les sections, cliquez sur le bouton Exporter les données pour lancer l'export.

👍

La puissante fonctionnalité d'export de Quable vous permet de lancer des exports à partir :

  • de la page Profils d'exports (via Plus d'actions), et
  • depuis la page Lancer un export (avec ou sans profil d'export).

Il existe deux principaux scénarios pour exporter du contenu dans Quable PIM :

Sans ProfilAvec Profil
Généralement utilisé pour les exports ponctuels.Pour les exports récurrents.

Ces scénarios sont décrits en détail dans les sections suivantes.

Sans Profil

Pour lancer un export sans profil d'export, sélectionnez Lancer un export dans le menu latéral Flux de données et remplissez les sections suivantes :

Identité de l'export

Cette section vous permet de définir l'export et ses paramètres.

2266

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

❗️

Documents orphelins et export - Des documents peuvent être manquants

Il existe un cas où un document pourrait ne pas être exporté.
Si un document est orphelin (non classifié dans le PIM) et qu'il est assigné manuellement à une classification d'un canal, il ne sortira pas dans l'export.
Un document non classifié dans le PIM est considéré comme une mauvaise pratique et il suffit donc de la classifier pour le retrouver.

Destination du fichier

Cette section vous permet de spécifier la destination de votre fichier d'export.

2280

Vous pouvez cliquer sur le bouton de glissement pour choisir entre les deux options suivantes :

  • Local
Le fichier est exporté vers l'ordinateur que vous utilisez.
  • Distant
Le fichier est exporté vers un serveur distant.

2260



Saisissez les informations suivantes :

InformationDescription Obligatoire
ProtocoleLe protocole à utiliser pour l'export.

Valeurs possibles :
  • http://
  • https://
  • ftp://
  • sftp://
Oui
Chemin du dossier + nom du fichierL'adresse complète du répertoire et le nom du fichier d'export.Oui
Identifiant de connexionIdentifiant pour la connexion à la source contenant le fichier d'import.Oui
Mot de passeMot de passe pour se connecter à la source contenant le fichier d'import.Oui

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.

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}_".

📘

Example :

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 ppur 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 ; S ; pictJR1.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 le contenu de votre Quable PIM à exporter.

2546

❗️

Attention

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

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

2268

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.
    Attention, seuls 500 attributs sont affichés dans cette liste. Vous pouvez effectuer une recherche afin de trouver un attribut de cette liste ou un autre attribut non affiché.
  • 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.

1470

🚧

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é de vos colonnes dans le fichier exporté.

Avec Profil

Pour lancer un export avec un profil d'export, sélectionnez Lancer un export dans le menu latéral Flux de Données et remplissez les sections suivantes :

Identité d'export

Dans la liste déroulante Sélectionner un profil, sélectionnez un profil d'export à utiliser.

750

Vous pouvez étendre la section en cliquant sur la flèche située sur le côté droit de la section. La section étendue affiche les détails du profil sélectionné.

2272

Après avoir cliqué sur le bouton Lancer l'export, la page Journal d'activités s'affiche et indique 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 sur Plus d'informations pour voir combien d'éléments ont été exportés.