Le module Eofferix est installé sur le site UMI.CMS et reçoit le catalogue préparé : sections, produits, offres, prix, stock, images, fichiers et propriétés. Le service peut récupérer les sources depuis l’email, les services de fichiers, FTP, 1C, les liens directs et les espaces fournisseurs protégés par mot de passe, puis transformer les données selon les règles configurées et les écrire dans la structure UMI.CMS.
Ce Dont Vous Avez Besoin
- Accès aux fichiers du site via SSH, SFTP, FTP ou gestionnaire d’hébergement.
- Accès administrateur à UMI.CMS.
- L’installateur
eofferix-umi-install.zipou l’archive du moduleeofferix-umi-cms-module.zip.
Etape 1. Installer Le Module UMI.CMS
- Connectez-vous à UMI.CMS dans le même navigateur.
- Décompressez
eofferix-umi-install.zip. - Envoyez
eofferix-umi-installà la racine du site, près deindex.php. - Ouvrez
https://site.com/eofferix-umi-install/install.php. - Attendez le message de réussite.
- Supprimez le dossier de l’installateur.
Etape 2. Connecter Le Profil
Ouvrez le profil, choisissez UMI.CMS, indiquez le site et l’administrateur, puis cliquez sur Vérifier la connexion. Les types de données, champs et sections racines sont alors chargés.
Etape 3. Choisir Types De Données, Section Racine Et Champs D’identification
Dans le bloc Identification des éléments UMI.CMS, choisissez les types de données pour les produits et les sections, la section racine d’import et les champs que Eofferix utilisera pour retrouver les sections, produits et offres existants.
Les champs d’identification indiquent comment le service compare la source avec le catalogue UMI.CMS existant. Choisissez la clé stable de votre source : external_id, article/SKU, id, une combinaison comme nom du produit plus article, ou un autre champ fiable.
Fonctionnement de ET et OU. Les pastilles d’identification séparées sont reliées par ET. Dans une même pastille, le bouton « ou … » ajoute des champs alternatifs testés de gauche à droite. Par exemple : (SKU OU Code externe OU Code-barres) ET Fournisseur ET (Marque OU Fabricant).
Eofferix s’arrête à la première combinaison complète qui retrouve des objets existants. Si cette combinaison en trouve plusieurs, l’ensemble complet est confié à la règle de doublons choisie ; la recherche ne passe pas à l’alternative suivante. Chaque groupe obligatoire doit avoir une valeur. L’utilisateur peut choisir n’importe quel champ disponible et les alternatives supplémentaires ne consomment pas de crédits supplémentaires.
La section racine définit où les nouvelles sections de la source seront créées. Si une section précise est sélectionnée, les nouvelles branches du catalogue seront créées dedans. Si la racine du site est sélectionnée, les sections seront créées depuis la racine.
Pour 1C, il vaut mieux utiliser external_id pour les produits comme pour les offres : ces identifiants sont toujours uniques.
Pour les sections, choisissez un champ d’identification séparé surtout lorsque les sections arrivent dans un bloc séparé de la source. Si la section est écrite dans le produit comme chemin complet ou simple nom, une correspondance séparée est généralement inutile : utilisez le chemin transformé de la section.
Etape 4. Choisir Le Scénario D’import
Dans les paramètres du profil, vous pouvez choisir un scénario d’échange prêt à l’emploi. Il définit quoi faire avec les nouveaux produits, les produits retrouvés, les offres et les objets qui ne sont plus présents dans la source.
| Scénario | Quand l’utiliser |
|---|---|
| Synchronisation prudente | Eofferix crée de nouveaux produits et met à jour les éléments retrouvés, mais ne supprime pas automatiquement les objets absents. Il ne rattache pas non plus les produits et offres à un profil précis. |
| Synchronisation complète de la source | Le profil rattache à lui tous les produits et offres importés. Un nouveau lancement du profil supprime les produits et offres qui ont disparu de la source et ajoute les nouveaux éléments apparus avec la dernière mise à jour. |
| Mettre à jour les trouvés | Ce scénario convient lorsque vous devez modifier les prix, stocks, noms ou propriétés uniquement pour les produits et offres déjà retrouvés. Aucun nouveau produit n’est créé. |
| Ajouter seulement les nouveaux | Lorsque vous devez ajouter les produits et offres absents sans modifier ce qui existe déjà sur le site. |
| Réécriture complète du catalogue | Ce scénario supprime les produits, offres et sections absents dans le périmètre choisi, puis crée ou met à jour les objets de la source actuelle. Les propriétés et valeurs de dictionnaire sont conservées. |
Vous pouvez aussi configurer manuellement le comportement d’échange pour les produits, offres et sections.
Etape 5. Marquer Les Rôles Du Snapshot
Marquez le nœud produit, section et offre. Si les offres sont imbriquées dans le produit, Eofferix lit le lien depuis la structure XML. Si elles arrivent dans un bloc séparé, liez le champ de service product_external_id — liaison de l’offre au produit.
Etape 6. Lier Les Champs Produit, Section Et Offre
Les propriétés produit vont dans le type produit. Les propriétés de section vont dans la section. Les propriétés d’offre vont dans l’objet de l’offre précise, avec les champs d’offre renvoyés par le site UMI.CMS connecté.
Avant d’écrire une valeur dans le CMS, vous pouvez la préparer : nettoyer le texte, normaliser un nombre ou une date, composer une valeur depuis plusieurs nœuds, utiliser une table de correspondance ou ajouter des conditions d’export. Exemples utiles : transformations de valeurs, conditions d’export du champ, correspondance par dictionnaire et plusieurs valeurs dans un champ.
Etape 7. Configurer Images Et Fichiers
XML, CSV, Excel et les autres sources contiennent généralement des URL, chemins ou noms de fichiers d’images, pas les images en binaire. Eofferix télécharge les images depuis les URL, les extrait des archives 1C ou des archives et fichiers envoyés avec la source, puis transmet les fichiers préparés à UMI.CMS. Dans les paramètres avancés du champ image, Eofferix peut enregistrer le fichier sur le service, convertir le format, réduire les grandes images à la largeur et hauteur choisies et définir la qualité JPEG/WEBP. Ces options influencent fortement la taille des fichiers et la vitesse de chargement des pages.
Les mêmes paramètres permettent d’ajouter un filigrane : chargez un fichier PNG/WEBP, choisissez sa position, son opacité et sa taille maximale. Pour les galeries, vous pouvez régler le séparateur d’images, la plage et l’omission du rechargement si le fichier n’a pas changé.
Etape 8. Lancer Un Test
Utilisez l’export de test pour vérifier la configuration. Il envoie à UMI.CMS un échantillon limité à 5 produits et ne supprime pas les éléments, sections ou autres objets absents.
Un export de test normal ne lance pas le nettoyage des objets absents. Si Test comme lancement complet est activé, les règles du lancement complet s’appliquent à l’échantillon limité : le nettoyage peut toucher les produits, offres, sections et images absents dans le périmètre choisi.
Le module Eofferix pour UMI.CMS ne supprime pas les propriétés, les caractéristiques ni les valeurs de dictionnaire. Il peut associer une propriété ou une valeur existante, ou créer celle qui manque, mais il ne supprime ni ne détache les propriétés et valeurs créées lors des exécutions suivantes. Les règles concernant les produits, offres, sections et images absents fonctionnent séparément.
L’import dans UMI.CMS ne permet pas de revenir à l’état d’une exécution précédente et ne crée pas de point de retour arrière. Un lancement arrêté ne peut reprendre que si un point de reprise confirmé existe ; sinon, corrigez la cause et lancez un nouvel import normal. Sauvegardez le site et la base de données avant un lancement complet avec des règles de suppression.
Coûts Et Éléments Inchangés
Avant le lancement, Eofferix calcule le coût estimé. Lors des imports répétés, les produits et offres inchangés doivent passer par l’action moins chère UMI.CMS · élément inchangé. Ainsi un échange régulier ne coûte pas comme une reconstruction complète du catalogue.
Si le catalogue est déjà importé, mais que le lancement suivant ressemble encore à la création de milliers de nouveaux objets, vérifiez les champs d’identification produit et offre, le scénario d’import et le rattachement au profil.
Si vous devez forcer la réécriture des éléments retrouvés du catalogue, décochez Ne pas mettre à jour l’élément UMI si les données n’ont pas changé dans Paramètres avancés d’import. Le service ne sautera plus rapidement les éléments inchangés et enverra une mise à jour complète ; ce lancement peut être plus long et coûter plus cher.
