PODRĘCZNIK UŻYTKOWNIKA DLA WERSJI 1.01-2-01 MODEL LOGICZNY SYSTEMU TOP-TEAM TT http://www.top-team.pl WARSZAWA 2008
CZĘŚĆ I Podręcznik Użytkownika Strona 2
Spis Treści INFORMACJE O PROGRAMIE...7 INSTALACJA PROGRAMU...8 SYSTEM OPERACYJNY WINDOWS...8 WYMAGANIA SPRZĘTOWE...8 WYMAGANIA PROGRAMOWE...8 INSTALACJA...8 SYSTEM OPERACYJNY LINUX WERSJA PODSTAWOWA...10 WYMAGANIA SPRZĘTOWE...10 WYMAGANIA PROGRAMOWE...10 INSTALACJA...10 INSTALACJA NA SYSTEMIE OBSŁUGUJĄCYM PAKIETY RPM...11 INSTALACJA NA SYSTEMIE NIE OBSŁUGUJĄCYM PAKIETÓW RPM...11 SYSTEM OPERACYJNY LINUX WYKRYWANIE WERSJA ZAAWANSOWANA...13 BŁĘDÓW...16 BŁĘDY BAZY DANYCH...17 BŁĘDY SERWERA TOMCAT...20 INSTALACJA I URUCHOMIENIE SYSTEMU NA STACJI ROBOCZEJ...21 PRACA Z PROGRAMEM...23 PIERWSZE URUCHOMIENIE PROGRAMU...23 SŁOWNIKI...24 DODANIE NOWEGO SŁOWA DO SŁOWNIKA LOKALNEGO...24 DOKUMENTY DOŁĄCZANE DO WNIOSKÓW...26 WPROWADZANIE DANYCH URZĘDU ADMINISTRACJI PUBLICZNEJ...28 WYBÓR LOKALIZACJI DO SPRAWOZDAŃ...30 WYJŚCIE Z PROGRAMU...31 UŻYTKOWNICY APLIKACJI...32 WZORY DECYZJI...33 SZABLONY PISM...35 SPRAWOZDANIA...37 TWORZENIE SPRAWOZDAŃ...37 ZBIÓR CENTRALNY ZA SPRAWOZDANIE 2008 ROK...37 RZECZOWO-FINANSOWE O ZADANIACH ZREALIZOWANYCH ZE ŚRODKÓW BUDŻETU ZAKRESIE ŚWIADCZEŃ RODZINNYCH ZA ROK SPRAWOZDANIE ŚRODKÓW BUDŻETU UTWORZONE W 2008...38 RZECZOWO-FINANSOWE O WYDATKACH PONIESIONYCH NA ZALICZKI ALIMENTACYJNE ZE PAŃSTWA SPRAWOZDANIA PAŃSTWA ORAZ BUDŻETÓW GMIN...39 UZUPEŁNIAJĄCE INFORMACJE Z ZAKRESU ŚWIADCZEŃ RODZINNYCH...40 SPRAWOZDANIA...42 Strona 3
USTAWIENIE STRONY KODOWEJ DRUKARKI...43 NAPRAWA DANYCH...44 KLIENCI...45 REJESTROWANIE NOWEGO WYSZUKIWANIE KLIENTA...45 KLIENTA...47 EDYCJA DANYCH KLIENTA...49 DODANIE CZŁONKA RODZINY...50 DODANIE NOWEGO KLIENTA DO ISTNIEJĄCEJ RODZINY...51 WYSZUKIWANIE DANYCH...52 WYSZUKIWANIE KLIENTÓW WEDŁUG PRZYZNANYCH ŚWIADCZEŃ...52 WYSZUKIWANIE DŁUŻNIKÓW...53 WYSZUKIWANIE CZŁONKÓW RODZINY...53 REJESTR DECYZJI...53 LISTA WNIOSKÓW KTÓRE NIE ZOSTAŁY ROZPATRZONE...54 LISTA NALEŻNOŚCI ZAREJESTROWANYCH JAKO ZWROT W KASIE...54 ZNAJDŹ OSOBY KTÓRE MAJA NUMERY KART PRZEDPŁACOWYCH...54 WNIOSKI...55 REJESTRACJA WNIOSKU O PRZYZNANIE ŚWIADCZENIA...55 ZASIŁEK RODZINNY WRAZ Z DODATKAMI...55 REJESTRACJA WNIOSKU O ZASIŁEK PIELĘGNACYJNY...59 REJESTRACJA WNIOSKU O ŚWIADCZENIE PIELĘGNACYJNE...61 DECYZJE...63 WYDANIE DECYZJI PRZYZNAJĄCEJ...63 PRZYZNANIE ŚWIADCZEŃ...65 REALIZACJA SAMYCH DODATKÓW BEZ ZASIŁKU RODZINNEGO...68 DODANIE ANOMALII W WYPŁACANIU ŚWIADCZENIA...69 WYDANIE DECYZJI ODMOWNEJ...71 WYDANIE DECYZJI WSTRZYMUJĄCEJ...73 WYDANIE DECYZJI ZMIENIAJĄCEJ...74 STATUS DECYZJI...75 WYDRUK DECYZJI...76 WYWIADY...77 WYPŁATY KLIENTA...78 ODWOŁANIA...79 NIENALEŻNIE POBRANE ŚWIADCZENIA...81 ZALICZKA ALIMENTACYJNA...84 OSOBA UBIEGAJĄCA SIĘ O ZALICZKĘ ALIMENTACYJNĄ...85 REJESTRACJA DŁUŻNIKA...87 Strona 4
PRZYDZIELANIE ISTNIEJĄCEGO DŁUŻNIKA...88 LISTA DŁUŻNIKÓW ALIMENTACYJNYCH...89 WYDRUK DŁUGU DŁUŻNIKÓW...90 WNIOSKI...91 WYDANIE DECYZJI...94 ODBIORCY ŚWIADCZEŃ...97 PISMA...98 LISTY WYPŁAT...100 TWORZENIE LISTY WYPŁAT...100 DRUKOWANIE LISTY WYPŁAT...103 EDYCJA LISTY, USUWANIE POJEDYNCZYCH WYPŁAT, ZMIANA STATUSU LISTY...104 ZATWIERDZENIE LISTY...105 DRUKOWANIE PRZELEWÓW I PRZEKAZÓW...106 WYDRUKI GRUPOWE...107 WYDRUKI ZBIORCZE Z LIST WYPŁAT...108 ZMIANA HASŁA...109 UWAGI POMOCNE PRZY ROZWIĄZYWANIU PROBLEMÓW...110 PROBLEMY, KTÓRE MOGĄ POJAWIĆ SIĘ W TRAKCIE INSTALACJI I PRZY PIERWSZYM URUCHOMIENIU SYSTEMU...110 WINDOWS 98...110 WINDOWS XP...110 WINDOWS 2000...110 PROBLEMY, CO KTÓRE MOGĄ POJAWIĆ SIĘ W TRAKCIE AKTUALIZACJI...111 ZROBIĆ GDY PO AKTUALIZACJI PROGRAMU NIE WIDAĆ ZMIAN?...111 USTAWIENIE PRZEGLĄDARKI INTERNETOWEJ...111 SPRAWOZDANIA...111 EKSPORT DOKUMENTÓW DO PROGRAMU PŁATNIKA...112 POWIADOMIENIE O UZUPEŁNIENIU DANYCH...113 MODEL LOGICZNY SYSTEMU...114 DIAGRAM MODELU DANYCH...115 ENCJE...116 CZŁONEK RODZINY...116 DECYZJA W SPRAWIE ODWOŁANIA...116 DECYZJA W SPRAWIE ŚWIADCZENIA...117 DOKUMENT...118 DZIECKO...118 INNA DECYZJA...119 KLIENT (BENEFICJENT)...120 LISTA WYPŁAT...121 Strona 5
NALEŻNOŚĆ...121 ODBIORCA ŚWIADCZENIA...122 ODWOŁANIE...123 POTRĄCENIE...123 POZYCJA NA LIŚCIE WYPŁAT...124 PRACOWNIK...125 RODZINA...126 ŚWIADCZENIE WNIOSEK RODZINNE...126 W SPRAWIE ŚWIADCZENIA...127 WNIOSKODAWCA...129 WPŁATA...129 ZAŁĄCZNIK...129 Strona 6
INFORMACJE O PROGRAMIE Program ewidencji i obsługi klientów korzystających ze świadczeń rodzinnych jest w pełni nowoczesnym i bardzo prostym w obsłudze programem spełniającym oczekiwania i wymagania użytkownika. Gwarancją wysokiej jakości nowego produktu jest doskonała znajomość problematyki pomocy społecznej wynikająca z 15-letniej współpracy pracowników firmy TOP-TEAM z OPS-ami wszystkich szczebli. Program jest programem zarządzania bazą danych, zawierającą informacje o osobach korzystających ze świadczeń rodzinnych. Informacje gromadzone w systemie przeznaczone są dodatkowo do wykorzystania przez Wojewódzkie Wydziały Pomocy Społecznej i Departament Pomocy Społecznej Ministerstwa Pracy i Polityki Socjalnej. Program spełnia wymagania formalne określone w przepisach Ustawy o Świadczeniach Rodzinnych oraz Rozporządzeniach Rady Ministrów. Ponadto program spełnia wymagania określone w projekcie Zasad Homologacji Oprogramowania opracowane przez Zespół ds. Rozwoju Systemu SYRIUSZ. Program w znacznym stopniu zwiększa skuteczność działania, usprawnia proces obsługi klientów oraz podnosi komfort pracy przez eliminację pracochłonnych, powtarzalnych a wykonywanych do tej pory najczęściej manualnie czynności ewidencyjnych, kontrolnych i rachunkowych. Przejrzysta i logiczna struktura programu, starannie zaprojektowany sposób prezentacji danych sprawiają, że program jest prosty w obsłudze dla początkującego użytkownika, który nie posiada specjalistycznego przygotowania z zakresu informatyki. Program pracuje w dowolnych środowiskach, takich jak: WINDOWS, LINUX, UNIX. Obsługiwany jest on przez przeglądarkę internetową, np.: Internet Explorer, Mozilla, Netscape, Opera. Program obejmuje wszystkie podstawowe funkcje i zadania realizowane przez urzędy administracji publicznej w zakresie: EWIDENCJI ZŁOŻONYCH WNIOSKÓW; EWIDENCJI DECYZJI WYDANYCH W SPRAWACH DOTYCZĄCYCH ŚWIADCZEŃ RODZINNYCH; OBSŁUGI WYPŁAT I TWORZENIA DOKUMENTÓW Z NIMI ZWIĄZANYCH; PROWADZENIA EWIDENCJI WYPŁACONYCH ŚWIADCZEŃ; OBSŁUGI ZWROTÓW NIENALEŻNIE POBRANYCH; TWORZENIA WYMAGANYCH SPRAWOZDAŃ. Ponadto program: ZAPEWNIA ZGODNOŚĆ PODEJMOWANYCH DZIAŁAŃ Z PROCEDURAMI ADMINISTRACYJNYMI; UŁATWIA WYMIANĘ INFORMACJI Z INNYMI SYSTEMAMI ZEWNĘTRZNYMI (NP. PROGRAM PŁATNIKA); WSPOMAGA PROCES OBSŁUGI KLIENTA PRZEZ UŻYTKOWNIKA; Strona 7
INSTALACJA PROGRAMU SYSTEM OPERACYJNY WINDOWS Wymagania Sprzętowe Do poprawnego działania aplikacji (przy założeniu, że serwer Tomcat i Firebird będą zainstalowane na tym samym komputerze) wymagany jest komputer o następującej minimalnej konfiguracji: procesor: Pentium III 500 MHz pamięć: 256 MB dysk twardy: 10 GB ATA-100 Wymagania Programowe Optymalnymi systemami operacyjnymi dla serwera są: Windows 2000 Windows NT Windows XP Windows 2003 Na serwerze może być (ale nie jest zalecany) zainstalowany Windows 98. Instalacja Instalację zaczynamy od uruchomienia pliku SETUP.EXE znajdującego się na płycie instalacyjnej. Kolejno zostaną wykonywane instalacje składników aplikacji, podczas których należy postępować wg wskazówek programu instalacyjnego: Firebird-1.5.5.4926-3-Win32.exe jre-1_5_0_06-windows-i586-p.exe apache-tomcat-5.5.25.exe aplikacja Świadczenia Rodzinne. Program Świadczenia Rodzinne instaluje się domyślnie na C:\TOPTEAM\SWIADCZENIA_RODZINNE. Baza programu domyślnie instaluje się na C:\TOPTEAM\SWIADCZENIA_BAZA. Aby umożliwić poprawne generowanie sprawozdań, należy Uruchomić z menu "start =>Programy =>Apache Software Foundation => Monitor Tomcat", na ikonce przy zegarku wybrać "configure" przejść do zakładki "java" i ustawić opcje dotyczące dostępnej pamięci: "Initial memory pool:" 128 "Maximum memory pool:" 768 Strona 8
Aby w przyszłości uniknąć problemów z uruchomieniem serwera Tomcat, należy wyłączyć aktualizacje składnika Java. Aby tego dokonać należy udać się w lokalizację menu "start => Panel Sterowania => Java => zakładka Update". Aby uruchomić aplikację należy w przeglądarce internetowej w pasku adresu wpisać: http://adres_ip_serwera:8080/swiadczenia_rodzinne W przypadku wykonywania aktualizacji aplikacji Świadczeń Rodzinnych, należy za każdym razem czyścić dane tymczasowe: dla serwera apache tomcat. Przechodzimy do katalogu "C:\Program Files\Apache Software Foundation\Tomcat 5.5\work\Catalina\localhost" i usuwamy katalog "swiadczenia_rodzinne" w przypadku danych tymczasowych przeglądarki internetowej dla obu aplikacji: Internet Explorer z górnego menu wybieramy "Narzędzia -> Opcje internetowe" a z tam wciskamy "Usuń pliki cookie" a następnie "Usuń pliki". Firefox z menu Narzędzia -> Opcje -> Prywatność -> zaznaczamy: "Zawsze czyść prywatne dane" przy zamykaniu programu Firefox" a w ustawieniach zaznaczyć wszystkie dostępne opcje. Odznaczamy oczywiście opcję przy "Poproś o potwierdzenie przed czyszczeniem prywatnych danych" Strona 9
SYSTEM OPERACYJNY LINUX WERSJA PODSTAWOWA Wymagania Sprzętowe Do poprawnego działania aplikacji (przy założeniu, że serwer Tomcat i Firebird będą zainstalowane na tym samym komputerze) wymagany jest komputer o następującej konfiguracji: procesor: Pentium III 500 MHz pamięć: 512 MB dysk twardy: 10 GB ATA-100 Aby komputer serwera mógł służyć dodatkowo jako stacja robocza konieczne jest rozbudowanie pamięci co najmniej do 768 MB (ze względu na duże potrzeby pamięciowe systemu X-Windows). Wymagania Programowe Jedynym elementem systemu, którego instalacja może zależeć od dystrybucji linuxa jest baza danych Firebird. Na płycie instalacyjnej znajduje się pakiet instalacyjny i źródło tej bazy danych. Pakiet instalacyjny może zostać automatycznie zainstalowany w przypadku, gdy dystrybucja systemu linux zawiera program rpm (np. dystrybucja RedHat) - zarządcę pakietów instalacyjnych rpm. Jeżeli wybrana dystrybucja nie zawiera takiego oprogramowania konieczne będzie wyszukanie w sieci Internet pakietu instalacyjnego bazy danych Firebird w wersji 1.5.0.4288 lub nowszej obsługiwanego przez daną dystrybucję lub kompilacja źródeł bazy Firebird. Najnowsze wersje bazy Firebird dostępne są na stronie: http://firebird.sourceforge.net Do poprawnej instalacji pakietu Firebird wymagane są następujące biblioteki: glibc-2.2-5 lub nowsza ncurses 4-5.0-2 lub nowsza Zaleca się użyć linuxa z jądrem 2.4 lub nowszym. Aplikacja została przetestowana ze standardową instalacją (tzn. bez instalowania żadnych dodatkowych bibliotek nie znajdujących się na płytach instalacyjnych) dystrybucji RedHat 9.0. Instalacja Instalacja systemu Świadczenia rodzinne składa się z następujących etapów: 1. Instalacja J2SE 2. Instalacja serwera Tomcat 3. Instalacja sterowników JDBC bazy danych Firebird 4. Instalacja aplikacji Świadczenia Rodzinne 5. Instalacja bazy danych Firebird 6. Ustawienie plików konfiguracyjnych aplikacji Świadczenia Rodzinne 7. Instalacja bazy danych Strona 10
8. Uruchomienie serwera Tomcat Instalacja na systemie obsługującym pakiety rpm Wykonaj następujące polecenia: 1. Uzyskaj prawa administratora systemu su root 2. Podłącz płytę instalacyjną do systemu plików (np. do katalogu /mnt/cdrom) mount -t iso9660 /dev/cdrom /mnt/cdrom 3. Wejdź do katalogu instalatora cd /mnt/cdrom/linux_install 4. Uruchom skrypt instalatora./install.sh Po poprawnym wykonaniu powyższych komend system Świadczenia Rodzinne będzie już gotowy do pracy. Instalacja na systemie nie obsługującym pakietów rpm Wykonać następujące polecenia: 1. Uzyskaj prawa administratora systemu su root 2. Podłącz płytę instalacyjną do systemu plików (np. do katalogu /mnt/cdrom) mount -t iso9660 /dev/cdrom /mnt/cdrom 3. Wejdź do katalogu instalatora cd /mnt/cdrom/linux_install 4. Uruchom skrypt instalatora./install_non-rpm.sh 5. Kompilacja bazy Firebird Po przegraniu pliku firebird-x.x.x.xxxx.tar.bz2 (x oznacza numery wersji) do odpowiedniego katalogu wydać polecenie: tar xfj firebird-x.x.x.xxxx.tar.bz2 Po wejściu do katalogu z źródłami:./autogen.sh make make install 6. Konfiguracja bazy danych (plik struts-config.xml) Plik konfiguracyjny znajduje się w katalogu /swiadczenia_rodzinne/tomcat/webapps/swiadczenia_rodzinne/web-inf Strona 11
W pliku tym należy wpisać poprawne ścieżki do pliku bazy danych oraz poprawne login i hasło do serwera Firebird. Przykładowy plik konfiguracyjny znajduje się w tym samym katalogu co ta instrukcja (ma on nazwę struts-config.xml). Strona 12
SYSTEM OPERACYJNY LINUX WERSJA ZAAWANSOWANA Opis instalacji i uruchomienia aplikacji przeznaczony jest dla użytkowników znających i mających doświadczenie z systemem Linux. Opis instalacji i uruchomienia dotyczy wykazanej w opisie architektury sprzętu, dystrybucji i wersji systemu. Sposób instalacji aplikacji Świadczenia Rodzinne na komputerze z procesorem Intel Core 2 Duo pod kontrolą systemu operacyjnego Linux OpenSuSe_10.3_x86_64. 1. Instalację zaczynamy od pobrania niezbędnych pakietów oprogramowania tj. apache-tomcat-5.5.25.tar.gz FirebirdSS-1.5.4.4910-0.i686.rpm jdk-1_5_0_15-linux-amd64.bin 2. Rozpakowujemy archiwum apache-tomcat-5.5.25.tar.gz do katalogu /opt a następnie zmieniamy jego nazwę na tomcat. 3. Umieszczamy plik konfiguracyjny (swiadczenia_rodzinne.xml) aplikacji dla serwera tomcat w katalogu /opt/tomcat/conf/catalina/localhost. W plikach tych opisujemy położenie aplikacji webowych. 4. Plik jdk-1_5_0_15-linux-amd64.bin uruchamiamy w katalogu z prawami do zapisu np. /tmp. Wyodrębniony katalog jdk1.5.0_15 przenosimy do katalogu /opt 5. Instalujemy FirebirdSS-1.5.4.4910-0.i686.rpm 6. W katalogu /etc tworzymy plik profile.local do katalogu, który pozwoli na ustawienie niezbędnych do prawidłowego działania serwera, zmiennych systemowych. JAVA_HOME="/opt/jdk1.5.0_15" JAVA_PATH="$JAVA_HOME/bin" JRE_HOME="/opt/jdk1.5.0_15/jre" CATALINA_HOME="/opt/tomcat" CATALINA_OPTS="-Xms256m -Xmx1024m -XX:MaxPermSize=128m -XX:PermSize=64m -XX: +UseConcMarkSweepGC -XX:NewSize=48m" PATH=$JAVA_HOME/bin:$PATH export JAVA_HOME JAVA PATH JRE_HOME CATALINA_HOME CATALINA_OPTS PATH 7. Do lokalizacji wykazanej w plikach konfiguracyjnych tomcat'a (swiadczenia_rodzinne.xml) kopiujemy potrzebne do uruchomienia pliki aplikacji, ustawiając jednocześnie odpowiednie prawa do katalogów, do katalogu swiadczenia_rodzinne (755), swiadczenia_baza (755). Prawa dla pliku bazy danych powinny wynosić odpowiednio sw_rodz.gdb (666). 8. Odczytujemy hasło dla serwera Firebird z pliku /opt/firebird/sysdba.password i modyfikujemy pliki konfiguracyjne aplikacji pod kątem położenia aplikacji oraz hasła do serwera Firebird. Pliki konfiguracyjny znajduje się w lokalizacji: Strona 13
/swiadczenia_rodzinne/web-inf/struts-config.xml <set-property property="url" value="jdbc:firebirdsql:localhost/3050:/data/sr/swiadczenia_baza/sw_rodz.gdb?encoding=win1250" /> <set-property property="username" value="sysdba" /> <set-property property="password" value="tajnehasło" /> 9. Uruchamiamy serwer tomcat za pomocą skryptu tomcat, który należy umieścić w lokalizacji /etc/init.d #!/bin/sh start_tomcat=/opt/tomcat/bin/startup.sh stop_tomcat=/opt/tomcat/bin/shutdown.sh start() { echo -n "Starting tomcat: " ${start_tomcat} echo "done." } stop() { echo -n "Shutting down tomcat: " ${stop_tomcat} echo "done." } # See how we were called case "$1" in start) start ;; stop) stop ;; restart) stop sleep 10 start ;; *) echo "Usage: $0 {start stop restart}" esac exit 0 Strona 14
10. Aby uzyskać dostęp do aplikacji otwieramy przeglądarkę internetową i w pasku adresu wpisujemy: http://adres_ip_serwera:8080/swiadczenia_rodzinne 11. Aby umożliwić szyfrowanie części wygenerowanego pliku zbioru centralnego, z aplikacji ŚR należy do dystrybucji systemu doinstalować pakiety xmlsec1. Dla opisanej dystrybucji i wersji systemu pakiety można wyszukać a następnie pobrać z tej lokalizacji http://rpm.pbone.net/ Pakiety do pobrania to: xmlsec1-1.2.10-13.1.x86_64.rpm xmlsec1-devel-1.2.10-13.1.x86_64.rpm xmlsec1-openssl-1.2.10-13.1.x86_64.rpm xmlsec1-openssl-devel-1.2.10-13.1.x86_64.rpm W przypadku wykonywania aktualizacji aplikacji Świadczeń Rodzinnych, należy za każdym razem czyścić dane tymczasowe: dla serwera apache tomcat. Przechodzimy do katalogu /opt/tomcat/work/catalina/localhost i usuwamy katalog "swiadczenia_rodzinne" Strona 15
WYKRYWANIE BŁĘDÓW. Komunikaty o błędach (nazywanych dalej wyjątkami) serwera Tomcat zapisywane są w logach w katalogu logs. Każdy konunikat o błędzie wygląda podobnie do wyjątku pokazanego na rysunku 3. java.net.bindexception: Address already in use:8080 at org.apache.tomcat.util.net.pooltcpendpoint.initendpoint(pooltcpendpoint.java:306) at org.apache.coyote.http11.http11protocol.init(http11protocol.java:184) at org.apache.coyote.tomcat5.coyoteconnector.initialize(coyoteconnector.java:1445) at org.apache.catalina.core.standardservice.initialize(standardservice.java:648) at org.apache.catalina.core.standardserver.initialize(standardserver.java:2416) at org.apache.catalina.startup.catalina.load(catalina.java:545) at org.apache.catalina.startup.catalina.load(catalina.java:566) at sun.reflect.nativemethodaccessorimpl.invoke0(native Method) at sun.reflect.nativemethodaccessorimpl.invoke(nativemethodaccessorimpl.java:39) at sun.reflect.delegatingmethodaccessorimpl.invoke(delegatingmethodaccessorimpl.java: 25) at java.lang.reflect.method.invoke(method.java:324) at org.apache.catalina.startup.bootstrap.load(bootstrap.java:260) at org.apache.catalina.startup.bootstrap.main(bootstrap.java:397) Rys 3. Przykładowy konunikat wyjątku. W dalszej części tego rozdziału pokazane zostaną najczęściej występujące wyjątki związane z błędami w administracji serewera Tomcat. Strona 16
BŁĘDY BAZY DANYCH. błędy w pliku struts-config.xml 1. Błąd składni w pliku struts-config.xml. a) W przeglądarce pojawi się strona z napisem: HTTP Status 404 - Servlet action is not available b) Plik Catalina.out będzie zawierać podobny wpis: org.xml.sax.saxparseexception: The value of attribute "value" associated with an element type "set-property" must not contain the '<' character. 2. Złe parametry definicji źródła danych. a) W przeglądarce pojawi się strona z napisem: HTTP Status 404 - Servlet action is not available b) Plik Catalina.out będzie zawierać podobny wpis: org.apache.commons.dbcp.sqlnestedexception: Cannot create PoolableConnectionFactory, cause: org.firebirdsql.jdbc.fbsqlexception: Resource Exception. I/O error during "open" operation for file "/swiadczenia_rodzinne/baza/w_rodz.gdb" Error while trying to open file null Reason: I/O error during "open" operation for file "/swiadczenia_rodzinne/baza/w_rodz.gdb" Error while trying to open file null 3. Złe hasło bazy danych. a) W przeglądarce pojawi się strona z napisem: HTTP Status 404 - Servlet action is not available b) Plik Catalina.out będzie zawierać podobny wpis: org.apache.commons.dbcp.sqlnestedexception: Cannot create PoolableConnectionFactory, cause: org.firebirdsql.jdbc.fbsqlexception: Resource Exception. Your user name and password are not defined. Ask your database administrator to set up a Firebird login. Reason: Your user name and password are not defined. Ask your database administrator to set up a Firebird login. 4. Zła nazwa hosta na którym zainstalowana jest baza danych. a) W przeglądarce pojawi się strona z napisem: HTTP Status 404 - Servlet action is not available b) Plik Catalina.out będzie zawierać podobny wpis: org.apache.commons.dbcp.sqlnestedexception: Cannot create PoolableConnectionFactory, cause: org.firebirdsql.jdbc.fbsqlexception: Resource Exception. Unable to complete network request to host "192.168.1.5". Reason: Unable to complete network request to host "192.168.1.5". Strona 17
5. Zły numer portu serwera bazy danych. a) W przeglądarce pojawi się strona z napisem: HTTP Status 404 - Servlet action is not available b) Plik Catalina.out będzie zawierać podobny wpis: org.apache.commons.dbcp.sqlnestedexception: Cannot create PoolableConnectionFactory, cause: org.firebirdsql.jdbc.fbsqlexception: Resource Exception. Unable to complete network request to host "localhost". Reason: Unable to complete network request to host "localhost". problemy z plikiem bazy danych 1. Nazwa pliku bazy została nieprawidłowo podana. a) W przeglądarce pojawi się strona z napisem: HTTP Status 404 - Servlet action is not available b) Plik Catalina.out będzie zawierać podobny wpis: org.apache.commons.dbcp.sqlnestedexception: Cannot create PoolableConnectionFactory, cause: org.firebirdsql.jdbc.fbsqlexception: Resource Exception. I/O error during "open" operation for file "/swiadczenia_rodzinne/baza/sw_rodz.gdb" Error while trying to open file null Reason: I/O error during "open" operation for file "/swiadczenia_rodzinne/baza/sw_rodz.gdb" Error while trying to open file null 2. Plik bazy danych nie ma praw do zapisu a) W przeglądarce pojawi się strona z napisem: HTTP Status 404 - Servlet action is not available b) Plik Catalina.out będzie zawierać podobny wpis: org.apache.commons.dbcp.sqlnestedexception: Cannot create PoolableConnectionFactory, cause: org.firebirdsql.jdbc.fbsqlexception: Resource Exception. no permission for read-write access to database /swiadczenia_rodzinne/baza/sw_rodz.gdb Reason: no permission for read-write access to database /swiadczenia_rodzinne/baza/sw_rodz.gdb 3. Plik bazy danych nie ma praw do odczytu a) W przeglądarce pojawi się strona z napisem: HTTP Status 404 - Servlet action is not available b) Plik Catalina.out będzie zawierać podobny wpis: org.apache.commons.dbcp.sqlnestedexception: Cannot create PoolableConnectionFactory, cause: org.firebirdsql.jdbc.fbsqlexception: Resource Exception. I/O error during "open" operation for file "/swiadczenia_rodzinne/baza/sw_rodz.gdb" Error while trying to open file null Reason: I/O error during "open" operation for file "/swiadczenia_rodzinne/baza/sw_rodz.gdb" Error while trying to open file Strona 18
3. Plik bazy danych nie ma praw do odczytu null 4. Niewłaściwa wersja pliku bazy danych a) W przeglądarce może pojawić się strona z napisem: HTTP Status 404 - Servlet action is not available lub pojawi się niewypełniony formularz (przy podglądzie danych). Wszelkie zapisywane dane zostaną utracone b) W zależności od bezpośredniej przyczyny wystąpienia błędu plik Catalina.out będzie zaierzać różne komunikaty. Oto przykładowy komunikat: org.firebirdsql.jdbc.fbsqlexception: Column name NR_KONTA not found in result set. Strona 19
BŁĘDY SERWERA TOMCAT problemy ze startem serwera Tomcat 1. Porty serwera Tomcat są już zajęte przez inną aplikację a) Serwer Tomcat nie uruchomi się b) Plik Catalina.out będzie zawierać podobny wpis: java.net.bindexception: Address already in use:8080 Strona 20
INSTALACJA I URUCHOMIENIE SYSTEMU NA STACJI ROBOCZEJ Z racji obsługi programu z poziomu przeglądarki internetowej instalacja na stacji roboczej sprowadza się do wpisania adresu serwera obsługującego program do pola Adres w przeglądarce w formacie: http://adres_serwera:8080/swiadczenia_rodzinne Informacje o adresie serwera w Państwa przypadku należy uzyskać od administratora na przykład: http://192.168.1.100:8080/swiadczenia_rodzinne Po wpisaniu poprawnego adresu pojawi się ekran logowania: W celu ułatwienia dalszej pracy poprzez eliminację konieczności każdorazowego wpisywania adresu, zalecane jest dodanie powyższego adresu do Ulubionych w przeglądarce Ie, do Zakładek w przeglądarce Firefox i/lub utworzenie skrótu na pulpicie w formie podanej powyżej. Dzięki modułowej budowie aplikacji istnieje możliwość jej obsługi w terenie i rozproszonej strukturze organizacyjnej (filie). W tym przypadku należy skontaktować się z administratorem w celu ustalenia routowalnego numeru IP odpowiadającego adresowi serwera w Państwa sieci. Przykład dla połączeń z serwerem aplikacji, posiadającym dwa interfejsy sieciowe: Serwer aplikacji znajduje się w ośrodku pomocy społecznej, jego konfiguracja sieciowa: 192.168.1.1 adres IP z puli prywatnej na interfejsie od strony sieci LAN 234.42.23.1 publiczny adres IP na interfejsie od strony sieci internet. Użytkowanie programu może odbywać się na dwa sposoby: Pracownicy korzystając z programu na terenie ośrodka łączą się z adresem 192.168.1.1 (w polu adresu przeglądarki podają: http://192.168.1.1:8080/swiadczenia_rodzinne) Strona 21
Pracownicy korzystając z programu w terenie łączą się z adresem 234.42.23.1 (w polu adresu przeglądarki podają: http://234.42.23.1:8080/swiadczenia_rodzinne) Istnieje możliwość obsługi programu zarówno w sieci wewnętrznej ośrodka (bez połączenia z Internetem) jak również z końcówek rozproszonych w dowolnym miejscu w Internecie. Końcówką może być nie tylko komputer ale również palmtop czy dowolne inne urządzenie obsługujące przeglądanie stron WWW. Gdy zdecydujemy się na pracę na centralnym serwerze, zagwarantuje to nam przede wszystkim spójność danych, bezpieczeństwo, łatwość archiwizacji oraz łatwość aktualizacji. Aby w maksymalnie bezpieczny sposób mogła odbywać się praca w terenie (użytkownicy mobilni) lub w odległych oddziałach (telepraca) na zasobach firmowych należy zastosować bezpieczne połączenia VPN. Stosowana w sieciach VPN technologia szyfrowania zapewnia bezpieczeństwo przesyłanych danych w taki sposób, aby nie mogły one być przechwytywane przez osoby niepowołane. Strona 22
PRACA Z PROGRAMEM PIERWSZE URUCHOMIENIE PROGRAMU Po uruchomieniu programu pojawi się okienko logowania. Przy pierwszym wejściu do systemu należy zalogować się jako użytkownik start. Początkowe hasło jest identyczne jak login, czyli start. Wejście do programu Loguj. Ustawienie kursora w odpowiednim polu za pomocą myszki lub klawisza Tab. Skok do następnego pola Tab. Skok do poprzedniego pola Shift+Tab Strona 23
SŁOWNIKI Jest to kolejna opcja w Menu System. Są trzy rodzaje słowników: Lokalne słowniki, które może zmieniać administrator systemu. Wszelkie zmiany np. terminów wypłaty, form wypłaty, bądź dopisanie nazw banków dokonuje się w słownikach lokalnych. Systemowe Dystrybuowane słowniki dostarczane przez MPiPS w postaci pliku, wczytywane przez program. Poniżej opisano przykładową operację dopisania nazwy banku w słowniku lokalnym. Dodanie nowego słowa do słownika lokalnego Wejście do słowników lokalnych przez menu System Lista słowników Słowniki lokalne. UWAGA! Ważne jest ustalenie przez użytkownika zawartości dwóch słowników: 6 - KOD_SPOSOBU_REALIZACJI_WYPŁATY 7 TERMIN_WYPŁATY Wstępnie 6 słownik wypełniono takimi formami wypłaty jak: gotówka, przekaz pocztowy, przelew. Dodanie kolejnego słowa odbywa się analogicznie jak w przypadku dopisywania nazw banków. Dodanie kolejnego sposobu realizacji jest zdefiniowane jako wypłata w kasie (np. Urzędu Pocztowego). Użytkownik może wg potrzeb wypełnić słownik 7, podając terminy, w jakich są realizowane wypłaty świadczeń (dodawanie nowych terminów analogicznie jak przy bankach). Aby dodać nazwę banku do słownika, należy wybrać (kliknąć na) słownik NAZWY_BANKÓW. W przypadku zmiany lub dopisywania słów do innego słownika wszystkie operacje dokonuje się analogicznie, wybierając odpowiedni słownik. Strona 24
W polu Tekst należy wpisać nazwę banku (nazwa ta będzie widoczna u klientów przy wyborze banku). W polu Kod zaleca się nadawać kolejne numery, zaczynając od 1. Dane słowo może mieć swoją ważność. Jeżeli pole Ważność do uzupełni się datą wsteczną, to dopisane słowo nie będzie widoczne przy wyborze banku u klienta. Daty ważności nie muszą być wypełnione, wówczas słowo będzie zawsze widoczne przy wyborze banku u klienta. Po wypełnieniu pól klikamy Zapisz. Aby zmiany dokonane w słownikach były widoczne w programie, należy się wylogować i ponownie się zalogować. Po wpisaniu nowego banku będzie on widniał w tabeli. Dodanie kolejnego banku odbywa się według instrukcji powyżej. W razie popełnienia błędu przy wypełnianiu nazwy banku można wrócić do edycji, klikając na nazwie banku w tabeli. Każdą zmianę należy zatwierdzić przez kliknięcie na Zapisz. Strona 25
DOKUMENTY DOŁĄCZANE DO WNIOSKÓW W systemie mamy do wyboru z listy dokumentów, dokumenty dołączane do wniosku. Istniejącym uproszczeniem, jest pogrupowanie dokumentów, w zależności od typu wniosku. W przypadku, gdy w zestawie dokumentów dołączanych do wniosku brakuje jakiegoś dokumentu, można go dodać do tego zestawu. Wejście do słowników lokalnych przez menu System Lista słowników Słowniki lokalne. Pojawi się ekran z nazwami wniosków. Aby przypisać dokumenty klikamy przy wybranym wniosku. Po wejściu w przypisywanie dokumentów pojawi się lista dokumentów. Strona 26
Jeśli dany dokument ma być wymieniony przy konkretnym wniosku, należy przy nim zaznaczyć, że jest wymagany. Po dokonaniu wyboru klikamy Zapisz. Strona 27
WPROWADZANIE DANYCH URZĘDU ADMINISTRACJI PUBLICZNEJ Po pierwszym uruchomieniu programu uzupełnij dane użytkownika (właściwego urzędu administracji publicznej). System Dane Użytkownika Edytuj dane Użytkownika. Zostaniemy przeniesieni do formatki, danych Użytkownika. Widok poniżej. Strona 28
Uzupełniamy dane użytkownika, wpisując adres, wybierając Bank, (uprzednio dodany do słowników), wpisując Nr konta, z którego będziemy dokonywać płatności. Pieczątka -1 linia oraz Pieczątka -2 linia służy do wpisania danych z pieczątki użytkownika, aby później korzystając ze zmiennych systemowych móc ich użyć w formie w jakiej zostały wpisane. Pole Upust na poczcie służy do uzupełnienia, aby tworząc listę na przekaz pocztowy i wyliczając automatycznie porto, uwzględnić posiadany upust. W przypadku braku pouczenia we wzorcach decyzji, uzupełnione pouczenie będzie drukowane jako domyślne w decyzjach. Pozostała część parametrów, występuje celem spersonalizowania aplikacji, gdzie każda instytucja może dokonać własnego wyboru. W polach dotyczących numeracji dokumentów, możemy zastosować zmienną $auto, która zastąpi nam kolejny numer, nadany automatycznie po zapisaniu dokumentu. Po uzupełnieniu danych, klikamy w Zapisz. Strona 29
WYBÓR LOKALIZACJI DO SPRAWOZDAŃ Po pierwszym uruchomieniu programu uzupełnij dane użytkownika (właściwego urzędu administracji publicznej). System Dane Użytkownika Wybierz lokalizację. Należy wybrać lokalizację (miejscowość) użytkownika, rozwijając kolejno (kliknięcie na +) województwo, podregion, powiat. Po dokonaniu wyboru miejscowości trzeba potwierdzić wybór poprzez kliknięcie na Zapisz. Strona 30