Currenda EPO Instrukcja Konfiguracji. Wersja dokumentu: 1.3

Currenda EPO Instrukcja Konfiguracji Wersja dokumentu: 1.3

Currenda EPO Instrukcja Konfiguracji - wersja dokumentu 1.3-19.08.2014 Spis treści 1 Wstęp... 4 1.1 Cel dokumentu... 4 1.2 Powiązane dokumenty... 4 1.3 Odniesienie do standardów... 4 1.4 Zakres dokumentu... 4 1.5 Zarządzanie zmianą... 4 2 Instrukcja dla Administratora... 5 2.1 Aktualizacja programów wydziałowych i biura podawczego... 5 2.2 Wprowadzenie danych identyfikujących usługi EPO do baz danych... 6 2.3 Rejestracja pliku SawaToEpo.dll... 6 2.4 Instalacja usługi windowsowej... 7 2.5 Konfiguracja usługi windowsowej... 9 2.6 Uzupełnienie bazy kodów pocztowych...12

Currenda EPO Instrukcja Konfiguracji - wersja dokumentu 1.3-19.08.2014 Historia dokumentu Data Wersja Opis zmian Autor 04.02.2013 1.0 Utworzenie dokumentu Krzysztof Wyrzykowski 09.12.2013 1.1 Utworzenie instrukcji konfiguracji Dorota Kamińska 15.04.2014 1.2 Drobne poprawki i formatowanie Mateusz Siergiej 19.08.2014 1.3 Aktualizacja instrukcji Kamil Borowicki Strona 3 z 13

1 Wstęp Currenda EPO Instrukcja Konfiguracji - wersja dokumentu 1.3-19.08.2014 1.1 Cel dokumentu Niniejszy dokument zawiera instrukcję instalacji i konfiguracji modułu Currenda EPO oraz aplikacji wydziałowych na potrzeby integracji z ministerialnym serwisem EPO. 1.2 Powiązane dokumenty 1.3 Odniesienie do standardów Strukturę dokumentu opracowano w oparciu o wewnętrzny standard firmy Currenda Sp. z o.o., najlepsze praktyki inżynierii oprogramowania oraz uwagi wynikające z walidacji poprzednich wersji dokumentu przez Klienta. 1.4 Zakres dokumentu W dokumencie został przedstawiony szczegółowy proces instalacji i konfiguracji modułu Currenda EPO oraz aplikacji wydziałowych w ramach integracji z ministerialnym serwisem EPO. 1.5 Zarządzanie zmianą Treść dokumentu może ulegać zmianie. Każda wersja dokumentu będzie zawierała datę oraz informacje o zmianach, jakich w nim dokonano. Historia dokumentu będzie miała postać tabeli umieszczonej na początku dokumentu: Data Wersja Opis zmian Autor Data data powstania wersji dokumentu Wersja numer wersji dokumentu Opis zmian opis zmian dokonanych w dokumencie Autor lista imion oraz nazwisk autorów wprowadzonych zmian Wiersze tabeli będą posortowane rosnąco według numeru wersji dokumentu. Strona 4 z 13

2 Instrukcja dla Administratora 2.1 Aktualizacja programów wydziałowych i biura podawczego Należy wykonać aktualizację aplikacji wydziałowej i biura podawczego do najnowszej wersji, poprzez folder synchronizacyjny lub bezpośrednią podmianę plików w folderach aplikacji, oraz zaktualizować bazy danych z poziomu programów korzystając z opcji Aktualizacja bazy. W ustawieniach programu wydziałowego, zakładka Konfiguracja -> Ustawienia programu, pojawi się opcja Czy uwzględniać integrację z EPO. Zaznaczenie TAK włączy mechanizm pozwalający na obsługę przesyłek EPO. Ustawienie na NIE pozwoli zachować istniejący sposób obsługi korespondencji. Dla programu wydziałowego apelacyjnego włączenie integracji z EPO odbywa się poprzez ręczną aktualizację tabeli konfig na bazie danych. Należy wykonać następujące polecenie: update konfig set czyepo = 1 (włączenie obsługi EPO) update konfig set czyepo = 0 (wyłączenie obsługi EPO) Dla biura podawczego wydziałowego i apelacyjnego włączenie integracji z EPO odbywa się poprzez ręczną aktualizację tabeli konfig na bazie danych. Należy wykonać następujące polecenie: update konfig set czyepo = 1 (włączenie obsługi EPO) update konfig set czyepo = 0 (wyłączenie obsługi EPO) Strona 5 z 13

