Comarch Mobile

Instalacja aplikacji Comarch Mobile możliwa jest po wcześniejszym zainstalowaniu aplikacji Comarch ERP Auto Update (więcej informacji TUTAJ) oraz Comarch ERP Menadżer Kluczy (więcej informacji TUTAJ).

Wskazówka
Jeżeli użytkownik wybrał w prekonfiguracji Comarch ERP Auto Update opcję [Konfiguruj jako: Comarch Mobile] należy przejść do kroku Konfiguracja serwera.

Instalacja za pomocą Comarch ERP Auto Update

W celu zainstalowania aplikacji należy ręcznie dodać produkt Comarch Mobile. Aby to zrobić należy kliknąć prawym przyciskiem myszy na [Produkty], wybrać opcję [Dodaj produkt] i na rozwijalnej liście wskazać Comarch Mobile.

Dodaj produkt

W tym momencie do drzewa produktów zostanie dodana pozycja Comarch Mobile. Następnie należy kliknąć prawym przyciskiem myszy na nowo dodany produkt. Z listy komponentów należy wybrać Serwer synchronizacji oraz Aplikacja mobilna.

Dodanie komponentów

Konfiguracja serwera

W celu konfiguracji serwera należy kliknąć prawym klawiszem myszy na komponencie Serwer synchronizacji i wybrać opcję [Konfiguracja].

Następnie w wywołanym oknie należy podać dane niezbędne do poprawnego uruchomienia serwera Comarch Mobile.

Okno konfiguracji serwera

W polu Typ należy wybrać typ logowania usługi. Do wyboru są następujące opcje:

  • Użytkownik – logowanie do bazy danych odbywa się na określonego użytkownika. Po wybraniu tego typu logowania pola: Login i Hasło są aktywne.
Uwaga
Jeżeli podczas instalacji aplikacji Comarch Mobile została wybrana opcja Użytkownik, natomiast w logach Comarch ERP AutoUpdate pojawia się błąd, należy zmienić Typ na Lokalnie.
Uwaga
W przypadku wybrania opcji logowania Użytkownik należy pamiętać o tym, że dany login musi posiadać dostęp do serwera SQL oraz możliwość instalowania usług w systemie Windows.
    • Login – nazwa (login) użytkownika Windows, który posiada dostęp do serwera SQL oraz możliwość instalowania usług w systemie Windows. Na tym użytkowniku będzie działać serwer, umożliwiający wymianę danych pomiędzy serwerem SQL a aplikacją. Jeżeli jest to użytkownik domenowy, należy wprowadzić także jej nazwę (nazwa_domeny\nazwa_uzytkownika);
    • Hasło – hasło na użytkownika, którego podaliśmy w polu Login;
Uwaga
Istnieje możliwość logowania do usługi Comarch Mobile Server za pomocą użytkownika SQL (po zainstalowaniu aplikacji). Aby zmienić użytkownika, na którego jest wykonywane logowanie należy w pliku configuration.properties (domyślna lokalizacja: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji) dodać linijki:

user=nazwa_uzytkownika

password=hasło_użytkownika

Dodatkowo na usłudze Comarch Mobile Server na zakładce Logowanie należy ustawić: Logowanie jako: Lokalne konto systemowe. Po wykonaniu powyższego należy zapisać zmiany i ponownie uruchomić usługę serwera synchronizacji.

  • Lokalne konto systemowe – logowanie do bazy danych odbywa się przy użyciu konta, na którym działa usługa Comarch Mobile Server. Użytkownik, na którego dane następuje logowanie powinien mieć dostęp do tabel systemu Comarch ERP XL oraz prawa do tworzenia i modyfikacji tabel w bazie danych.
Po zapisaniu ustawień należy wrócić do okna głównego aplikacji Comarch ERP Auto Update i wybrać [Pobierz i instaluj].

Po wybraniu tej opcji nastąpi pobranie nowej wersji aplikacji Comarch Mobile z serwera Comarch, a następnie Agent przystąpi do instalacji programu. Pojawi się treść umowy licencyjnej, z którą należy się zapoznać oraz ją zaakceptować. Jeżeli umowa nie zostanie zaakceptowana instalacja zostanie przerwana. Aby kontynuować instalowanie produktu należy wybrać przycisk [Zatwierdź].

