Konfiguracja synchronizacji

Połączenie synchronizuje tylko te rodzaje danych, dla których ma konfigurację synchronizacji. Tworzysz jedną konfigurację synchronizacji na typ encji (produkty, marki, ceny itd.) na karcie Konfiguracja synchronizacji połączenia. Ustawienia dotyczące całego połączenia, takie jak tryb śledzenia zmian, znajdziesz w oknie Edytuj połączenie.

Obecnie dane płyną w jedną stronę: z Twojego ERP do Omnilinkera. Agent nie zapisuje niczego w Twoim ERP, niezależnie od tego, co wybierzesz w polach Kierunek, Źródło główne czy Zachowanie przy usuwaniu. Zobacz Co ustawienia robią obecnie.

Dodawanie konfiguracji synchronizacji

Potrzebujesz uprawnienia Zarządzanie konfiguracjami synchronizacji.

Otwórz połączenie

Otwórz Integracja ERP > Połączenia i wybierz Szczegóły przy połączeniu.

Dodaj konfigurację

Na karcie Konfiguracja synchronizacji kliknij Dodaj konfigurację.

Wybierz typ encji

Wybierz Typ encji. Każdy typ encji może mieć jedną konfigurację na połączenie.

Załaduj ustawienia domyślne dostawcy

Kliknij Załaduj domyślne ustawienia, aby wypełnić pola wartościami zalecanymi przez dostawcę. Jeśli Omnilinker zgłosi, że ustawienia domyślne nie są dostępne, ustaw samodzielnie wartości z sekcji Zalecane wartości dla Wapro.

Utwórz konfigurację

Sprawdź pola Kierunek i Źródło główne, a następnie kliknij Utwórz. Konfiguracja jest od razu włączona.

Zachowania przy usuwaniu ani ustawień czasowych nie ma w oknie Dodaj konfigurację. Aby je zmienić, edytuj konfigurację po jej utworzeniu. W przypadku Wapro dodaj konfigurację dla każdego z tych typów encji: Produkt, Marka, Poziom cen, Cena produktu, Magazyn i Stan magazynowy. Agent wysyła produkty i marki tylko wtedy, gdy ich konfiguracja istnieje i jest włączona. Ceny produktów i magazyny są wysyłane, chyba że dodasz ich konfigurację i ją wyłączysz.

Edycja, wyłączanie i usuwanie konfiguracji

Na karcie Konfiguracja synchronizacji każdy wiersz pokazuje Typ encji, Kierunek, Źródło główne oraz stan Włączone lub Wyłączone.

Kliknij ikonę edycji, aby otworzyć okno Edytuj konfigurację synchronizacji.
Kliknij Wyłącz, aby przestać synchronizować ten typ encji, i Włącz, aby wznowić synchronizację.
Kliknij Usuń, aby usunąć konfigurację.

Zmiany docierają do agenta w ciągu kilku minut. Agent pobiera nową konfigurację przy następnym sygnale kontrolnym (heartbeat), wysyłanym co minutę, a niezależnie od tego sprawdza, czy jest nowa konfiguracja, co 5 minut.

Ustawienia

Ustawienia podstawowe

Ustawienie	Opcje	Znaczenie
Kierunek	Z ERP, Do ERP, Dwukierunkowa	Kierunek, w którym mają płynąć dane tego typu encji. Wybierz Z ERP.
Źródło główne	ERP, Katalog	System, który jest właścicielem tych danych. Wybierz ERP.
Zachowanie przy usuwaniu	Pomiń, Miękkie usuwanie, Twarde usuwanie	Co zrobić w ERP, gdy element zostanie usunięty w Omnilinkerze. Zobacz Zachowanie przy usuwaniu.
Rozmiar paczki	1–1000	Liczba zmian, które agent odczytuje z kanału zmian ERP w jednej paczce dla tego typu encji.

Nowa konfiguracja ma domyślnie ustawione Dwukierunkowa i ERP. Ustawienia domyślne Wapro to Z ERP i ERP.

Wyzwalacze synchronizacji

Przy tworzeniu, Przy aktualizacji i Przy usuwaniu (przy dodawaniu konfiguracji widoczne jako Synchronizuj przy tworzeniu, Synchronizuj przy aktualizacji i Synchronizuj przy usuwaniu) określają, jakie rodzaje zmian mają być synchronizowane. Są przeznaczone do synchronizacji z Omnilinkera do ERP. Zmiany z ERP są stosowane niezależnie od tego, co tu zaznaczysz.