2.2 Wprowadzenie danych identyfikujących usługi EPO do baz danych Wprowadzenie danych identyfikacyjnych usługi EPO odbywa się poprzez ręczną aktualizację tabeli konfig na bazie danych, zarówno dla aplikacji wydziałowej jak i biura podawczego. Należy wykonać następujące polecenie (przykład): UPDATE konfig SET adres_uslugi='https://epotest.bialystok.so.gov.pl:443/eposervice.svc?wsdl',uz ytkownik='gospodarczyadam',password='!qazxsw2',api_key='21a2e877-9fc8-4534- b7ec-a25f00bef40e' Dane dla poszczególnych kolumn są generowane przez system EPO i te dane należy wpisać do powyższego zapytania. 2.3 Rejestracja pliku SawaToEpo.dll Pliki SawaToEpo.dll oraz zlib.net.dll należy przenieść do folderu biura podawczego (wydziałowego lub/i apelacyjnego) a następnie dokonać rejestracji pliku SawaToEpo.dll. Rejestrację pliku wykonuje się poprzez wpisanie polecenia w konsoli cmd: dla 32 bitowego systemu Windows: gdzie C:\SAWA\BPOD to przykładowa ścieżka do aplikacji biura podawczego w której znajduje się plik SawaToEpo.dll dla 64 bitowego systemu Windows: gdzie C:\SAWA\BPOD to przykładowa ścieżka do aplikacji biura podawczego w której znajduje się plik SawaToEpo.dll Wraz z udostępnieniem nowej wersji biblioteki SawaToEpo.dll niezbędne będzie wyrejestrowanie wcześniejszej wersji i ponowne zarejestrowanie aktualnej wersji. Wyrejestrowania dokonuje się poprzez wpisanie polecenia w konsoli cmd: Strona 6 z 13

dla 32 bitowego systemu Windows: gdzie C:\SAWA\BPOD to przykładowa ścieżka do aplikacji biura podawczego w której znajduje się plik SawaToEpo.dll dla 64 bitowego systemu Windows: gdzie C:\SAWA\BPOD to przykładowa ścieżka do aplikacji biura podawczego w której znajduje się plik SawaToEpo.dll Po pomyślnym zakończeniu procesy wyrejestrowywania, należy przenieść aktualny plik SawaToEpo.dll do folderu biura podawczego (wydziałowego lub/i apelacyjnego) i wykonać rejestrację zgodnie z wcześniej opisaną procedurą. 2.4 Instalacja usługi windowsowej Instalacja usługi windowsowej pozwala na automatyczne pobieranie statusów pism z serwisu EPO. W tym celu należy stworzyć folder EpoToSawa (proponowana lokalizacja to folder z aplikacjami wydziałowymi C:\SAWA\EpoToSawa) i przenieść do niego następujące pliki: EpoToSawa.exe instal_epotosawa.bat uninstal_epotosawa.bat Administrator_EpoToSAWA.exe SawaToEpoWS.dll zlib.net.dll W pierwszej kolejności rejestrujemy usługę EpoToSawa poprzez uruchomienie pliku instal_epotosawa.bat. W przypadku problemów z rejestracją usługi należy wyedytować plik instal_epotosawa.bat (otwarcie pliku poprzez edytor tekstu) dla 32 bitowego systemu Windows: @echo off c:\windows\microsoft.net\framework\v4.0.30319\installutil.exe EpoToSawa.exe pause Strona 7 z 13

dla 64 bitowego systemu Windows: @echo off c:\windows\microsoft.net\framework64\v4.0.30319\installutil.exe EpoToSawa.exe pause Strona 8 z 13

2.5 Konfiguracja usługi windowsowej Po pomyślnym zarejestrowaniu usługi EpoToSawa należy uruchomić aplikację administratora Administrator_EpoToSAWA.exe. Podczas pierwszego uruchomienia pojawi się poniższy komunikat, który należy potwierdzić przyciskiem OK. Następnie z menu Konfiguracja należy wybrać opcję Ścieżki dostępu do konfiguracji EpoToSawa i wskazać ścieżkę do folderu w którym znajduje się plik EpoToSawa.exe, a następnie zatwierdzić wybór przyciskiem OK. Po wskazaniu ścieżki dostępu aplikacja wyświetli poniższy komunikat, który należy potwierdzić przyciskiem TAK. Zostanie utworzony plik konfiguracyjny usługi EpoToSawa w folderze wskazanym w poprzednim kroku. Strona 9 z 13

