Dokumentacja administratora W projekcie: Wykonanie modułów, raportów i rejestrów do EZD PUW, usług na epuap oraz przeprowadzenie szkoleń w ramach projektu POIG Wersja 0.1 Białystok 2015
Metryka Nazwa projektu Wykonanie modułów, raportów i rejestrów do EZD PUW, usług na epuap oraz przeprowadzenie szkoleń w ramach projektu POIG Tytuł dokumentu Dokumentacja administratora Usługi na epuap Odpowiada Maciej Dorosz Odebrał Data zapisu Wersja 0.1 Status Oczekujący 04.11.2015 Historia dokumentu Nr wersji Data wersji Opis zmiany Autorzy Dokument 0.1 04.11.2015 Pierwsza Tomasz Sobolewski, Dokumentacja wersja robocza Tomasz Laszuk, Adam administratora - raporty Drojewski, Jarosław v0.1.docx Wasilewski, Robert Dąbrowski
Spis treści 1 Cel dokumentu... 4 2 Słownik pojęć... 4 3 Instrukcja instalacji, konfiguracji i administracji dostarczonego oprogramowania aplikacyjnego.. 6 4 Instrukcja i rekomendacje postępowania w przypadkach szczególnych oraz awarii, w tym odtworzenia oprogramowania... 18 5 Rekomendacje dot. archiwizacji oraz tworzenia kopii zapasowej systemu... 18
1 Cel dokumentu Celem dokumentu jest przedstawienie instrukcji instalacji, konfiguracji i administrowania oraz instrukcji i rekomendacji postępowania w przypadkach szczególnych oraz awarii oraz dot. archiwizacji i tworzenia kopii zapasowych oprogramowania zrealizowanego w ramach projektu Wykonanie modułów, raportów i rejestrów do EZD PUW, usług na epuap oraz przeprowadzenie szkoleń w ramach projektu POIG realizowanego przez BIT S.A. na podstawie Umowy WZF-V.806.1.9.2015 z dnia 15.09.2015r. Przedmiot zamówienia jest przeznaczony do realizacji celów Projektu Rozwój i upowszechnienie elektronicznych usług administracji rządowej poprzez rozwój jednolitego systemu elektronicznego zarządzania dokumentacją (EZD) oraz udostępnienie i wdrożenie jednolitych usług w urzędach administracji rządowej RP. Dokument ten stanowi pomoc dla użytkowników zewnętrznych epuap o uprawnieniach instytucji publicznej w zakresie instalacji plików formularzy epuap oraz zamieszczania usług na liście wszystkich usług. Instrukcja instalacji dotyczy instalacji formularzy epuap przygotowanych w ramach zamówienia Wykonanie modułów, raportów i rejestrów do EZD PUW, usług na epuap oraz przeprowadzenie szkoleń w ramach projektu POIG w ramach projektu Rozwój i upowszechnienie elektronicznych usług administracji rządowej poprzez rozwój jednolitego systemu elektronicznego zarządzania dokumentacją (EZD) oraz udostępnienie i wdrożenie jednolitych usług w urzędach administracji rządowej RP. 2 Słownik pojęć Nazwa Formatka Opis usługi Aplikacja epuap Formularz Objaśnienie Każdy ekran, na którym system wyświetla dane użytkownikowi Opis usługi zamieszczony w Katalogu przez instytucję publiczną, zawierający szereg informacji związanych z usługą świadczoną przez tę instytucję i mających na celu ułatwienie użytkownikom skorzystania z danej usługi Konkretny, ze względu na oferowaną użytkownikom funkcjonalność, zestaw metadanych definiujących określone współpracujące ze sobą zasoby uruchomione (lub możliwe do uruchomienia) na platformie epuap, wspierające udostępnienie i realizację jakiejś usługi lub grupy usług publicznych. Platforma teleinformatyczna, umożliwiająca jednostkom administracji świadczenie usług publicznych opartych na elektronicznych kanałach komunikacji poprzez pojedynczy punkt dostępowy w Internecie. Dane oraz oprogramowanie, sporządzone na podstawie wzorca formularza elektronicznego, umożliwiające wprowadzenie danych związanych z konkretnym pismem/podaniem/wnioskiem/informacją.
Wzór lokalny Wyróżnik Schemat wyróżnika XML XSLT Przestrzeń nazw Składnik aplikacji, epuap, który może wchodzić w skład lokalnego repozytorium wzorów dokumentów. Słowny opis całego wzoru zapisany w formie pliku XML. Publikowany na stronach MAiC wzór określający, w jaki sposób należy tworzyć wyróżnik. Istnieje tylko jeden ważny w danym momencie schemat wyróżnika. Uniwersalny język formalny przeznaczony do reprezentowania różnych danych w strukturalizowany sposób. Plik XSL pozwalający na wyświetlenie (zwizualizowanie) danych zawartych w dokumencie elektronicznym w bardziej czytelnej postaci (np. zbliżonej do wersji papierowej). Również standard umożliwiający przetwarzanie dokumentów XML z jednej postaci w inną tzw. transformata. Opisuje referencje zewnętrzne w schemacie danych. Jeśli schemat danych korzysta z innych schematów danych musi to zostać umieszczone w przestrzeni nazw, np. http://crd.gov.pl/xml/schematy/meta/2008/05/09/, http://crd.gov.pl/wzor/2009/02/19/583/.
3 Instrukcja instalacji, konfiguracji i administracji dostarczonego oprogramowania aplikacyjnego 3.1 Warunki wstępne Użytkownik posiada założone konto Instytucji Publicznej na platformie epuap. Użytkownik posiada paczkę instalacyjną z programem generującym pliki formularzy epuap. 3.2 Minimalne wymagania programowe Systemy operacyjne : Microsoft Windows Linux Przeglądarki : Microsoft Internet Explorer 7.0 Mozilla Firefox 3.0 Dodatkowe: Microsoft.Net 3.5 (do uruchomienia programu generującego pliki formularzy epuap) 3.3 Aplikacja 3.3.1 Generowanie plików aplikacji W celu wygenerowania plików formularzy epuap, które następnie będą mogły być zainstalowane na epuap należy uruchomić dostarczoną aplikację poig.epuap.instalator.exe : Po uruchomieniu aplikacji pojawi się ekran jak poniżej:
W odpowiednich polach należy wprowadzić właściwe dane urzędu, które zostaną przeniesione do generowanych plików formularzy epuap oraz fragmenty oświadczeń, informacji i nagłówków dla wybranych formularzy. Po wprowadzeniu danych należy wcisnąć przycisk Generuj. Po chwili, w katalogu z aplikacją zostaną zapisane (pojawią się) pliki formularzy epuap, które należy zaimportować do epuap:
3.3.2 Import pliku formularzy Aby zaimportować pliki formularzy, należy zalogować się na swoje konto. Następnie należy przejść do pozycji menu Administrowanie -> Budowanie usług:
Następnie należy wybrać sekcję (z lewego menu) Formularze :
Następnie należy kliknąć przycisk Import z XML : W oknie, które się pojawi, należy kliknąć przycisk Wybierz plik formularza i wskazać z dysku jeden z plików wygenerowanych we wcześniejszym kroku.
Po wskazaniu pliku należy wcisnąć przycisk Import z XML :
Prawidłowy import formularza zostanie potwierdzony odpowiednim komunikatem: 3.3.3 Postępowanie w przypadku błędu W przypadku błędu należy skontaktować się z administratorami epuap w celu dalszej weryfikacji problemu. 3.4 Katalog usług W celu dodania usługi do katalogu usług należy przejść do sekcji menu Administrowanie -> Budowanie usług, a następnie przejść do sekcji (działu) Karty sprawy:
W oknie które się pojawi należy kliknąć przycisk Dodaj kartę sprawy, a następnie z listy kart usług dostępnych i potwierdzonych przez administratorów epuap wskazać właściwą dla danego formularza/usługi pozycję klikając link Wybierz : Następnie pod listą klikamy w przycisk Dalej. Na kolejnej stronie należy upewnić się czy dane urzędu są prawidłowe. Potwierdzamy przyciskiem Dalej. Na kolejnym ekranie należy wskazać tzw. Poziom dostępności usługi: Następnie należy kliknąć przycisk Dalej. Na kolejnym ekranie można opcjonalnie uzupełnić dane dot. m.in. płatności lub wymaganych dokumentów. W celu przejścia na kolejny ekran kreatora karty należy kliknąć przycisk Dalej. Na kolejnym etapie należy wskazać obszar terytorialny świadczenia usługi przez dany urząd wskazując odpowiednio województwo, powiat oraz gminę:
Każdy obszar należy dodać do listy klikając przycisk Dodaj lokalizację. W celu przejścia na kolejny etap należy kliknąć przycisk Dalej. Na etapie Formularze należy kliknąć przycisk Załącz formularz : W oknie które się pojawi należy wprowadzić tytuł formularz widoczny dla klienta:
Następnie wybrać właściwy formularz przyciskiem Wybierz : W sekcji Data obowiązywanie formularza można zaznaczyć pole formularz bezterminowy : W sekcji Wskaż skrytkę należy wybrać jedną z dostępnych skrytek na którą będzie wysyłany formularz wypełniony przez klienta. Zalecane jest wskazanie skrytki SkrytkaESP:
Okno załączania formularza zatwierdzamy przyciskiem Zapisz, a następnie klikamy przycisk Dalej kreatora karty. Na ostatnim etapie tworzenia karty usługi można zdecydować o przetestowaniu karty przed publikacją lub bezpośredniej publikacji karty w katalogu usług: 3.5 Test usługi Po poprawnej publikacji karty usługi, usługa wraz z formularzem dostępna jest z poziomu katalogu usług epuap. Miejsce dostępności formularza uzależnione jest od sposobu opisania i skatalogowania danej usługi przez administratorów epuap.
3.6 Pomoc Pomoc można szukać na stronach epuapu (http://epuap.gov.pl/ ) w sekcji pomoc. W razie pytań lub problemów związanych z działaniem systemu epuap prosimy o kontakt z Service Desk epuap
4 Instrukcja i rekomendacje postępowania w przypadkach szczególnych oraz awarii, w tym odtworzenia oprogramowania Z uwagi na charakter i miejsce działania usług nie przewiduje się sytuacji szczególnych lub awaryjnych. Zalecane jest zachowanie poszczególnych plików formularzy w backupie w przypadku awarii systemu epuap lub nieumyślnego skasowania plików formularzy z konta epuap. Działanie formularzy jest całkowicie uzależnione od platformy epuap. 5 Rekomendacje dot. archiwizacji oraz tworzenia kopii zapasowej systemu Zalecane jest zachowanie w backupie plików formularzy. Nie przewiduje się innych dodatkowych czynności archiwizacji.