Dokumentacja Użytkownika Systemu Obszar: Comarch ERP Auto Update Dokumentacja Użytkownika Systemu Obszar: Comarch ERP Auto Update
Copyright 2016 COMARCH SA Wszelkie prawa zastrzeżone Nieautoryzowane rozpowszechnianie całości lub fragmentu niniejszej publikacji w jakiejkolwiek postaci jest zabronione. Wykonywanie kopii metodą kserograficzną, fotograficzną, a także kopiowanie na nośniku filmowym, magnetycznym lub innym, powoduje naruszenie praw autorskich niniejszej publikacji. 2
Spis treści Wstęp... 4 1. Wymagane komponenty... 4 2. Instalacja Comarch ERP Auto Update... 6 3. Konfiguracja Comarch ERP Auto Update... 9 3.1 Prekonfiguracja produktu Comarch ERP Auto Update... 9 3.2 Struktura agentów w Comarch ERP Auto Update... 11 3.2.1 Konfiguracja Comarch ERP Auto Update dla agenta głównego... 11 3.2.2 Dodawanie agentów podrzędnych... 16 3.2.2.1 Pobieranie agentów ze struktury firmy... 17 3.2.2.2 Zdalna aktualizacja agentów podrzędnych... 21 3.2.3 Konfiguracja Comarch ERP Auto Update dla agenta podrzędnego... 22 3.3 Profile 23 3.3.1 Konfiguracja profile dodatkowego... 24 4. Konfiguracja i instalacja Menadżera Kluczy... 26 5. Konfiguracja i instalacja systemu... 28 5.1 Pobieranie i instalacja... 28 5.1.1 Konfiguracja konwersji cech... 30 5.1.2 Konwersja struktury praw... 32 5.2 Konfiguracja produktu... 32 5.2.1 Konfiguracja baz... 33 5.2.2 Konfiguracja usługi licencjonowania... 35 5.2.3 Konfiguracja modułów... 36 5.2.4 Konfiguracja wyszukiwarki... 36 5.2.5 Konfiguracja usługi danych DataService... 37 5.2.6 Konfiguracja rozszerzeń usługi danych... 38 5.2.7 Konfiguracja synchronizacji z Comarch ERP XL... 39 5.2.8 Konfiguracja synchronizacji z e-sklep/wszystko.pl... 40 5.2.9 Zarządzanie usługami... 41 6. Konfiguracja Centrali Retail i oddziałów dla produktu Comarch Retail... 42 6.1 Pobieranie i instalacja Comarch Retail... 42 6.2 Konfiguracja jako Centrala Retail... 42 6.3 Konfiguracja Retail Backoffice Serwer do pierwszej synchronizacji... 45 6.4 Konfiguracja serwera i klienta usług biznesowych... 47 7. Poprawki... 48 7.1 Instalacja lokalna... 48 7.2 Instalacja zdalna... 50 7.3 Zgodność zainstalowanych poprawek w strukturze agentów... 52 8. Dodatki... 54 8.1 Instalacja lokalna... 54 8.2 Instalacja zdalna... 56 8.3 Kreator dodatków... 57 8.3.1 Konfiguracja dodatku... 60 8.3.2 Wybór akcji... 61 8.3.3 Definiowanie zachowania procesów i usług... 61 8.3.4 Edycja manifestu... 62 8.3.5 Instalacja dodatkowych języków za pomocą kreatora dodatków... 64 9. Lista portów dla instalacji / Retail w ramach Profilu głównego... 67 Spis rysunków... 68 3
Wstęp Comarch ERP Auto Update jest aplikacją, która pozwala m. in. na instalację, aktualizację oraz dezinstalację najnowszych wersji różnych produktów Comarch ERP w środowisku rozproszonym. Produkty dostępne do instalacji to: /Retail Comarch ERP Mobile Magazyn Comarch ERP Mobile Sprzedaż Comarch ERP Mobile Flota Comarch WMS Comarch ERP Menadżer Kluczy Comarch ERP Narzędzia Comarch ERP Mobile Kierownik Sprzedaży W niniejszej dokumentacji zostały zawarte instrukcje instalacji produktów, Comarch Retail, Comarch ERP Menadżer Kluczy i Comarch ERP Narzędzia, a także informacje na temat instalacji poprawek oraz rejestracji i instalacji dodatków. Szczegóły instalacji produktów Comarch ERP Mobile Magazyn, Comarch EPR Mobile Sprzedaż oraz Comarch ERP Mobile Flota zostały opisane odpowiednio w dokumentach Comarch ERP Mobile Magazyn Online Instalacja i konfiguracja, Comarch ERP Mobile Sprzedaż na platformę Android - Instalacja i konfiguracja oraz Comarch ERP Mobile Flota - Instalacja i konfiguracja, które są dostępne na Indywidualnych stronach Partnerów znajdujących się pod adresem: http://www.erp.comarch.pl/partnerzy/default.aspx?site=340. 1. Wymagane komponenty Instalator Comarch ERP Auto Update został udostępniony na Indywidualnych stronach Partnerów oraz na serwerze ftp1.support.comarch.pl. Aplikacja Comarch ERP Auto Update wymaga zainstalowania dodatkowych komponentów, o czym użytkownik zostanie poinformowany przez komunikat widoczny na Błąd! Nie można odnaleźć źródła odwołania.. Rys. 1 Automatyczna instalacja komponentów 4
Uwaga: Po instalacji komponentów może wystąpić konieczność ponownego uruchomienia komputera. Wymagane komponenty, instalowane razem z programem Comarch ERP Auto Update to: Microsoft.Net Framework 4.0 Microsoft SQL Server Compact 3.5 SP2 x64 Microsoft SQL Server Compact 3.5 SP2 x86 Microsoft SQL Server System CLR Types (w wersji 2008 SP3) Microsoft SQL Server Shared Management Objects (w wersji 2008 SP3) Uwaga: W przypadku braku któregokolwiek z komponentów instalator wyświetli komunikat o konieczności jego zainstalowania. Wszystkie komponenty, niezbędne do prawidłowego działania aplikacji, znajdują się w folderze Prerequisites, w katalogu Comarch ERP Auto Update umieszczonym na serwerze ftp1.support.comarch.pl. Przedstawione w dokumentacji produkty, Comarch Retail, Comarch ERP Menadżer Kluczy i Comarch ERP Narzędzia wykorzystują połączenie z serwerem bazy danych Microsoft SQL Server. Wymagania dotyczące serwera SQL zostały opisane w dokumencie i Retail Skalowalność sprzętowa. Uwaga: W celu optymalizacji działania systemu, przed przystąpieniem do jego konfiguracji zaleca się zapoznanie z dokumentem i Retail Skalowalność Sprzętowa oraz biuletynem technicznym - Wydajność i praca terminalowa. Przy konfiguracji serwera SQL należy zwrócić również uwagę na jego collation i język. Uwaga: Wspierane collation na serwerze SQL to SQL_Latin1_General_CI_AS i język angielski. W przypadku instalacji Comarch Retail collation dla centrali i oddziałów musi być jednakowe. 5
2. Instalacja Comarch ERP Auto Update Przed rozpoczęciem instalacji i konfiguracji systemu niezbędna jest poprawna instalacja i konfiguracja programu Comarch ERP Auto Update. W tym celu, należy pobrać i uruchomić plik instalatora. Plik ten dostępny jest na serwerze ftp1.support.comarch.pl w katalogu Pub w folderze Comarch ERP Auto Update oraz na Indywidualnych stronach Partnerów. Instalacja Comarch ERP Auto Update przebiega w kilku krokach. Po uruchomieniu pobranego instalatora, pojawi się okno instalacji. Rys. 2 Okno powitalne instalatora Comarch ERP Auto Update Pierwsze okno, powitalne, zawiera informację o działaniu instalatora. Jeżeli użytkownik zgadza się z informacjami zawartymi w tym miejscu, może przystąpić do instalowania produktu Comarch ERP Auto Update, wybierając [Dalej]. 6
Rys. 3 Okno umowy licencyjnej Kolejnym etapem jest zaakceptowanie warunków gwarancji i korzystania z oprogramowania Comarch ERP Auto Update. W celu przejścia do kolejnego etapu instalacji należy zapoznać się z treścią umowy i zaakceptować zawarte w niej warunki, a następnie przejść dalej. 7
Rys. 4 Wybór katalogu instalacyjnego Następnie należy wybrać ścieżkę instalacji Comarch ERP Auto Update. Możliwe jest zostawienie domyślnej ścieżki lub wybranie nowej za pomocą przycisku [Zmień ]. Aplikacja zawsze będzie instalowana dla wszystkich użytkowników systemu Windows. Proces instalacji może potrwać kilka minut, jej postęp będzie widoczny na pasku poniżej statusu widocznym na Rys. 5. Rys. 5 Postęp instalacji Comarch ERP Auto Update Po zakończeniu procesu instalacji produktu zostanie wyświetlone okno podsumowania widoczne na Rys. 6. 8
Rys. 6 Zakończenie instalacji Comarch ERP Auto Update Zamknięcie okna z zaznaczoną opcją Uruchom aplikację Auto Update spowoduje uruchomienie Comarch ERP Auto Update, co pozwoli przejść do konfiguracji programu. 3. Konfiguracja Comarch ERP Auto Update 3.1 Prekonfiguracja produktu Comarch ERP Auto Update Podczas pierwszego uruchomienia Comarch ERP Auto Update pojawi się okno wyboru języka interfejsu. Użytkownik ma możliwość wybrania języka aplikacji na czas trwania danej sesji programu lub zapamiętać wybór na stałe za pomocą parametru Zapamiętaj wybór widocznym na Rys. 7. Do wyboru są 4 wspierane języki: polski, angielski, niemiecki i francuski (domyślnie podpowiadany jest język systemu operacyjnego). Rys. 7 Okno wyboru języka 9
Po zatwierdzeniu wyboru języka pojawi się okno Prekonfiguracji. W przypadku konfiguracji wstępnej: Agenta głównego - należy pozostawić zaznaczony domyślnie parametr Podłącz tego agenta do serwera Comarch oraz uzupełnić pole Id klienta (dostarczone przez Comarch). Następnie należy określić konfigurację agenta (np. Konfiguruj jako: /Retail Centrala), od której zależeć będzie struktura produktów widoczna po instalacji programu Comarch ERP Auto Update na zakładce Konfiguracja. Rys. 8 Konfiguracja wstępna agenta głównego Uwaga: W celu zainstalowania wraz z komponentem Business Intelligence Server należy wybrać produkt, BI Server. Agenta podrzędnego - należy odznaczyć parametr Podłącz tego agenta do serwera Comarch oraz podać Kod agenta, który wcześniej został dodany do struktury agentów w agencie nadrzędnym. Dodatkowo należy podać dane niezbędne do połączenia z agentem nadrzędnym (tj. jego adres i port), do którego ma się łączyć agent podrzędny. Konfiguracja agenta podrzędnego opisana została w rozdziale 3.2.3 Konfiguracja Comarch ERP Auto Update dla agenta podrzędnego Rys. 9 Konfiguracja wstępna agenta podrzędnego 10
Zakończenie konfiguracji wstępnej otworzy okno aplikacji Comarch ERP Auto Update. W przypadku, gdy agent nie połączy się prawidłowo z agentem nadrzędnym, próba połączenia spowoduje pojawienie się komunikatu: Agent nie zarejestrował się u agenta nadrzędnego. Agent nie posiada wymaganych uprawnień. Należy je nadać u agenta nadrzędnego.. Może to oznaczać, że: Wpisane Id klienta jest nieprawidłowe Kod agenta nie został dodany do agenta nadrzędnego lub został usunięty Połączenie jest blokowane przez zaporę systemową/program antywirusowy 3.2 Struktura agentów w Comarch ERP Auto Update Program Comarch ERP Auto Update pozwala na stworzenie połączonej ze sobą struktury agentów zainstalowanych na różnych maszynach. Umożliwia to stworzenie sieci agentów, w której agent główny łączy się z serwerem Comarch, do niego zaś podłączane są agenty podrzędne, które mogą być równocześnie agentami nadrzędnymi dla kolejnych agentów podrzędnych. Ułatwia to rozsyłanie poprawek, dodatków oraz wersji programów w całej sieci. 3.2.1 Konfiguracja Comarch ERP Auto Update dla agenta głównego Agent główny w strukturze agentów łączy się zawsze do serwera Comarch znajdującego się pod adresem update.comarch.com. Jeżeli Comarch ERP Auto Update połączy się z serwerem nadrzędnym, taka informacja będzie widoczna w lewym dolnym rogu. Po dłuższym przytrzymaniu kursora nad ikoną zaznaczoną na Rys. 10 pojawi się informacja o statusie rejestracji Comarch ERP Auto Update. Rys. 10 Sprawdzanie statusu Comarch ERP Auto Update Konfigurację programu Comarch ERP Auto Update można uruchomić z poziomu Ekranu Głównego za pomocą przycisku [Konfiguracja] znajdującego się w lewym dolnym rogu okna. Drugim sposobem uruchomienia konfiguracji jest przejście na zakładkę Więcej, a następnie wybranie przycisku [Konfiguracja]. 11
Rys. 11 Lista przycisków Na zakładce Konfiguracja widoczne są zainstalowane produkty oraz ustawienia programu. Rys. 12 Okno zakładki Konfiguracja Z tego poziomu możliwa jest edycja ustawień (zalecane jest jednak pozostawienie domyślnych wartości): Folder pobierania katalog, do którego pobierane będą nowe wersje produktów oraz komponenty wymagane do poprawnej pracy zainstalowanych programów. Są one pobierane z serwera Comarch bądź bezpośrednio z agenta nadrzędnego. Do tego folderu będą również pobierane nowe wersje programu Comarch ERP Auto Update. Główny folder instalacyjny katalog, w którym będą instalowane nowe wersje produktów Folder kopii zapasowych katalog, w którym przechowywane są kopie zapasowe plików konfiguracyjnych produktów oraz kopie zapasowe konfiguracji Comarch ERP Auto Update Id klienta id klienta dostarczone przez Comarch 12
Połącz z agentem nadrzędnym adres hosta i port udostępniany przez agenta nadrzędnego. Dla agenta głównego należy pozostawić domyślne ustawienia. Automatycznie wycofaj zmiany w przypadku błędu ustawienie decydujące o tym, czy Comarch ERP Auto Update przywróci poprzednią wersję aplikacji, jeżeli w trakcie instalacji lub aktualizacji zostaną napotkane problemy Ilość otwartych połączeń dla agentów podrzędnych liczba oznaczająca maksymalną ilość otwartych połączeń dla agentów podrzędnych znajdujących się w strukturze sieci agentów podczas wykonywania masowych akcji zdalnych Usuń pobrane pliki parametr ten wykorzystywany jest przy odinstalowywaniu produktu. Jego zaznaczenie spowoduje usunięcie pobranych plików podczas dezinstalacji. Parametr ten można zmienić w kreatorze dezinstalacji lokalnej, jednak, gdy będzie ona wywołana zdalnie, dezinstalator pobierze ustawienie z konfiguracji agenta podrzędnego. Usuń kopie zapasowe konfiguracji zaznaczenie tego parametru spowoduje usunięcie kopii zapasowych konfiguracji podczas odinstalowywania produktu. Parametr ten można zmienić w kreatorze dezinstalacji lokalnej, lecz w przypadku, gdy będzie ona wywołana zdalnie dezinstalator pobierze to ustawienie z konfiguracji agenta podrzędnego. Aktualizuj automatycznie przy starcie programu z aznaczenie tego parametru spowoduje automatyczną aktualizację programu Comarch ERP Auto Update przy jego uruchomieniu, jeżeli będzie ona dostępna Uwaga: Po pierwszej instalacji zostaje zablokowana możliwość zmiany folderu pobierania. Po poprawnym zarejestrowaniu się u klienta nadrzędnego, blokuje się również możliwość edycji pola Id klienta. Pozostałe wartości pozostają modyfikowalne. W zależności od prekonfiguracji opisanej w rozdziale 3.1 Prekonfiguracja produktu Comarch ERP Auto Update, do drzewa produktów dodane zostaną domyślne produkty i komponenty (dla przykładu dla wybranej w konfiguracji /Retail Centrala domyślnym produktem będzie z komponentem Centrala Serwer oraz Comarch ERP Menadżer Kluczy z komponentem Comarch ERP Menadżer Kluczy). Rys. 13 Drzewo produktów 13
W celu dodania dodatkowego produktu należy kliknąć prawym przyciskiem myszy w gałąź Produkty następnie wybrać Dodaj produkt oraz produkt z listy pokazanej na Błąd! Nie można odnaleźć źródła odwołania.rys. 14. Dostępne produkty to: Comarch ERP Narzędzia Comarch ERP Mobile Kierownik Sprzedaży Comarch ERP Mobile Magazyn Comarch ERP Mobile Flota Comarch WMS Comarch ERP Mobile Sprzedaż Rys. 14 Dodawanie produktu Do produktu można również dodać komponenty. W tym celu należy prawym przyciskiem myszy kliknąć na produkt (np. ) i wybrać Dodaj komponent. Do wyboru są komponenty z rozwijanej listy przedstawionej na Rys. 15. 14
Rys. 15 Dodawanie komponentu Uwaga: Na jednym profilu nie może być jednocześnie zainstalowany dany komponent jako serwer i stanowisko. Taka konfiguracja nie jest wspierana, ze względu na to, że jest nieprawidłowa i jest przeznaczona wyłącznie do celów prezentacyjnych. Ponadto przy próbie dodania komponentu Retail Backoffice Serwer oraz Centrala Serwer na jednym profilu wyświetlony zostanie komunikat: Został już skonfigurowany komponent Centrala Serwer. Dodanie Retail Backoffice Serwer spowoduje konflikt usług. Usługa DataService, usługa BPM oraz usługa komunikatora i wyszukiwarki zostaną zainstalowane dla Retail Backoffice Serwer. Czy chcesz kontynuować? Różnica między komponentem serwerowym, a stanowiskowym jest taka, że razem z komponentem serwerowym instalują się usługi: Comarch ERP BPM Server Comarch ERP Messager service Comarch ERP Search service Comarch ERP Synchronization Headquarters/Backoffice Comarch ERP Business Services Comarch ERP.POS Data service Komponenty Retail Backoffice Serwer, Retail Backoffice Stanowisko, Retail POS są przeznaczone dla produktu Comarch Retail. 15
3.2.2 Dodawanie agentów podrzędnych W celu dodania nowych agentów podrzędnych, po zakończeniu konfiguracji produktu na agencie głównym należy uruchomić Comarch ERP Auto Update i przejść do Struktury agentów. Rys. 16 Struktura agentów Nowych agentów podrzędnych należy dodać za pomocą przycisku [Dodaj]. Rys. 17 Dodawanie agentów Po dodaniu agenta otworzy się okno Nowy agent. Należy w tym miejscu zdefiniować kod agenta oraz wybrać z rozwijanej listy jego konfigurację. Rys. 18 Nowy agent Po wybraniu poniższych profili konfiguracji zostaną przypisane agentowi podrzędnemu odpowiednie komponenty, które dodadzą się domyślnie do drzewa produktów w tym agencie: 1. HQMaster, POS Centrala Serwer oraz POS 2. HQMaster, POS, BI Server Centrala Serwer, POS oraz Business Intelligence Serwer 3. HQMaster Centrala Serwer 4. HQMaster, BI Server Centrala Serwer oraz Business Intelligence Serwer 16
5. BI Server Business Intelligence Serwer 6. HQ Centrala Stanowisko 7. HQ, POS Centrala Stanowisko oraz POS 8. BOMaster Backoffice Serwer 9. BOMaster, POS Backoffice Serwer oraz POS 10. BO Backoffice Stanowisko 11. BO, POS Backoffice Stanowisko oraz POS 12. POS POS Po dodaniu agenta podrzędnego będzie on widoczny w strukturze agentów. Rys. 19 Lista agentów Uwaga: Kod profilu agenta podrzędnego musi być taki sam, jak kod profilu agenta nadrzędnego. Informacja na temat profili znajduje się w rozdziale 3.3 Profile. 3.2.2.1 Pobieranie agentów ze struktury firmy Rys. 20 Pobierz ze struktury firmy Po wybraniu przycisku [Pobierz ze struktury firmy] wyświetlone zostanie okno logowania, w którym należy podać login i hasło użytkownika serwera SQL, nazwę serwera oraz nazwę bazy danych. 17
Rys. 21 Okno logowania Po zalogowaniu się do bazy danych, otworzy się okno konfiguracji oddziału. Są dostępne 3 opcje konfiguracji: Oddział i stanowiska POS na osobnych komputerach oznacza to, że oddział i wszystkie zdefiniowane dla niego stanowiska POS będą na osobnych maszynach Oddział oraz POS na jednym komputerze oznacza to, że oddział oraz stanowiska POS będą na jednej maszynie, natomiast pozostałe stanowiska POS, (jeżeli zostały zdefiniowane) będą na innych komputerach Nieokreślony oznacza to, że nie została jeszcze podjęta ostateczna decyzja, czy oddział i stanowisko POS będą na jednej maszynie. Wybrana konfiguracja będzie mogła być później modyfikowana. Rys. 22 Konfiguracja oddziału Po wybraniu konfiguracji można ją ustawić tylko dla konfigurowanego oddziału lub dla wszystkich oddziałów pobranych z bazy. Po skonfigurowaniu oddziałów pojawi się okno z pobranymi kodami agentów, w którym 18
można zatwierdzić poprawność konfiguracji lub anulować tworzenie struktury oddziałów w Comarch ERP Auto Update. Rys. 23 Sprawdzanie poprawności konfiguracji Po zatwierdzeniu konfiguracji dodani agenci podrzędni pojawią się na liście. Rys. 24 Lista agentów podrzędnych Po dodaniu agenta podrzędnego do struktury agentów w konfiguracji zostanie dodany nowa sekcja Konfiguruj usługę dla agentów podrzędnych widoczna na Rys. 25. 19
Rys. 25 Konfiguracja W polu host należy określić nazwę hosta będącego agentem nadrzędnym, zaś w polu Port określić port usługi służącej do zdalnego wywoływania akcji na agencie podrzędnym. 20
3.2.2.2 Zdalna aktualizacja agentów podrzędnych Przycisk [Aktualizuj wszystkich] znajdujący się w sekcji Zarządzanie siecią agentów pozwala na zdalną aktualizację wersji programu Comarch ERP Auto Update zainstalowanego na agentach podrzędnych. Agenci, posiadający nieaktualną wersję programu Comarch ERP Auto Update na liście, obok nazwy, oznaczeni są symbolem. Rys. 26 Zdalne aktualizowanie wszystkich agentów Aby zaktualizować zdalnie wersje programu Comarch ERP Auto Update należy wybrać przycisk [Aktualizuj wszystkich] z sekcji Zarządzanie siecią agentów. Po jego wybraniu przycisku Aktualizuj wszystkich pojawi się pasek postępu informujący o stanie aktualizacji agentów. Rys. 27 Postęp aktualizacji agentów Po poprawnym zaktualizowaniu się agentów, pojawi się komunikat informujący o zakończeniu aktualizacji. Rys. 28 Komunikat informujący o zakończeniu aktualizacji Po zakończeniu aktualizacji, symbol przy wersji agenta zmieni się na. 21
3.2.3 Konfiguracja Comarch ERP Auto Update dla agenta podrzędnego Po prekonfiguracji agenta podrzędnego opisanej w rozdziale 3.1 Prekonfiguracja produktu Comarch ERP Auto Update, instalacji programu Comarch ERP Auto Update oraz zarejestrowaniu go u agenta nadrzędnego, pojawią się przyciski akcji pobierania i instalacji. Rys. 29 Agent podrzędny W agencie głównym pojawi się natomiast informacja o zarejestrowaniu agenta podrzędnego w strukturze agentów. Rys. 30 Agent zarejestrowany Instalację komponentów dla agenta podrzędnego można wykonać analogicznie do rozdziału 5.1 Pobieranie i instalacja lub z poziomu agenta nadrzędnego w strukturze agentów. Zdalną instalację produktów można wykonać równocześnie dla kilku agentów podrzędnych. W tym celu za pomocą dostępnej checklisty można wybrać wszystkich agentów, na których mają być wykonywane akcje lub wybrać produkt, na którym mają zostać wprowadzone zmiany w całej sieci agentów. Następnie za pomocą przycisków z sekcji Akcje zdalne widocznej na Rys. 31 można zdalnie pobrać (najnowszą pobraną, bądź aktualnie zainstalowaną na agencie nadrzędnym wersję), zainstalować, wycofać ostatnio zainstalowaną wersję, odinstalować wybrane komponenty oraz przerwać wykonywaną akcję. Jeżeli wybrana akcja nie będzie dostępna na danym agencie, to zostanie ona pominięta. 22
Rys. 31 Akcje zdalne na agentach podrzędnych Uwaga: W przypadku pobrania najnowszej wersji komponentu, pobranej wcześniej na agencie nadrzędnym, jej instalacja będzie możliwa dopiero, gdy na agencie nadrzędnym zainstalowana zostanie ta sama wersja. Następnie należy dokonać konfiguracji programu na agencie podrzędnym za pomocą Konfiguratora Altum analogicznie do rozdziału 5.2 Konfiguracja produktu. 3.3 Profile W aplikacji Comarch ERP Auto Update została udostępniona funkcjonalność Profili, która umożliwia instalację kilku wersji produktów na jednej maszynie. Profil to zestaw konfiguracji, umożliwiający stworzenie niezależnego środowiska pracy. Wyróżniamy dwa rodzaje profili: Profil główny tworzony przy instalacji aplikacji Comarch ERP Auto Update. Podczas aktualizacji aplikacji Comarch ERP Auto Update dotychczasowa konfiguracja zostanie zmieniona w Profil główny. Profile dodatkowe profile tworzone przez użytkowników. Każdy profil posiada niezależną konfigurację, bazę lokalną programu, niezależne: katalog instalacyjny, katalog pobierania dodatków oraz poprawek, a także osobne porty pozwalające na instalację usług. Uwaga: Comarch ERP Auto Update może być uruchomiony tylko dla jednego profilu jednocześnie. 23
W ramach każdego profilu będą rejestrowane odrębne usługi dostosowane do instalowanych komponentów. Usługi działają w niezależnych i odseparowanych od siebie środowiskach. Dla profili dodatkowych do każdej usługi jest dodawany prefiks z kodem profilu (np. [profil1] Comarch ERP Business Services). 3.3.1 Konfiguracja profile dodatkowego W celu dodania i konfiguracji nowego profilu należy przejść na zakładkę Konfiguracja i wybrać przycisk [Profile]. Z tego poziomu widoczne są wszystkie, zdefiniowane wcześniej profile, co przedstawia Rys. 32. Rys. 32 Konfiguracja profili Następnie za pomocą przycisku [Dodaj] można dodać nowy profil. Po wybraniu przycisku, pojawi się formatka pokazana na Rys. 33. 24
Rys. 33 Formatka definiowania nowego profilu Podczas definiowania nowego profilu w sekcji Konfiguracja należy podać parametry: Nazwa profilu Kod profilu może składać się maksymalnie z 5 znaków i musi być unikalny Id klienta\kod Agenta w zależności, czy agent jest agentem nadrzędnym, czy podrzędnym będzie to Id klienta dostarczone przez firmę Comarch, lub Kod Agenta dodany wcześniej do agenta nadrzędnego Katalog instalacyjny katalog, w którym będą instalowane komponenty w ramach tworzonego profilu. Każdy profil musi mieć zdefiniowany osobny katalog instalacyjny. Domyślny język profilu Port bazowy określa port, który wraz z kolejnymi 99 portami zostanie zarezerwowany dla danego profilu. Jest on określany tylko dla agentów głównych. Dla pozostałych agentów ten sam zakres portów będzie rezerwowany przy pierwszym połączeniu z agentem głównym. Dodatkowo w sekcji Połączenie należy określić, czy definiowany profil ma się łączyć do serwera Comarch, czy ma być połączony jako agent podrzędny do innego agenta oraz określić port komunikacji. Z poziomu Konfiguracji profili można również usuwać profile. Usuwanie profili jest zablokowane dla: Profilu głównego Aktualnie aktywnego profilu Profilu, dla którego jest zainstalowany przynajmniej jeden komponent Za pomocą przycisku [Przełącz profil] można przełączyć aplikację do zaznaczonego profilu. Przełączanie profili wymaga restartu aplikacji. Po wybraniu tej akcji zostanie wyświetlony komunikat widoczny na Rys. 34. 25
Rys. 34 Komunikat przełączania profilu aplikacji Comarch ERP Auto Update Po zdefiniowaniu profilu dodatkowego podczas kolejnego uruchomienia aplikacji Comarch ERP Auto Update pojawi się okno wyboru profilu widoczne na Rys. 35. Rys. 35 Okno wyboru profilu Po wybraniu odpowiedniego profilu można zdecydować, czy profil, do którego użytkownik będzie się logować ma zostać oznaczony jako domyślny podczas logowania. Okno wyboru profilu jest wyświetlane, jeżeli: Został dodany przynajmniej jeden profil dodatkowy Żaden profil nie jest oznaczony jako domyślny podczas logowania Praca została zakończona na profilu innym niż domyślny Uwaga: Na profilu dodatkowym można instalować wersję produktów 2015.0 i wyższe. 4. Konfiguracja i instalacja Menadżera Kluczy Menadżer Kluczy jest narzędziem odpowiadającym za aktywację i pobieranie zakupionych modułów produktów Comarch ERP. W celu jego poprawnej instalacji należy w pierwszej kolejności dokonać konfiguracji komponentu. Można to zrobić z poziomu zakładki Konfiguracja w aplikacji Comarch ERP Auto Update. Po zaznaczeniu komponentu Comarch ERP Menadżer Kluczy uaktywni się przycisk konfiguracja. Innym sposobem przejścia do konfiguracji komponentu jest użycie prawego przycisku myszy na komponencie. 26
Rys. 36 Konfiguracja komponentu Po przejściu do konfiguracji Comarch ERP Menadżer Kluczy należy podać nazwę instancji serwera bazy danych, dla którego ma zostać on zainstalowany wraz z danymi do logowania na konto użytkownika z uprawnieniami administracyjnymi. Ponadto należy podać ID klienta, PIN oraz Numer klucza. Dodatkowo, możliwe jest podanie adresu e-mail wraz z zaznaczeniem, czy wysyłać powiadomienie, gdy klucz utraci kontakt z serwerami Comarch. Adres e-mail wraz z zaznaczonym lub odznaczonym parametrem zostanie przeniesiony po instalacji Menadżera Kluczy do jego konfiguracji. Rys. 37 Konfiguracja Comarch ERP Menadżer Kluczy Po skonfigurowaniu komponentu można przejść do jego pobierania i instalacji. Na Ekranie Głównym Comarch ERP Auto Update można wybrać jedną z dwóch opcji widocznych na Rys. 38: Pobierz 27
Pobierz i instaluj Rys. 38 Ekran Główny Po wybraniu przycisku [pobierz] produkt zostanie pobrany do katalogu wskazanego podczas konfiguracji programu Comarch ERP Auto Update. Domyślny folder to C:\Comarch ERP Auto Update\Downloads. Po zakończeniu pobierania zostanie uaktywniony przycisk [instaluj]. Natomiast po wybraniu opcji [pobierz i instaluj], produkt zostanie pobrany, a następnie automatycznie zostanie wywołana akcja instalacji. 5. Konfiguracja i instalacja systemu W celu instalacji systemu niebędącego oddziałem, należy do drzewa produktu dodać komponent Centrala Serwer lub Centrala Stanowisko. Dodawanie komponentów zostało opisane w rozdziale 3.2.1. Konfiguracja Comarch ERP Auto Update dla agenta głównego. Różnica między komponentami jest fakt, że razem z Centrala Serwer instalują się dodatkowo usługi: Comarch ERP BPM Service Comarch ERP Messanger service Comarch ERP Search service 5.1 Pobieranie i instalacja Po zakończeniu konfiguracji należy przejść do pobierania oraz instalacji systemu. Na Ekranie Głównym Comarch ERP Auto Update dla tego komponentu można wybrać jedną z dwóch opcji: Pobierz Pobierz i instaluj 28
Rys. 39 Ekran Główny Po wybraniu przycisku [pobierz] produkt zostanie pobrany i zapisany w katalogu zdefiniowanym w konfiguracji. Domyślna ścieżka to C:\Comarch ERP Auto Update\Downloads\. Po zakończeniu pobierania wyświetlony zostaje przycisk [instaluj]. Rys. 40 Instalacja Natomiast po wybraniu przycisku [pobierz i instaluj] program automatycznie zostanie pobrany, a następnie zostanie wyświetlony komunikat przedstawiony na Rys. 41 zawierający ostrzeżenia dotyczące procesu instalacji. Rys. 41 Komunikat z ostrzeżeniami 29
Po wybraniu opcji Tak pojawi się okno z Umową Licencyjną. Po przeczytaniu i akceptacji warunków umowy, nastąpi instalacja systemu. Rys. 42 Umowa licencyjna 5.1.1 Konfiguracja konwersji cech W przypadku aktualizacji systemu wykonywana jest konwersja baz danych firmowej i konfiguracyjnej. Jeżeli firmowa baza danych jest starsza niż wersja 6.0, może być wymagana dodatkowo konwersja cech. W związku z funkcjonalnością wielokulturowości w systemie, jeżeli na bazie znajdują się obiekty, których wartości w różnych kulturach językowych mają różną reprezentację i wymagają konwersji, zostanie ona wykonana również podczas aktualizacji. Przed wykonaniem konwersji cech, należy wykonać jej konfigurację. Można jej dokonać za pomocą przycisku [Konfiguracja] znajdującego się w sekcji Komponent bądź klikając prawym przyciskiem myszy na komponencie i wybierając opcję Konfiguracja. 30
Rys. 43 Konfiguracja komponentu Następnie w sekcji Konfiguracja konwersji cech można przejść do konfiguracji konwersji cech za pomocą przycisku [Konfiguruj]. Rys. 44 Konfiguracja konwersji cech W oknie konfiguracji konwersji wartości należy określić kulturę wprowadzania wartości. Można ją zdefiniować dla każdego obiektu osobno lub dla wszystkich jednocześnie. Do wyboru są 4 języki: polski, angielski, niemiecki, francuski. Taka konfiguracja musi zostać wykonana na agencie głównym, a następnie zostanie ona pobrana przez agentów podrzędnych. Rys. 45 Konwersja wartości zależnych od kultury wprowadzania 31
5.1.2 Konwersja struktury praw W wersji 2015.0, w systemie została wprowadzona możliwość obsługi wielu firm w jednej bazie danych. W przypadku aktualizacji systemu przy wykonywaniu konwersji baz danych z wersji systemu niższej niż 2015.0, należy zadecydować czy dotychczasowy węzeł główny ma nim pozostać, czy też ma zostać przekonwertowane na centrum typu Firmę. W związku z tymi zmianami podczas konwersji pojawi się komunikat pokazany na Rys. 46: Rys. 46 Konwersja struktury praw. Jeżeli dotychczasowe centrum główne pozostanie węzłem głównym (nadrzędnym), to nowo dodawane centra typu Firma będą w stosunku do niego podrzędne. W przypadku przekonwertowania centrum głównego na centrum typu Firma, zostanie dodany nowy węzeł główny, a nowo dodawane centra typu Firma umiejscowione będą w strukturze na tym samym poziomie, co dotychczasowe centrum główne. 5.2 Konfiguracja produktu W celu konfiguracji systemu, po jego zakończonej instalacji należy uruchomić Konfigurator, który domyślnie znajduje się w Menu Start w folderze Comarch ERP. Konfigurator można również uruchomić poprzez plik NewAltumConfigurator.exe znajdujący się w folderze instalacyjnym. Konfigurację odpowiednich komponentów można wykonać w dowolnym czasie. Po uruchomieniu Konfiguratora pojawi się okno wyboru języka. 32
Rys. 47 Wybór języka Po wybraniu języka, pojawi się okno konfiguracji baz przedstawione na Rys. 48. Rys. 48 Konfigurator Altum 5.2.1 Konfiguracja baz Jeżeli nie zostały wcześniej wykreowane bazy, to należy wykonać kreację na zakładce Kreacja baz. W tym celu należy podać nazwę serwera SQL, nazwy baz oraz dane do logowania do serwera. Ponadto można wybrać język 33
kreacji bazy oraz zdecydować, czy kontrahenci mają być podzieleni na dostawców i nabywców za pomocą opcji Pokaż dostawców i nabywców. Po wypełnieniu wszystkich pól należy wybrać przycisk [Wykreuj bazę]. Podczas kreacji bazy widoczny będzie pasek postępu. Rys. 49 Pasek postępu kreacji baz Po zakończeniu procesu kreacji baz zostanie wyświetlony komunikat widoczny na Rys. 50. Rys. 50 Komunikat aktualizacji konfiguracji usług W przypadku wybrania opcji Tak informacje o nazwie serwera, nazwie baz oraz danych do logowania zostaną przeniesione na zakładki konfiguracji usług. W przypadku, gdy bazy zostały wykreowane wcześniej, należy przejść na zakładkę Wybór baz i podać na niej nazwę serwera SQL, dane do logowania do serwera oraz wybrać nazwy baz z rozwijanej listy. Rys. 51 Konfiguracja baz: Wybór baz 34
Następnie należy sprawdzić poprawność danych za pomocą przycisków odświeżania. Stan powinien zmienić się na Poprawne. Rys. 52 Poprawność danych Po poprawnym skonfigurowaniu baz należy nacisnąć przycisk [Ustaw]. Uwaga: W przypadku, gdy ustawione są bazy w starszej wersji niż zainstalowana wersja systemu, to po wybraniu przycisku [Ustaw] możliwa będzie również konwersja baz. 5.2.2 Konfiguracja usługi licencjonowania Na zakładce Serwer klucza należy podać nazwę serwera, na którym został zainstalowany Comarch ERP Menadżer Kluczy oraz numer klucza licencyjnego. Dodatkowo należy określić typ aplikacji, jako dla centrali lub Comarch Retail dla oddziałów Retail. Rys. 53 Konfiguracja usługi licencjonowania Po wprowadzeniu odpowiednich wartości należy wybrać przycisk [Zapisz]. 35
5.2.3 Konfiguracja modułów Za pomocą konfiguracji modułów można podpinać/odpinać moduły UI oraz moduły biznesowe. Rys. 54 Konfiguracja modułów Po wprowadzeniu odpowiednich zmian należy je zapisać za pomocą przycisku [Zapisz]. Ten krok nie jest obowiązkowy. 5.2.4 Konfiguracja wyszukiwarki Na kolejnej zakładce można skonfigurować wyszukiwarkę. Należy podać nazwę serwera SQL, dane logowania do serwera oraz wybrać z listy nazwę bazy konfiguracyjnej. Po sprawdzeniu poprawności danych za pomocą przycisku odświeżania należy zapisać wprowadzone ustawienia przyciskiem [Zapisz]. 36
Rys. 55 Konfiguracja wyszukiwarki W przypadku pominięcia tego kroku, opcja wyszukiwarki w nie zostanie skonfigurowana. Istnieje jednak możliwość jej późniejszej konfiguracji. Dokładny opis konfiguracji wyszukiwarki w systemie znajduje się w Dokumentacji technicznej Comarch ERP Konfiguracja. 5.2.5 Konfiguracja usługi danych DataService Usługa danych Data Service odpowiada za transfer danych między bazą konfigurowanego komponentu a stanowiskiem POS. W celu jej skonfigurowania, należy przejść na zakładkę Usługa danych. Na zakładce należy podać nazwę serwera SQL, dane logowania do bazy danych oraz wybrać z listy odpowiednią firmową bazy danych. W sekcji Ogólne należy ustawić język oraz nazwę konfigurowanego centrum. Notyfikacja przetwarzania dokumentów umożliwia automatyczne wysyłanie wiadomości email, gdy wystąpi problem z przesłaniem dokumentu z pamięci podręcznej do bazy firmowej centrali lub oddziału. Aby skorzystać z tej funkcjonalności należy w sekcji Notyfikacja przetwarzania dokumentów podać adres odbiorcy, serwer SMTP, port serwera SMTP oraz dane do logowania do poczty. Dodatkowo za pomocą opcji SSL można zdecydować, czy wysyłana wiadomość ma być szyfrowana. Pozostałe wartości są wypełnione automatycznie i zalecane jest pozostawienie ustawień domyślnych. 37
Rys. 56 Konfiguracja usługi danych DataService Jeżeli do konfigurowanego stanowiska (centrali lub oddziału) nie będzie podłączane stanowisko POS, ten krok można pominąć. 5.2.6 Konfiguracja rozszerzeń usługi danych Konfigurator umożliwia dodanie modułów biznesowych API oraz modułów biznesowych usługi danych. Odpowiednie rozszerzenia można dodawać oraz konfigurować kolejność ich wczytywania. 38
Rys. 57 Konfiguracja rozszerzeń usługi danych Ten krok można pominąć, jeżeli operator nie chce wprowadzać zmian. Zakładki Serwer synchronizacji i Serwer usług biznesowych zostały opisane w rozdziale 6. Konfiguracja Centrali Retail I oddziałów dla produktu Comarch Retail. 5.2.7 Konfiguracja synchronizacji z Comarch ERP XL Ten krok należy pominąć, jeżeli na instalowanym środowisku nie jest dostępna synchronizacja z Comarch ERP XL. W celu skonfigurowania synchronizacji z Comarch ERP XL należy przejść na zakładkę Klient synchronizacji XL, a następnie podać dane serwera SQL, dane do logowania oraz nazwę firmowej bazy danych centrali Retail. 39
Rys. 58 Konfiguracja synchronizacji z Comarch ERP XL Następnie w sekcji Parametry należy podać ID oddziału, nazwę serwera SQL, lokalizację pliku wymiany, lokalizację folderu dla archiwalnych plików wymiany oraz domyślne rozszerzenie plików wymiany. 5.2.8 Konfiguracja synchronizacji z e-sklep/wszystko.pl Ten krok należy pominąć, jeżeli na instalowanym środowisku nie jest dostępna synchronizacja z e-sklep lub wszystko.pl. W celu skonfigurowania synchronizacji z e-sklep lub wszystko.pl należy przejść na zakładkę Klient synchronizacji z e-sklep/wszystko.pl, a następnie podać nazwę serwera SQL, dane do logowania oraz nazwę firmowej bazy danych Altum. Po wprowadzeniu danych zmiany należy zapisać za pomocą przycisku [Zapisz]. 40
Rys. 59 Konfiguracja synchronizacji z e-sklep/wszystko.pl 5.2.9 Zarządzanie usługami Na ostatniej zakładce Stan usług można zatrzymać, uruchomić, zainstalować lub odinstalować wcześniej skonfigurowane usługi. Instalacja i dezinstalacja usługi jest jednoznaczna z jej zarejestrowaniem i wyrejestrowaniem. Rys. 60 Zarządzanie usługami 41
6. Konfiguracja Centrali Retail i oddziałów dla produktu Comarch Retail System Comarch Retail jest systemem sprzedaży detalicznej. Pozwala na stworzenie sieci składającej się z Centrali Retail i odległych do niej oddziałów Retail. Konfigurację Centrali Retail wykonuje się od strony konfiguratora i instalatora Comarch ERP Auto Update analogicznie jak dla komponentu z tą różnicą, że należy skonfigurować również zakładki Serwer synchronizacji oraz Serwer usług biznesowych w celu umożliwienia synchronizacji z oddziałami oraz zakładkę Usługa danych w celu umożliwienia synchronizacji ze stanowiskiem POS. 6.1 Pobieranie i instalacja Comarch Retail Pobieranie i instalacja produktu Comarch Retail odbywa się analogicznie jak w przypadku i została opisana w rozdziale 5.1 Pobieranie i instalacja. Różnicą są instalowane komponenty. W przypadku Centrali Retail do drzewa produktów opisanego w rozdziale 3.2.1 Konfiguracja Comarch ERP Auto Update dla agenta głównego należy dodać komponent Centrala Serwer lub Centrala Stanowisko, a dla oddziału komponent Retail Backoffice Serwer lub Retail Backoffice Stanowisko. Należy pamiętać, że w przypadku instalacji komponentów jako stanowisko nie zostaną zainstalowane usługi: Comarch ERP BPM Server, Comarch ERP Messanger service, Comarch ERP Search service, Comarch ERP Synchronization Headquarters/Backoffice, Comarch ERP Business Services, Comarch ERP POS Data service, co oznacza, że nie będzie możliwości przeprowadzenia synchronizacji na tych maszynach. Instalację można wykonać lokalnie na stanowisku, gdzie zainstalowany jest agent podrzędny lub zdalnie z poziomu agenta nadrzędnego. 6.2 Konfiguracja jako Centrala Retail W celu skonfigurowania usługi synchronizacji dla Centrali Retail należy uruchomić Konfigurator i przejść na zakładkę Serwer Synchronizacji. Następnie w sekcji Baza danych podać Serwer SQL, na którym znajduje się firmowa baza danych, login SQL i hasło użytkownika posiadającego uprawnienia db_owner, a następnie z rozwijanej listy wybrać bazę firmową Centrali Retail. 42
Rys. 61 Konfiguracja serwera synchronizacji W sekcji Komunikacja znajduje się port usługi jest to port, na którym uruchamiana będzie usługa synchronizacji na centrali. W sekcji Parametry można dodatkowo zdefiniować parametry takie jak Język, Limit czasu będący timeoutem operacji wykonywanych na bazie, Interwał, czyli odstęp czasu oznaczający, co ile ma zostać uruchamiana synchronizacja i Backupy błędów, których liczba określa ilość backupów bazy zachowywanych w ibard24. Parametry te zostały dokładniej opisane w dokumentacji technicznej Comarch Retail Synchronizacja. Po zapisaniu zmian, w celu uruchomienia synchronizacji na Centrali Retail należy uruchomić / zrestartować usługę Comarch ERP Synchronization Headquarters. Można tego dokonać z poziomu usług (Rys. 62) lub za pomocą Konfiguratora, przechodząc na zakładkę Usługi i wybierając przycisk dla Serwera synchronizacji. 43
Rys. 62 Uruchomienie usługi Comarch ERP Synchronization Headquarters Synchronizację można również uruchomić w trybie konsolowym. W tym celu w katalogu gdzie została zainstalowana wersja należy uruchomić RetailSyncHQ.exe. Rys. 63 Uruchomienie RetailSyncHQ.exe 44
6.3 Konfiguracja Retail Backoffice Serwer do pierwszej synchronizacji Po instalacji komponentu Retail Backoffice Server należy za pomocą Konfiguratora wykreować bazę konfiguracyjną i firmową. Konfigurator produktu Comarch Retail znajduje się domyślnie w Katalogu Comarch Retail w folderze Comarch ERP w Menu Start. Kreacja baz odbywa się analogicznie jak dla produktu Comarch ERP Altum opisanym w rozdziale 5.2.1 Konfiguracja baz. W celu skonfigurowania usługi klienta synchronizacji należy uruchomić Konfigurator i przejść na zakładkę Klient synchronizacji. Następnie w sekcji Baza danych podać Serwer SQL, na którym znajduje się firmowa baza danych, login SQL i hasło użytkownika posiadającego uprawnienia db_owner, a następnie z rozwijanej listy wybrać bazę firmową oddziału Retail. Rys. 64 Konfiguracja klienta synchronizacji W sekcji Komunikacja dostępne są pola Serwer określające nazwę komputera, na którym uruchomiona jest usługa Comarch ERP Synchronization Headquarters, Port usługi, czyli port, na którym uruchomiona jest usługa na centrali oraz Port lokalny tj. port zdalnego wywoływania synchronizacji. Sekcja Parametry pozwala na określenie parametrów takich jak: Język logowania synchronizacji, Kod oddziału wprowadzony wcześniej w strukturze firmy w Centrali Retail, Limit czasu, czyli timeout operacji wykonywanych na bazie danych, Interwał synchronizacji (zalecana wartość 0 oznacza, że synchronizacja wywoływana jest wyłącznie od strony centrali), Długość kolejki, Opóźnienie i Backupy błędów. Parametry te zostały dokładniej opisane w dokumentacji technicznej Comarch Retail Synchronizacja. 45
Po zapisaniu zmian w celu umożliwienia synchronizacji od strony oddziału należy uruchomić / zrestartować usługę Comarch ERP Synchronization Backoffice. Rys. 65 Uruchomienie usługi Comarch ERP Synchronization Backoffice Alternatywnie synchronizację można uruchomić w trybie konsolowym. W tym celu w katalogu gdzie została zainstalowana wersja należy uruchomić RetailSyncBO.exe. Rys. 66 Uruchomienie RetailSyncBO.exe Więcej informacji odnośnie konfiguracji oddziału i synchronizacji znajduje się w dokumencie Comarch Retail Synchronizacja. 46
6.4 Konfiguracja serwera i klienta usług biznesowych Aby skonfigurować serwer usług biznesowych na centrali, tj. stany magazynowe, bony, kredyt kupiecki, należy przejść na zakładkę Serwer usług biznesowych. Następnie należy podać nazwę serwera SQL, dane do logowania do tego serwera oraz nazwę bazy danych, sprawdzić poprawność danych przyciskiem odświeżania oraz zapisać zmiany. W celu umożliwienia korzystania ze sprawdzania stanów magazynowych, bonów i kredytu kupieckiego na oddziałach, po zapisaniu zmian należy uruchomić usługę Comarch ERP Business Services. Można tego dokonać z poziomu Usług w systemie Windows lub z poziomu Konfiguratora uruchamiając Usługi biznesowe znajdujące się na zakładce Usługi. Rys. 67 Konfiguracja serwera usług biznesowych W konfiguratorze instalowanym razem z produktem Comarch Retail na oddziale, na zakładce Klient usług biznesowych należy wskazać nazwę serwera tj. komputera, na którym uruchomiona jest usługa, a także porty odpowiadającym portom ustawionym na Centrali Retail. Rys. 68 Konfiguracja klienta usług biznesowych 47
7. Poprawki W Comarch ERP Auto Update została udostępniona funkcjonalność lokalnej oraz zdalnej instalacji poprawek. W celu instalacji poprawek należy przejść na zakładkę Poprawki. Rys. 69 Poprawki Następnie pojawi się okno zarządzania poprawkami. 7.1 Instalacja lokalna Na zakładce Poprawki została udostępniona funkcjonalność lokalnej instalacji udostępnionych poprawek. Udostępnione poprawki dla danego stanowiska będą widoczne w oknie zarządzania poprawkami. Rys. 70 Lista poprawek Na liście poprawek znajdują się wszystkie poprawki, które są udostępnione dla danego agenta lub dla jego agentów podrzędnych. Należy pamiętać o tym, że widoczne będą jedynie te poprawki, które są przeznaczone dla zainstalowanej wersji produktu. W chwili udostępnienia poprawki będzie ona zablokowana. W celu jej odblokowania należy wybrać przycisk [Odblokuj]. Następnie pojawi się okno, w którym należy wpisać odpowiedni kod autentykacyjny udostępniony wraz z poprawką. Uwaga: Instalowane poprawki są kumulatywne, więc każda kolejna poprawka z danego obszaru zawiera wcześniejsze. 48
Rys. 71 Okno wpisywania kodu autentykacyjnego Po wpisaniu poprawnego kodu, użytkownik zostanie poinformowany o jego poprawnej weryfikacji. Poprawka zostanie odblokowana i będzie możliwa do pobrania. Jeżeli odblokowana poprawka jest przeznaczona dla komponentu zainstalowanego na danym agencie, to za pomocą akcji [Pobierz] można pobrać ją lokalnie. Akcja [Instaluj] pozwala na lokalną instalację pobranej poprawki. Jeżeli poprawka nie jest przeznaczona dla zainstalowanych komponentów, to po pobraniu, będzie ona niedostępna do instalacji lokalnej. Taką poprawkę można zainstalować zdalnie w sieci agentów podrzędnych (instalacja zdalna została opisana w rozdziale 7.2 Instalacja zdalna). Istnieje również możliwość wycofania ostatniej zainstalowanej poprawki za pomocą akcji [Przywróć], która jest dostępna wyłącznie dla ostatniej wgranej poprawki. Przy wykonywaniu tej akcji należy pamiętać, że kopie baz danych nie zostaną automatycznie przywrócone. Uwaga: Należy pamiętać, że udostępnione poprawki muszą zostać zainstalowane na wszystkich agentach, dla których poprawka jest przeznaczona. Po wybraniu akcji [Instaluj] pojawi się komunikat widoczny na Rys. 72, na którym można wybrać, czy podczas instalacji poprawki ma zostać utworzona kopia zapasowa bazy danych. Ten parametr jest domyślnie zaznaczony i nie zostanie wyświetlony, gdy do komponentu nie jest podpięta baza danych (np. stanowisko POS). Rys. 72 Komunikat przy instalacji poprawki Gdy podczas instalacji poprawki wykonywana jest kopia zapasowa bazy danych, to będzie ona zapisana w domyślnym katalogu kopii baz danych ustalonego dla zainstalowanego Serwera SQL. 49
Uwaga: Podczas instalacji muszą być wyłączone ręcznie następujące procesy: Altum POS Synchronizacja Retail Comarch ERP Business Services BPMServer Comarch.B2.Inbox.ServiceHost Panel zarządzania EtlExex Jeżeli któryś z procesów nie został zamknięty, to wyświetli się komunikat informujący o konieczności jego wyłączenia. 7.2 Instalacja zdalna Za pomocą Comarch ERP Auto Update istnieje możliwość zdalnej instalacji poprawek na agentach podrzędnych. Można to zrobić za pomocą przycisków w sekcji Akcje zdalne. Rys. 73 Akcje zdalne Po wybraniu przycisku [Pobierz], wyświetli się lista agentów, dla których można pobrać zaznaczoną poprawkę oraz agenci, którzy nie są połączeni z agentem głównym. Niepodłączeni agenci są wyświetlani na liście ze względu na brak aktualnej informacji o zainstalowanych przez nich komponentach. Rys. 74 Zdalne pobieranie poprawek W oknie pobierania zdalnego można wybrać agentów, dla których zostanie pobrana poprawka. Po wybraniu akcji [Zdalne pobieranie] program poinformuje użytkownika o rozpoczęciu pobierania poprawki. 50
Rys. 75 Potwierdzenie rozpoczęcia zdalnego pobierania poprawki Po wyborze opcji Tak rozpocznie się proces pobierania poprawki. Rys. 76 Pobieranie poprawki Po wybraniu akcji [Instaluj] wyświetli się lista agentów, dla których można zainstalować zaznaczoną poprawkę oraz agenci, którzy nie są połączeni z agentem głównym. Tak jak w przypadku pobierania, niepodłączeni agenci są wyświetlani na liście ze względu na brak aktualnej informacji o zainstalowanych przez nich komponentach. Rys. 77 Instalacja zdalna poprawek W oknie instalacji zdalnej można wybrać agentów, na których zostanie zainstalowana poprawka oraz zdecydować, czy ma powstać kopia zapasowa bazy danych. Po wybraniu akcji [Instalacja zdalna] poprawka zostanie zainstalowana na wybranych agentach. Rys. 78 Instalacja zdalna poprawki 51
Uwaga: Podczas instalacji muszą być wyłączone następujące procesy: Altum POS Synchronizacja Retail Retail Services BPMServer Comarch.B2.Inbox.ServiceHost Panel zarządzania EtlExex Jeżeli taki proces jest uruchomiony, to podczas instalacji zdalnej zostanie on automatycznie zamknięty. Zainstalowane poprawki można również odinstalować (przywracać stan z przed instalacji ostatniej poprawki) zdalnie. W tym celu należy wybrać przycisk [Przywróć] z sekcji Akcje zdalne. Uruchomi się wtedy okno zawierające listę agentów, w którym można wybrać agentów, na których użytkownik chce odinstalować poprawkę. Uwaga: Odinstalowywanie poprawek jest dostępne tylko dla ostatniej zainstalowanej poprawki. 7.3 Zgodność zainstalowanych poprawek w strukturze agentów W Comarch ERP Auto Update w oknie dostępnych poprawek znajduje się oznaczenie, dzięki któremu można sprawdzić, czy w całej strukturze agentów zostały zainstalowane odpowiednie poprawki. W chwili, gdy poprawka nie została jeszcze zainstalowana na żadnym stanowisku oznaczenie to nie będzie widoczne. 52
Rys. 79 Lista dostępnych poprawek Poniżej zostały przedstawione możliwe oznaczenia: Gdy poprawka została wgrana tylko dla części agentów, (czyli istnieją w strukturze agentów są tacy, dla których poprawka nie została poprawnie zainstalowana) przy nazwie poprawki pojawia się trójkąt jak na Rys. 80 Rys. 80 Oznaczenie niezainstalowania poprawki w całej sieci agentów W sytuacji, gdy w sieci agentów poprawka została zainstalowana dla wszystkich agentów, którzy są połączeni z agentem nadrzędnym, ale w sieci agentów są takie stanowiska, które nie są połączone i nie wiadomo, czy ta poprawka została tam zainstalowana oznaczenia zmienia się na takie, jak przedstawione na Rys. 81 Rys. 81 Oznaczenie zainstalowania poprawki tylko dla podłączonych agentów Oznaczenie, gdy poprawka została prawidłowo zainstalowana w całej sieci agentów zostało pokazane na Rys. 82 53
Rys. 82 Oznaczenie poprawności instalacji poprawek w całej strukturze agentów 8. Dodatki Za pomocą Comarch ERP Auto Update można rejestrować, instalować oraz odinstalowywać dodatki. Jest to funkcjonalność, dzięki której nie ma konieczności ręcznej instalacji rozszerzeń. W celu zarządzania dodatkami, należy w programie Comarch ERP Auto Update przejść na zakładkę Dodatki. Rys. 83 Dodatki Uwaga: Każde rozszerzenie można zdefiniować dla kilku komponentów jednocześnie za pomocą Kreatora Dodatków. Więcej informacji na temat tworzenia dodatków jest zawarte w pliku pomocy dla Kreatora Dodatków. Możliwa jest lokalna i zdalna instalacja i dezinstalacja dodatków. 8.1 Instalacja lokalna Aby zainstalować dodatek lokalnie, w pierwszej kolejności należy go zarejestrować za pomocą przycisku [Rejestruj], po czym wskazać ścieżkę do pliku, który zawiera pakiet instalacyjny dodatku. Plik ten powinien być w formacie archiwum zip, który zawiera plik manifestu definiujący dodatek oraz pozostałe pliki wchodzące w 54
skład dodatku tj. biblioteki dll i/lub skrypty SQL. Dalsze informacje na temat tworzenia dodatków opisane są w rozdziale 8.3. Kreator dodatków. Po zarejestrowaniu, dodatek będzie widoczny na liście dodatków. Rys. 84 Lista dodatków Zarejestrowany dodatek można zainstalować. Instalacja będzie możliwa w przypadku, gdy zdefiniowany dodatek będzie przypisany do odpowiedniej wersji produktu oraz dla odpowiedniego komponentu. Wszystkie informacje na ten temat powinny być zawarte w manifeście dodatku. Podczas instalacji widoczny będzie pasek postępu pokazany na Rys. 85. Rys. 85 Instalacja dodatku Po zainstalowaniu dodatku będzie można go odinstalować za pomocą przycisku [Odinstaluj]. Rys. 86 Zainstalowany dodatek W celu dokonania aktualizacji dodatku należy go zarejestrować na agencie nadrzędnym. Następnie taka aktualizacja będzie dostępna dla agentów podrzędnych, którzy mieli ten dodatek zainstalowany. Dla pozostałych agentów będzie możliwość pobrania i instalacji nowszej wersji dodatku. 55
8.2 Instalacja zdalna Za pomocą Comarch ERP Auto Update można zdalnie pobrać, instalować oraz odinstalować dodatki na agentach podrzędnych. W celu zdalnego pobrania dodatku należy wybrać przycisk [Pobierz], w celu zdalnej instalacji przycisk [Instaluj] z sekcji Akcje zdalne, natomiast w celu wycofania dodatku przycisk [Odinstaluj]. Rys. 87 Akcje zdalne Po wybraniu akcji [Pobierz], [Instaluj] lub [Odinstaluj] zostanie wyświetlona lista agentów, na której żądane działanie jest możliwe do wykonania oraz w celach informacyjnych lista agentów podrzędnych, którzy nie są połączeni z agentem nadrzędnym. Rys. 88 Zdalne pobieranie dodatku 56
Po pobraniu dodatku istnieje możliwość jego zdalnej instalacji. Rys. 89 Instalacja zdalna dodatku Po wybraniu agentów, dla których ma zostać wykonana akcja zdalna oraz jej uruchomieniu rozpocznie się zdalne pobieranie, instalacja lub dezinstalacja dodatku. Za pomocą akcji instalacji można również zaktualizować rozszerzenie. Rys. 90 Zdalna instalacja dodatku 8.3 Kreator dodatków Kreator dodatków jest narzędziem, które usprawnia tworzenie rozszerzeń dla produktów Comarch ERP. Dodatki stworzone w ten sposób są przystosowane do rozpowszechniania i instalacji w każdym oddziale struktury firmy za pomocą programu Comarch ERP Auto Update. 57
W celu zainstalowania Kreatora dodatków należy przejść na zakładkę Konfiguracja, kliknąć prawym przyciskiem myszy w gałąź Produkty i wybrać Dodaj produkt. Następnie należy wybrać Comarch ERP Narzędzia z rozwijanej listy. Rys. 91 Drzewo produktów Do wybranego produktu można dodać odpowiednie komponenty. W tym celu należy prawym przyciskiem myszy nacisnąć na produkt Comarch ERP Narzędzia i wybrać Dodaj komponent. Następnie należy wybrać z listy Kreator Dodatków. Rys. 92 Drzewo komponentów Po skonfigurowaniu komponentu można przejść do jego pobierania i instalacji. Na Ekranie Głównym Comarch ERP Auto Update można wybrać jedną z dwóch opcji: Pobierz 58
Pobierz i instaluj Rys. 93 Ekran główny Po wybraniu opcji [pobierz] produkt zostanie pobrany do katalogu wybranego podczas konfiguracji. Domyślny folder to C:\Comarch ERP Auto Update\Downloads. Po zakończeniu pobierania zostanie uaktywniony przycisk [instaluj]. Natomiast po wybraniu opcji [pobierz i instaluj] produkt zostanie pobrany oraz automatycznie zostanie wywołana akcja instalacji. Po zainstalowaniu i uruchomieniu aplikacji pojawi się okno główne Kreatora dodatków. Rys. 94 Okno główne Aby przejść do Menu głównego Kreatora należy kliknąć prawym przyciskiem myszy w dowolnym punkcie aplikacji. 59
Rys. 95 Menu główne Z poziomu tego menu dostępne są poniższe akcje: Stwórz nowy rozpoczyna proces kreacji nowego dodatku Wczytaj nowy dodaje dodatek do listy dodatków kreatora Konfiguracja otwiera okno konfiguracji aplikacji Pomoc wyświetla plik pomocy Proces tworzenia nowego dodatku składa się z czterech etapów opisanych w kolejnych rozdziałach. 8.3.1 Konfiguracja dodatku W tym etapie można zdefiniować podstawowe informacje o tworzonym dodatku takie jak: nazwa, wersja, produkt i autor. Dodatkowo należy wybrać komponenty produktu, dla jakich dedykowane jest nowotworzone rozszerzenie. Rys. 96 Krok pierwszy tworzenia dodatku 60
8.3.2 Wybór akcji W tym kroku wybierane są akcje, które zostaną wykonane w trakcie instalacji dodatku. Można skonfigurować poszczególne akcje oraz ustalić kolejność wykonywania danego zadania. Rys. 97 Krok drugi tworzenia dodatku 8.3.3 Definiowanie zachowania procesów i usług W trzecim kroku kreatora należy zdefiniować zachowanie procesów i usług powiązanych z instalacja dodatku. Procesy i usługi powiązane z produktem zostanę zamknięte automatycznie. Dodatkowo istnieje możliwość zdefiniowania własnych procesów, które powinny zostać zamknięte oraz wyboru czy poszczególne usługi mają być uruchamiane automatycznie po zakończeniu procesu instalacji dodatku. 61
Rys. 98 Trzeci krok tworzenia dodatku 8.3.4 Edycja manifestu W tym kroku można wprowadzić zmiany w pliku manifest.xml. Jest to opcjonalny krok dla zaawansowanych użytkowników. 62
Rys. 99 Czwarty krok tworzenia dodatku Na liście dodatków wyświetlane są wszystkie stworzone lub tylko najnowsze (jest to zależne od opcji wybranej na zakładce Konfiguracja) przez użytkownika dodatki. Każdy z dodatków jest dedykowany dla wybranego produktu i jego określonej wersji. Rys. 100 Lista stworzonych dodatków Z poziomu listy dodatków można edytować lub usunąć wybrany dodatek, a także stworzyć jego aktualizację. Więcej szczegółowych informacji dotyczących tworzenia dodatków zawartych jest w pliku Pomocy w Kreatorze Dodatków. 63