Mapuj dane dostawców do Pimcore. Bez kodu.
Pimcore 11 nie ma webservice'u REST, więc SDM Portal zapisuje przez API GraphQL Datahub: obiekty znajdowane po key, tworzone w wybranym przez Ciebie folderze, aktualizowane po jednym języku. Konektor jest w wersji beta, a ta strona mówi dokładnie, co robi, a czego nie.
Połączenie
- ProtokółDatahub GraphQL, /pimcore-graphql-webservices/{config}
- UwierzytelnianieKlucz API Datahub w security definition konfiguracji
- WersjaPimcore 11
- StrukturaClass
- AdresowanieKey obiektu, w folderze docelowym per profil
- StatusBeta
Gdzie naprawdę zacina się feed dostawcy do Pimcore
Pliki dostawców są tworzone dla ludzi. Pimcore jest zbudowane pod schemat. Praca polega głównie na dystansie między jednym a drugim, a ten dystans wraca z każdym nowym plikiem.
Brak webservice'u REST
Pimcore 11 go usunął. Wszystko idzie przez konfigurację Datahub, którą tworzysz sam, i która decyduje, które klasy są do czytania i zapisu, oraz przechowuje klucz API.
Obiekty to key i ścieżki
Obiekt Pimcore nie jest adresowany atrybutem identifier, ale key wewnątrz drzewa folderów. Wiersz dostawcy musi trafić na key, zanim cokolwiek da się zapisać.
Języki to osobne zapisy
Pola lokalizowane są aktualizowane per język, co oznacza, że szeroki wielojęzyczny katalog to wiele małych mutacji, a nie jeden dokument.
Jak SDM Portal zapisuje do Pimcore
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 Pimcore.
Datahub jako powierzchnia integracji
Tworzysz konfigurację Datahub w Pimcore, udostępniasz klasy, które chcesz zapełnić, ustawiasz klucz API w security definition i ją aktywujesz. SDM Portal łączy się z tym endpointem za pomocą klucza. W Pimcore nic nie jest instalowane.
Mapowanie w obrębie klasy
Wybierz klasę, a szyna atrybutów ogranicza się do jej pól, tak samo jak rodzina albo szablon w dwóch pozostałych systemach PIM.
Sprawdzenie istnienia po key
Przed zapisem SDM Portal sprawdza key, których zamierza dotknąć, i decyduje dla każdego wiersza, czy to utworzenie, czy aktualizacja. Sprawdzenie znajduje też obiekty nieopublikowane, więc obiekt utworzony w poprzednim uruchomieniu jest aktualizowany, a nie duplikowany.
Folder docelowy, który wybierasz
Nowe obiekty są tworzone w ścieżce folderu ustawionej per profil. Gdy konfiguracja Datahub udostępnia foldery obiektów, wybierasz go z przeszukiwalnego drzewa czytanego na żywo z Pimcore; gdy nie udostępnia, wpisujesz ścieżkę.
Wartości zapisywane per język
Jedno utworzenie, potem jedna mutacja aktualizacji na język, z kontrolowanym tempem, żeby duży katalog nie zalał endpointu. Aktualizacja bez treści jest pomijana, a nie wysyłana.
Wszystko przed zapisem jest takie samo
Wgrywanie, link do udostępniania lub odbiór e-mail, wizualny edytor przepływu, przekształcenia kompilowane przez AI, bloki Translate i Compose, dry-run wiersz po wierszu, workflow zatwierdzania, tryby create, update i upsert oraz delta sync są identyczne jak w ścieżkach Ergonode i Akeneo. Różni się tylko zapis.
Co możemy zapisać do Pimcore
Wartości są zapisywane przez mutacje aktualizacji Datahub, per język. Wartości select są mapowane na kody, których oczekuje Twoja klasa; SDM Portal nie tworzy nowych wartości ani pól w definicji klasy.
Czego konektor Pimcore jeszcze nie robi
Wolimy, żebyś przeczytał to przed rejestracją, niż odkrył w drugim tygodniu. Każdy punkt poniżej to rzeczywista granica konektora Pimcore dzisiaj.
Młodszy niż dwa pozostałe konektory
Dziś zapisuje do rzeczywistej instancji Pimcore: znajduje obiekty po key, tworzy je w folderze docelowym i aktualizuje wartości per język. Ma mniej funkcji niż konektory Ergonode i Akeneo, a wszystkie są tu wymienione.
Obiekty trafiają nieopublikowane
Obiekt utworzony przez SDM Portal nie jest publikowany. Publikacja pozostaje decyzją w Pimcore. Sprawdzenie po key znajduje obiekty nieopublikowane, więc kolejne uruchomienie aktualizuje ten obiekt, a nie tworzy drugiego.
Warianty, tworzenie opcji, status workflow
Brak rodziców wariantów i osi, brak tworzenia wartości select ani opcji, brak wzbogacania opcji i brak przejść statusu workflow. To funkcje Ergonode i Akeneo.
Tworzenie pól
Nie da się utworzyć nowego pola klasy z edytora. Definicja klasy jest zarządzana w Pimcore.
Zduplikowane key w różnych folderach
Sprawdzenie po key porównuje wszystkie foldery. Jeśli ten sam key istnieje dwa razy, otrzymujesz ostrzeżenie o duplikacie, a zapis trafia na pierwsze trafienie.
Jedna aktualizacja na język na obiekt
Szeroki wielojęzyczny katalog idzie wolniej niż wsadowe ścieżki zapisu Ergonode i Akeneo, gdzie wiele produktów jedzie w jednym żądaniu.
Wybór folderu
Czytanie folderów obiektów jest domyślnie wyłączone w konfiguracji Datahub. Włącz je, aby dostać drzewo folderów, albo wpisz ścieżkę docelową.
Pytania o Pimcore i SDM Portal
Której wersji Pimcore i którego API używa SDM Portal?
Pimcore 11 przez API GraphQL Datahub. Pimcore 11 nie ma webservice'u REST, więc Datahub jest powierzchnią integracji. Tworzysz konfigurację Datahub, udostępniasz klasy, które chcesz zapełnić, ustawiasz klucz API w jej security definition i ją aktywujesz.
Co oznacza beta dla konektora Pimcore?
Dziś zapisuje do rzeczywistej instancji Pimcore: znajduje obiekty po key, tworzy je w folderze docelowym i aktualizuje wartości per język. Jest młodszy niż konektory Ergonode i Akeneo i ma mniej funkcji, wymienionych na tej stronie. Nazywamy go beta, żebyś mógł ocenić to sam.
Czy obiekty są publikowane automatycznie?
Nie. Obiekty utworzone przez SDM Portal trafiają nieopublikowane, a publikacja pozostaje decyzją w Pimcore. Sprawdzenie istnienia znajduje obiekty nieopublikowane, więc późniejsze uruchomienie aktualizuje utworzony obiekt, a nie tworzy kolejnego.
Jak obiekty Pimcore są dopasowywane do wierszy dostawcy?
Po key obiektu. Przed zapisem SDM Portal przegląda key, których zamierza dotknąć, i decyduje dla każdego wiersza, czy to utworzenie, czy aktualizacja. Sprawdzenie porównuje key we wszystkich folderach, więc jeśli ten sam key istnieje dwa razy, otrzymujesz ostrzeżenie o duplikacie, a zapis trafia na pierwsze trafienie.
Czy nadal mogę korzystać z wizualnego edytora i dry-runu?
Tak. Wszystko przed zapisem jest takie samo jak dla Ergonode i Akeneo: kanwa przepływu, przekształcenia, reguły kompilowane przez AI, bloki Translate i Compose, dry-run wiersz po wierszu, workflow zatwierdzania i delta sync.
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 Pimcore raz. Potem działa samo.
Utwórz obszar roboczy, podłącz swoją instancję Pimcore i zmapuj pierwszy plik dostawcy. Czternaście dni bezpłatnie, w okresie próbnym nie obciążamy karty.