Gérer et explorer
Importer et exporter des produits avec Excel
Exportez vos produits avec tous les forfaits. Avec Lite ou Premium, ajoutez ou modifiez aussi des produits dans Excel. Partez d’un modèle CodePersist ou d’un export récent.
- Préparer le fichier
Téléchargez le modèle ou exportez les produits à modifier.
- Importer et vérifier
Vérifiez les changements et les retraits. Rien n’est encore enregistré.
- Confirmer vos choix
Enregistrez les produits, puis publiez ceux que vous avez sélectionnés.
L’import peut retirer les liens absents du fichier. Pour modifier des produits, partez d’un export récent et vérifiez les retraits avant de confirmer. Gardez la page d’import ouverte jusqu’à la fin.
Exporter tous les produits ou une sélection
- Dans Produits, sélectionnez des lignes puis choisissez Exporter la sélection.
- Pour exporter tout le catalogue, effacez la recherche, choisissez Tous les statuts, sélectionnez cette page puis tous les produits correspondants.
- Les sélections restent cochées entre les pages, recherches et filtres. Le modèle Excel se télécharge dans Plus.
- L’exportation comprend les champs modifiables, les sujets sélectionnés, les titres, URL et langues des liens et les paramètres QR, y compris pour les produits désactivés sélectionnés.
- Les définitions des sujets, les métadonnées masquées et les ressources absentes de l’éditeur restent sur le serveur.
- Le classeur peut être modifié et réimporté avec un forfait payant.
- Il exclut l’historique, les statistiques, les fichiers de codes, les identifiants secrets et la configuration du fournisseur.
Vérifier, importer et publier
- Choisissez Importer Excel, téléversez le fichier et corrigez les erreurs. La validation n’enregistre rien.
- L’aperçu distingue les nouveaux produits des mises à jour, compte les sujets et liens et indique les suppressions.
- La publication est sélectionnée par défaut pour les produits admissibles; décochez des produits pour enregistrer seulement des brouillons ou utilisez la sélection globale. Confirmez une fois pour commencer.
- Gardez la fenêtre ouverte pendant les enregistrements successifs.
- Toutes les tentatives d’enregistrement se terminent avant le début des publications.
- Si tous les enregistrements réussissent, les versions sélectionnées sont publiées.
En cas d’échec d’enregistrement ou de publication
- Si un enregistrement échoue, les autres sont tentés et la publication automatique est suspendue.
- Réessayez les produits échoués, publiez seulement les produits sélectionnés enregistrés ou quittez sans publier.
- Réessayer un enregistrement ne lance pas automatiquement la publication. Les enregistrements réussis ne sont pas répétés.
- Les nouvelles tentatives de publication utilisent la révision enregistrée et n’en créent pas une autre.
- Les nouvelles tentatives d’enregistrement conservent la version vérifiée au départ et ne peuvent pas résoudre un conflit de version.
- Si une modification est survenue après l’aperçu ou qu’une erreur réseau laisse l’écriture précédente incertaine, vérifiez les produits actuels et exportez un nouveau classeur.
- Quittez et rouvrez l’importation pour téléverser vos modifications et les vérifier de nouveau.
- Fermer la fenêtre n’annule pas les enregistrements terminés et ne programme aucune reprise.
Consultez les détails du fichier au besoin
Commencez avec un modèle téléchargé ou un export. Ouvrez ces sections si vous avez besoin d’aide avec une colonne ou une erreur.
Conserver la structure du modèle
- Utilisez exactement Products et Links, avec un tableau par feuille : ProductsTable et LinksTable, commençant en A1.
- Conservez les en-têtes téléchargés dans leur ordre initial, y compris les colonnes facultatives.
- N’ajoutez pas de feuilles, de totaux, de formules ni de notes hors des tableaux. Ajoutez les lignes dans les tableaux. Les lignes vides sont ignorées.
- Les couleurs, les largeurs et l’ordre des onglets peuvent changer.
Utilisez un fichier .xlsx non protégé : 10 Mio téléversés, 100 Mio décompressés et 2 000 produits maximum. Les limites existantes de 16 sujets, 32 liens et quatre liens par sujet s’appliquent. Les nouveaux produits doivent aussi respecter la limite du forfait.
Products / ProductsTable
| Colonne | Valeur à saisir |
|---|---|
| ProductKey | Clé obligatoire dans le fichier, par exemple coffee250. Réutilisez la même clé dans Links. |
| GTIN | Texte obligatoire. GTIN-8, GTIN-12, GTIN-13 ou GTIN-14 valide. Conservez les zéros initiaux. |
| Name | Nom affiché obligatoire, 200 caractères maximum. |
| Resolver | Origine HTTPS facultative du résolveur, sans chemin, paramètres ni fragment. Une cellule vide utilise le résolveur CodePersist configuré; l’exportation la laisse vide pour celui-ci. Une correspondance exacte d’URL et de GTIN met à jour ce produit. Sinon, une URL personnalisée ayant le même GTIN qu’un produit CodePersist existant lui rattache ce domaine. Le domaine doit appartenir à votre espace de travail et être actif. Un rattachement existant ne peut pas être remplacé. Les mises à jour suivantes acceptent l’URL d’origine ou l’URL rattachée. |
| ShowLinkChoices | true affiche une page où les visiteurs choisissent parmi les liens du produit après le scan. false ou une cellule vide redirige vers le lien par défaut. |
| QrErrorCorrection | L, M, Q ou H. Laissez vide pour utiliser M. L’exportation laisse cette cellule vide lorsque la valeur enregistrée est M. |
| XDimensionMm | Taille du module QR en millimètres, de 0.396 à 0.990 par pas de 0.001. Laissez vide pour utiliser 0.495. L’exportation laisse cette cellule vide lorsque la valeur enregistrée est 0.495. |
Links / LinksTable
| Colonne | Valeur à saisir |
|---|---|
| ProductKey | Obligatoire. ProductKey exact de Products. |
| TopicKey | Sujet de l’éditeur : allergens, ingredients, nutrition, instructions, certification, safety, quick-start, tutorials, handling-storage, recall-status, registration, service, support ou verification-service. Les sujets sont déduits des liens. Laissez cette cellule vide sur exactement une ligne par produit pour identifier sa page produit obligatoire. |
| Title | Titre du lien obligatoire destiné aux clients, 200 caractères maximum. |
| Url | Destination HTTP ou HTTPS absolue obligatoire, 2 048 caractères maximum, sans identifiants intégrés. |
| Languages | Codes de langue facultatifs séparés par des points-virgules, par exemple en;fr-CA;es. Utilisez deux lettres, avec éventuellement une région de deux lettres. Laissez vide pour product-page; ses métadonnées de langue enregistrées sont conservées. |
| IsDefault | true sélectionne ce lien par défaut pour le produit. Utilisez true sur une seule ligne par produit au maximum; plusieurs valeurs true sont refusées. false ou une cellule vide laisse la ligne non sélectionnée. Sans sélection, la page produit est utilisée. |
| LinkId | Identifiant facultatif fourni par l’exportation pour un lien enregistré. Conservez-le pour modifier un lien existant; laissez-le vide pour chaque nouveau lien, y compris ceux d’un nouveau produit. Chaque identifiant fourni doit appartenir à ce produit et ne figurer qu’une fois. L’identifiant de la page produit reste sur sa ligne. Une cellule vide ou contenant seulement des espaces crée toujours un nouveau lien. |
Exemple complet — utilisez la même clé de produit sur chaque feuille
Ces lignes décrivent un café, sa page produit obligatoire et des liens d’ingrédients en anglais et en français. Conservez le GTIN en Texte : 09506000134352. Un Resolver vide utilise le résolveur CodePersist configuré. Saisissez votre domaine personnalisé actif seulement pour l’utiliser. Remplacez les destinations par vos URL publiques. Le modèle ne contient aucun produit d’exemple à supprimer.
Products
| ProductKey | GTIN | Name | Resolver | ShowLinkChoices | QrErrorCorrection | XDimensionMm |
|---|---|---|---|---|---|---|
| coffee250 | 09506000134352 | Ground coffee 250g | false |
Links
| ProductKey | TopicKey | Title | Url | Languages | IsDefault | LinkId |
|---|---|---|---|---|---|---|
| coffee250 | Product page | https://brand.example/coffee | true | |||
| coffee250 | ingredients | Ingredients | https://brand.example/coffee/ingredients/en-es | en;es | ||
| coffee250 | ingredients | Ingrédients | https://brand.example/coffee/ingredients/fr | fr |
Plusieurs langues et valeurs des cellules
- Séparez les codes de langue par des points-virgules dans Languages, par exemple en;fr-CA;es. Les espaces autour des codes sont ignorés. Laissez Languages vide pour product-page.
- Utilisez true ou false pour ShowLinkChoices et un point pour les décimales, par exemple 0.495. Les cellules numériques Excel sont acceptées.
- Les sujets sont déduits des liens; les sujets vides ne peuvent pas être importés.
Mettre à jour des produits existants
- La correspondance utilise l’origine normalisée du résolveur et le GTIN dans votre espace de travail.
- Un résolveur vide sélectionne celui de CodePersist, jamais un domaine personnalisé existant. Un GTIN existant sur un autre résolveur est refusé. Chaque importation confirmée crée une révision.
- Les liens modifiables omis et leurs sujets vides sont supprimés; les sujets masqués et ressources hors éditeur restent sur le serveur.
- Conservez le LinkId exporté pour modifier ce lien en gardant ses métadonnées, même si son URL ou ses langues changent.
- Laissez LinkId vide pour créer un nouveau lien avec les métadonnées par défaut.
- Déplacer un lien entre sujets facultatifs conserve ses métadonnées et ajoute la relation requise par le nouveau sujet.
- Sélectionnez un seul IsDefault par produit au maximum; sans sélection, la page produit est utilisée. Les produits désactivés restent désactivés.
- Les versions publiées restent actives jusqu’à la publication des remplacements.
- Pour un produit avec un domaine personnalisé rattaché, sa valeur Resolver d’origine ou la même URL personnalisée permet de le mettre à jour en conservant le rattachement. Pour ajouter un domaine à un produit CodePersist existant, consultez les étapes ci-dessous.
Ajouter un domaine personnalisé avec Excel
- Connectez votre domaine personnalisé dans CodePersist et attendez l’état Actif. Lite ou Premium est requis.
- Exportez le produit CodePersist existant, conservez ses valeurs GTIN et LinkId, puis inscrivez l’origine HTTPS personnalisée dans sa cellule Resolver, par exemple https://id.example.com/. Modifiez son contenu au besoin.
- L’aperçu recherche d’abord un produit utilisant déjà cette URL et ce GTIN. Sinon, il trouve votre produit ayant le même GTIN sur le résolveur CodePersist par défaut et indique le rattachement permanent. Aucune deuxième place de produit n’est nécessaire.
- Vérifiez le rattachement avant d’enregistrer. Le produit doit être activé, sans publication, retrait ni changement de forfait en cours. Il est impossible de remplacer le domaine personnalisé ou d’en ajouter un deuxième.
- L’enregistrement applique le contenu et le rattachement dans une seule nouvelle version. Sélectionnez Publier pendant l’importation pour publier les deux URL, ou publiez la version enregistrée plus tard. Les codes CodePersist déjà imprimés continuent de fonctionner.
- Les importations suivantes peuvent utiliser la valeur Resolver d’origine ou la même URL personnalisée rattachée. L’exportation conserve la valeur Resolver d’origine, vide pour l’adresse CodePersist par défaut.
- Incluez une seule ligne par produit : ses URL d’origine et personnalisée désignent le même produit. Sans produit correspondant, la ligne crée un nouveau produit sur le domaine fourni.
Erreurs courantes et corrections
- Products · ligne 1 : structure invalide — rétablissez un en-tête renommé ou déplacé à partir d’un nouveau modèle.
- Products · ligne 2 · GTIN : texte requis — formatez la cellule en Texte et retapez le GTIN; changer seulement le format ne rétablit pas les zéros perdus.
- Links · ligne 3 · ProductKey : référence inconnue — copiez la clé exacte de Products. Formule non prise en charge — collez une valeur.
- Valeur hors tableau — agrandissez le tableau d’origine pour inclure vos lignes.
- Les messages apparaissent dans la langue de l’application avec la feuille, la ligne et la colonne.