Przejdź do głównej treści
Agent ERP Sync to jeden pakiet instalacyjny, który zawiera wszystkie części agenta:
  • Usługę Windows (Omnilinker.ErpSync.Service.exe). Komunikuje się z Omnilinkerem, uruchamia konektor i przechowuje ustawienia agenta. Działa jako Lokalny system i nie otwiera żadnego portu sieciowego.
  • Konektor Wapro (connectors\wapro\Omnilinker.ErpIntegration.Connectors.Wapro.Host.exe). To osobny proces, który łączy się z bazą danych ERP: usługa uruchamia go przy swoim starcie i sprawdza nim bazę danych. Działa jako Lokalny system, tak jak usługa.
  • Aplikację w zasobniku systemowym (tray\Omnilinker.ErpSync.Tray.exe). Służy do konfigurowania agenta i śledzenia, co robi. Działa na koncie osoby, która jest zalogowana.
Instalator to MSI dla całego komputera: instaluje agenta raz, dla wszystkich użytkowników komputera. Razem z krokiem Dokończ instalację w aplikacji w zasobniku wykonuje całą instalację: kopiuje pliki, rejestruje i uruchamia usługę Windows, przygotowuje folder danych agenta i sprawia, że aplikacja w zasobniku uruchamia się dla każdego, kto się zaloguje. Nie uruchamiasz żadnego skryptu.

​
Zanim zaczniesz

  • Utwórz połączenie w Omnilinkerze. Połączysz z nim agenta kodem połączenia. Zobacz Tworzenie połączenia.
  • Sprawdź, czy komputer spełnia wymagania.
  • Potrzebujesz konta lokalnego administratora: podczas instalacji Windows dwa razy prosi o zgodę administratora.
  • Zdecyduj, kto będzie konfigurować agenta z aplikacji w zasobniku. Instalator daje to prawo Tobie. Inne osoby trzeba dodać do lokalnej grupy. Zobacz Kto może zmieniać agenta.

​
Zainstaluj agenta

1

Uruchom instalator

Otwórz OmnilinkerErpSync-stable.msi. Windows prosi o zgodę administratora, a agent instaluje się w C:\Program Files\OmnilinkerErpSync\current. To jest folder instalacji. Zawiera usługę, appsettings.json i aplikację w zasobniku w osobnym podfolderze tray.
Używaj MSI. Wydanie zawiera też Setup.exe, którego używa kanał aktualizacji. Otwarty ręcznie instaluje się w Twoim profilu użytkownika, a usługa, która działa jako Lokalny system, nigdy nie jest rejestrowana z folderu, który może zmienić zalogowana osoba: każdy, kto mógłby podmienić jej pliki, mógłby uruchomić kod jako SYSTEM.
2

Dokończ instalację

Gdy pliki są na miejscu, aplikacja w zasobniku otwiera okno Dokończ instalację. MSI nie potrafi samo zarejestrować usługi Windows, bo swoje kroki wykonuje bez uprawnień administratora. Wybierz Dokończ instalację i jeszcze raz wyraź zgodę. Prośba o zgodę pochodzi z tego okna, więc pojawia się przed nim.Jeśli wybierzesz Później, z tego komputera nic jeszcze nie działa. Aplikacja w zasobniku zapyta ponownie przy następnym uruchomieniu: przy następnym logowaniu albo gdy otworzysz Omnilinker ERP Sync z menu Start.Dokończenie instalacji wykonuje następujące kroki:Na koniec usługa się uruchamia, a aplikacja w zasobniku otwiera konfigurację, w której łączysz agenta.Jeśli usługa OmnilinkerErpSyncService już istnieje, na przykład z wcześniejszej wersji, dokończenie instalacji kieruje ją na tę instalację i zachowuje jej pozostałe ustawienia, w tym konto z karty Logowanie.
Dział IT może zainstalować agenta bez interakcji albo przez Intune lub zasady grupy. Uruchomione jako SYSTEM, MSI wykonuje wszystko od razu, bez kroku Dokończ instalację:
3

Sprawdź wynik

Status powinien mieć wartość Running.Dokończenie instalacji nie przerywa się, gdy któryś krok się nie uda. To, czego nie udało się zrobić, zapisuje w %ProgramData%\Omnilinker\ErpSync\logs\setup.log, po jednym wierszu na problem. Udana instalacja zapisuje done.
Jeśli zgoda nie została udzielona albo część z podwyższonymi uprawnieniami się nie uruchomiła, własny zapis aplikacji w zasobniku znajduje się w %LocalAppData%\Omnilinker\ErpSync\setup-trace.log osoby, która instalowała agenta. Aby spróbować ponownie, otwórz Omnilinker ERP Sync z menu Start: aplikacja proponuje Dokończ instalację, dopóki usługa nie działa z tej instalacji. Każdy krok można bezpiecznie powtórzyć. Zobacz Rozwiązywanie problemów.

​
Kto może zmieniać agenta

