Integracja Magento 1.x z Akeneo PIM - jak zaplanować katalog

Integracja jest możliwa, jeśli dla konkretnych wersji da się bezpiecznie wymieniać dane przez utrzymywany konektor, API lub rozwiązanie własne. Oficjalna dokumentacja Akeneo opisuje konektor dla Adobe Commerce i Magento Open Source; jego aktualna macierz zgodności obejmuje wersje Magento 2.x, a nie Magento 1.x (macierz zgodności konektora Akeneo). Repozytorium społecznościowego konektora także określa go jako moduł dla Magento 2 i wymienia minimalną obsługiwaną wersję Magento Open Source 2.3.7 (repozytorium Akeneo na GitHub).

Przed wyborem rozwiązania zbierz wersje systemów, edycje Akeneo, wersję PHP, sposób hostowania oraz listę modułów zmieniających produkty, warianty, ceny lub kategorie. Potwierdź u dostawców dostępność wspieranej metody dla dokładnej pary wersji. Nie instaluj rozszerzenia Magento 2 w sklepie Magento 1.

Tabela oddziela zgodność potwierdzoną dokumentacją od założeń wymagających testu. Jeśli analiza wskaże potrzebę przebudowy platformy, projekt sklepu internetowego może uwzględnić ocenę platformy i plan integracji.

Akeneo powinno zarządzać polami redakcyjnymi i katalogowymi, które zespół wzbogaca oraz publikuje z PIM, a Magento powinno pozostać właścicielem danych operacyjnych przypisanych do procesu sklepu. Właściciel pola to system, w którym użytkownicy edytują wartość i z którego integracja przekazuje ją do drugiego systemu.

Kierunek synchronizacji ustalaj dla każdego pola, a nie tylko dla całego produktu. Oficjalny konektor Akeneo dla Adobe Commerce działa jednokierunkowo: importuje dane z PIM do sklepu i nie odsyła danych Magento do Akeneo (opis architektury konektora).

Zalecamy zatwierdzić właściciela każdego pola przed przygotowaniem mapowania. Pozwala to wykryć konflikty, zanim import zacznie nadpisywać wartości utrzymywane w drugim systemie.

Audyt katalogu zaczyna się od znalezienia niejednoznacznych SKU, brakujących wartości i różnic między wariantami produktów. Wybierz próbkę obejmującą typy produktów, języki, kanały oraz przypadki z polami wymaganymi.

Przeprowadź audyt w tej kolejności:

1. Wyeksportuj listę SKU z Magento i Akeneo, a następnie znajdź duplikaty i rekordy bez identyfikatora.
2. Porównaj atrybuty, typy danych, wartości słownikowe oraz wymagane pola.
3. Sprawdź rodziny produktów, warianty, jednostki, języki i statusy publikacji.
4. Wybierz produkty proste, wariantowe, niekompletne oraz wycofywane.
5. Zapisz oczekiwany wynik importu dla każdego produktu z próbki.

Rodzina produktu w Akeneo grupuje produkty o wspólnych atrybutach, a rodzina wariantów opisuje osie różnicowania, na przykład rozmiar lub kolor. Magento może reprezentować warianty inną strukturą, dlatego przed importem określ, czy wynik ma utworzyć produkt konfigurowalny, produkty proste czy oba poziomy. Zachowanie zależy od wybranego konektora albo projektu własnego.

Zalecamy rozpocząć od pilota na małej, reprezentatywnej próbce, zanim obejmiesz importem cały katalog. W próbce umieść co najmniej po jednym przypadku z każdej istotnej struktury produktu.

Mapowanie przypisuje pole lub strukturę Akeneo do pola lub struktury Magento i definiuje konwersję wartości oraz zachowanie przy brakach. Dla każdego atrybutu zapisz nazwę źródłową, pole docelowe, typ, język, obowiązkowość i regułę dla pustej wartości.

W mapie umieść przykładowy kod koloru, wartość liczbową i opis w dwóch językach. Taki zestaw ujawnia różnice typów oraz brakujące tłumaczenia przed importem większej partii.

Dokumentacja Akeneo pokazuje porównanie modelu danych i zakres funkcji konektora dla Adobe Commerce; nie jest potwierdzeniem obsługi Magento 1.x (zakres funkcji konektora Akeneo).

