Aller au contenu principal
— Tutoriel de configuration

Mapper des fichiers en masse à des produits avec un CSV

Alva Digital Downloads mappe plusieurs fichiers à des produits Shopify en un seul import. Construisez un CSV avec une colonne PRODUCT_ID et une ou plusieurs colonnes FILE_, déposez-le dans l'écran de mappage en masse, prévisualisez les correspondances, puis traitez. Les grands catalogues se mappent en quelques minutes au lieu d'un produit à la fois.

Ce que fait le mappage en masse

Alva Digital Downloads lie les fichiers déjà présents dans le stockage à des produits Shopify à partir d'un seul CSV. Ouvrez la page Produits et cliquez sur l'action secondaire Bulk Product-File Mapping. L'écran n'est disponible que sur les forfaits payants — il est désactivé sur le forfait gratuit.

Ce dont le CSV a besoin

Le parseur lit la ligne d'en-tête et fait correspondre les colonnes par nom, sans tenir compte de la casse. Il requiert une colonne PRODUCT_ID et au moins une colonne FILE_1. Les colonnes de variante sont facultatives. L'ordre des colonnes n'a pas d'importance, et vous pouvez ajouter autant de colonnes FILE_ et VARIANT_ que nécessaire.

  • PRODUCT_ID — l'ID du produit Shopify. Utilisez le numéro brut (1234567890) ou la forme complète gid://shopify/Product/1234567890.
  • FILE_1, FILE_2, … — chacune contient le titre d'un fichier dans le stockage Alva, éventuellement préfixé par @ (le @ est retiré). Chaque ligne a besoin d'au moins un fichier.
  • VARIANT_1, VARIANT_2, … — IDs de variante Shopify facultatifs. Laissez-les vides pour mapper sur la variante par défaut de l'ensemble du produit.

Comment mapper des fichiers en masse

1. Ouvrez l'écran de mappage en masse

Sur la page Produits, cliquez sur Bulk Product-File Mapping. La page s'ouvre avec une carte d'instructions — incluant un exemple de CSV travaillé — et un outil de téléversement par glisser-déposer. Il n'y a pas de modèle téléchargeable ; copiez la disposition de l'exemple dans votre feuille de calcul.

2. Construisez et enregistrez le CSV

Mettez un produit par ligne. Remplissez PRODUCT_ID avec l'ID Shopify et chaque colonne FILE_ avec un titre de fichier. Une ligne brute 123456789,,,,@User Manual,, mappe un fichier sur la variante par défaut d'un produit. Enregistrez la feuille au format .csv.

Capture d'écran nécessaire

La table d'aperçu Bulk Product-File Mapping après un téléversement de CSV. Montrer les quatre colonnes — File, Product, Variants, Status — avec 3 à 4 lignes d'exemple : badges verts « success », une ligne rouge « error » et un produit portant un badge « Existing ». Utiliser des noms de produits fictifs, aucune donnée client réelle.

La table d'aperçu valide chaque ligne avant que vous ne traitiez l'import.

3. Téléversez et examinez l'aperçu

Déposez le fichier dans l'outil de téléversement. Alva vérifie chaque titre de fichier dans le stockage et valide les IDs de produit et de variante face à Shopify. L'aperçu liste chaque ligne avec un badge Statussuccess, error ou pending — et signale les produits qui ont déjà des mappages avec un badge Existing.

4. Traitez les mappages

Cliquez sur Process CSV. Les lignes valides sont enregistrées comme mappages de produits et les lignes en erreur sont ignorées. Si plus de 30 % des lignes sont invalides, Alva bloque l'exécution. En dessous de ce seuil, une boîte de dialogue de confirmation vous indique combien de lignes seront ignorées avant de poursuivre.

5. Vérifiez la couverture

Après une exécution réussie, cliquez sur View Products pour revenir à la liste des produits. Chaque produit affiche son nombre de pièces jointes, vous pouvez donc repérer tout produit affichant encore zéro fichier. Corrigez ces lignes et relancez-les avec Retry failed mappings.

Questions fréquentes

Où trouver l'ID Shopify d'un produit ?

Ouvrez le produit dans l'admin Shopify et copiez l'ID numérique à la fin de l'URL, comme 1234567890. Alva accepte ce numéro brut ou la forme complète gid://shopify/Product/1234567890 dans la colonne PRODUCT_ID.

Alva propose-t-il un modèle de CSV téléchargeable ?

Non. L'écran de mappage en masse affiche un exemple de CSV travaillé à l'intérieur de la carte d'instructions. Copiez cette disposition dans votre feuille de calcul — une colonne PRODUCT_ID plus des colonnes FILE_1, FILE_2 — plutôt que de télécharger un fichier modèle.

Comment une ligne identifie-t-elle le fichier ?

Par le titre du fichier dans le stockage Alva, sans tenir compte de la casse. Vous pouvez préfixer le titre par un symbole @, qu'Alva retire. Le fichier doit déjà être téléversé — le mappage en masse lie des fichiers existants, il ne les téléverse pas.

Qu'advient-il des lignes comportant des erreurs ?

Les lignes en erreur sont ignorées et les lignes valides sont quand même enregistrées. Si plus de 30 pour cent des lignes sont invalides, Alva bloque toute l'exécution. En dessous, une fenêtre de confirmation vous avertit quelles lignes seront ignorées avant le traitement.

Comment mapper un fichier différent par variante ?

Ajoutez des colonnes VARIANT_1, VARIANT_2 et mettez un ID de variante Shopify dans chacune. Les lignes sans colonne de variante se mappent sur la variante par défaut et s'appliquent à l'ensemble du produit. Il n'y a aucune limite au nombre de colonnes de variante.

Voir aussi

Cet article vous a-t-il été utile ?

Toujours bloqué ? Écrivez-nous.

Dernière mise à jour 2026-06-01