Dokumenty SEDU składają się z dwóch części: Opisu sprawy Formularza elektronicznego

Transkrypt

1 Opis dokumentów SEDU Standard Elektronicznych Dokumentów Urzędowych są to dokumenty zapisane w standardzie XML, opisujące różnorakie procedury urzędowe, możliwe do częściowej lub całkowitej realizacji przez Internet. Dokumenty SEDU składają się z dwóch części: Opisu sprawy Formularza elektronicznego Opis sprawy Część opisowa dokumenty pozwala na opracowanie i wygenerowania tzw. karty sprawy, czyli strony zawierającej komplet informacji niezbędnych do załatwienia sprawy w Cyfrowym Urzędzie. Wszystkie informacje niezbędne do utworzenia oraz sprawdzenia poprawności dokumentu opisowego zawarte są w tzw. DTD (ang. Document Type Definition) - definicji dokumentu. Określa on poprawną zawartość dokumentu, w tym kolejność znaczników, ich zawartość i wzajemne relacje. Definicja dokumentu <?xml version="1.0" encoding="iso "? <!ENTITY % nbool "(1 0) '1'" <!ENTITY % URL "href CDATA #IMPLIED target NMTOKEN #IMPLIED name CDATA #IMPLIED id CDATA #IMPLIED" <!-- argument display pozwala kontrolować wyświetlanie