Publikacja katalogu powinna przejść przez przygotowanie danych, walidację, eksport, import, aktualizację indeksów Magento i kontrolę widoczności produktu. W projekcie własnym trzeba zaprojektować każdy etap; w konektorze sprawdź, które czynności wykonuje automatycznie i gdzie zapisuje status.

Przykładowy przepływ obejmuje:

1. Redaktor uzupełnia produkt i wybiera język oraz kanał publikacji.
2. Walidacja wykrywa brak SKU, wymaganych atrybutów lub kategorii.
3. Eksport obejmuje produkty gotowe do publikacji albo zatwierdzony zakres.
4. Integracja zapisuje wynik, błędy i identyfikator zadania.
5. Magento aktualizuje indeksy i udostępnia produkt we właściwym sklepie.
6. Operator sprawdza próbkę w panelu i na stronie sklepu.

Harmonogram i wielkość partii dopasuj do wydajności hostingu oraz częstotliwości zmian katalogu. Ponowienie powinno obsługiwać błędy przejściowe bez tworzenia duplikatów i cofania nowszych wartości. Ustal też, kto odbiera alert oraz jak rozpoznać błąd pojedynczego produktu i awarię całego eksportu.

Testuj import najpierw na środowisku testowym i próbce obejmującej różne typy zmian oraz błędne dane. Przed uruchomieniem zapisz wartości źródłowe i oczekiwane wyniki, aby jednoznacznie porównać stan katalogu po imporcie.

Po imporcie porównaj w próbce SKU, języki, kategorie, atrybuty i warianty. Sprawdź widok sklepu, indeks katalogu i logi procesu. Kryteria odbioru powinny obejmować zarówno poprawne rekordy, jak i sposób odnalezienia oraz ponowienia błędnych.

Magento 1.x wymaga oddzielnego potwierdzenia sposobu wymiany danych, ponieważ aktualny konektor Akeneo z opublikowaną macierzą zgodności dotyczy Adobe Commerce i Magento Open Source 2.x. Nie przenoś instrukcji instalacji ani listy zgodności konektora Magento 2 na Magento 1.x.

Dla Magento 1.x możliwa jest integracja własna, rozszerzenie utrzymywane przez dostawcę albo migracja platformy. Wybór zależy od stanu kodu, modułów, infrastruktury, dostępnego API i planu utrzymania. Artykuł o wariantach Magento i ich zastosowaniach pomaga osadzić tę decyzję w szerszym kontekście platformy.

Magento 2 także wymaga sprawdzenia konkretnych wersji, PHP, Akeneo i konektora. Repozytorium społecznościowe podaje tabelę zgodności i wymagania, które zmieniają się wraz z wydaniami (repozytorium konektora Magento 2). Przed zmianą platformy przeanalizuj również zakres migracji między Magento a Shopify.

Zakres prac zależy od zgodnego konektora, liczby mapowanych pól, złożoności wariantów, języków, kierunków synchronizacji i jakości katalogu. Wycena powinna osobno opisywać analizę zgodności, porządkowanie danych, konfigurację, prace własne, testy i uruchomienie.

Przed odbiorem uzgodnij odpowiedzialność za mapowanie, przygotowanie danych, dostęp do środowisk, testy biznesowe i obsługę błędów. Wymagaj dokumentacji pól i przepływów, przykładowych logów oraz procedury ponownego uruchomienia importu. Zapisz warunki, przy których projekt przejdzie na integrację własną albo migrację sklepu.

Jeśli chcesz połączyć katalog z przebudową sklepu, planowanie i realizacja sklepu internetowego może uwzględnić analizę platformy oraz integracji. W przypadku osobnego projektu PIM przed rozmową z wykonawcą przygotuj wersje systemów, próbkę katalogu i tabelę właścicieli pól. Artykuł Magento RAKS SQL i integracja pokazuje także, jak planować przepływ danych między sklepem i systemem zewnętrznym.

• Integracja Magento 1.x z BPA Platform: plan dla starszego sklepu
• Integracja Magento 1.x z Exact Globe Next: procesy i ryzyka
• Magento 1 w firmie: jak ocenić ryzyko i zaplanować dalsze działanie
• Magento API w praktyce: endpointy, integracje i bezpieczeństwo