Akceptacja umowy licencyjnej

W tym momencie zainstalowane zostaną komponenty potrzebne do prawidłowej współpracy Comarch Mobile z systemem ERP. Po skończonej instalacji pojawi się poniżej przedstawiona informacja w oknie głównym aplikacji Comarch ERP Auto Update.

Zainstalowana wersja Comarch Mobile

Następnie trzeba zweryfikować, czy usługa serwera Comarch Mobile Server została uruchomiona poprawnie. W tym celu należy sprawdzić:

  1. czy w procesach Menedżera zadań systemu Windows znajduje się pozycja Java.exe;
  2. czy w pliku [log.txt] ostatnim wpisem jest [Server started…] – oznacza to, że wszystko zostało poprawnie skonfigurowane i uruchomione (plik ten znajduje się w folderze, w którym został zainstalowany serwer Comarch Mobile; domyślnie jest to lokalizacja: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji)
Wskazówka
W momencie, gdy konfiguracja jest nieprawidłowa i serwer nie został uruchomiony w logu znajdziemy informację [Server down]. Wówczas we wpisach bezpośrednio nad tą frazą znajdować się będzie informacja pozwalająca ustalić przyczynę problemu.

W przypadku pojawienia się błędu [Server down] należy zweryfikować przede wszystkim:

  • Czy w pliku [configuration.properties] zostały odpowiednio wypełnione dane odnośnie: serwera (z podaniem instancji poprzedzonej podwójnym znakiem „\”), nazwy bazy, dodatkowych parametrów oraz Menadżera Kluczy (plik configuration.properties powinien znajdować się w folderze, w którym został zainstalowany serwer Comarch Mobile; domyślnie jest to lokalizacja: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji)?
  • Czy została zainstalowana Java?
  • Która wersja Javy jest zainstalowana jako „domyślna”? – w tym celu należy otworzyć rejestr Windows (regedit) i przejść do wpisu: HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/services/ServerService/Parameters/Application. Należy zmodyfikować wartość [Application] i wpisać poprawną ścieżkę do Javy (np. C:\Program Files\Java\jre1.8.0_131\bin\java.exe).
  • Czy na zakładce Logowanie we właściwościach usługi Comarch Mobile Server zaznaczona jest opcja [To konto] i podane są właściwe dane do logowania lub w pliku [configuration.properties] jest wskazany użytkownik na którego usługa ma logować się do serwera SQL? Jeżeli na zakładce Logowanie usługi Comarch Mobile Server zostanie wskazane Lokalne konto systemowe, wówczas nastąpi logowanie do bazy przy użyciu konta, na którym działa usługa Comarch Mobile Server.
Właściwości usługi Comarch Mobile Server

Po wprowadzeniu poprawek należy ponownie uruchomić usługę Comarch Mobile Server.

Uwaga
W sytuacji, gdy na serwerze SQL znajdują się instancje, do poprawnego działania usługi Comarch Mobile Server wymagane jest uruchomienie serwisu SQL Server Browser.
Uwaga
Usługa Comarch Mobile Server do poprawnego uruchomienia wymaga włączonego serwera SQL. Przy restarcie komputera może zdarzyć się, że ta usługa będzie uruchamiała się przed nim, czego efektem będzie błąd w inicjalizacji serwera Comarch Mobile. Jeżeli serwer Comarch Mobile i serwer SQL są na tym samym komputerze można się przed tym zabezpieczyć odpowiednio ustawiając zależności. W tym celu należy ręcznie z linii poleceń dodać zależność do usługi Comarch Mobile Server:

Na właściwościach usługi Comarch Mobile Server należy wejść na zakładkę [Zależności] i sprawdzić, jakie zależności aktualnie obowiązują.

