Wstęp

Dokument opisuje instalację aplikacji Integrator Comarch ERP XL z Comarch APS w wersji 2025.0. Wersja ta współpracuje z aplikacją Comarch APS 2025.0 oraz Comarch ERP XL w wersjach 2025.0 i 2024.1 wraz z jej aktualizacjami HF.

Wymaganie systemowe

Do pracy z aplikacją Integrator Comarch ERP XL z Comarch APS potrzebne są:

Instalowanie Integratora Comarch ERP XL z Comarch APS

Uruchomienie instalatora

Należy uruchomić plik: XLIntegrator_2025_0.exe znajdujący się w paczce plików instalatora Integratora Comarch ERP XL z Comarch APS.

W oknie powitalnym należy wybrać opcję .

Weryfikacja zainstalowania dodatków

Instalator weryfikuje czy są zainstalowane wszystkie niezbędne dodatki w wymaganej wersji, tj.:

Brakujące dodatki domyślnie są zaznaczone na liście, a ich instalacja zostanie zainicjowana po naciśnięciu przycisku . W osobnym oknie podniesiony zostanie instalator dodatku, przez który należy przejść akceptując wymagania licencyjne i wybierając domyślne ustawienia.

Gdy instalacja dodatków zakończy się, nastąpi przekierowanie do okna powitalnego instalatora.

Należy nacisnąć przycisk , aby przejść do następnego kroku.

Konfigurowanie aplikacji

Aplikacja Integrator Comarch ERP XL z Comarch APS zostanie zainstalowana jako lokalna witryna dostępna pod wskazanym portem. Podczas konfiguracji ww. witryny należy zdefiniować port witryny, pod jakim będzie uruchamiana, np. 1026.

Następnie konfiguruje się folder docelowy, w którym zostanie zainstalowana aplikacja Integrator Comarch ERP XL z Comarch APS.

Po wykonaniu opisanych wyżej czynności, należy nacisnąć przycisk .

Parametry połączenia do bazy danych

W kolejnym kroku zostaną wykonane czynności polegające na wskazaniu serwera baz danych, typu połączenia i bazy Comarch ERP XL, z którą będzie współpracował Integrator Comarch ERP XL z Comarch APS.

Parametry połączenia dla bazy Microsoft SQL Server

Chcąc zainstalować Integrator Comarch ERP XL z Comarch APS na bazie znajdującej się na serwerze MS SQL należy:

Po wskazaniu wszystkich danych, należy nacisnąć przycisk , aby sprawdzić połączenie z serwerem.

Wybór bazy danych Comarch ERP XL

Po nawiązaniu połączenia z serwerem, w następnym ekranie należy wybrać z listy bazę danych Comarch ERP XL w wersji zgodnej z wersją instalowanej aplikacji Comarch APS.

Po wskazaniu bazy danych, należy nacisnąć przycisk .

Połączenie z serwerem klucza

W tym kroku należy uzupełnić dane dla połączenia z serwerem SQL, na którym zmapowany jest Comarch ERP Menadżer Kluczy z kluczem z licencją na Comarch APS:

Instalacja

W oknie podsumowującym należy zweryfikować poprawność uprzednio wprowadzonych danych. Jeżeli dane są prawidłowe, to należy wybrać przycisk .

Kolejne okno informuje o postępie instalacji aplikacji Integrator Comarch ERP XL z Comarch APS.

Zakończenie instalacji

Po prawidłowym zakończeniu, pojawi się ekran informujący o pomyślnym zakończeniu instalacji aplikacji.

Należy nacisnąć przycisk , co spowoduje zamknięcie okna instalatora.

Wraz z aplikacją, automatycznie instalowany jest też współpracujący z nią proces XLAPSIntegration.exe. To, czy proces został zainstalowany i uruchomiony można zweryfikować z poziomu menadżera zadań systemu Windows, na zakładce [Szczegóły].

Deinstalacja Integratora Comarch ERP XL z Comarch APS

Odinstalowanie Integratora Comarch ERP XL z Comarch APS z poziomu okna Aplikacje i funkcje (Dodaj lub usuń programy)