2 <!-- argument display pozwala kontrolować wyświetlanie poszczególnych sekcji na stronie -- <!ENTITY % display "display %nbool;" <!-- pojedynczy załącznik lub odnośnik -- <!ELEMENT link (#PCDATA) <!-- target może przyjmować takie same wartości jak znacznik "a" w HTML. Wartość argumentu type ma być taka jak rozszerzenie załącznika i określa jego ikonę, np. doc, pdf itp. -- <!ATTLIST link class CDATA #IMPLIED type CDATA #IMPLIED <!-- uniwersalny element opisowy -- <!ELEMENT desc (#PCDATA) <!-- Element główny -- <!ELEMENT procdesc (info, description, department, address, place?, phones*, working_hours?, procedure_time?, attachments?, other.docs?, fee_list?, law_backgrounds*, notes?, connected_procedures?) <!ATTLIST procdesc type CDATA #REQUIRED id ID #IMPLIED <!-- METRYKA PROCEDURY -- <!ELEMENT info (office, author?, version?, title, header?) <!-- nazwa i link do strony urzędu -- <!ELEMENT office (#PCDATA) <!ATTLIST office

3 <!-- Autor dokumentu -- <!ELEMENT author (#PCDATA) <!-- adres lub url (z protokołem!) -- <!ATTLIST author <!-- Wersji procedury i ew. data tej wersji-- <!ELEMENT version (#PCDATA) <!ATTLIST version date CDATA #IMPLIED <!-- tytuł sprawy -- <!ELEMENT title (#PCDATA) <!-- opcjonalny nagłówek wyświetlany nad opisem -- <!ELEMENT header (#PCDATA) <!-- opis sprawy -- <!ELEMENT description (#PCDATA) <!ATTLIST description <!-- wydział, departament itp. -- <!ELEMENT department (#PCDATA) <!ATTLIST department <!-- adres biura, w tym przynajmniej -- <!ELEMENT address (#PCDATA link)* <!ATTLIST address

4 <!ATTLIST address <!-- numer pokoju, piętra w urzędzie, gdzie tę sprawę można załatwić -- <!ELEMENT place (#PCDATA) <!ATTLIST place <!-- numery telefonów, faxów -- <!ELEMENT phones (phone_no+) <!ATTLIST phones <!-- numer telefonu -- <!ELEMENT phone_no (#PCDATA) <!ATTLIST phone_no <!-- godziny pracy realizującego sprawę -- <!ELEMENT working_hours (#PCDATA) <!ATTLIST working_hours <!-- okres oczekiwania na załatwienie sprawy -- <!ELEMENT procedure_time (#PCDATA) <!ATTLIST procedure_time <!-- lista załączników w postaci linków do formularzy (do ściągnięcia lub wypełnienia on-line) -- <!ELEMENT attachments (link+)

5 <!ATTLIST attachments <!-- pozostałe dokumenty wymagane do realizacji sprawy: jako lista lub opis -- <!ELEMENT other.docs (#PCDATA link)* <!ATTLIST other.docs <!-- lista opłat -- <!ELEMENT fee_list ((fee link)*, fee_description?) <!ATTLIST fee_list <!-- pojedyncza opłata - opis jako zawartość znacznika -- <!ELEMENT fee (#PCDATA) <!-- wartość i waluta -- <!ATTLIST fee value CDATA #IMPLIED currency CDATA "zł" <!-- opis opłat np. miejsce opłat lub numer konta -- <!ELEMENT fee_description (#PCDATA) <!-- podstawy prawne -- <!ELEMENT law_backgrounds (law_background+) <!ATTLIST law_backgrounds <!ELEMENT law_background (desc?, link*) <!-- uwagi --

6 <!-- uwagi -- <!ELEMENT notes (#PCDATA) <!ATTLIST notes <!-- lista procedur powiązanych -- <!ELEMENT connected_procedures (link+) <!ATTLIST connected_procedures Nagłówek jest zapisany pomiędzy znacznikami: <info Znaczniki: office - nazwa urzędu/biura atrybuty href - odnośnik np. do strony WWW lub adres autor-mail author - nazwa autora dokumentu atrybuty href - odnośnik np. do strony WWW lub adres autor-mail version - wersja dokumentu atrybuty date - data wydania title - tytuł dokumentu header - nagłówek Część główna dokumentu Znaczniki: description - opis dokumentu department - nazwa departamentu address - adres biura

7 address - adres biura place - numer pokoju phones - spis telefonów phone_no - numer telefonu working_hours - godziny pracy attachments - załączniki w postaci dokumentów (np. doc, pdf) link - adres URL law_backgrounds - znacznik grupujący podstawy prawne law_background - podstawa prawna desc - opis notes - notatki odnośnie danej sprawy fee_list - lista opłat fee - opłata Formularz <?xml version="1.0" encoding="iso "? <!-- definicja formularzowej części dokumentu SEDU dla Cyfrowego Urzędu portalu Wrota Podlasia ( -- <!ENTITY % nbool "(1 0) '1'" <!ENTITY % URL "href CDATA #REQUIRED target NMTOKEN #IMPLIED" <!ENTITY % coreattrs "id ID #IMPLIED name CDATA #IMPLIED desc CDATA #IMPLIED class CDATA #IMPLIED display %nbool;" <!-- procedura -- <!ELEMENT procedure (webservice, info, section+)

8 <!ELEMENT procedure (webservice, info, section+) <!ATTLIST procedure type CDATA #REQUIRED id ID #IMPLIED <!ELEMENT webservice EMPTY <!ATTLIST webservice send %nbool; <!-- informacje o procedurze -- <!ELEMENT info (office, author?, cdate?, version?, desc?, title, header?) <!ELEMENT desc (#PCDATA) <!-- nazwa i link do strony urzędu -- <!ELEMENT office (#PCDATA) <!ATTLIST office <!ELEMENT author (#PCDATA) <!ATTLIST author <!-- Wersji procedury i ew. data tej wersji-- <!ELEMENT version (#PCDATA) <!ATTLIST version date CDATA #IMPLIED <!ELEMENT title (#PCDATA) <!ELEMENT header (#PCDATA) <!-- Sekcje zawierają właściwe definicje pól formularza procedury i ew. przekazywane dane --

9 ew. przekazywane dane -- <!ELEMENT section (attribs+) <!ATTLIST section %coreattrs; <!ELEMENT attribs (attrib*) <!ATTLIST attribs type (textbox_group file_group textarea_group radio_group checkbox_group clear_text) "clear_text" header CDATA #IMPLIED <!ELEMENT attrib (#PCDATA) <!-- desc opisuje opis atrybutu, wyświetlany np. jako ikona z opisem w dymku, albo pod polem formularza -- <!ATTLIST attrib %coreattrs; value CDATA #IMPLIED header CDATA #IMPLIED form (text textarea radio check file label) "text" require %nbool; valid_type (range regexp type none) "none" valid_param CDATA #IMPLIED Nagłówek Jest zapisany pomiędzy znacznikami: <info Znaczniki: office - nazwa biura atrybuty: href - odnośnik URL author - nazwa autora dokumentu atrybuty: href - odnośnik URL, np. adres

10 href - odnośnik URL, np. adres version - wersja dokumentu atrybuty: date - data wydania desc - opis dokumentu title - tytuł dokumentu header - nagłowek Część główna dokumentu Składa się z szeregu znaczników grupujących section - główny atrybut sekcji atrybuty id - id sekcji name - nazwa sekcji desc - statyczny tekst który będzie wyświetlany w nagłówku danej sekcji class - nazwa klasy kaskadowych arkuszy styli display - sugeruje czy dana sekcja ma być wyświetlana podczas wydruku formularza attribs - grupa atrybutów atrybuty: type - znacznik decydujący o typie pól w danej grupie Atrybut może przyjmować następujące wartości: textbox_group - pole tekstowe <input type= textbox file_group - pole wyboru pliku do uploadu <input type= file textarea_group - duże pole tekstowe <textarea </testarea radio_group - pole wyboru (jednokrotnego) checkbox_group - pole wyboru (wielokrotnego) clear_text - tekst

11 clear_text - tekst header - statyczny tekst który będzie wyświetlany w nagłówku header nagłówek (opis) grupy atrybutów Znacznik attribs może zawierać dowolną ilość znaczników attrib. attrib - atrybut/pole formularza atrybuty: id - id elementu (musi być unikalne) name - nazwa elementu class - nazwa klasy kaskadowych arkuszy styli value - wartość znacznika, powinna pozostać pusta lub zawierać wartośc domyślną pola desc - opis atrybutu, wyświetlany np. jako ikona z opisem w dymku, albo pod polem formularza value - wartość atrybutu form - typ pola Atrybut może przyjmować następujące wartości: text - pole tekstowe <input type= textbox file - pole wyboru pliku do uploadu <input type= file textarea - duże pole tekstowe <textarea</testarea radio - pole wyboru (jednokrotnego) check - pole wyboru (wielokrotnego) clear - tekst header - statyczny tekst który będzie wyświetlany jako opis pola require - wymagalność jego wypełnienia valid_type - typ walidacji pola valid_param - dodatkowe parametry walidacji pola, np. wyrażenie regularne lub typ pola

12