Każdy, kto jest zalogowany na komputerze agenta, może otworzyć aplikację w zasobniku i zobaczyć status agenta, jego logi i ustawienia, z wyjątkiem tego, gdzie jest baza danych ERP (serwer, baza danych, użytkownik SQL Server i numer firmy): to widzą tylko operatorzy. Hasło i klucz agenta nigdy nie są pokazywane. Zmienianie agenta wymaga więcej. Tylko te osoby mogą w aplikacji w zasobniku przejść przez konfigurację, zmieniać ustawienia bazy danych ERP, sprawdzać, uruchamiać ponownie lub odświeżać konektor w Ustawieniach, wstrzymywać agenta oraz od razu instalować pobraną aktualizację:
  • członkowie lokalnej grupy Omnilinker ERP Sync Operators,
  • administratorzy, których aplikacja w zasobniku działa z podwyższonymi uprawnieniami (Uruchom jako administrator).
Pozostali widzą komunikat „Może to zrobić tylko operator tego komputera: członek grupy „Omnilinker ERP Sync Operators” albo administrator.”. Pełną listę znajdziesz w sekcji Kto może co zrobić. Instalator dodaje do grupy osobę, która zainstalowała agenta. Aby dodać kogoś jeszcze, uruchom w PowerShell jako administrator:
Ta osoba musi wylogować się z Windows i zalogować ponownie, zanim członkostwo zacznie działać: Windows odczytuje grupy użytkownika przy logowaniu. Do tego czasu aplikacja w zasobniku nadal mówi, że nie jest operatorem. Administratorowi od razu wystarczy uruchomienie aplikacji przez Uruchom jako administrator. Grupą możesz też zarządzać w Zarządzanie komputerem > Użytkownicy i grupy lokalne > Grupy.

​
Następny krok

Połącz agenta w aplikacji w zasobniku: zobacz Konfiguracja agenta. Konfiguracja otwiera się sama po instalacji. Jeśli się nie otworzy, otwórz Omnilinker ERP Sync z menu Start.

​
Zaktualizuj agenta

Agent aktualizuje się sam. Usługa sprawdza, czy jest nowa wersja, 5 minut po uruchomieniu, a potem co 4 godziny. Gdy ją znajdzie, od razu ją pobiera i instaluje w nocy, między 01:00 a 05:00 czasu lokalnego, gdy agent nie wykonuje żadnego polecenia. Potem się zatrzymuje, a Windows po kilku sekundach uruchamia nową wersję. Aktualizacja wykonuje te same kroki co instalator, więc usługa, grupa operatorów i uruchamianie aplikacji w zasobniku przy logowaniu zostają na miejscu. Aplikacja w zasobniku zamyka się na czas podmiany plików. Usługa uruchamia ją ponownie dla każdego, kto jest zalogowany. Co aktualizacja zachowuje, a co zastępuje:
  • Połączenie, jego ustawienia, lokalna baza danych agenta i logi zostają zachowane. Są przechowywane poza folderem instalacji.
  • appsettings.json w folderze instalacji zostaje zastąpiony plikiem nowej wersji. Zmieniane wartości ustaw zamiast tego jako zmienne środowiskowe komputera. Zobacz Zmień ustawienie.
Aby wyłączyć automatyczne aktualizacje, ustaw AutoUpdateEnabled na false. Zobacz Aktualizacje. Aplikacja w zasobniku pokazuje wersję i pobraną aktualizację w Ustawienia… > Aktualizacje: Sprawdź teraz szuka aktualizacji, a Zainstaluj teraz instaluje ją, gdy tylko nic nie będzie synchronizowane. Zobacz Ustawienia. Aby zaktualizować agenta ręcznie, otwórz MSI nowej wersji. Zastępuje ono zainstalowaną wersję: usługa i aplikacja w zasobniku uruchamiają się ponownie w nowej wersji, a Twoja konfiguracja zostaje zachowana.

​
Przejdź z wcześniejszej wersji

Zainstaluj nową wersję na starej, jak w sekcji Zaktualizuj agenta albo nowym MSI. Potem sprawdź:
  • Połącz agenta ponownie, jeśli otworzy się konfiguracja. Agent odczytuje teraz połączenie tylko z %ProgramData%\Omnilinker\ErpSync. Komputer połączony przez starszą wersję, która trzymała połączenie gdzie indziej, po aktualizacji otwiera konfigurację: połącz go ponownie nowym kodem z Połącz komputer.
  • Wapro: sprawdź numer firmy. W aplikacji w zasobniku otwórz Ustawienia… > Zmień… i wpisz Numer firmy, jeśli jest pusty (zwykle 1). Formularz połączenia teraz go wymaga, ale po aktualizacji nic o niego nie pyta, a bez niego agent nie odczytuje żadnych list, mimo że jego testy przechodzą. Zobacz Numer firmy.
  • Raz kliknij Odśwież listy na karcie Przegląd połączenia w Omnilinkerze, żeby powiązania produktów powstały z listy produktów ERP. Zobacz Listy i mapowania.
  • Usuń starą lokalną bazę danych, jeśli chcesz. Wcześniejsze wersje trzymały kolejkę w erpsync.db, w C:\Windows\System32\config\systemprofile\AppData\Local\Omnilinker\ErpSync (albo w folderze profilu konta, na którym działała stara usługa). Agent już jej nie odczytuje, więc możesz usunąć ten folder.
  • Skrypty korzystające z lokalnego API przestają działać. Wcześniejsze wersje odpowiadały pod http://localhost:5555. Agent nie otwiera już żadnego portu sieciowego; zamiast tego korzystaj z karty Komputer i konektor połączenia i plików logów agenta.