Zachowanie przy usuwaniu

Zachowanie przy usuwaniu dotyczy tylko usunięć przekazywanych z Omnilinkera do ERP:

Opcja	Znaczenie
Pomiń	Nie przekazuj usunięć do ERP. To opcja domyślna i najbezpieczniejsza.
Miękkie usuwanie	Zamiast usuwać element w ERP, oznacz go jako nieaktywny lub wycofany.
Twarde usuwanie	Usuń element w ERP. Tej operacji nie można cofnąć. Twarde usunięcie może naruszyć ślady audytowe, faktury i historię stanów magazynowych w ERP.

Omnilinker nie zapisuje jeszcze niczego w Twoim ERP, więc obecnie żadna z tych opcji nie zmienia Twojego ERP. Zostaw Pomiń.

Usunięcia w przeciwnym kierunku są przekazywane. Gdy artykuł zostanie usunięty w Wapro albo przestanie być aktywny dla systemów zewnętrznych, agent zgłasza go jako usunięty, a Omnilinker usuwa odpowiadający mu produkt w katalogu. Zobacz Wapro.

Zaawansowane ustawienia czasowe

Aby zobaczyć te ustawienia, rozwiń Zaawansowane ustawienia czasowe w oknie Edytuj konfigurację synchronizacji. Gdy sekcja jest zwinięta, jednowierszowe podsumowanie pokazuje bieżące wartości.

Sekcja	Ustawienie	Zakres	Wartość domyślna
Główne odpytywanie	min i sek	Od 10 sekund do 1 godziny	60 sekund
Wykrywanie zmian przez hash	Włączone	Włączone lub wyłączone	Włączone
	Sprawdzaj co (min)	Od 1 minuty do 24 godzin	15 minut
	Rozmiar paczki	100–100 000	10 000 w domyślnych ustawieniach produktu dla Wapro
Harmonogram pełnej synchronizacji	Uruchamiaj co (godz.)	Od 1 godziny do 7 dni	24 godziny
Publikowanie Outbox	Rozmiar partii Outbox	1–1000, nie więcej niż Limit partii API w chmurze	100
	Limit partii API w chmurze	1–1000	100
	Interwał publikacji	1–60 sekund	5 sekund
	Maksymalna liczba powtórzeń	1–10	5

Co ustawienia robią obecnie

Nie każde ustawienie na tym ekranie zmienia działanie agenta w bieżącej wersji. Ta tabela pokazuje, których ustawień agent używa.

Ustawienie	Używane obecnie?
Włączona lub wyłączona	Tak, dla typów Produkt, Marka, Cena produktu i Magazyn. Poziomy cen przychodzą z codziennym przesłaniem danych słownikowych, a stany magazynowe ze zmianami produktów, niezależnie od ich własnej konfiguracji.
Rozmiar paczki (ustawienia podstawowe)	Tak, jako rozmiar paczki, gdy agent odczytuje kanał zmian WFM_INT.
Wykrywanie zmian przez hash: Włączone, Sprawdzaj co, Rozmiar paczki	Tak, w trybie Skanowanie skrótów, na podstawie konfiguracji typu Produkt (lub Marka, jeśli nie ma konfiguracji produktu).
Rozmiar partii Outbox, Limit partii API w chmurze	Tak. Agent używa największej wartości spośród wszystkich konfiguracji połączenia.
Kierunek, Źródło główne, Zachowanie przy usuwaniu, wyzwalacze synchronizacji	Nie. Będą miały znaczenie, gdy Omnilinker będzie mógł zapisywać dane w ERP.
Główne odpytywanie, Harmonogram pełnej synchronizacji, Interwał publikacji, Maksymalna liczba powtórzeń	Nie. Agent używa własnych stałych interwałów, wymienionych w sekcji Jak często dane są synchronizowane.

Ustawienia synchronizacji dla całego połączenia

Te ustawienia dotyczą wszystkich typów encji w połączeniu. Otwórz Integracja ERP > Połączenia, wybierz Edytuj przy połączeniu i znajdź je w sekcji Ustawienia synchronizacji. Potrzebujesz uprawnienia Edycja połączeń ERP.