W tym momencie należy wybrać z menu Konfiguracja drugą opcję Konfiguracja usługi EpoToSawa. Aplikacja wyświetli okno umożliwiające określenie parametrów usługi. grupa Dane autoryzacyjne EpoWS W polu danych autoryzacyjnych należy wpisać dane otrzymane przy rejestracji do usługi EPO i zaznaczyć przełącznik Serwis EpoWS zabezpieczony protokołem SSL. a) Adres EpoWS adres sieciowy serwisu EPO b) Nazwa użytkownika nazwa użytkownika posiadającego konto w serwisie EPO c) Hasło użytkownika hasło użytkownika posiadającego konto w serwisie EPO d) Kluz autoryzacji klucz autoryzacji generowany w serwisie EPO grupa Interwał uruchamiania usługi EpoToSawa Pole pozwalające na ustalenie interwału czasowego po upływie którego będzie następowało automatyczne uruchomienie usługi i pobieranie danych z serwisu EPO. grupa Błędy usługi EpoToSawa Informacje pochodzące z usługi zostały zgrupowane w sześciu poziomach logowania. Użytkownik ma możliwość wyboru jednego z tych poziomów w zależności od własnych preferencji. W codziennej pracy zaleca się ustawienie poziomu logowania błędów w przedziale od 0 do 2. Gdy wystąpią problemy z działaniem usługi należy podnieść poziom logowania błędów z przedziału 3 do 5. Pozwoli to na zebranie szczegółowych danych umożliwiających ustalenie przyczyny niepoprawnego działania usługi. a) Poziom 0 informacje zapisywane są wyłącznie w dzienniku zdarzeń. Są to: informacje startowe, diagnostyczne, zatrzymania usługi, rozpoczęcia i zakończenia cyklu przetwarzania, wszystkie błędy. b) Poziom 1 informacje zapisywane są w ograniczonym stopniu do dziennika zdarzeń systemu oraz do bazy danych biura podawczego. Do dziennika zdarzeń zapisywane są informacje startowe i diagnostyczne do momentu testu połączenia z bazą danych biura podawczego oraz informacja o zatrzymaniu usługi. Do bazy danych biura podawczego zapisywane są informacje od momentu zakończenia testu z bazą danych. Są to informacje rozpoczęcie i zakończenie cyklu przetwarzania oraz wszystkie błędy. Strona 10 z 13

c) Poziom 2 jest to poziom logowania 1 z tą różnicą, że do dziennika systemy zapisywane są wszystkie informację a nie tylko te do zakończenia testu połączenia z bazą biura podawczego. d) Poziom 3 jest to poziom logowania 0 z tą różnicą, że w cyklu przetwarzania zapisywane będą wszystkie informacje o każdej czynności, którą wykonuje usługa. e) Poziom 4 jest to poziom logowania 1 z tą różnicą, że w cyklu przetwarzania zapisywane będą wszystkie informacje o każdej czynności, którą wykonuje usługa. f) Poziom 5 jest to poziom logowania 2 z tą różnicą, że w cyklu przetwarzania zapisywane będą wszystkie informacje o każdej czynności, którą wykonuje usługa. Informacje z usługi zapisywane są w dzienniku zdarzeń systemowych w kontenerze EpoToSawaLog i/lub w bazie danych biura podawczego. Występują trzy rodzaje danych: Informacje, Ostrzeżenia, Błędy. grupa Połączenie z bazą biura podawczego systemu SAWA Pola pozwalające na ustalenie parametrów połączenia z bazą danych biura podawczego. W przypadku biura podawczego obsługującego aplikacje apelacyjne należy zaznaczyć przełącznik Sąd Apelacyjny. a) Adres serwera adres serwera SQL do którego podłączona jest baza biura podawczego b) Nazwa bazy danych nazwa bazy danych biura podawczego c) Nazwa użytkownika w przypadku wybrania autoryzacji SQL, nazwa użytkownika SQL Strona 11 z 13

d) Hasło hasło do bazy danych dla użytkownika SQL Po zapisaniu zmian pojawi się komunikat: Po kliknięciu OK można zamknąć aplikację administratora i uruchomić managera usług windowsowych wybierając w Panel sterowania -> Narzędzia administracyjne -> Usługi. Na liście usług znajdować się będzie wpis EpoToSawa. Należy otworzyć okno właściwości usługi (ppm - > Właściwości) i wybrać opcję Uruchom. Od tego momentu usługa zaczyna działać i będzie automatycznie uruchamiana przy każdym włączeniu komputera. Jeśli w przyszłości pojawi się nowsza wersja pliku EpoToSawa.exe, należy zatrzymać usługę przyciskiem Zatrzymaj, następnie ją odinstalować korzystając z deinstalatora uninstal_epotosawa.bat, a następnie wykonać ponowną instalację zgodnie z opisaną procedurą. 2.6 Uzupełnienie bazy kodów pocztowych Aby pisma było poprawnie rozpoznawane jako przesyłki EPO należy dodać kody pocztowe objęte systemem EPO do baz danych aplikacji wydziałowych. Aktualizację wykonuje się z poziomu aplikacji administratora Administrator_EpoToSAWA.exe, po wybraniu opcji Kody pocztowe -> Aktualizacja kodów pocztowych. Strona 12 z 13

Należy wskazać ścieżkę do pliku z kodami pocztowymi (plik w formacie.csv) i wybrać opcję Aktualizuj. Aplikacja wyświetli komunikat, który potwierdzamy przyciskiem Tak, informujący o rozpoczęciu aktualizacji bazy danych. W przypadku, gdy któraś z baz nie jest dostosowana do obsługi przesyłek EPO zostanie wyświetlone okno informacyjne, które należy potwierdzić przyciskiem OK. Proces aktualizacji będzie kontynuowany. Po wykonaniu aktualizacji aplikacja wyświetli komunikat, który należy potwierdzić przyciskiem OK, informujący o zakończonym procesie dodawania kodów pocztowych do baz danych. Strona 13 z 13