Developers
Quable Guide

Identifier les médias orphelins (médias non reliés)

📘

Objectifs pédagogiques

  • Comprendre ce qu’est un média orphelin.
  • Savoir identifier les médias orphelins dans Quable.
  • Apprendre à gérer efficacement ces médias.

Introduction

Dans Quable, un média orphelin désigne un fichier média (image, vidéo, document PDF, etc.) qui n’est associé à aucune fiche produit. Ces fichiers peuvent s'accumuler au fil du temps dans le DAM, ce qui peut impacter la qualité des données et créer de la confusion auprès des utilisateurs finaux.

À quoi sert d'obtenir la liste des médias orphelins ?

Obtenir la liste des médias orphelins permet de nettoyer le DAM pour garder un environnement de travail clair et performant, et de lier des médias valides à des fiches produits, si besoin.

Cette action est utile dans le cadre de la gestion de la qualité des données, et fait partie intégrante d’une bonne gouvernance des contenus dans le PIM.


Comment procéder ?

Il existe trois méthodes pour obtenir la liste des médias orphelins :

  • via l’interface du PIM,
  • via les exports croisés,
  • via l’API.

1. Depuis l'interface du PIM

  1. Aller sur la page Données > Orphelins > Médias.
  1. Consulter la liste :
    Tous les médias affichés dans cette page sont, par définition, non liés à une fiche produit. Depuis cette page, il est possible de les visualiser et d'y accéder directement.
  1. Actions :

  • Associer les médias à une fiche produit :

    • Cocher un ou plusieurs médias,

    • En bas de page, taper le nom ou le code de la fiche produit (au moins 3 caractères),

    • Sélectionner la fiche produit depuis la liste déroulante.

  • Supprimer les médias :

    • Cocher un ou plusieurs médias,
    • Clique sur l’icône de suppression [-].
    • Confirme la suppression dans la fenêtre qui s’affiche.

🚧

Limitations

  • Lors de l'association d’un média orphelin depuis cette page, la liaison par défaut image-média est utilisée. Pour sélectionner un autre type de liaison, il est préférable de passer par la fiche produit ou la fiche média
  • La recherche dans la page des médias orphelins est manuelle : il n’y a pas de filtre avancé par type, poids, date d’ajout, etc.
  • La suppression est irréversible : il n’existe pas de corbeille ou d’historique de restauration pour les médias supprimés.

2. Par croisement d’exports (option avancée)

📘

Pré-requis

Il est nécessaire de maîtriser les flux de données pour procéder par croisement d'exports. Pour plus d'informations, voir le cours Télécharger et mettre à jour en masse de grandes quantités d’informations.

  1. Faire un export de tous les médias du PIM.
  2. Faire ensuite un export des liaisons médias-documents.
  3. Croiser les deux fichiers (par exemple dans Excel ou Google Sheets) pour identifier les codes médias présents dans le premier export mais absents du second.
  1. Les médias qui n’apparaissent que dans un seul fichier ne sont liés à aucun document : ils sont orphelins.

👍

Bon à savoir

  • L’accès aux exports peut être restreint selon le rôle utilisateur dans le PIM : se rapprocher de l’administrateur du compte le cas échéant.
  • L’analyse croisée via export demande de la rigueur : des erreurs de formule ou de tri peuvent fausser les résultats.

3. Par API (option experte)

  1. Utiliser l’endpoint :
    GET /api/assets
  2. Filtrer les résultats pour ne garder que ceux sans liaison à une fiche produit.

👍

Bon à savoir

  • Cette méthode nécessite des compétences techniques en API et n’est généralement pas utilisée par des profils non techniques.

Bonnes pratiques

  • Favoriser les liaisons directes depuis les fiches produits, via l’onglet Médias, pour éviter les oublis et spécifier le type de liaison à utiliser.
  • Faire une revue régulière des médias présents dans le DAM pour limiter l’accumulation de médias orphelins.
  • Utiliser plusieurs onglets dans votre navigateur pour faciliter la gestion des orphelins : une avec le DAM, une avec les fiches produits, une avec la page des médias orphelins.
  • Vérifier la pertinence avant de supprimer : un média orphelin peut être utile, mais simplement non encore lié à une fiche produit.

📘

En résumé

  • Un média orphelin est un fichier non relié à une fiche produit.
  • Il peut être repéré via :
    • l’interface PIM, sur la page Données > Orphelins > Médias,
    • les exports croisés,
    • l’API.
  • Depuis l’interface, on peut associer ou supprimer les médias orphelins.
  • Il est recommandé de revoir régulièrement les médias hébergés sur le DAM pour maintenir un haut niveau de qualité des données produit.

Chapitre suivant

Maintenant que vous savez comment obtenir la liste des médias orphelins, découvrons comment télécharger et exporter des médias.

Updated about 13 hours ago