MINISTERSTWO SPRAW WEWNĘTRZNYCH I ADMINISTRACJI DEPARTAMENT INFORMATYZACJI ul. Wspólna 1/3 00-529 Warszawa ZASADY TWORZENIA JEDNOLITYCH IDENTYFIKATORÓW Projekt współfinansowany Przez Unię Europejską Europejski Fundusz Rozwoju Regionalnego
Autor Zespół projektowy epuap Klient Ministerstwo Spraw Wewnętrznych i Administracji Wersja dokumentu 2.01 Liczba stron 8 Historia zmian Wersja Data Kto Opis zmian 1.00 2007-11 Zespół projektowy epuap 2.00 2008-02-04 Zespół projektowy epuap 2.01 2008-02-12 Zespół projektowy epuap Utworzenie dokumentu Modyfikacja dokumentu (zmiany wypracowane w ramach publicznej dyskusji na portalu epuap oraz w trakcie warsztatów) Uzupełnienie dokumentu 2/8
Wstęp Spis treści Wstęp... 4 Jednolity Identyfikator... 5 1.1 Znaczenie Jednolitego Identyfikatora... 5 1.2 Struktura Jednolitego Identyfikatora... 6 1.3 Nazwa domenowa serwera repozytorium... 6 1.4 Identyfikator w repozytorium... 6 1.5 Struktura Jednolitego Identyfikatora... 7 1.6 Umieszczanie Jednolitego Identyfikatora w strukturze Wyróżnika.... 7 1.7 W jaki sposób dysponując jedynie Identyfikatorem pobrać informacje o Schemacie oraz Stylu... 7 3/8
Wstęp Wstęp Dokument został opracowany w ramach projektu epuap. Niniejszy materiał stanowi założenia inicjujące proces ustanowienia zasad nadawania jednolitych identyfikatorów. Zawarte w dokumencie informacje mają ułatwić interpretacje Jednolitego Identyfikatora. Właściwa Interpretacja zapewnia sprawne zarządzanie wzorami oraz samymi dokumentami elektronicznymi. Dokument powstał w oparciu o Doświadczenia zebrane podczas prac prowadzonych w administracji publicznej. Wymagania polskiego prawa Przegląd doświadczeń międzynarodowych 4/8
Jednolity Identyfikator Jednolity Identyfikator 1.1 Znaczenie Jednolitego Identyfikatora Proces tworzenia i zarządzania Interoperacyjnością wymaga stosowania jednolitej identyfikacji obiektów (dokumentów elektronicznych, wzorów, schematów XML, Styli XSL). Zastosowanie jednolitej i czytelnej struktury Identyfikatorów ułatwi proces przetwarzania i zarządzania dokumentami elektronicznymi. Podczas publikowania Schematu XML dla dokumentu elektronicznego należy zapewnić przypisanie odpowiedniej przestrzeni nazw (targetnamespace) odpowiadającej nadanemu Jednolitemu Identyfikatorowi. Oznacza to że każdy dokument zgodny ze Schematem XML będzie zawierał przestrzeń nazw umożlwiajacą odczytanie wszystkich niezbędnych informacji (o typie dokumentu, schemacie xml, wyróżniku, stylu XSL itp). na podstawie przestrzeni nazw np. http://crd.gov.pl/wzor/2007/06/15/324/ mamy dostęp do wyróżnika zgodnie z zasadą nadawania jednolitych identyfikatorów URI w postaci URL do wyróżnika to przestrzeń nazw pod którą został opublikowany wzór + nazwa pliku wyróżnika czyli http://crd.gov.pl/wzor/2007/06/15/324/ + wyroznik.xml Jednolity Identyfikator wzoru dokumentu, który jest wskazywany w treści dokumentu jest niezbędny do poprawnej jego interpretacji po dłuższym okresie czasu od utworzenia samego dokumentu. Jednolity Identyfikator jest nadawany przez Ministra właściwego do spraw informatyzacji dla wzorów, które otrzymał celem wprowadzenia ich do Centralnego Repozytorium. Nadanie Jednolitego Identyfikatora jest uzależnione od poprawności przesłanego przez wnioskodawcę i zawartego we wzorze wyróżnika. 5/8
Jednolity Identyfikator 1.2 Struktura Jednolitego Identyfikatora Jednolity Identyfikator to URI (w formie adresu URL) lokalizacji, w której został opublikowany wzór dokumentu elektronicznego a dokładniej plik wyróżnika. Jednolity Identyfikator jest umieszczany w strukturze Wyróżnika. Struktura Jednolitego Identyfikatora nie może zawierać WIELKICH liter. Struktura Jednolitego Identyfikatora nie może zawierać WIELKICH liter. Przykład Jednolitego Identyfikatora - http://crd.gov.pl/wzor/2007/06/07/12/wyroznik.xml 1.3 Nazwa domenowa serwera repozytorium Centralne repozytorium jest umieszczone w strukturach rządowych, ale jego właściwość może się zmieniać, nazwa domenowa nie powinna ulegać zmianom (dopuszcza się istnienie wielu domen) http://crd.gov.pl 1.4 Identyfikator w repozytorium Identyfikator w repozytorium powinien mieć strukturę katalogową umożliwiającą jednoznaczne wskazanie każdego umieszczonego wzoru. Struktura identyfikatora nie zawiera informacji o wersjach i zależnościach wzorów. Opisana poniżej struktura identyfikatora dotyczy jedynie wzorów dokumentów elektronicznych. W przypadku innych obiektów struktura może się różnić szczegółami (przykładem innej struktury jest identyfikator przestrzeni nazw opracowanych w ramach portalu interoperacyjności schematów XML np. http://crd.gov.pl/xml/schematy/epuap/osoba/2006/11/08/ gdzie został pominięty numer kolejnego schematu oraz nazwa pliku) Identyfikator opublikowanego wzoru ma następującą strukturę: Informację o typie obiektu którego dotyczy (w naszym przypadku) wzór elektroniczny wzor Rok publikacji wzoru np. 2007 Miesiąc publikacji wzoru np. 06 Dzieo publikacji wzoru np. 15 Numer kolejny wzoru (numeracja ciągła wszystkich wzorów w repozytorium) np. 324 6/8
Jednolity Identyfikator Nazwa pliku/obiektu którego dotyczy wyroznik.xml (w przypadku Jednolitych Identyfikatowrów dotyczących wzorów dokumentów elektronicznych nazwa wyroznik.xml jest wartością obligatoryjną bezwzględnie wymaganą ) /wzor/2007/06/15/324/wyroznik.xml 1.5 Struktura Jednolitego Identyfikatora Jednolity identyfikator URI (w formie adresu URL) dla wzorów dokumentów będzie miał postać: Nazwa domenowa serwera repozytorium + Identyfikator w repozytorium http://crd.gov.pl/wzor/2007/06/15/324/wyroznik.xml 1.6 Umieszczanie Jednolitego Identyfikatora w strukturze Wyróżnika. Po nadaniu Jednolitego Identyfikatora dla wzoru dokumentu elektronicznego musi ona być umieszczony w strukturze wyróżnika. Więcej szczegółów dotyczących wyróżnika zostało zawarte w dokumencie Zasady Tworzenia Wyróżników 1.7 W jaki sposób dysponując jedynie Identyfikatorem pobrać informacje o Schemacie oraz Stylu Ponieważ dokumenty elektroniczne powinny zawierać Jednolity Identyfikator wzoru, na podstawie którego powstały, w łatwy sposób można uzyskać niezbędne informacje (URI w postaci URL Stylu oraz Schematu są zawarte w Wyróżniku). Przypadek 1 Jak wyświetlić treść dokumentu, jeżeli nie ma dostępu do stylu XSL a do dyspozycji jest jedynie plikiem XML zawierający przestrzeń nazw? na podstawie przestrzeni nazw np. http://crd.gov.pl/wzor/2007/06/15/324/ można uzyskać dostęp do wyróżnika zgodnie z zasadą nadawania jednolitych identyfikatorów URI do wyróżnika to przestrzeń nazw pod którą został opublikowany wzór + nazwa pliku wyróżnika czyli http://crd.gov.pl/wzor/2007/06/15/324/ + wyroznik.xml z treści wyróżnika można pobrać URI do właściwego stylu/transformaty a następnie pobrać styl XSL z centralnego repozytorium. 7/8
Jednolity Identyfikator Posiadając URI Stylu XSL można wyświetlić dokument elektroniczny po transformacji za pomocą pobranego stylu XSL Przypadek 2 Jak zweryfikować treść dokumentu z regułami XSD, jeżeli nie ma dostępu do schematu XML a do dyspozycji jest jedynie plikiem XML zawierający przestrzeń nazw? na podstawie przestrzeni nazw np. http://crd.gov.pl/wzor/2007/06/15/324/ można uzyskać dostęp do wyróżnika zgodnie z zasadą nadawania jednolitych identyfikatorów URI do wyróżnika to przestrzeń nazw pod którą został opublikowany wzór + nazwa pliku wyróżnika czyli http://crd.gov.pl/wzor/2007/06/15/324/ + wyroznik.xml z treści wyróżnika można pobrać URI do właściwego Schematu XML a następnie pobrać schemat XML (XSD) z centralnego repozytorium. Posiadając URI Schematu można zweryfikować dokument elektroniczny za pomocą pobranego schematu XML (Pliku XSD) 8/8