Bardzo stare wersje instalowały się w profilu osoby instalującej i potrzebowały skryptu install-service.ps1. Zamknij starą aplikację w zasobniku, uruchom uninstall-service.ps1 ze starego folderu instalacji w PowerShell uruchomionym jako administrator, odinstaluj starą wersję w Ustawienia > Aplikacje > Zainstalowane aplikacje, a potem zainstaluj agenta i połącz go kodem.

​
Usuń agenta

1

Odinstaluj aplikację

Otwórz Ustawienia > Aplikacje > Zainstalowane aplikacje (w Windows 10: Aplikacje i funkcje) i odinstaluj Omnilinker ERP Sync. Potrzebujesz zgody administratora.Windows może poinformować, że potrzebne będzie ponowne uruchomienie, bo usługa działa z plików, które usuwa. Wybierz OK; nie musisz uruchamiać komputera ponownie. Usługa zauważa, że jej plików już nie ma, i usuwa się w ciągu pół minuty: wyrejestrowuje usługę Windows, wyłącza uruchamianie aplikacji w zasobniku przy logowaniu i usuwa resztę folderu instalacji. Aplikacja w zasobniku zamyka się sama.
2

Usuń dane lokalne (opcjonalnie)

Odinstalowanie zachowuje folder danych agenta, %ProgramData%\Omnilinker\ErpSync, na potrzeby wsparcia i na wypadek ponownej instalacji. Zawiera zaszyfrowane połączenie (credentials.dat), lokalną bazę danych agenta (agent.db), zapisaną kopię konfiguracji i pliki logów. Nowa instalacja na tym komputerze startuje połączona z tym, co wskazuje credentials.dat.Usuń ten folder, jako administrator, jeśli nie zamierzasz ponownie instalować agenta na tym komputerze albo jeśli ponownie zainstalowanego agenta połączysz z innym połączeniem. Jeśli wcześniejsza wersja pozostawiła C:\Windows\System32\config\systemprofile\AppData\Local\Omnilinker\ErpSync, możesz usunąć także ten folder.
3

Usuń grupę operatorów (opcjonalnie)

Odinstalowanie celowo zachowuje grupę Omnilinker ERP Sync Operators, żeby ponownie zainstalowany agent zachował swoich operatorów. Aby ją usunąć, uruchom w PowerShell jako administrator:
Aby zatrzymać kopię agenta, do której nie masz dostępu, wyłącz połączenie w Omnilinkerze albo połącz nowym kodem inny komputer: zobacz Zatrzymaj komputer.

​
Uruchom agenta jako program konsolowy (wsparcie)

Wsparcie Omnilinkera może uruchomić agenta jako program konsolowy, na potrzeby pilotażu albo diagnozy problemu, zamiast jako usługę Windows. Program konsolowy nie działa jako Lokalny system, więc nie może zapisywać w %ProgramData%\Omnilinker\ErpSync. Potrzebuje wtedy zmiennej środowiskowej OMNILINKER_ERPSYNC_DATA_ROOT ustawionej na bezwzględną ścieżkę folderu, w którym może zapisywać; bez niej zatrzymuje się przy starcie i podaje nazwę zmiennej. Zainstalowana usługa nigdy nie używa tej zmiennej. Nie ustawiaj jej dla usługi.

​
Kopia przenośna (ZIP)

Pakiet zawiera też install-service.ps1 i uninstall-service.ps1, przeznaczone dla kopii rozpakowanej z pliku ZIP zamiast zainstalowanej instalatorem. Gdy tylko możesz, używaj instalatora. Skrypt tylko rejestruje usługę (jako Lokalny system, z automatycznym uruchamianiem, ponownym uruchomieniem po awarii i nazwą wyświetlaną Omnilinker ERP Sync Service). Nie tworzy grupy operatorów, nie ogranicza dostępu do folderu danych i nie uruchamia aplikacji w zasobniku przy logowaniu. Bez grupy agenta może zmieniać tylko administrator, który uruchomił aplikację w zasobniku z podwyższonymi uprawnieniami. Rozpakuj kopię do folderu poza wszystkimi profilami użytkowników, na przykład C:\Program Files\Omnilinker\ErpSync, a potem uruchom z tego folderu w PowerShell jako administrator:
uninstall-service.ps1 zatrzymuje usługę, czeka do 30 sekund na jej zatrzymanie (potem kończy proces) i ją usuwa.