Jeżeli na serwerze SQL nie ma instancji oraz nie została ustalona zależność do SQL Servera to:

  • Należy odnaleźć na liście usług usługę SQL Server, która jest odpowiedzialna za instancję, na której znajduje się baza danych systemu ERP
  • Z właściwości usługi należy pobrać nazwę usługi
  • Następnie należy wykonać komendę z linii komend: sc config serverservice depend= „nazwa_usługi_sqlserver”
Jeżeli na serwerze SQL znajdują się instancje, ale nie ma ustanowionej zależności do SQL Browser, to wykonujemy polecenie: sc config serverservice depend = „MSSQLSERVER/SQLBrowser” (usunąć zależność można poleceniem: sc config serverservice depend= „”)
Uwaga
W sytuacji, gdy aplikacja Comarch Mobile została zainstalowana przez Comarch ERP Auto Update i w konfiguracji podano nieprawidłowe dane, wszelkich zmian dla bieżącej instalacji należy dokonywać w pliku [configuration.properties] (powinien on znajdować się w folderze, w którym został zainstalowany serwer Comarch Mobile; domyślnie jest to lokalizacja: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji).

Po dokonaniu zmian należy uruchomić ponownie usługę Comarch Mobile Server.

Zmiany dokonane w konfiguracji Comarch ERP Auto Update po zakończeniu instalacji będą dokonane na poczet przyszłych instalacji. W bieżącej instalacji nie zostaną dokonane żadne zmiany.

Instalacja aplikacji umożliwiającej pobranie wersji na urządzenie z Androidem

Po zainstalowaniu serwera aplikacji Comarch Mobile, należy na urządzeniu z Androidem zainstalować plik [0.Vendor.Installer.apk]. Plik ten znajduje się domyślnie w lokalizacji: C:\Program Files (x86)\Comarch Mobile\Aplikacja mobilna lub w pakiecie instalacyjnym pobranym ze stron walidowanych. Aplikacja ta umożliwia pobranie wersji Comarch Mobile na urządzenie mobilne.

Wskazówka
Aplikację Comarch Instalator można zainstalować na kilka różnych sposobów, m. in. poprzez wykorzystanie odpowiednich programów dołączanych przez producentów urządzeń (np. opcja [Instaluj aplikację] w HTCSync) lub wgranie pliku do pamięci telefonu i zainstalowanie jej z dowolnego Menedżera plików (np. Astro File Manager).
Uwaga
Przed zainstalowaniem aplikacji Comarch Instalator należy upewnić się, że urządzenie zezwala na instalowanie programów spoza Google Play (dawny Android Market). Aby sprawdzić ustawienia na smartfonie należy wybrać Ustawienia/Aplikacje (lub Ustawienia/Ekran blokady i zabezpieczenia) i zaznaczyć opcję Nieznane źródła.

Po zainstalowaniu [0.Vendor.Installer.apk] na urządzeniu w menu Aplikacje znajdzie się pozycja [Comarch Instalator]. 

Instalator aplikacji Comarch Mobile
Uwaga
Przed uruchomieniem programu Comarch Instalator należy upewnić się, że urządzenie z Androidem ma dostęp do komputera, na którym znajduje się wersja aplikacji Comarch Mobile. Jeżeli telefon podłączony do komputera przy pomocy kabla USB, to dla niektórych urządzeń trzeba wybrać specjalny typ połączenia – urządzenie nie może być podłączone jako karta SD. Wybór rodzaju połączeń umożliwiają programy dostarczane przez producenta urządzenia.

Po uruchomieniu aplikacji Comarch Instalator pojawi się okno, w którym należy uzupełnić poniżej zaprezentowane dane:

Wprowadzenie danych potrzebnych do pobrania wersji

Login i hasło operatora systemu Comarch ERP XL to dane operatora, który jest przypisany do oddziału Comarch Mobile (więcej informacji na ten temat TUTAJ).

Następnie powinno pojawić się okno dostępnych aktualizacji.

Pobieranie aplikacji na urządzeniu – dostępne aktualizacje

Aby uruchomić aplikację należy wybrać ikonę [Comarch Mobile] w menu [Aplikacje]:

