Współpraca z platformą Emp@tia dokumentacja techniczna INFO-R Spółka Jawna - 2013 43-430 Pogórze, ul. Baziowa 29, tel. (33) 479 93 29, (33) 479 93 89 fax (33) 853 04 06 e-mail: admin@ops.strefa.pl Strona1
1. Instalacja pakietu programów służących do współpracy z platformą Emp@tia Pakiet programów obsługujących współpracę z platformą Emp@tia wystarczy jedynie zainstalować na komputerze, który będzie pełnił rolę serwera łączącego system dziedzinowy z systemem centralnym lub serwera łączącego system dziedzinowy z oporogramowanie terminali mobilnych. Aby zainstalować programy obsługujące współpracę z platformą Emp@tia należy uruchomić plik empsetup.exe. Po jego uruchomieniu na ekranie pojawi się następujące okno : wybieramy przycisk dalej i pojawi się kolejne okno : Strona2
wybieramy ponownie przycisk dalej, pojawi się kolejne okno : wybieramy przycisk instaluj rozpocznie się instalacja pakietu Strona3
pakiet programów zostanie domyślnie zainstalowany w następującej lokalizacji katalog programów systemu operacyjnego \Info-r\Empatia czyli np.: C:\Program Files (x86)\info- R\Empatia. Po zakończeniu kopiowania plików pojawi się następujące okno : Strona4
wybieramy przycisk zakończ, który kończy proces instalacji. Po zainstalowaniu na pulpicie powinny pojawić się następujące ikony programów : 2. Baza empatia.fdb W katalogu w którym został zainstalowany pakiet programów obsługujących współpracę z platformą Emp@tia powinien znajdować się katalog Baza, wewnątrz którego znajduję się plik empatia.fdb. Jest to plik bazy danych Firebird, który jest podstawowym elementem potrzebnym do współpracy pomiędzy systemem dziedzinowym a systemem centralnym lub oprogramowaniem terminali mobilnych. Dlatego na komputerze, który będzie pełnił rolę serwera musi być zainstalowany i uruchomiony serwer baz danych Firebird. 3. Program Emp@tia - transmisja komunikatów Program ten zapewnia wymianę informacji (komunikatów) pomiędzy systemem dziedzinowym a systemem centralnym. W architekturze systemu do współpracy z platformą komunikacyjną Emp@tia pełni on rolę brokera, czyli pośrednika, odpowiadającego za wymianę komunikatów. Program ten musi być włączony aby system dziedzinowy mógł wymieniać informację z systemem centralnym, dlatego należy zapewnić jego automatyczne włączenie w momencie uruchomienia systemu operacyjnego na komputerze, który będzie pełnił rolę serwera łączącego system dziedzinowy z systemem centralnym. a) uruchomienie programu Po uruchomieniu programu na ekranie powinno pojawić się następujące okno : Na liście mogą być wyświetlane komunikaty oczekujące w kolejce na wysłanie do systemu centralnego. Przy normalnej pracy, gdzie zapewniona jest stała łączność z systemem centralnym lista ta najczęściej jest pusta. Strona5
b) konfiguracja programu Współpraca z platformą Emp@tia Konfiguracja programu zapisana jest w pliku empbrk.ini znajdującym się w katalogu, w którym zostały zainstalowane programy obsługujące współpracę z platformą Emp@tia. Zawartość pliku empbrk.ini : [Baza] Empatia=.: C:\Program Files (x86)\info-r\empatia \Baza\empatia.fdb [SlownikiSerwis] WSDL=C:\Projekt\Empatia\Dokumentacja\Sierpień2013\Wymagania_PSintegracjaCSIZS_v1.02\pl\gov\mpips\csizs\pi\slowniki\SlownikiSerwis_v2_0.wsdl URL=https://ws.mpips.gov.pl/pi/slowniki/v3/Slowniki Svc=SlownikiSoapService Prt=SlownikiSoapPort [Poczta] WSDL=C:\Projekt\Empatia\Dokumentacja\Sierpień2013\Wymagania_PSintegracjaCSIZS_v1.02\pl\gov\mpips\csizs\pi\mkm\PocztaSerwis_v2_0.wsdl URL=https://ws.mpips.gov.pl/pi/mkm/Poczta Svc=PocztaSoapService Prt=PocztaSoapPort [ZapytPESELSerwis] WSDL=C:\Projekt\Empatia\Dokumentacja\Sierpień2013\Wymagania_PSintegracjaCSIZS_v1.02\pl\gov\mpips\csizs\pi\pesel\ZapytPESELSerwis_v2_0.wsdl URL=https://ws.mpips.gov.pl/pi/pesel/ZapytPESEL Svc=ZapytPESELSoapService Prt=ZapytPESELSoapPort [ZapytACSerwis] WSDL=C:\Projekt\Empatia\Dokumentacja\Sierpień2013\Wymagania_PSintegracjaCSIZS_v1.02\pl\gov\mpips\csizs\pi\ac\ZapytACSerwis_v2_0.wsdl URL=https://ws.mpips.gov.pl/pi/ac/ZapytAC Svc=ZapytACSoapService Prt=ZapytACSoapPort [ZapytEKSMOoNSerwis] WSDL=C:\Projekt\Empatia\Dokumentacja\Sierpień2013\Wymagania_PSintegracjaCSIZS_v1.02\pl\gov\mpips\csizs\pi\eksmoon\ZapytEKSMOoNSerwis_v2_0.wsdl URL=https://ws.mpips.gov.pl/pi/eksmoon/ZapytEKSMOoN Svc=ZapytEKSMOoNSoapService Prt=ZapytEKSMOoNSoapPort [ZapytCEPIKSerwis] WSDL=C:\Projekt\Empatia\Dokumentacja\Sierpień2013\Wymagania_PSintegracjaCSIZS_v1.02\pl\gov\mpips\csizs\pi\cepik\ZapytCEPiKSerwis_v2_0.wsdl URL=https://ws.mpips.gov.pl/pi/cepik/ZapytCEPiK Svc=ZapytCEPiKSoapService Prt=ZapytCEPiKSoapPort [ObslugaBeneficjentaSerwis] WSDL=C:\Projekt\Empatia\Dokumentacja\Wrzesień2013\WSDL_CBB_SD_2.0\2013-09- 24\pl\gov\mpips\csizs\cbb\rb\ObslugaBeneficjentaSerwis_v1_1.wsdl URL=https://ws.mpips.gov.pl/cbb/rb/ObslugaBeneficjentaSerwisZewn Svc=ObslugaBeneficjentaSerwisZewnSoapService Strona6
PrtObslugaBeneficjentaSerwisZewnSoapPort Sekcja [Baza] musi zawierać poprawną ścieżkę dostępu do pliku bazy danych empatia.fdb Kolejne sekcje definiują poszczególne usługi dostępne w ramach platformy Emp@tia. Element WSDL wskazuje położenia pliku opisującego definicję danej usługi. Element URL zawiera adres pod którym dana usługa jest świadczona. Element Svc określa nazwę usługi, a element Prt nazwę portu usługi. Jeżeli plik empbrk.ini zostanie zmieniony, to zmiany te zostaną uwzględnione po ponownym uruchomieniu programu empbrk.exe. 4. Program Emp@tia - administracja Program ten służy do wykonywania czynności administracyjnych, związanych ze współpracą z platformą Emp@tia. a) konfiguracja programu Konfiguracja programu zapisana jest w pliku empout.ini znajdującym się w katalogu, w którym zostały zainstalowane programy obsługujące współpracę z platformą Emp@tia. Zawartość pliku empout.ini : [Baza] Empatia= C:\Program Files (x86)\info-r\empatia \Baza\empatia.fdb [SystemDziedzinowy] WSDL=C:\Projekt\Empatia\Dokumentacja\Sierpień2013\Wymagania_PSintegracjaCSIZS_v1.02\pl\gov\mpips\csizs\pi\mzt\SystemDziedzinowySerwis_v2_0.wsdl URL=https://ws.mpips.gov.pl/pi/mzt/sd/SystemDziedzinowy Svc=SystemDziedzinowySoapService Prt=SystemDziedzinowySoapPort Sekcja [Baza] musi zawierać poprawną ścieżkę dostępu do pliku bazy danych empatia.fdb Sekcja [SystemDziedzinowy] definiuje usługę SystemDziedzinowy dostępną w ramach platformy Emp@tia. Element WSDL wskazuje położenia pliku opisującego definicję usługi. Element URL zawiera adres pod którym usługa jest świadczona. Element Svc określa nazwę usługi, a element Prt nazwę portu usługi. Jeżeli plik empout.ini zostanie zmieniony, to zmiany te zostaną uwzględnione po ponownym uruchomieniu programu empout.exe. b) uruchomienie programu Po uruchomieniu programu na ekranie pojawi się okno logowania (podczas pierwszego logowania użytkownik Administrator jest bez hasła): Strona7
po zalogowaniu się do programu przez OK na ekranie pojawi się okno umożliwiające przeprowadzenie czynności administracyjnych: W głównym oknie programu na liście prezentowane są operację przeprowadzone w celu zarejestrowania systemu dziedzinowego, aktualizacji danych systemu dziedzinowego lub uzyskania certyfikatu. c) rejestracja systemu dziedzinowego i uzyskanie certyfikatu W celu zarejestrowania i uzyskania certyfikatu dla jednostki wybieramy ikonę Rejestracja, certyfikaty a w kolejnym oknie wybieramy ikonę Rejestracja: Kolejnym krokiem jest wskazanie obszaru, którego dotyczy system dziedzinowy: Strona8
następnie zatwierdzamy wybór przez ikonę OK na ekranie pojawi się okno do wprowadzenia loginu i hasła jednostki użytkownika: po wprowadzeniu loginu i hasła swojej jednostki (loginu i hasła dla systemu Empatia przypisanego do użytkownika nie jest to login i hasło do uruchomienia systemu Helios) użytkownik zatwierdza dane przez ikonę OK, co jest automatyczne z wysłaniem zgłoszenia jednostki do bazy centralnej. Jeżeli jednostka zostanie poprawnie zarejestrowana na ekranie pojawi się stosowny komunikat: natomiast w głównym oknie rejestracji pojawi się zapis informujący o nadaniu identyfikatora dla systemu dziedzinowego: Kolejnym krokiem będzie wysłanie żądania wydania certyfikatu dla systemu dziedzinowego. W tym celu użytkownik wybiera ikonę Certyfikat : Strona9
na ekranie pojawi się zapytanie, które potwierdzamy poprzez ikonę TAK: na ekranie pojawi się komunikat, który także zatwierdzamy przez OK: W tym momencie system poprosi o wprowadzenie loginu i hasła jednostki (loginu i hasła dla systemu Empatia przypisanego do użytkownika nie jest to login i hasło do uruchomienia systemu Helios): a o pomyślnym przeprowadzeniu certyfikacji systemu powiadomi użytkownika komunikatem: Strona10
d) rejestrowanie użytkownika Podczas pierwszego uruchomienia programu Emp@tia administracja w systemie widoczny będzie tylko jeden użytkownik Administrator (bez hasła) posiadający wszystkie prawa. Wskazane jest, aby przed rozpoczęciem zakładania kolejnych użytkowników, ustalić hasło dostępu dla użytkownika Administrator, korzystając z ikony Użytkownik i hasło: Strona11
Następnie należy uzupełnić dane osobowe i adresowe Administratora sytemu. W następnej kolejności Administrator będzie miał możliwość założenia pozostałych użytkowników programu korzystając z ikony Nowy : Po wprowadzeniu danych osobowych i adresowych użytkownika dodajemy go na listę korzystając z ikony OK a następnie Wybierz. W tym momencie będziemy mieli możliwość ustalenia loginu i hasła dla danego użytkownika (analogicznie jak w przypadku Administratora) oraz nadanie mu praw: Strona12
Strona13
e) podgląd komunikatów wymiany informacji W głównym oknie programu należy dwukrotnie kliknąć listę operacji pojawi się wówczas okno prezentujące dane szczegółowe wszystkich komunikatów wysłanych do i odebranych z systemu centralnego. Strona14
5. Program Emp@tia - obsługa terminali mobilnych Program ten pozwala uruchomić Webservice obsługujący wymianę informacji z oprogramowaniem terminala mobilnego. a) uruchomienie programu Po uruchomieniu programu na ekranie pojawi się następujące okno : Na liście prezentowane będą zapytania i odpowiedzi związane z komunikacją z terminalami mobilnymi. Przyciski Start i Stop służą odpowiednio do uruchomienia (domyślnie Webservice jest uruchamiany na starcie) lub zatrzymania serwisu usług. Jeżeli serwis jest zatrzymany to wówczas dostępne będzie pole Port umożliwiające zmianę domyślnego portu usługi (8080) na inny. Przycisk dane serwisu pozwala zaprezentować podstawowe informacje o serwisie w oknie przeglądarki. Program ten musi być włączony aby oprogramowanie terminala mobilnego mogło wymieniać informację z systemem dziedzinowym, dlatego należy zapewnić jego automatyczne włączenie w momencie uruchomienia systemu operacyjnego na komputerze, który będzie pełnił rolę serwera łączącego system dziedzinowy z oprogramowanie terminala mobilnego. b) konfiguracja programu Konfiguracja programu zapisana jest w pliku empotm.ini znajdującym się w katalogu, w którym zostały zainstalowane programy obsługujące współpracę z platformą Emp@tia. Zawartość pliku empotm.ini : [Baza] Empatia= C:\Program Files (x86)\info-r\empatia \Baza\empatia.fdb [Serwis] Port=8080 Sekcja [Baza] musi zawierać poprawną ścieżkę dostępu do pliku bazy danych empatia.fdb. Sekcja [Serwis] zawiera numer portu, na którym zostanie uruchomiony serwis. Jeżeli plik empotm.ini zostanie zmieniony, to zmiany te zostaną uwzględnione po ponownym uruchomieniu programu empotm.exe. Strona15
c) konfiguracja dostępu do serwisu w oprogramowaniu OTM W oprogramowaniu terminala mobilnego należy podać w ustawieniach adres serwisu obsługującego wymianę informacji np.: http://192.168.1.20:8080/soap/otmsdporttype, gdzie adres IP jest adresem IP komputera na którym uruchomiono serwis, numer portu (domyślnie 8080) jest numerem portu podanym w ustawieniach serwisu, natomiast ścieżka /soap/otmsdporttype zawiera nazwę serwisu i nie może być zmieniana. Aby przesłać lub pobrać dane wywiadów należy użyć loginu i hasła zgodnego z użytkownikiem i hasłem przypisanym do pracownika zdefiniowanego w programie Emp@tia - administracja. Strona16