Ustawienie	Działanie
Automatycznie twórz magazyny	Tworzy magazyn w Omnilinkerze dla każdego magazynu ERP, którego nie zmapowano. Zobacz Dane słownikowe.
Automatycznie twórz poziomy cen	Tworzy poziom cen w katalogu dla każdego poziomu cen ERP, którego nie zmapowano. Zobacz Dane słownikowe.
ID magazynu źródłowego	W systemach ERP, które przechowują osobny wiersz produktu dla każdego magazynu: magazyn, którego wiersz dostarcza dane produktu. Zostaw — nie ustawiono — (automatyczna wartość domyślna), aby agent wybrał go sam.
Tryb śledzenia zmian	Sposób wykrywania zmian w ERP przez agenta: Skanowanie skrótów lub Śledzenie zmian WFM_INT. Zobacz niżej.
Źródło ceny zestawu	Skąd pochodzą ceny zestawów: Stała — z ERP lub Kalkulowana — ze składników. Zobacz Ceny zestawów.

Tryb śledzenia zmian

Tryb	Jak działa	Co obejmuje
Skanowanie skrótów (domyślny)	Agent odczytuje rekordy ERP według harmonogramu, oblicza skrót (hash) zmapowanych pól i wysyła rekordy, których skrót się zmienił. Nie wprowadza żadnych zmian w bazie danych ERP.	Produkty i marki.
Śledzenie zmian WFM_INT	Agent rejestruje się we własnym mechanizmie śledzenia zmian Wapro i mniej więcej raz na minutę odczytuje zarejestrowane przez niego zmiany. Cotygodniowe uzgadnianie wychwytuje wszystko, co zostało pominięte.	Produkty, ceny produktów, magazyny i stany magazynowe. Marki są wychwytywane przez cotygodniowe uzgadnianie.

W obu trybach agent codziennie przesyła też poziomy cen, magazyny i inne dane słownikowe, a co 6 godzin składy zestawów. Przejście na Śledzenie zmian WFM_INT wymaga dwóch kroków, w tej kolejności:

Zarejestruj śledzenie zmian w agencie

Na komputerze z agentem otwórz ustawienia aplikacji w zasobniku. W sekcji ERP Change Tracking zaznacz I consent to Omnilinker registering change tracking in the WFM_INT framework tables, a następnie kliknij Enable Change Tracking. Ta operacja zapisuje dane w tabelach frameworku Wapro, więc login SQL potrzebuje dodatkowych uprawnień. Zobacz Wymagania i Wapro.

Przełącz tryb połączenia

W aplikacji webowej wybierz Edytuj przy połączeniu, ustaw Tryb śledzenia zmian na Śledzenie zmian WFM_INT i kliknij Zapisz.

Agent używa WFM_INT tylko wtedy, gdy oba warunki są spełnione. Jeśli połączenie wymaga WFM_INT, ale agent nie jest zarejestrowany, agent nadal używa skanowania skrótów. Karta Agent połączenia pokazuje tryb, którego agent faktycznie używa. Aby wrócić, ustaw Tryb śledzenia zmian na Skanowanie skrótów. Aby dodatkowo usunąć rejestrację z bazy danych ERP, kliknij Disable Change Tracking w aplikacji w zasobniku.

Ponowna rejestracja śledzenia zmian w przyszłości oznacza wszystkie rekordy jako nowe, więc agent wyśle ponownie cały Twój katalog jako pełne uzupełnienie danych.

Ceny zestawów

Źródło ceny zestawu decyduje o tym, jak zapisywana jest cena zestawu zaimportowanego z ERP:

Opcja	Znaczenie
Stała — z ERP (domyślna)	Ceny zestawów są pobierane bez zmian z artykułu zestawu w ERP.
Kalkulowana — ze składników	Ceny zestawów są obliczane z cen składników: jako suma cen netto składników, opodatkowana stawką VAT samego zestawu. Są przeliczane, gdy zmieni się skład zestawu lub cena składnika. O tym, jakie poziomy cen istnieją, nadal decyduje ERP, a gdy brakuje ceny składnika, używana jest cena zestawu z ERP.

To ustawienie dotyczy tylko zestawów. Produkty proste pozostają bez zmian.

Jak przepływają zmiany

Z ERP do Omnilinkera każda zmiana przechodzi tę samą drogę:

Agent wykrywa zmianę w bazie danych ERP za pomocą skanowania skrótów lub WFM_INT.
Agent zapisuje zmianę w swojej lokalnej kolejce wychodzącej (outbox), zanim oznaczy ją w ERP jako odczytaną. Gdy połączenie z internetem zostanie przerwane, zmiany czekają w kolejce wychodzącej.
Co 5 sekund agent wysyła oczekujące zmiany do Omnilinkera przez HTTPS, w skompresowanych paczkach.
Omnilinker stosuje Twoje mapowania pól do produktów i marek, a następnie tworzy lub aktualizuje produkt, markę, poziom cen lub cenę w katalogu. Zmiany magazynów i stanów magazynowych trafiają do modułu magazynowego.
Każda zmiana jest rejestrowana na karcie Logi synchronizacji połączenia. Zobacz Monitorowanie.

