# Dane dostawców do Pimcore, zmapowane wizualnie 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. Wersja web: https://sdmportal.com/pl/pimcore/ ## Połączenie - **Protokół:** Datahub GraphQL, /pimcore-graphql-webservices/{config} - **Uwierzytelnianie:** Klucz API Datahub w security definition konfiguracji - **Wersja:** Pimcore 11 - **Struktura:** Class - **Adresowanie:** Key obiektu, w folderze docelowym per profil - **Status:** Beta ## Gdzie naprawdę zacina się feed dostawcy do Pimcore ### 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 ### 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. - Pola tekstowe - Textarea - Liczby - Daty - Pola lokalizowane per język - Key obiektu - Umieszczenie w folderze docelowym ## Czego konektor Pimcore jeszcze nie robi ### Młodszy niż dwa pozostałe konektory (beta) 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 (twoja decyzja) 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 (nieobsługiwane) 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 (zostaje w pimcore) Nie da się utworzyć nowego pola klasy z edytora. Definicja klasy jest zarządzana w Pimcore. ### Zduplikowane key w różnych folderach (do pilnowania) 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 (przepustowość) 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 (zależne od konfiguracji) 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ą. ## FAQ ### 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. ## Zacznij Wypróbuj bezpłatnie 14 dni: https://app.sdmportal.com/signup?lang=pl Inne systemy PIM: https://sdmportal.com/pl/ergonode/ · https://sdmportal.com/pl/akeneo/ · https://sdmportal.com/pl/pimcore/ SDM Portal.