2.11.1. Comment configurer une intégration Pimcore
Ce guide vous aide à connecter, étape par étape, votre catalogue produits Pimcore à Fozzels.
Avant de commencer : préparation dans Pimcore
Fozzels se connecte à Pimcore via le module Datahub, un outil intégré à Pimcore qui ouvre l'accès à vos données par le biais d'une API.
Votre instance Pimcore doit disposer d'un endpoint Datahub configuré (votre administrateur Pimcore l'a peut-être déjà mis en place). Si ce n'est pas le cas, contactez-le ou contactez notre équipe support. Vous aurez besoin de :
- Nom de l'endpoint : disponible dans Pimcore, sous Datahub, dans le champ Name.
- Clé d'API : affichée à côté de l'endpoint, dans l'onglet Security Definition, dans le champ Datahub API Keys.
Important : dans les paramètres de l'endpoint (onglet Security Definition → Workspaces), l'accès en lecture (Read) doit être accordé aux objets concernés, et surtout au dossier contenant vos produits (par exemple
/products). Si vos produits sont répartis dans plusieurs dossiers imbriqués, assurez-vous que l'accès est accordé à chacun d'entre eux.
1. Créer l'intégration
- Accédez à Home → Integrations.
- Cliquez sur Create.
- Sélectionnez la plateforme Pimcore.
2. Remplir le formulaire de configuration
| Champ | Ce qu'il faut saisir |
|---|---|
| Name | Nom de l'intégration, pour votre propre repérage |
| URL | Adresse de base de votre instance Pimcore (par exemple https://your-company.pimcore.com) |
| DataHub endpoint | Le nom de l'endpoint dans Pimcore (par exemple fozzels) |
| API key | La clé d'accès de Pimcore (depuis l'onglet Security Definition) |
| Product class | Laissez vide si vos produits sont stockés dans une classe nommée Product. Ne renseignez ce champ que si la classe porte un autre nom |
| Category class | Comme ci-dessus : laissez vide si les catégories sont stockées dans une classe nommée Category |
| Asset folder | Facultatif. Nécessaire uniquement si Fozzels doit générer de nouvelles images produit pour vous et qu'elles doivent être enregistrées quelque part dans Pimcore (par exemple /products) |
| Champ | Ce qu'il faut saisir |
|---|---|
| Languages | Liste de codes de langue séparés par des virgules (par exemple nl,en). Chaque langue devient un Store distinct dans Fozzels |
| Include unpublished objects | Désactivé par défaut. Activez-le si vous souhaitez que la synchronisation récupère aussi les produits et catégories non publiés (brouillons). Ils seront traités de la même manière que les autres |
Planification de la synchronisation (Global Pull Schedule)
Vous pouvez conserver la planification par défaut, ou activer Overwrite Global Pull Schedule et définir votre propre heure.
L'heure est en UTC : l'heure est définie en UTC, et non dans votre fuseau horaire local. Si vous souhaitez que la synchronisation s'exécute la nuit selon votre fuseau, convertissez votre heure de nuit locale en UTC avant de la saisir ici.
Délai entre les requêtes
Nous recommandons de ne pas renseigner ces champs tout de suite. Lancez d'abord quelques synchronisations avec les paramètres par défaut. Si tout fonctionne correctement, aucune configuration supplémentaire n'est nécessaire. Si des erreurs apparaissent, revenez ici et ajoutez un petit délai.
Cliquez sur Save.
3. Activer et importer les produits
- Activez le bouton Active (en haut à droite).
- Cliquez sur PULL WEBSITES AND STORES. Fozzels récupère vos langues sous forme de Stores distincts.
- Activez les boutons des Website et Store concernés.
- Cliquez sur Pull products pour importer les produits, les catégories et leurs attributs.
Si le nombre de produits est inférieur à celui attendu
Si moins de produits ont été importés dans Fozzels que vous n'en avez dans Pimcore, la raison la plus fréquente est la présence de produits non publiés (statut unpublished/draft) dans Pimcore. Activez le bouton Include unpublished objects dans les paramètres de l'intégration (Configuration) et relancez la synchronisation.
Astuce : une fois cette option activée, les produits disposent d'un nouvel attribut Published (Yes/No). Vous pouvez l'utiliser pour filtrer les produits dans le catalogue, ou y limiter un flow spécifique, si vous souhaitez par exemple ne traiter que les produits publiés.
Parmi les autres causes possibles figurent un accès limité à certains dossiers de produits, ou des produits répartis sur plusieurs classes dans Pimcore. Dans ces cas, le mieux est de nous contacter ou de contacter votre administrateur Pimcore afin de vérifier les paramètres d'accès.
Pour exposer davantage d'attributs, comme l'indicateur de publication ou votre galerie d'images, consultez 2.11.2. Pimcore : exposer des attributs via DataHub.
Et voilà : votre catalogue Pimcore est désormais connecté. Vous pouvez actualiser les données à tout moment en cliquant à nouveau sur Pull products.