Pimcore w firmie z dużym katalogiem technicznym
Pimcore to platforma do zarządzania danymi, w której PIM działa obok MDM i DAM. Produkt jest tam obiektem danych (Data Object), a jego strukturę wyznacza definicja klasy, którą projektuje zespół wdrożeniowy. Stąd popularność Pimcore u producentów i dystrybutorów, u których karta produktu ma setki parametrów, a każda grupa asortymentu ma inny zestaw cech.
Dla integracji ze sklepem ma to jedną ważną konsekwencję: nie istnieje „standardowy produkt Pimcore”. Dwie instalacje mogą opisywać to samo łożysko zupełnie innymi klasami i polami. Integracja z Endora Commerce zaczyna się więc od przeglądu Twojego modelu danych, a nie od włączenia przełącznika.
Co przechodzi z Pimcore do sklepu
Dane płyną w jednym kierunku: Pimcore pozostaje źródłem prawdy o produkcie, a katalog sklepu go odzwierciedla. To Pimcore wysyła dane, a sklep je przyjmuje. Endora Commerce nie odpytuje Datahub, nie przegląda folderów Pimcore i nie synchronizuje obiektów po identyfikatorze: każdy rekord przychodzi kompletny, już zmapowany na strukturę katalogu, i podpisany wspólnym sekretem HMAC przez HTTPS.
- Treści i parametry: produkty z opisami i parametrami, kategorie, atrybuty i zestawy atrybutów.
- Media produktowe: zdjęcia oraz dokumenty, na przykład karty techniczne, podpinają się pod produkt w sklepie. Sklep pobiera je wyłącznie z publicznego adresu Pimcore i z dodatkowych adresów HTTPS, które dopuścisz, na przykład CDN. Plik, którego nie da się pobrać, jest odnotowany w raporcie, a produkt i tak trafia do katalogu.
- Komplet naraz: każdy rekord niesie pełny zestaw danych produktu, a nie osobno treści, osobno media.
Na start Pimcore wysyła pełną dostawę, z paska narzędzi obiektu konfiguracyjnego albo poleceniem konsoli. Dopóki się nie zakończy, rekordy bieżące są odrzucane, chyba że świadomie ją pominiesz, bo katalog jest już zgodny. Potem każdy zapis w Pimcore wysyła rekord bieżący po zatwierdzeniu zmiany, więc praca w Pimcore nie czeka na sklep. Ponowienie tej samej wysyłki nie zapisuje danych drugi raz.
Jak pojęcia Pimcore przekładają się na przygotowanie wdrożenia
Mapowanie ustawia się w Pimcore, w pakiecie integracyjnym Endory. Pakiet korzysta z podpisanych słowników sklepu: atrybutów, zestawów atrybutów, kategorii, języków, kanałów sprzedaży i cenników. W panelu sklepu nie ma ekranów mapowania klas ani atrybutów.
| W Pimcore | Co trzeba ustalić przed startem |
|---|---|
| Klasa produktu i jej pola | Które pola stają się nazwą, opisem i atrybutami w sklepie |
| Warianty z dziedziczeniem | Wariant dziedziczy wartości z obiektu nadrzędnego: które pola są wspólne, a które różnią warianty |
| Classification Store | Atrybuty zależne od kategorii, dodawane bez zmiany klasy: które grupy cech ma zobaczyć kupujący |
| Pola zlokalizowane | Które języki trafiają do sklepu i co zrobić, gdy tłumaczenia brakuje |
| Zasoby (Assets) | Które zdjęcia tworzą galerię, a które pliki są załącznikami do pobrania |
Co przygotować po stronie Pimcore
Integracja nie korzysta z Datahub: w sklepie nie podajesz adresu GraphQL ani klucza API Datahub. Przed uruchomieniem przygotuj:
- Pakiet integracyjny Endory zainstalowany w projekcie Pimcore przez Composera. W nim konfigurujesz mapowanie, folder z produktami i korzeń drzewa kategorii.
- Adres wysyłki do Endory, skopiowany z ekranu połączenia w panelu sklepu i wklejony w konfiguracji pakietu. Pakiet sam dopisuje do niego adresy próby połączenia, pełnych dostaw i rekordów bieżących.
- Wspólny sekret HMAC, ten sam po obu stronach. Sklep zapisuje go w postaci zaszyfrowanej i nie pokazuje ponownie.
- Domyślny, aktywny kanał sprzedaży w sklepie, wymagany do włączenia połączenia.
- Środowisko testowe Pimcore z reprezentatywną próbką katalogu, na której da się sprawdzić mapowanie przed produkcją.
Rzeczy, o które warto zapytać wcześniej
- Nazwa i języki. Pakiet wymaga numeru SKU i zlokalizowanego pola nazwy. Każdy język z Pimcore trafia do języka sklepu o tym samym kodzie, a w domyślnym języku sklepu nazwa musi być uzupełniona.
- Widoczność nowych produktów. Domyślnie produkty przychodzą jako nieaktywne i nie pojawiają się w sprzedaży, dopóki ich nie włączysz. Możesz też wybrać, żeby zawsze były aktywne albo żeby ich status w sklepie odpowiadał statusowi publikacji w Pimcore. Wycofanie lub cofnięcie publikacji w Pimcore dezaktywuje produkt w sklepie, ale go nie usuwa.
- Ceny. Ceny bez przypisanego cennika są pomijane, chyba że zmapujesz je jako zwykłe atrybuty.
- Jakość SKU. Produkty identyfikuje SKU i numeryczny identyfikator Pimcore, więc numery muszą być unikalne i stabilne.
- Lokalne poprawki w sklepie. Wspólna warstwa konektorów PIM w platformie definiuje jednolity sposób ochrony pól, czyli wyłączania lokalnie dopracowanej wartości z nadpisywania przy imporcie. Obejmuje on nazwę, opis, atrybuty (także per język i kanał sprzedaży), metadane SEO, pozycje galerii, załączniki i przypisanie do kategorii. Zapytaj, które z tych pól chcesz redagować w sklepie.
Jeden aktywny PIM na instalacji
Platforma pozwala zainstalować kilka konektorów PIM, ale aktywny może być tylko jeden. Na świeżej instalacji żaden nie jest włączony: operator wybiera go w panelu, a próba włączenia drugiego kończy się odmową z nazwą konektora, który już działa. Zmiana PIM nie kasuje danych, produkty zaimportowane wcześniej zostają w katalogu.
Warto też wiedzieć, że konektor nie importuje stanów magazynowych, a sklep nie pobiera danych z Pimcore według harmonogramu. Zmiany docierają wtedy, gdy wyśle je Pimcore. Historia dostaw w panelu pokazuje każdy przebieg z wynikiem, licznikami i problemami na poziomie pojedynczych rekordów, a o nieudanym przebiegu administratorzy dostają powiadomienie.
Kiedy Pimcore, a kiedy inny PIM
Pimcore jest naturalnym wyborem, gdy już w nim pracujesz albo potrzebujesz własnego modelu danych i zarządzania zasobami w jednym narzędziu. Jeśli dopiero porządkujesz dane produktowe i zależy Ci na lżejszym starcie, zobacz UnoPim. Gotowy model rodzin i atrybutów oferuje Akeneo, a Ergonode to PIM rozwijany w Polsce.
Chcesz sprawdzić, jak Twój model klas przełoży się na katalog sklepu? Napisz do nas i pokaż przykładową kartę produktu.