Dla kogo jest ten konektor
Akeneo to system PIM, w którym zespół produktowy buduje katalog z rodzin, atrybutów i modeli produktów, a wartości uzupełnia osobno dla języków i kanałów. Konektor ma sens wtedy, gdy Akeneo już u Ciebie działa albo jest w trakcie wdrożenia i ma pozostać jedynym miejscem, w którym edytuje się opisy i parametry. Sklep staje się wtedy odbiorcą tych danych, a nie drugim miejscem do ich poprawiania.
Konektor współpracuje z Akeneo instalowanym we własnej infrastrukturze (self-hosted).
Kierunek i zakres danych
Dane płyną w jedną stronę: z Akeneo do katalogu sklepu. To Akeneo wysyła dane, a sklep je przyjmuje. Endora Commerce nigdy nie odpytuje Akeneo o produkty: każdy rekord przychodzi kompletny, po stronie PIM już zmapowany na strukturę katalogu, i jest podpisany wspólnym sekretem HMAC przez HTTPS. Nie ma pliku pośredniego, eksportu CSV ani ręcznego importu.
| Z Akeneo | W katalogu Endora Commerce |
|---|---|
| Produkty | Produkty z nazwą, opisem i parametrami |
| Atrybuty | Parametry produktu widoczne na karcie |
| Zestawy atrybutów | Zestawy atrybutów katalogu |
| Kategorie | Drzewo kategorii i przypisania produktów |
| Zdjęcia i pliki | Galeria i załączniki karty produktu |
Przepływ ma dwa rodzaje dostaw. Pełna dostawa przekazuje cały uzgodniony zakres katalogu. Pierwsza pełna dostawa jest warunkiem startu: dopóki się nie zakończy, pojedyncze rekordy bieżące są odrzucane, chyba że świadomie ją pominiesz, bo katalog jest już zgodny. Potem Akeneo wysyła rekordy bieżące, czyli kolejne zmiany, które sklep stosuje bez ponownego pobierania czegokolwiek. Rekord wycofany w PIM jest w sklepie dezaktywowany.
Pliki mediów sklep pobiera wyłącznie z adresów, które dopuścisz w ustawieniach połączenia. Gdy lista jest pusta albo plik nie da się pobrać, produkt i tak trafia do katalogu, a brak pliku jest odnotowany w raporcie przebiegu.
Warto znać jedną zbieżność modeli. W Akeneo wartość atrybutu może być osobna dla języka i dla kanału. Katalog Endora Commerce też przechowuje wartości atrybutów per język i per kanał sprzedaży, więc takie rozróżnienie ma dokąd trafić.
Stany magazynowe i zamówienia to nie jest rola PIM. Konektor PIM i konektor ERP, na przykład Comarch ERP Optima albo Comarch ERP XL, mogą działać na jednej instalacji równolegle.
Co przygotować po stronie Akeneo
Po stronie Akeneo działa komponent wysyłający, który mapuje dane PIM na strukturę katalogu i wysyła rekordy do sklepu. Mapowanie ustawia się w Akeneo: komponent korzysta z podpisanych słowników sklepu, czyli list atrybutów, zestawów atrybutów, kategorii, kanałów sprzedaży, języków, cenników i typów powiązań produktów. Przed uruchomieniem przygotuj:
- Adresy odbioru skopiowane z ekranu połączenia w panelu sklepu: do próby połączenia, do pełnych dostaw, do rekordów bieżących i do słowników.
- Wspólny sekret HMAC, ten sam po obu stronach. Akeneo podpisuje nim każde żądanie, a sklep zapisuje go w postaci zaszyfrowanej i nie pokazuje ponownie.
- Publiczny adres Akeneo i ewentualne dodatkowe adresy HTTPS, na przykład CDN, z których sklep ma pobierać media.
- Zakres pierwszej pełnej dostawy: które rodziny, kategorie i produkty mają trafić do sklepu.
Co widzi administrator sklepu
Konektor jest modułem o identyfikatorze pim_akeneo i po instalacji jest wyłączony. Włącza się go na liście modułów w panelu administracyjnym. Po włączeniu w katalogu pojawia się sekcja Akeneo PIM, widoczna tylko dla operatorów z odpowiednim uprawnieniem. Znajdziesz w niej:
- ekran połączenia z adresami odbioru, sekretem, domyślnym kanałem sprzedaży i stanem pierwszej pełnej dostawy,
- zasadę widoczności nowych produktów: zawsze nieaktywne, zawsze aktywne albo zgodnie ze statusem przekazanym z Akeneo,
- historię dostaw, czyli zapis tego, co dany przebieg zrobił.
Przebieg opisuje wspólny słownik konektorów PIM, więc raport czyta się tak samo niezależnie od systemu:
- rodzaj dostawy: pełna dostawa albo rekordy bieżące,
- wynik: zakończony, zakończony z problemami, nieudany albo przerwany,
- liczniki: rekordy utworzone, zaktualizowane, pominięte, wycofane i błędne,
- problemy z poziomem ważności: pominięcie, ostrzeżenie albo błąd.
Pola chronione
Nie każda wartość musi pochodzić z PIM. Platforma pozwala oznaczyć wybrane pola produktu jako chronione: nazwę i opis w danym języku, pojedynczy atrybut, pola SEO, pozycję w galerii, załącznik, cenę w konkretnym cenniku i walucie albo przypisanie do kategorii. Kolejne dostawy z Akeneo zostawiają takie wartości bez zmian.
Ograniczenia, o których warto wiedzieć
- Jeden aktywny PIM. Próba włączenia drugiego konektora kończy się odmową z informacją, który konektor jest aktywny. Najpierw trzeba wyłączyć obecny.
- Sklep nie pobiera danych z Akeneo. Nie ma harmonogramu po stronie sklepu ani synchronizacji pojedynczego produktu na żądanie. Zmiany docierają wtedy, gdy wyśle je Akeneo.
- Wyłączenie niczego nie kasuje. Połączenie, pola chronione i historia przebiegów zostają i wracają po ponownym włączeniu modułu. Wyłączone połączenie odrzuca dostawy.
- Mapowanie żyje w Akeneo. W panelu sklepu nie ma edytora mapowań atrybutów. Jeśli Twój model danych w Akeneo jest nietypowy, omów to przed wdrożeniem.
Akeneo czy inny PIM
O wyborze konektora decyduje to, jaki PIM masz albo wybierasz, a nie sama platforma sklepowa. Oprócz Akeneo dostępne są konektory do Pimcore, Ergonode i UnoPim. Wszystkie korzystają z tego samego słownika przebiegów i tych samych pól chronionych, więc zmiana PIM w przyszłości nie zmienia sposobu pracy administratora sklepu.
Jeśli Twój PIM nie ma gotowego konektora, pozostaje API partnerskie platformy: zapis produktów po numerze SKU i przyrostowe pobieranie zmian od podanego znacznika czasu.