Instalacja i pierwsze uruchomienie aplikacji Cyfrowe Repozytorium Dokumentów (CRD) Aplikacja Cyfrowe Repozytorium Dokumentów (CRD) jest przeznaczona do wspomagania zarządzania teczkami klientów, przechowywanymi w postaci elektronicznej i papierowej oraz obsługi dokumentów zgromadzonych w tych teczkach w ramach obsługi Świadczeń Rodzinnych, Świadczeń Wychowawczych, Funduszu Alimentacyjnego, Dodatków Mieszkaniowych i Energetycznych, Stypendiów oraz Pomocy Społecznej (w tym Pomoc Społeczna, Wsparcie Rodziny, Piecza Zastępcza, Zespół Interdyscyplinarny oraz Karta Polaka ). 27 kwietnia 2018r.
W niniejszym dokumencie zostały szczegółowo opisane procedury postępowania przy instalacji aplikacji Cyfrowe Repozytorium Dokumentów (CRD), która wspomaga zarządzanie teczkami klientów przechowywanymi w postaci elektronicznej i papierowej, w Jednostkach z obszaru Zabezpieczenia Społecznego oraz obsługę dokumentów zgromadzonych w tych teczkach. Aplikacja ta może współpracować z dowolną liczbą systemów dziedzinowych (systemów źródłowych), zasilających Cyfrowe Repozytorium Dokumentów dokumentami klientów. Aplikację CRD można zainstalować w środowisku Windows na serwerze z systemami dziedzinowym, jak i na komputerze bez systemów dziedzinowych. Plik instalacyjny CRD_1.1.0.exe należy skopiować na dysk komputera, na którym będzie prowadzona instalacja, następnie uruchomić go. Niniejsza instrukcja opisuje trzy rodzaje instalacji aplikacji: Instalację na serwerze; Instalację na stacji roboczej klienckiej; Instalację na stacji roboczej klienckiej, z możliwością obsługi skanowania dokumentów. Przed przystąpieniem do instalacji aplikacji CRD należy zapoznać się z opisem wymagań sprzętowo - systemowych. Szczegółowy opis wymagań, z podziałem na rodzaj instalacji znajduje się w osobnym dokumencie Wymagania sprzętowo - systemowe dla CRD. Po poprawnym zainstalowaniu aplikacji CRD należy: - wykonać czynności związane z pierwszym uruchomieniem aplikacji. Szczegółowy opis znajduje się w rozdziale Pierwsze uruchomienie i logowanie do aplikacji, - wprowadzić klucz licencyjny. Szczegółowy opis znajduje się w rozdziale Licencje, - skonfigurować ustawienia komunikacji systemu dziedzinowego z aplikacją CRD Szczegółowy opis znajduje się w rozdziale Konfiguracja połączenia systemów źródłowych z aplikacją CRD. Instalacja na serwerze Niezbędnym wymogiem do poprawnego działania aplikacji jest: możliwość nawiązania połączenia sieciowego z serwera systemów źródłowych poprzez port TCP domyślnie port o numerze 8380; zainstalowana Java JDK 8 update 65 lub wyższa; zainstalowane oprogramowanie bazodanowe Firebird 2.5.7 (zalecana wersja). Po uruchomieniu pliku instalacyjnego otworzy się okno "Instalacja oprogramowania", w którym prezentowane są kolejne kroki, umożliwiające instalację aplikacji. Po przeczytaniu zawartych w oknie informacji wybieramy przycisk Dalej >. 2
Wybieramy rodzaj instalacji. Jeżeli wykonujemy instalację na serwerze, zaznaczamy ( ) opcję Serwer, a następnie wybieramy przycisk Dalej >. Wskazujemy lokalizację uprzednio zainstalowanego serwera bazy danych Firebird 2.5.7 oraz JDK 8 update 65. Jako domyślna lokalizacja serwera bazy danych Firebird sugerowana jest: C:\ProgramFiles\Firebird\Firebird_2_5. Jako domyślna lokalizacja Javy sugerowana jest: C:\ProgramFiles\\Java\ jdk1.8.0_65. W przypadku, gdy podpowiedziana lokalizacja nie jest właściwa, to za pomocą przycisku Zmień należy wskazać poprawną. Wybieramy przycisk Dalej >. Wskazujemy lokalizację na dysku, na którym ma być zainstalowana aplikacja. Aplikacja zostanie zainstalowana na wskazanym dysku w katalogu: SYG_CyfroweRepozytoriumDokumentow W przypadku, gdy podpowiedziana lokalizacja nie jest właściwa, to za pomocą przycisku Zmień wskazujemy poprawne miejsce instalacji aplikacji. Wybieramy przycisk Dalej >. 3
Następnie wprowadzamy własne hasło użytkownika SYSDBA serwera bazy danych Firebird i wybieramy przycisk Dalej>. Uwaga! Ze względów bezpieczeństwa zalecane jest wprowadzenie hasła innego niż domyślnie podpowiadanego "masterkey". Wybieramy rodzaj instalacji serwera JBoss. Wybranie opcji Zainstaluj serwer JBoss jako usługę uruchamianą przy starcie systemu operacyjnego spowoduje, że na liście usług systemowych zostanie dodana usługa JBossCRD uruchamiana automatycznie wraz ze startem systemu operacyjnego (JBoss będzie pracował w tle bez widocznej konsoli). Wybranie opcji Zainstaluj serwer JBoss jako aplikację uruchamianą przy starcie systemu operacyjnego spowoduje, że serwer będzie uruchamiany po zalogowaniu się do systemu operacyjnego na podstawie skrótu umieszczonego w Autostarcie (w trakcie pracy będzie widoczna konsola JBossa). Wybieramy przycisk Dalej >. W oknie "Instalacja oprogramowania" wyświetli się informacja o parametrach wykonywanej instalacji. Po przeczytaniu zawartych w oknie informacji wybieramy przycisk Dalej >. 4
Rozpocznie się proces instalacji plików. Po zakończeniu instalacji plików, jeśli w trakcie konfiguracji nie pojawią się żadne błędy, otworzy się okno, informujące o pomyślnym zainstalowaniu aplikacji. Po wybraniu przycisku Zakończ nastąpi zakończenie instalacji aplikacji. Jeżeli w trakcie instalacji nie pojawiły się żadne problemy ani komunikaty o błędach, możemy uznać, że instalacja aplikacji zakończyła się powodzeniem. Po zakończeniu instalacji musimy zrestartować komputer. Po zainstalowaniu aplikacji CRD możemy przystąpić do pracy w aplikacji. Instalacja na stacji roboczej klienckiej Niezbędnym wymogiem do poprawnego działania aplikacji na stacji klienckiej jest: możliwość nawiązania połączenia sieciowego z serwera systemów źródłowych poprzez port TCP domyślnie port o numerze 8380; zainstalowana Java JRE 8 update 65 lub wyższa. Uwaga! W przypadku instalacji aplikacji na stacji roboczej do skanowania dokumentów niezbędna jest wcześniejsza instalacja Java JRE 8 update 65 lub wyższa, w wersji 32-bitowej. 5
Po uruchomieniu pliku instalacyjnego otworzy się okno "Instalacja oprogramowania", w którym prezentowane są kolejne kroki, umożliwiające instalację aplikacji. Po przeczytaniu zawartych w oknie informacji wybieramy przycisk Dalej >. Wybieramy rodzaj instalacji. Jeżeli wykonujemy instalację na klienckiej stacji roboczej, zaznaczamy ( ) opcję Stacja robocza (Klient). Jeżeli wykonujemy instalację na klienckiej stacji roboczej z obsługą skanowania, zaznaczamy ( ) opcję Stacja robocza (Klient z obsługą skanowania), a następnie wybieramy przycisk Dalej >. Wprowadzamy dane serwera aplikacji, a następnie wybieramy przycisk Dalej >. 6
W oknie "Instalacja oprogramowania" wyświetli się informacja o parametrach wykonywanej instalacji. Po przeczytaniu zawartych w oknie informacji wybieramy przycisk Dalej >. Rozpocznie się proces instalacji plików. Po zakończeniu instalacji plików, jeśli w trakcie konfiguracji nie pojawią się żadne błędy, otworzy się okno, informujące o pomyślnym zainstalowaniu aplikacji. Po wybraniu przycisku Zakończ nastąpi zakończenie instalacji aplikacji. 7
Jeżeli w trakcie instalacji nie pojawiły się żadne problemy ani komunikaty o błędach, możemy uznać, że instalacja aplikacji zakończyła się powodzeniem. Po zakończeniu instalacji musimy zrestartować komputer. Po zainstalowaniu aplikacji CRD możemy przystąpić do pracy w aplikacji. Pierwsze uruchomienie i logowanie do aplikacji Przed uruchomieniem aplikacji CRD należy uruchomić serwer aplikacji. W tym celu należy wybrać ikonę, znajdującą się na pulpicie. Po poprawnym uruchomieniu serwera należy uruchomić aplikację CRD, wybierając ikonę, znajdującą się na pulpicie. W przeglądarce zostanie otwarte okno umożliwiające uruchomienie aplikacji, poprzez wybranie pozycji Uruchomienie systemu Cyfrowego Repozytorium Dokumentów. Uwaga! Aplikację CRD można również uruchomić bez korzystania z przeglądarki internetowej, wybierając na pulpicie ikonę. Przy pierwszym uruchomieniu aplikacji otworzy się okno "Pierwsze uruchomienie aplikacji", w którym podajemy dane jednostki, która będzie pracować w aplikacji oraz dane użytkownika. 8
W oknie uzupełniamy pola: Nazwa - podajemy pełną nazwę jednostki pracującej w systemie; Jednostka - z listy wybieramy Kod Elementu Struktury Organizacyjnej (KESO) jednostki. Jeśli są dwie takie same miejscowości wybieramy jedną z nich i sprawdzamy czy typ obszaru jest zgodny z tym, w którym chcemy wykonać instalację. Z kodu lokalizacji możemy rozpoznać typ obszaru. Ostatnia cyfra przed literami SR oznacza typ obszaru: 1 - gmina miejska, 2 - gmina wiejska, 3 - gmina miejsko-wiejska. Kod lokalizacji - pole uzupełnia się automatycznie po podaniu jednostki, pole niedostępne; Typ obszaru - pole uzupełnia się automatycznie po podaniu jednostki, pole niedostępne; W dolnej części okna podajemy dane użytkownika: Identyfikator - w tym polu wpisujemy login, jakim osoba będzie posługiwała się przy logowaniu się do systemu, mogą to być np. inicjały użytkownika; Nazwisko - podajemy nazwisko użytkownika; Imię - podajemy imię użytkownika; Hasło - podajemy hasło, jakim użytkownik będzie się posługiwał przy kolejnym logowaniu się do systemu; Powtórz hasło - jeszcze raz wpisujemy hasło wpisane w polu powyżej; Po uzupełnieniu wszystkich pól opuszczamy okno, wybierając ikonę Akceptuj. Pojawi się okno "Logowanie". W oknie wprowadzamy dane administratora Identyfikator oraz Hasło, zadeklarowane podczas uzupełniania danych w oknie "Pierwsze uruchomienie aplikacji". Uwaga! Wpisując hasło musimy zwrócić uwagę na wielkość liter - w przypadku włączonego klawisza <Caps Lock> pojawi się odpowiednia informacja:. Po zalogowaniu się Użytkownik będzie miał dostępne wszystkie zakładki, przyciski i menu wynikające z uprawnień i ról Administratora. Użytkownik może przystąpić do konfiguracji ustawień aplikacji CRD oraz połączenia systemu dziedzinowego z CRD. WAŻNE! Aby uzyskać dostęp do konfiguracji komunikacji systemu Pomost Std z aplikacją CRD, należy zaktualizować system Pomost Std do wersji 3-15.2. Każda Jednostka, która złoży zamówienie na licencję współpracy CRD z Pomost Std, zwrotnie otrzyma aktualizację aktywującą konfigurację połączenia CRD z Pomost Std. Aktualizacja ta będzie dostępna z okna automatycznych aktualizacji w systemie Pomost Std 3-15.2 i będzie oznaczona jako 3-15.2DPP001. 9
Licencje Aby uzyskać dostęp do aplikacji CRD należy złożyć zamówienie na licencję, poprzez przesłanie do dostawcy oprogramowania formularza zamówienia licencji. Formularz zamówienia licencji jest dostępny do pobrania na stronie: http://public.sygnity.pl/zabezpieczeniespoleczne/cyfrowe-repozytorium-dokumentow/oferta. Uwaga! Istnieje możliwość wykupienia klucza licencyjnego na rok: na komunikację tylko z jednym systemem dziedzinowym lub wszystkim obsługiwanymi systemami dziedzinowymi (Oprogramowanie do obsługi SR/FA/SW/DM/ST i/lub Pomost Std (PS, WR, PZ, ZI, KP)), na ograniczoną ilość przesłanych dokumentów, bez limitu na ilość przesłanych dokumentów. W tym przypadku należy skontaktować się z dostawcą pod adresem usługi.zs@sygnity.pl. Dla jednostek, które złożyły zamówienie na licencję, generowany jest kod licencyjny, umożliwiający dostęp do aplikacji i zasilanie wybraną w formularzu zamówienia ilością dokumentów z systemu źródłowego. Dla jednostek obsługujących na jednej bazie wszystkie obsługiwane systemy dziedzinowe dedykowana jest licencja pakietowa komunikacji z Oprogramowaniem do obsługi SR/FA/SW/DM/ST i systemem Pomost Std. Kod licencyjny zostanie przesłany na podany przez jednostkę adres mailowy. Aby wprowadzić otrzymany kod licencyjny, w głównym oknie aplikacji CRD wybieramy link Kody Licencyjne. Otworzy się okno "Wprowadzanie kodu". W oknie w polu edycyjnym wprowadzamy otrzymany kod licencyjny i wybieramy przycisk Wprowadź nowy kod. Po prawidłowym wprowadzeniu kodu licencyjnego, pojawi się okno Akceptacja warunków umowy. Po zapoznaniu się z Umową licencyjną, zaznaczamy w lewym dolnym rogu okna akceptuję warunki umowy. Okno opuszczamy za pomocą ikony Akceptuj. 10
Uwaga! W przypadku nie zaakceptowania warunków licencji i opuszczeniu okna za pomocą ikony Akceptuj, pojawi się komunikat: Należy zaakceptować warunki umowy licencyjnej. Jeśli nie chcemy akceptować warunków licencji, należy opuścić okno Akceptacja warunków umowy poprzez ikonę Anuluj. Po zaakceptowaniu Umowy licencyjnej, w oknie Wprowadzanie kodu pojawią się informacje o terminie obowiązywania wprowadzonego kodu licencyjnego oraz zakupionym limicie dokumentów. Okno "Wprowadzenie kodu licencyjnego opuszczamy, wybierając ikonę. W lewym dolnym rogu głównego okna aplikacji znajduje się sekcja Stan zasilenia, w której prezentowany jest licznik, zgodny z zamówionym w licencji limitem dokumentów: Licznik stanu zasilenia, w przypadku: braku ważnego kodu licencyjnego, wyświetlana jest wartość: Brak klucza licencyjnego ; zakupu licencji z limitem dokumentów, wyświetlana jest wartość zgodna z zamówionym w licencji limitem dokumentów. Jeżeli w trakcie obowiązywania licencji limit zostanie wyczerpany, to wówczas wyświetlana jest wartość 0. Wówczas zasilenie aplikacji CRD dokumentami z systemu źródłowego jest niemożliwe Jeżeli limit nie zostanie wykorzystany w trakcie obowiązywania licencji, to w przypadku zakupu kolejnej licencji niewykorzystany limit z poprzedniego okresu zostanie dodany do nowego limitu limity zostaną zsumowane; zakupu licencji bez limitu dokumentów (w trakcie obowiązywania licencji), wyświetlana jest wartość: Brak limitu. Stan zasilenia może zostać zwiększony tylko przez wprowadzenie nowego klucza licencyjnego. Licznik stanu zasilenia jest aktualizowany po odebraniu w CRD dokumentów przesłanych z systemu źródłowego. Powodem zmniejszania się stanu licznika jest: przesłanie z systemów źródłowych do CRD dokumentów: wniosków, wszczęć postępowań i odwołań (z datą złożenia od 2018 roku) oraz decyzji, upomnień, tytułów wykonawczych, korespondencji i wywiadów (z datą rejestracji od 2018 roku); usunięcie dokumentów z CRD (ręcznie w CRD lub automatycznie np. przez cofnięcie zatwierdzenia decyzji w systemie źródłowym) i ponownego przesłania dokumentu. Uwaga! Ponowne przesłanie dokumentu z systemu źródłowego do CRD (np. przez aktualizację dokumentu), nie powoduje zmniejszenia się stanu licznika. Konfiguracja połączenia systemów źródłowych z aplikacją CRD Aby skonfigurować połączenie wybranego systemu źródłowego z aplikacją CRD, w głównym oknie systemu źródłowego, na zakładce Administracja wybieramy menu Administracja>Usługi>Konfiguracja usług. Otworzy się okno "Konfiguracja usług". 11
W oknie, na zakładce Cyfrowe Repozytorium Dokumentów wprowadzamy Adres serwera, na którym została zainstalowana aplikacja CRD. Domyślnie system podpowiada w polu Port usługi numer: 8380, który jest portem, na którym pracuje aplikacja CRD i w związku z tym nie należy zmieniać podpowiedzianego numeru portu. Przed uzupełnieniem danych identyfikujących system źródłowy w CRD, za pomocą przycisku Konfiguracja komunikacji należy skonfigurować pozostałe dane dotyczące komunikacji systemu źródłowego z aplikacją CRD. Szczegółowy sposób konfiguracji połączenia tych danych został opisany w oddzielnej instrukcji Instrukcja obsługi aplikacji Cyfrowe Repozytorium Dokumentów (CRD), w rozdziale Konfiguracja komunikacji systemów źródłowych z aplikacją CRD. Następnie można przystąpić do rejestracji systemu źródłowego w CRD. W tym celu w oknie Konfiguracja usług, na zakładce Cyfrowe Repozytorium Dokumentów należy w polu Identyfikator SD wprowadzić unikalny identyfikator systemu źródłowego - dowolną wartość z przedziału od 11 do 98. Następnie na podstawie identyfikatora SD należy wygenerować unikalny identyfikator UUID SD, wybierając przycisk Generuj UUID. Uwaga! Identyfikator SD i UUID SD są ze sobą powiązane i zależne, co oznacza, że dla jednego Identyfikatora SD możemy wygenerować jeden unikalny UUID. Na podstawie wartości uzupełnionych w polach Identyfikator SD i UUID SD, aplikacja CRD identyfikuje system źródłowy. Za pomocą przycisku Sprawdź połączenie mamy możliwość sprawdzenia poprawności konfiguracji połączenia z aplikacją CRD. Wynik sprawdzenia zostaje wyświetlony w polu Test usługi. W przypadku poprawnego połączenia z aplikacją w polu Test usługi zostaną wyświetlone informacje dotyczące połączenia z zainstalowaną aplikacją. Uwaga! Jeżeli do CRD ma być podłączony więcej niż jeden system źródłowy, to Identyfikator SD trzeba ustalić z administratorem systemu. Wprowadzenie jednakowego Identyfikatora SD dla dwóch różnych systemów spowoduje, że CRD będzie odbierało komunikaty i zasilenia z systemu źródłowego, który skomunikował się (połączył) z CRD, jako pierwszy natomiast komunikaty pochodzące z systemu źródłowego, który połączył się z CRD, jako drugi będą odrzucane. Po prawidłowym skomunikowaniu obu aplikacji, przed przystąpieniem do zasilania aplikacji CRD danymi z systemu źródłowego, zaleca się przelogowanie Użytkownika. Szczegółowy opis obsługi aplikacji CRD oraz zasilania CRD danymi z systemów źródłowych znajduje się w dokumentacji użytkownika dla aplikacji Cyfrowe Repozytorium Dokumentów (CRD). 12