Zainstalowana aplikacja Integrator Comarch ERP XL z Comarch APS widoczna jest w oknie Aplikacje i funkcje (Dodaj lub usuń programy).

W celu odinstalowania aplikacji Integrator Comarch ERP XL z Comarch APS, należy odnaleźć ją na liście i wybrać opcję Odinstaluj.

Odinstalowanie Integratora Comarch ERP XL z Comarch APS przy użyciu instalatora

Odinstalowanie aplikacji Integrator Comarch ERP XL z Comarch APS jest możliwe również przy użyciu instalatora. Przy ponownym uruchomieniu instalatora, tj. pliku XLIntegrator.exe, pojawia się okno odinstalowania aplikacji.

Należy wybrać opcję , co spowoduje rozpoczęcie procesu deinstalacji aplikacji Integrator Comarch ERP XL z Comarch APS.

W ostatnim oknie wyświetla się informacja o zakończeniu procesu odinstalowania aplikacji.

W celu zamknięcia okna deinstalacji, należy nacisnąć przycisk .

Wskazówki do zarządzania aplikacją

Analiza komunikatów informacyjnych, ostrzeżeń oraz komunikatów o błędach

Aby dostać się do dziennika systemu Windows należy uruchomić aplikację Podgląd zdarzeń.

W aplikacji należy rozwinąć Dzienniki systemu Windows.

Następnie wskazać pozycję Aplikacja. Pojawi się lista, na której między innymi wyświetlane są błędy związane z uruchamianymi na stanowisku aplikacjami.

Konfiguracja witryny Integratora Comarch ERP XL z Comarch APS

W celu zweryfikowania danych dotyczących konfiguracji witryny Integrator Comarch ERP XL z Comarch APS, należy przejść do pliku appsettings.json, który znajduje się w folderze instalacyjnym aplikacji (domyślna lokalizacja: „C:\Program Files (x86)\Integrator Comarch ERP XL z Comarch APS 2025.0\appsettings.json„).

W pliku znajdują się informacje odnośnie:

Weryfikacja działania usługi z poziomu harmonogramu zadań oraz menedżera zadań

W Harmonogramie zadań możemy zweryfikować stan usługi XLAPSIntegration. Do poprawnego działania aplikacji Integrator Comarch ERP XL z Comarch APS jej stan powinien mieć status Działa. W przypadku, gdy status stanu jest inny, niż Działa, wtedy należy go zmienić, wybierając opcję Uruchom (podrozdział 5.4 Ponowne uruchamianie usługi XLAPSIntegration).

W Menedżerze zadań możemy również sprawdzić, czy Integrator Comarch ERP XL z Comarch APS został uruchomiony. Do poprawnego działania aplikacji Integrator Comarch ERP XL z Comarch APS na liście powinien pojawić się proces XLAPSIntegration.exe.

Ponowne uruchamianie usługi XLAPSIntegration

W celu ponownego uruchomienia usługi XLAPSIntegration w harmonogramie zadań, należy najpierw na liście znaleźć usługę XLAPSIntegration. Następnie z menu kontekstowego dla wiersza wybrać opcję Zakończ. Stan usługi zostanie zmieniony z Działa na Gotowy.

Daną usługę można również zamknąć w programie Harmonogram zadań poprzez naciśnięcie opcji Zakończ w prawej części okna. Należy najpierw na liście znaleźć usługę XLAPSIntegration, a następnie w prawej dolnej części okna w sekcji Wybrany element wybrać opcję Zakończ. Stan usługi zostanie zmieniony z Działa na Gotowy.

W celu uruchomienia usługi XLAPSIntegration, należy znaleźć ją na liście w Harmonogramie zadań. Po jej wskazaniu należy z menu kontekstowego wybrać opcję Uruchom. Stan usługi zostanie zmieniony z Gotowy na Działa.

XLAPSIntegration można również ponownie uruchomić w programie Harmonogram zadań poprzez naciśnięcie opcji Uruchom w prawej części okna. Stan usługi zostanie zmieniony z Gotowy na Działa.