Po naciśnięciu na ikonę aplikacji pojawi się Kreator, który poprowadzi użytkownika poprzez proces pierwszego uruchomienia programu. Kreator składa się z kroków zaprezentowanych poniżej.

Krok 1 – ekran powitalny aplikacji

Krok 1 – tworzenie bazy mobilnej

Krok 2 – wybór trybu konfiguracji aplikacji

W zależności od preferencji oraz od tego, w jakim modelu działa Klient istnieje możliwość wyboru trybu konfiguracji aplikacji. Do wyboru są opcje zaprezentowane poniżej.

Krok 2 – wybór trybu konfiguracji aplikacji
  • Wybór opcji: Łączę się z serwerem w mojej firmie
  • Wybór opcji: Wykupiłem usługę w modelu ASP – opcja dostępna tylko przy współpracy z Comarch ERP Optima
  • Wybór opcji: Sam dokonam właściwej konfiguracji
Po wyborze opcji: Sam dokonam odpowiedniej konfiguracji nastąpi przejście do ustawień aplikacji.

Dla Klientów, którzy posiadają serwer w swojej firmie, należy uzupełnić poniższe dane.

Konfiguracja aplikacji

Adresy pomocnicze serwera umożliwią szybką zmianę adresu serwera w zależności od lokalizacji, w jakiej znajduje się Przedstawiciel handlowy (przykładowo w sieci wewnętrznej firmy adres IP serwera może być inny niż adres IP serwera widoczny na zewnątrz firmy).

Po wykonaniu powyższych czynności można wyjść z okna ustawień (przycisk [Powrót] na urządzeniu), zalogować się do aplikacji i wykonać pierwszą synchronizację.

Krok 3 – uzupełnienie adresu serwera

Krok 3 – wpisanie adresu serwera

Krok 4 – uzupełnienie nazwy użytkownika i hasła

Krok 4 – uzupełnienie nazwy użytkownika i hasła

Krok 5 – zakończenie konfiguracji i wykonanie synchronizacji

W kroku 5 należy nacisnąć przycisk [Dalej] – nastąpi zakończenie konfiguracji i zostanie wykonana pierwsza synchronizacja.

Krok 5 – zakończenie konfiguracji i wykonanie synchronizacji
Uwaga
Podczas wykonywania pierwszej synchronizacji konieczne jest, aby wszystkie obiekty się przesynchronizowały (obiekt zaznaczony kolorem zielonym, pasek realizacji kolorem niebieskim). Jeśli chociaż jeden z elementów nie zostanie przesynchronizowany, wówczas po otwarciu aplikacji pojawią się tylko 3 kafelki (Ustawienia, Stan, Synchro).
Widok prawidłowego przebiegu synchronizacji

Szyfrowanie bazy danych

Aplikacja Comarch Mobile umożliwia szyfrowanie bazy danych. Ustawienie szyfrowania sprawdzane jest podczas każdej synchronizacji. Jeżeli szyfrowanie bazy zostało ustawione jako wymagane i aplikacja wykryje, że baza nie jest zaszyfrowana, wówczas na ekranie urządzenia mobilnego zostanie wyświetlony komunikat:

Komunikat informujący o konieczności szyfrowania bazy danych

Po wystąpieniu komunikatu należy kliknąć w przycisk [OK] – nastąpi automatyczne zaszyfrowanie bazy danych. Po zakończeniu szyfrowania synchronizacja uruchomi się automatycznie.

Ustawienia szyfrowania są zapisane domyślnie w pliku C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods\encryption.configuration. Parametr encrypted może przyjąć odpowiednio wartość 0 – szyfrowanie wyłączone, 1 – szyfrowanie włączone.

Uwaga
Z poziomu programów do zarządzania bazami danych SQLite nie ma możliwości otworzenia bazy zaszyfrowanej- wówczas pojawi się komunikat o błędzie. Odszyfrowanie bazy może nastąpić jedynie przez: synchronizację, usunięcie bazy, zmianę w ustawieniu parametru (wpisanie wartości „0”), ponowne otwarcie aplikacji i przeprowadzenie synchronizacji.

Czy ten artykuł był pomocny?