Mapuj dane dostawców do Akeneo. Bez kodu.
Twój dostawca przysyła arkusz kalkulacyjny. Akeneo oczekuje dokumentu produktu z właściwą rodziną, kanałem, lokalizacją i walutą przy każdej wartości. SDM Portal jest warstwą mapowania pomiędzy: budujesz ją raz na dostawcę, a każdy kolejny plik odtwarza te same reguły.
Połączenie
- ProtokółAkeneo REST API, /api/rest/v1
- UwierzytelnianieOAuth2 password grant: client ID, secret, nazwa użytkownika, hasło
- EdycjeCommunity Edition 7 i Serenity, wykrywane przy handshake
- StrukturaRodzina
- ZapisND-JSON PATCH /products, do 100 na batch
- Delta syncHash dokumentu na produkt
Gdzie naprawdę zacina się feed dostawcy do Akeneo
Pliki dostawców są tworzone dla ludzi. Akeneo jest zbudowane pod schemat. Praca polega głównie na dystansie między jednym a drugim, a ten dystans wraca z każdym nowym plikiem.
Atrybuty żyją w rodzinach
Kolumna dostawcy nic nie znaczy, dopóki nie wiesz, do której rodziny należy. Wybierz rodzinę, a szyna atrybutów zawęża się do atrybutów tej rodziny, w jej własnej kolejności.
Każda wartość ma wymiar
Wartości w Akeneo noszą lokalizację i, przy atrybutach scopable, kanał. Cena to kolekcja z walutą. Wartość metryczna to liczba plus jednostka. Pomyl jedno z nich i wartość zostanie odrzucona.
Opcje to kody, nie etykiety
Wartość select musi trafić na istniejący kod opcji zgodny ze znakami, które akceptuje Akeneo. Pliki dostawców przysyłają zamiast tego etykiety w rodzaju Navy Blue.
Jak SDM Portal zapisuje do Akeneo
Mapowanie rysujesz na kanwie. Trudne reguły opisujesz zwykłym językiem i są kompilowane raz do stałej reguły, więc uruchomienia pozostają powtarzalne. Poniżej opisujemy, co dokładnie robi strona Akeneo.
Mapowanie w obrębie rodziny
Wybierz rodzinę, a szyna atrybutów ogranicza się do niej, zachowując kolejność atrybutów tej rodziny. Atrybut identifier jest pomijany, a w jego miejsce dodawane jest pole systemowe esa_sku, więc SKU mapujesz jak każdą inną kolumnę, dokładnie tak jak w Ergonode.
Lokalizacja na połączeniu
Włączone lokalizacje pochodzą z Twojej instancji. Lokalizacja jest właściwością połączenia, które rysujesz, więc trzy kolumny opisu mogą zasilić jeden atrybut w trzech językach. Atrybut lokalizowalny przyjmuje lokalizację połączenia; nielokalizowalny zachowuje pierwszą wartość i zgłasza ostrzeżenie.
Kanał i waluta na profil
W ustawieniach publikacji znajdują się kanał i domyślna waluta profilu, proponowane z Twoich własnych kanałów i ograniczone do walut tego kanału. Wartość scopable bez ustawionego kanału jest pomijana z ostrzeżeniem. Ustaw to przed zatwierdzeniem: zmiana zmienia każdy hash dokumentu i wymusza pełne ponowne wysłanie.
Kolekcje cen, wielowalutowość
Waluta jest również właściwością połączenia. Kilka kolumn źródłowych, na przykład price_eur i price_usd, łączy się w jedną kolekcję cen na jednym atrybucie. Mieszanie połączeń z walutą i bez waluty powoduje niepowodzenie dry-runu, zamiast zgadywania.
Atrybuty metryczne
Wartość metryczna jest zapisywana jako liczba plus domyślna jednostka metryczna atrybutu. Atrybut bez domyślnej jednostki pomija wartość i to komunikuje, zamiast zapisywać liczbę bez jednostki.
Tworzenie opcji z etykietami
Brakujące opcje select są tworzone z etykietami dla każdej lokalizacji. Kody muszą używać znaków dozwolonych przez Akeneo, a nieprawidłowy kod jest odrzucany z propozycją poprawki, a nie po cichu przepisywany, więc kod, który widzisz, jest kodem, który trafia na miejsce.
Nowe atrybuty z edytora
Twórz atrybuty typu text, textarea, number, date, simple select, multi select, boolean, price collection i metric bez opuszczania kanwy. Każdy typ wymaga grupy atrybutów; metric wymaga też rodziny i domyślnej jednostki. Nowy atrybut jest dopisywany do rodziny profilu za pomocą PATCH-a, który czyta i dokleja, więc nic innego w tej rodzinie nie jest ruszane.
Reference entities w Serenity
Atrybut reference entity zachowuje się jak select, a jego wariant collection jak multi select. Lista opcji to rekordy powiązanej encji, więc wartości dostawcy mapujesz wprost na kody rekordów.
Mechanika zapisu, którą można sprawdzić
Produkty wychodzą w batchach ND-JSON po maksymalnie 100. Każda linia wraca jako utworzona, zaktualizowana lub odrzucona, a odrzucenie jest raportowane per atrybut. Limity zapytań są respektowane na podstawie odpowiedzi. Każdy produkt nosi hash dokumentu, więc ponowne uruchomienie na niezmienionym pliku nie zapisuje niczego. W trybach create i update najpierw sprawdzane jest, co już istnieje, w blokach po 500 SKU.
Co możemy zapisać do Akeneo
Wartości select i multi select są mapowane na kody opcji, a brakujące opcje można utworzyć wraz z ich etykietami. Kategorie są przypisywane per produkt jako zbiór bez duplikatów.
Czego konektor Akeneo jeszcze nie robi
Wolimy, żebyś przeczytał to przed rejestracją, niż odkrył w drugim tygodniu. Każdy punkt poniżej to rzeczywista granica konektora Akeneo dzisiaj.
Product models i warianty
Osie wariantów są dziś funkcją Ergonode. W profilu Akeneo znaczniki wariantów są ukryte. Jeśli starszy przepływ nadal je nosi, dzieci są zapisywane jako samodzielne produkty, a rodzice pomijani z jednym zbiorczym ostrzeżeniem.
Media, tabele, identifier
Atrybuty obrazu i mediów, atrybuty tabelowe oraz atrybut identifier są widoczne w szynie, ale nie da się do nich zapisywać. Pozostają czytelne, żebyś widział całą rodzinę.
Rekordy reference entity
Rekordy reference entity są czytane jako opcje, nigdy nie są tworzone. Ich etykietą jest kod rekordu, więc lista wyboru pokazuje kody.
Status workflow
Akeneo nie ma statusu workflow na produktach. Mapowanie statusu przeniesione z przepływu Ergonode jest ignorowane z jednym ostrzeżeniem, zamiast przerywać uruchomienie.
Custom fields przy opcjach
Opcje w Akeneo mają etykiety, ale nie mają custom fields, więc funkcje wzbogacania opcji pozostają ukryte w profilu Akeneo.
Usuwanie atrybutów
Atrybutu utworzonego przez API nie da się już usunąć przez API CE 7. Twórz je świadomie.
Pytania o Akeneo i SDM Portal
Które wersje Akeneo obsługuje SDM Portal?
Akeneo Community Edition 7 i Serenity. Edycja i wersja są wykrywane w czasie handshake połączenia i pokazywane w wierszu połączenia, więc widzisz dokładnie, z czym jesteś połączony.
Jak SDM Portal uwierzytelnia się w Akeneo?
Przez połączenie API Akeneo: client ID, client secret, nazwa użytkownika i hasło przez OAuth2 password grant. Token bearer jest cache'owany per połączenie i odnawiany raz przy odpowiedzi 401. Poświadczenia są przechowywane w postaci zaszyfrowanej i nigdy nie wchodzą w skład eksportowanego mapowania.
Czy SDM Portal obsługuje product models i warianty Akeneo?
Jeszcze nie. Osie wariantów i bindings są dziś funkcją Ergonode. W profilu Akeneo znaczniki wariantów są ukryte, a przepływ, który nadal je nosi, zapisuje dzieci jako samodzielne produkty i pomija rodziców z jednym ostrzeżeniem.
Jak obsługiwane są kanały, lokalizacje i waluty?
Lokalizacja jest właściwością połączenia mapowania, więc trzy kolumny opisu mogą zasilić jeden atrybut w trzech językach. Kanał i domyślną walutę ustawiasz per profil w ustawieniach publikacji, wybierając z własnych kanałów. Atrybut ceny może przyjąć kilka walut jednocześnie, jeśli ustawisz walutę na każdym połączeniu.
Czy mogę zobaczyć, co się stanie, zanim cokolwiek zostanie zapisane do Akeneo?
Tak. Dry-run pokazuje wynik wiersz po wierszu, z ostrzeżeniami o niezmapowanych wartościach i pominiętych polach, i nie zapisuje niczego. Uruchomienia mogą trafić najpierw do Akeneo staging, a potem na produkcję, a delta sync oznacza, że ponownie wysyłane są tylko zmienione produkty.
Używasz innego systemu PIM?
Edytor, przekształcenia i workflow są wspólne. Różni się tylko ścieżka zapisu dla każdego PIM, więc każdy konektor ma własną stronę.
Mapujesz Akeneo raz. Potem działa samo.
Utwórz obszar roboczy, podłącz swoją instancję Akeneo i zmapuj pierwszy plik dostawcy. Czternaście dni bezpłatnie, w okresie próbnym nie obciążamy karty.