Omnilinker pomija zmianę, zamiast oznaczać ją jako nieudaną, gdy coś, od czego ona zależy, jeszcze nie istnieje. Na przykład cenę, której poziom cen nie jest zmapowany, albo stan magazynowy produktu, który jeszcze nie dotarł. Takie zmiany są stosowane później, gdy zależność już istnieje. Zobacz Dane słownikowe. Gdy zmiany docierają w innej kolejności, niż powstały, Omnilinker zachowuje najnowszą. Aktualizacja ze znacznikiem czasu ERP starszym niż już zastosowany jest pomijana.

Z Omnilinkera do ERP

Zapisywanie danych w ERP nie jest jeszcze dostępne. Edycja produktu w Omnilinkerze nie zmienia go w ERP. Następna zmiana tego produktu w ERP nadpisze pola, które pochodzą z ERP.

Jak często dane są synchronizowane

Oto domyślne ustawienia agenta.

Co	Kiedy
Zmiany ze śledzenia zmian WFM_INT	Co 60 sekund
Skanowanie skrótów (tryb Skanowanie skrótów)	Domyślnie co 15 minut (wartość Sprawdzaj co w konfiguracji produktu), po raz pierwszy 2 minuty po uruchomieniu agenta
Uzgadnianie (tryb Śledzenie zmian WFM_INT)	Co tydzień oraz po wykryciu przez agenta aktualizacji Wapro
Poziomy cen, magazyny i inne dane słownikowe	Przy uruchomieniu agenta, potem codziennie
Składy zestawów	Przy uruchomieniu agenta, potem co 6 godzin
Wysyłanie zmian z kolejki do Omnilinkera	Co 5 sekund
Odświeżanie konfiguracji	W ciągu mniej więcej minuty od zmiany i nie rzadziej niż co 5 minut

Własne interwały agenta ustawia się na komputerze z agentem. Zobacz Opis konfiguracji.

Pierwsza synchronizacja

Nie ma osobnego ustawienia pełnej synchronizacji. Pierwsza synchronizacja odbywa się samoczynnie:

Skanowanie skrótów: przy pierwszym skanowaniu agent nie ma jeszcze żadnych skrótów, więc wysyła wszystkie produkty i marki.
Śledzenie zmian WFM_INT: rejestracja oznacza wszystkie istniejące rekordy jako nowe, więc agent wysyła wszystko. Najpierw wysyła dane słownikowe i magazyny, potem produkty i stany magazynowe, a na końcu ceny, tak aby zależności każdego elementu docierały przed nim.

Pierwsza synchronizacja dużego katalogu może trwać wiele godzin. Dodanie pola do skrótu (zobacz Uwzględnij w weryfikacji hash) również sprawia, że następne skanowanie skrótów ponownie wyśle wszystkie produkty.

Przycisk Uruchom synchronizację na stronie połączenia w bieżącej wersji nie uruchamia synchronizacji w agencie. Zamiast tego rejestruje w połączeniu nieudaną próbę synchronizacji. Aby uruchomić synchronizację od razu, użyj Sync Now w aplikacji w zasobniku. Zobacz Aplikacja w zasobniku.

Zalecane wartości dla Wapro

Oto ustawienia domyślne dostawcy Wapro, które wypełnia przycisk Załaduj domyślne ustawienia.

Typ encji	Kierunek	Źródło główne	Rozmiar paczki	Weryfikacja hash	Sprawdzaj co
Produkt	Z ERP	ERP	100	Włączona	15 min
Marka	Z ERP	ERP	50	Włączona	60 min
Poziom cen	Z ERP	ERP	20	Włączona	60 min
Cena produktu	Z ERP	ERP	500	Wyłączona	—
Magazyn	Z ERP	ERP	20	Wyłączona	—
Stan magazynowy	Z ERP	ERP	500	Wyłączona	—

Wszystkie używają opcji Pomiń w polu Zachowanie przy usuwaniu. Ceny produktów, magazyny i stany magazynowe wymagają śledzenia zmian WFM_INT.

Pierwsze kroki

Instalacja