Mapuj dane dostawców do Ergonode. Bez kodu.
Ergonode udostępnia wyłącznie GraphQL, a każdy rodzaj atrybutu ma własną typowaną mutację. SDM Portal wie, której użyć, zapisuje Twoje warianty w kolejności wymaganej przez Ergonode i odtwarza te same reguły na każdym pliku, który przysyła ten dostawca.
Połączenie
- ProtokółWyłącznie GraphQL, /api/graphql/
- UwierzytelnianieKlucz API w nagłówku X-API-KEY
- StrukturaTemplate
- ZapisMutacje GraphQL z aliasami, 25 operacji na żądanie
- WariantyNajpierw simple products, potem variable product z bindings
- Delta syncHash na operację zapisu
Gdzie naprawdę zacina się feed dostawcy do Ergonode
Pliki dostawców są tworzone dla ludzi. Ergonode jest zbudowane pod schemat. Praca polega głównie na dystansie między jednym a drugim, a ten dystans wraca z każdym nowym plikiem.
Każdy rodzaj ma własną mutację
Text, numeric, select, multi select, unit, price i relation wymagają każdy innej typowanej mutacji. Wyślij wartość przez niewłaściwą i Ergonode odpowie nieznanym błędem bez żadnych szczegółów.
Warianty wymagają kolejności
Dzieci muszą istnieć, zanim variable product będzie mógł je powiązać. Pomyl kolejność i bindings się nie udadzą.
Status to graf, nie pole
Ergonode waliduje przejścia workflow po stronie serwera, więc nie da się po prostu ustawić statusu, który chcesz, z miejsca, w którym produkt jest teraz.
Jak SDM Portal zapisuje do Ergonode
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 Ergonode.
Mapowanie w obrębie szablonu
Wybierz szablon, a szyna atrybutów ogranicza się do jego atrybutów. Szablony nie mają w API nazwy wyświetlanej, więc lista wyboru pokazuje kod szablonu. Wbudowany SKU nie jest częścią strumienia atrybutów, więc dodawane jest pole esa_sku i SKU mapujesz jak każdą inną kolumnę.
Typowane zapisy, rozstrzygane na żywo
Text, textarea i date wychodzą jako łańcuch znaków, numeric, price i unit jako float, select jako kod opcji, multi select jako lista kodów opcji, a relation jako lista SKU. Rodzaj pochodzi z Twojego katalogu na żywo, nie z kształtu wartości, więc numer artykułu, który wygląda na liczbę, i tak trafia jako tekst.
Wartości per lokalizacja
Lokalizacja jest właściwością połączenia, które rysujesz. Trzy kolumny opisu zasilają jeden atrybut w trzech językach, a język uruchomienia decyduje o wartości domyślnej.
Warianty z osiami i bindings
Oznacz parent key, jedną lub więcej osi wariantu oraz SKU wariantu na kolumnach źródłowych. Najpierw tworzone są simple products, potem variable product z jego bindings, co jest kolejnością wymaganą przez Ergonode. Wartości osi, które przechodzą przez ValueMap, wciąż trafiają na kody bindings.
Status workflow najkrótszą ścieżką
Ponieważ Ergonode wymusza graf przejść, najkrótsza ścieżka od aktualnego statusu produktu do tego, który zmapowałeś, jest wyliczana i przechodzona krok po kroku, a nie ustawiana jednym skokiem.
Kategorie z wielu taksonomii
Przepływ może zawierać więcej niż jeden węzeł taksonomii. Każdy mapuje wartość źródłową na kategorię, a produkt otrzymuje sumę bez duplikatów wszystkiego, co zostało rozstrzygnięte, w jednym wywołaniu kategorii.
Opcje, tworzone i wzbogacane
Brakujące opcje są tworzone z krótkim proponowanym kodem, małymi literami, który możesz edytować dla każdej wartości. Custom fields opcji typu text, textarea i rich text mogą być wypełniane z innych kolumn tego samego wiersza, więc długi tekst pielęgnacyjny trafia do custom field, a opcja zachowuje czytelną nazwę. Nazwy opcji kończą się na 255 znakach.
Nowe atrybuty z edytora
Twórz atrybuty typu text, textarea, numeric, date, select, multi select, unit, price i relation z kanwy. Ergonode nie ma API do dodania atrybutu do szablonu, więc utworzony atrybut obowiązuje w całej instancji, a do szablonu dodajesz go już w Ergonode. Edytor mówi o tym w chwili, gdy tworzysz atrybut.
Batche, które przetrwają błędną komórkę
Zapisy wychodzą jako mutacje GraphQL z aliasami, 25 operacji na żądanie, z kontrolowanym tempem. Jedna odrzucona wartość może wywalić cały dokument w batchu, więc batch, w którym każda operacja zawiodła z tym samym błędem, jest ponawiany po jednej operacji. Zawodzi tylko prawdziwy sprawca, a szczegół walidacji z Ergonode jest pokazywany w wierszu.
Miękkie błędy pozostają miękkie
Wartość w rodzaju nvt na atrybucie liczbowym jest pomijana z ostrzeżeniem wskazującym SKU. Zduplikowana wartość na atrybucie unique, na przykład wspólny kod taryfowy, jest zapisywana jako pominięcie, a nie porażka produktu. Relacja do SKU, które jeszcze nie istnieje, jest usuwana z tego zapisu i wskazywana w ostrzeżeniu, więc reszta relacji i tak trafia na miejsce.
Co możemy zapisać do Ergonode
Select i multi select są mapowane na kody opcji, a brakujące opcje można tworzyć i wzbogacać. Atrybut ceny to pojedynczy float, którego waluta jest konfigurowana na atrybucie w Ergonode, a atrybut unit czyta swój symbol z atrybutu.
Czego konektor Ergonode jeszcze nie robi
Wolimy, żebyś przeczytał to przed rejestracją, niż odkrył w drugim tygodniu. Każdy punkt poniżej to rzeczywista granica konektora Ergonode dzisiaj.
Obrazy, galerie, pliki
Atrybuty mediów są widoczne w szynie, ale nie są zapisywane. Custom fields opcji typu obraz są z tego samego powodu odfiltrowywane.
Ceny
Atrybut ceny w Ergonode zawiera jeden float, a jego waluta jest konfigurowana na atrybucie w Ergonode. Waluta na połączenie, gdzie kilka kolumn łączy się w jedną kolekcję, jest funkcją Akeneo.
Grouping products
Tylko simple i variable products. Grouping products nie są tworzone.
Dodanie atrybutu do szablonu
Ergonode nie ma do tego API. Atrybut utworzony z edytora istnieje w całej instancji, a do szablonu dodajesz go w Ergonode, zanim pojawi się w zawężonej szynie.
Nazwy opcji powyżej 255 znaków
Ergonode odrzuca dłuższe nazwy opcji nieprzejrzystym błędem, więc nazwy są skracane do 255. Pełny tekst umieść w custom field opcji.
Nazwy szablonów
API Ergonode nie zwraca nazwy wyświetlanej szablonu, więc listy wyboru i ostrzeżenia pokazują kod szablonu.
Pytania o Ergonode i SDM Portal
Jak SDM Portal łączy się z Ergonode?
Ergonode udostępnia wyłącznie GraphQL, pod /api/graphql/. Podajesz adres instancji i klucz API, który jest wysyłany jako nagłówek X-API-KEY, a połączenie jest weryfikowane rzeczywistym handshake'iem. Klucz jest przechowywany zaszyfrowany i nigdy nie wchodzi w skład eksportowanego mapowania.
Czy SDM Portal obsługuje warianty Ergonode?
Tak. Oznaczasz parent key, osie wariantu i SKU wariantu na kolumnach źródłowych. Najpierw tworzone są simple products, a potem variable product z jego bindings, co jest kolejnością wymaganą przez Ergonode. Wartości osi, które przechodzą przez ValueMap, wciąż trafiają na kody bindings.
Czy może ustawić status workflow w Ergonode?
Tak. Ergonode waliduje przejścia statusu po stronie serwera, więc SDM Portal wylicza najkrótszą ścieżkę od aktualnego statusu produktu do tego, który zmapowałeś, i przechodzi ją krok po kroku.
Jak jedna błędna komórka nie wywala całego batcha?
Zapisy są grupowane w mutacje GraphQL z aliasami, 25 operacji na żądanie. Jedna odrzucona wartość może wywalić cały dokument w batchu, więc batch, w którym każda operacja zawiodła z tym samym błędem, jest ponawiany po jednej operacji. Zawodzi tylko prawdziwy sprawca, a powód zwrócony przez Ergonode jest pokazywany w wierszu.
Czy drugie uruchomienie wyśle wszystko ponownie?
Nie. Każdy zapis jest hashowany per operacja, więc ponowne uruchomienie na niezmienionym pliku raportuje produkty jako niezmienione i nie zapisuje niczego. Wymuszona pełna resynchronizacja jest dostępna na te sytuacje, gdy naprawdę chcesz wysłać wszystko ponownie.
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 Ergonode raz. Potem działa samo.
Utwórz obszar roboczy, podłącz swoją instancję Ergonode i zmapuj pierwszy plik dostawcy. Czternaście dni bezpłatnie, w okresie próbnym nie obciążamy karty.