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.
Kierunek i zakres danych
Dane płyną w jedną stronę: z Akeneo do katalogu sklepu. Nie ma pliku pośredniego, eksportu CSV ani ręcznego importu.
| Z Akeneo | W katalogu Endora Commerce |
|---|---|
| Produkty i warianty | Produkty i ich warianty |
| Nazwy i opisy | Nazwa i opis produktu w wersjach językowych |
| Atrybuty | Parametry produktu widoczne na karcie |
| Kategorie | Przypisanie produktu do kategorii |
| Zdjęcia i pliki | Galeria i załączniki karty produktu |
Po zmianie w Akeneo sklep pokazuje kupującym aktualne opisy, parametry i zdjęcia, bez opóźnienia wynikającego z ręcznej pracy.
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, mogą działać na jednej instalacji równolegle.
Co przygotować po stronie Akeneo
Akeneo udostępnia dane przez REST API, a dostęp do niego wymaga połączenia utworzonego w samym PIM. Przed uruchomieniem przygotuj:
- Połączenie założone w menu Connect, w ustawieniach połączeń. Dla sklepu internetowego Akeneo zaleca typ przepływu „Destination”, czyli taki, który głównie pobiera dane z PIM. Dzięki temu ruch konektora jest widoczny w monitoringu połączeń.
- Cztery dane uwierzytelniające wygenerowane razem z połączeniem: identyfikator klienta, sekret, nazwę użytkownika i hasło połączenia.
- Osobną rolę użytkownika dla połączenia, inną niż role osób pracujących w interfejsie. Rola decyduje o tym, do których zasobów API połączenie ma dostęp.
- Grupę użytkowników, jeśli korzystasz z edycji Enterprise. Tam grupa ogranicza widoczność części katalogu, więc konektor zobaczy tylko to, do czego grupa ma dostęp.
Jedna praktyczna uwaga: ponowne wygenerowanie sekretu albo hasła w Akeneo natychmiast zatrzymuje wywołania API tego połączenia. Po takiej zmianie trzeba od razu zaktualizować dane połączenia w panelu sklepu.
Szczegóły opisuje dokumentacja Akeneo: uwierzytelnianie w REST API oraz zarządzanie połączeniami.
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 menu pojawia się sekcja Akeneo, widoczna tylko dla operatorów z odpowiednim uprawnieniem. Znajdziesz w niej:
- ekran połączenia z Akeneo,
- szczegóły przebiegów importu, czyli zapis tego, co dany import zrobił.
Przebiegi wszystkich konektorów PIM opisuje wspólny słownik, więc raport czyta się tak samo niezależnie od systemu:
- sposób uruchomienia: ręcznie, według harmonogramu albo po sygnale z PIM,
- tryb: przyrostowy albo pełny,
- wynik: zakończony, zakończony z problemami, nieudany albo pominięty,
- liczniki: rekordy rozpatrzone, utworzone, zaktualizowane, pominięte, wycofane i błędne,
- problemy z poziomem ważności: informacja, 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. Liczba wartości objętych ochroną trafia do podsumowania przebiegu.
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.
- Wyłączenie niczego nie kasuje. Połączenie, mapy identyfikatorów, pola chronione i historia przebiegów zostają i wracają po ponownym włączeniu modułu.
- Brak edytora mapowań w panelu. Moduł Akeneo nie ma obecnie ekranu do ręcznego mapowania 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.
