Zasady tworzenia Jednolitych Identyfikatorów

Zasady tworzenia
Jednolitych
Identyfikatorów
Czym jest Jednolity Identyfikator , jaka jest jego struktura ?
Spis treści
Wstęp ...................................................................................................................................................... 3
Znaczenie Jednolitego Identyfikatora ..................................................................................................... 3
Struktura Jednolitego Identyfikatora ...................................................................................................... 3
Nazwa domenowa serwera repozytorium .......................................................................................... 3
Identyfikator w repozytorium ............................................................................................................. 4
Struktura Jednolitego Identyfikatora .................................................................................................. 4
Umieszczanie Jednolitego Identyfikatora w strukturze Wyróżnika. ................................................... 4
W jaki sposób dysponując jedynie Identyfikatorem pobrad informacje o Schemacie oraz Stylu ....... 4
Wstęp
Dokument został opracowany w ramach projektu e-PUAP. Niniejszy materiał stanowi założenia
inicjujące proces ustanowienia zasad nadawania jednolitych identyfikatorów.
Zawarte w dokumencie informacje mają ułatwid 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świadczeo międzynarodowych
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 tworzenia Schematu XML dla dokumentu elektronicznego należy zapewnid aby dokument
powstający na jej podstawie zawierał w treści Jednolity Identyfikator. Oznacza to że każdy dokument
zgodny ze Schematem XML będzie zawierał Jednolity Identyfikator wzoru na podstawie którego
powstał.
Jednolity Identyfikator dokumentu oraz wzoru na podstawie którego powstał jest niezbędny również
do poprawnej interpretacji dokumentów po dłuższym okresie czasu od ich utworzenia.
Jednolity Identyfikator jest nadawany przez Ministra właściwego do spraw informatyzacji. Nadanie
Jednolitego Identyfikatora jest uzależnione od poprawności przesłanego wyróżnika (jeżeli wyróżnik
jest niewłaściwy Minister właściwy do spraw Informatyzacji może odmówid nadania Jednolitego
Identyfikatora).
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.
Przykład Jednolitego Identyfikatora - http://crd.gov.pl/wzor/2007/06/07/12/wyroznik.xml
Nazwa domenowa serwera repozytorium
Centralne repozytorium jest umieszczone w strukturach rządowych, ale jego właściwośd może się
zmieniad, nazwa domenowa nie powinna ulegad zmianom
http://www.crd.gov.pl
Komentarz [A1]: Bardzo dobre
założenie. Wręcz krytyczne dla powodzenia
integracji ePUAP z innymi systemami (np.
SEKAP).
Identyfikator w repozytorium
Identyfikator w repozytorium powinien mied strukturę katalogową umożliwiającą jednoznaczne
wskazanie każdego umieszczonego wzoru. Struktura identyfikatora nie zawiera informacji o wersjach
i zależnościach wzorów.
Proponowany identyfikator 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
Nazwa pliku/obiektu którego dotyczy – np. wyroznik.xml
/wzor/2007/06/15/324/.wyroznik.xml
Struktura Jednolitego Identyfikatora
Jednolity identyfikator URI (w formie adresu URL) dla wzorów dokumentów będzie miał postad:
Nazwa domenowa serwera repozytorium + Identyfikator w repozytorium
http://www.crd.gov.pl/wzor/2007/06/15/324/wyroznik.xml
Komentarz [A2]: W zasadzie każdy
system zapewniający unikalnośd jest dobry.
Rozwiązanie powinno byd wygodne ze
względu na potrzeby pracy repozytorium.
Wprowadzanie do adresu podziałów na
grupy merytoryczne jest wg doświadczeo
SEKAP bardzo trudne do wykonania.
W przyszłości wystąpi koniecznośd jeszcze
wielokrotnego przebudowywania
przyjętych grup. Nie będzie to jednak
wpływało na działające formularze, które
nadal będą musiały byd publikowane pod
starymi nazwami.
W związku z powyższym przyjęte
rozwiązanie uważamy za prawidłowe.
Nawet skrócilibyśmy oznaczenie do
postaci:
/wzor/324/wyroznik.xml
Umieszczanie Jednolitego Identyfikatora w strukturze Wyróżnika.
Po nadaniu Jednolitego Identyfikatora dla wzoru dokumentu elektronicznego musi ona byd
umieszczony w strukturze wyróżnika.
Struktura jednolitego Identyfikatora w notacji XML (więcej szczegółów dotyczących wyróżnika zostało
zawarte w dokumencie „Zasady Tworzenia Wyróżników”):
<Identyfikator>
<Typ>Jednolity Identyfikator</Typ>
<Wartosc>http://crd.gov.pl/wzor/2007/06/07/12/wyroznik.xml</Wartosc>
</Identyfikator>
W jaki sposób dysponując jedynie Identyfikatorem pobrać informacje o
Schemacie oraz Stylu
Ponieważ dokumenty elektroniczne powinny zawierad Jednolity Identyfikator wzoru, na podstawie
którego powstały, w łatwy sposób można uzyskad niezbędne informacje (URL Stylu oraz Schematu są
zawarte w Wyróżniku)
Składniki wzoru (XSD, XSL) są publicznie dostępne dlatego cały proces pobierania niezbędnych
danych może byd przeprowadzany automatycznie za pomocą zapytao XPATH.
Komentarz [A3]: Ta spacja mi się nie
podoba. Proponuje JednolityIdentyfikator.