Wstęp

Dokument opisuje instalację aplikacji Integrator Comarch ERP XL z Comarch APS w wersji 2024.1. Wersja ta współpracuje z aplikacją Comarch APS 2024.1 oraz Comarch ERP XL w wersji 2024.1 oraz 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_2024_1.exe znajdujący się w paczce plików instalatora Integratora Comarch ERP 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ąć , 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 powyższych danych należy nacisnąć przycisk , aby sprawdzić połączenie z serwerem. Po nawiązaniu połączenia, należy wybrać z listy bazę danych Comarch ERP XL w wersji zgodnej z wersją instalowanej aplikacji Comarch APS.

Po wprowadzeniu wszystkich danych, należy nacisnąć przycisk .

Wybór bazy danych Comarch ERP XL

W następnym ekranie z listy dostępnych baz należy wybrać odpowiednią bazę danych.

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 są prawidłowe 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 Zainstalowane aplikacje (Dodaj i usuń programy)

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

Aby odinstalować aplikację 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 odinstalowania aplikacji.

Aby zamknąć okno deinstalacji należy nacisnąć .

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

Aby zweryfikować dane dotyczące 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 2024.1\appsettings.json”).

W pliku znajdują się informacje odnośnie:

• Portu, na którym uruchamiana jest witryna Integrator Comarch ERP XL z Comarch APS :

• Nazwę serwera bazy danych

• Wskazaną do pracy bazę danych

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 należy go zmienić wybierając opcję Uruchom (punkt 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ę:

Ponowne uruchamianie usługi XLAPSIntegration

Aby ponownie uruchomić usługę 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

Aby uruchomić usługę 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”.