Opis Migratora 2011 1
2
Spis treści 1. Słownik pojęd... 5 2. Przygotowanie danych do migracji... 6 3. Migracja danych... 6 3.1 Krok 1. Import kategorii... 6 3.2 Krok 2. Import artykułów... 9 3.3 Krok 3. Import zamówieo publicznych... 12 3.4 Krok 4: Import ofert pracy... 16 4. Zakooczenie - sprawdzenie poprawności migracji danych... 20 3
4
1. Słownik pojęć pojęcie Administrator SP BIP definicja Osoba upoważniona przez kierownika jednostki zobowiązanej do prowadzenia SP BIP na podstawie art. 4 Ustawy z dnia 6 września 2001 r. o dostępie do informacji publicznej, do zarządzania SP BIP jednostki funkcjonującej w ramach SSDIP. Administrator SP BIP nadaje uprawnienia Redaktorom SP BIP do zarządzania treścią SP BIP. Dostęp Administratora SP BIP do SSDIP wymaga autoryzacji. Base64 Rodzaj kodowania transportowego; zmodyfikowana pod kątem zwiększenia przenośności wersja kodowania uuencode. Dokładny opis znajduje się pod adresem http://www.faqs.org/rfcs/rfc3548.html Istniejąca SP BIP Kliknięcie Redaktor SP BIP SPBIP Strona SSDIP Strona Podmiotowa Biuletynu Informacji Publicznej stworzona przez podmioty zobowiązane do jej prowadzenia na podstawie art. 8 Ustawy z dnia 6 września 2001 r. o dostępie do informacji publicznej stworzona przed uruchomieniem SSDIP. Naciśnięcie, czyli wciśnięcie i zwolnienie lewego przycisku myszy komputerowej. Osoba upoważniona przez Administratora SP BIP do zarządzania treścią SP BIP zgodnie z nadanymi uprawnieniami. Dostęp Redaktora SP BIP do SSDIP wymaga autoryzacji. Strona Podmiotowa Biuletynu Informacji Publicznej stworzona przez podmioty zobowiązane do jej prowadzenia na podstawie art. 8 Ustawy z dnia 6 września 2001 r. o dostępie do informacji publicznej. Strona SSDIP umożliwia zarejestrowanie strony SPBIP oraz zarządzanie nią System SSDIP System SSDIP obejmuje wszystkie zarejestrowane strony SPBIP oraz stronę SSDIP 5
2. Przygotowanie danych do migracji Migracja danych z istniejącego SP BIP do nowo utworzonego systemu SSDIP odbywa się przez opcję "Narzędzia importu", która dostępna jest dla każdego użytkownika posiadającego uprawnienia Administratora SP BIP dla danego podmiotu. Dane istniejącej SP BIP przeznaczone do migracji należy zapisad w postaci pliku w formacie XML. W tym celu dział informatyczny jednostki posiadającej istniejącą SP BIP powinien przygotowad aplikację, która wyeksportuje dane do pliku XML. W każdym z narzędzi do importu poszczególnych sekcji znajduje się formatka, dzięki której można plik XML wgrad do systemu SSDIP. Zaraz po wgraniu plik jest analizowany i przetwarzany, a dane znajdujące się w nim są zamieszczane w bazie danych SSDIP. 3. Migracja danych Migracja składa się z czterech podstawowych kroków, przy czym dwa pierwsze kroki są ze sobą powiązane i powinny byd wykonywane w kolejności: najpierw import kategorii a następnie import danych artykułów. Poniżej znajduje się opis poszczególnych kroków wraz z opisem struktury XML dla każdej z sekcji. 3.1 Krok 1. Import kategorii W celu zaimportowania kategorii z istniejącej SP BIP należy wejśd w narzędzia importu kategorii i wgrad przygotowany plik XML. Przykład pliku XML importowania kategorii: <?xml version="1.0" encoding="utf-8"?> <Categories> <Category> <id>31337</id> <parent_id></parent_id> <maptocategory></maptocategory> <name>moja kategoriia</name> <active>1</active> <position>5</position> <href></href> </Category> <Category> 6
<id>31338</id> <parent_id></parent_id> <maptocategory>dla prasy</maptocategory> <name></name> <active></active> <position></position> <href></href> </Category> <Category> <id>31339</id> <parent_id>31338</parent_id> <maptocategory></maptocategory> <name>dla prasy - podstawowe informacje</name> <active>1</active> <position></position> <href></href> </Category> </Categories> W pliku tym mamy trzy podstawowe zadania jakie mogą byd wykonane na kategoriach. a) utworzenie kategorii w systemie SSDIP na bazie kategorii z istniejącego systemu SP BIP Celem tego zadania jest utworzenie kategorii o identycznej nazwie jak ta już istniejąca w SP BIP. <Category> <id>31337</id> <parent_id></parent_id> <maptocategory></maptocategory> <name>moja kategoriia</name> <active>1</active> <position>5</position> <href></href> </Category> Opis użytych pól: <id></id> - identyfikator kategorii z istniejącej SP BIP <name></name> - nazwa kategorii z istniejącej SP BIP <active></active> - atrybut określający czy dana kategoria ma byd aktywna po dodaniu <position></position> - pozycja kategorii względem innych kategorii, które będą dodane 7
<href></href> - opcjonalnie link kierujący na stronę zewnętrzną (np. http://www.mswia.gov.pl) b) zmapowanie kategorii Celem tego zadania jest odwzorowanie kategorii z systemu SP BIP w systemie SSDIP. Jeśli jakaś kategoria istnieje już w systemie SSDIP, np. Dla prasy, i nie chcemy dodawad duplikatu takiej kategorii, ale chcemy mied ciągle możliwośd przypisania do niej artykułów, to wykonujemy właśnie taką operację: <Category> <id>31338</id> <parent_id></parent_id> <maptocategory>dla prasy</maptocategory> <name></name> <active></active> <position></position> <href></href> </Category> Opis użytych pól: <id></id> <maptocategory></maptocategory> - identyfikator kategorii z istniejącej SP BIP - nazwa kategorii w systemie SSDIP, na którą chcemy zmapowad istniejącą w SP BIP kategorię c) dodanie podkategorii Celem tego zadania jest utworzenia drzewa kategorii, tak by odwzorowywało ono strukturę istniejącą w SP BIP. Podkategorie można dodad tylko do kategorii, które zostały utworzone w ramach migracji lub istniejącego już w SSDIP systemu SP BIP. Nie można utworzyd dla kategorii, do których wykonujemy mapowanie. Kategoriami głównymi, do których można wykonad mapowanie, może zarządzad jedynie administrator SSDIP. <Category> <id>31339</id> <parent_id>31338</parent_id> <maptocategory></maptocategory> <name>dla prasy - podstawowe informacje</name> <active>1</active> <position></position> <href></href> </Category> 8
Opis użytych pól: <id></id> <parent_id></parent_id> <name></name> <active></active> - identyfikator kategorii podrzędnej z systemu SP BIP - identyfikator kategorii nadrzędnej z systemu SP BIP - nazwa kategorii z systemu SP BIP - atrybut określający czy dana kategoria ma byd aktywna po dodaniu Wymagane pola dla kategorii to: <id>, <name> lub <mapcategory>. 3.2 Krok 2. Import artykułów W celu zaimportowania artykułów z istniejącej SP BIP należy wejśd w narzędzia importu artykułów i wgrad przygotowany plik XML. Należy pamiętad, że każdy artykuł powinien byd przyporządkowany do jakiejś kategorii, stąd zawsze przed tym krokiem powinno się wykonad import kategorii. Przykład pliku XML importowania artykułów: <?xml version="1.0" encoding="utf-8"?> <Articles> <Article> <id>1235</id> <name>artykuł zaimportowany #2- z załącznikami</name> <category_id>31337</category_id> <active>1</active> <short>skrót artykułu importowanego - ale tego z załącznikami :)</short> <full>dg8gamvzdcbhcnr5a3vsihogemfsywn6bmlryw1plcb0dsb6bmfqzhvqzsbzawugamvnbybw ZWxuYSB0cmVzYwo=</full> <tags></tags> <language_id>1</language_id> <author>pawel Importowy Ciekawski</author> <publishfrom>2010-01-02</publishfrom> <publishto></publishto> <Attachments> <Attachment> <name>plik_jakis.pdf</name> 9
<content> JVBERi0xLjQKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMSAwIFIKL1Jlc291cmNlcyAy GVj IDAgUgovQ29udGVudHMgNCAwIFI+PgplbmRvYmoKNCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlR b2rlic9mzw5ndgggode+pgpzdhjlyw0kej... </content> <filesize>123123</filesize> <author></author> </Attachment> </Attachments> </Article> </Articles> <Articles> <Article> <id>1234</id> <name>artykuł zaimportowany #1</name> <category_id>31340</category_id> <active>1</active> <short>skrót artykułu importowanego</short> <full> PGI+b3RvIGJvbGQ8L2I+aSB0dXRhaiBqZXN0IHBlbG5hIHRyZXNjLCA8aT50cmVzYzwvaT4gcG93 aw5uysbiewmgemfrb2rvd2fuysb6ihv6ewnpzw0gymfzzty0cg== </full> <tags></tags> <language_id>1</language_id> <author>pawel Importowy</author> <publishfrom></publishfrom> <publishto></publishto> </Article> </Articles> Przykładowy plik zawiera dwa artykuły, z czego pierwszy artykuł posiada także jeden załącznik (Plik_jakis.pdf). Opis poszczególnych pól struktury XML: 10
<id></id> - identyfikator artykułu w istniejącej SP BIP <name></name> - nazwa artykułu w istniejącej SP BIP <category_id></category_id> - identyfikator kategorii z systemu SP BIP, do której należy dany artykuł <active></active> - atrybut aktywności artykułu, jeśli jest nieaktywny, to jego treśd nie jest dostępna na stronie podmiotowej <short></short> - krótki opis treści artykułu <full></full> - pełna treśd artykułu; należy użyd algorytmu base64 do zakodowania informacji tu się znajdujących, treśd może zawierad tagi HTML, np.: <tags></tags> - tagi artykułu oddzielone przecinkiem (np. tag1,tag2,tag3) <language_id></language_id> - identyfikator wersji językowej artykułu: 1 - wersja polska, 2 - wersja angielska <author></author> - autor artykułu <publishfrom></publishfrom> - data publikacji w formacie RRRR-MM-DD, jednocześnie data od której, dany artykuł, jest widoczny na stronie podmiotowej <publishto></publishto> - data kooca publikacji w formacie RRRR-MM-DD, jeśli będzie ustawiona, to system SSDIP uwzględni ją później, podczas archiwizacji danego artykułu. Artykuł może zawierad także załączniki, które opisuje sekcja: <Attachments> <Attachment> <name>plik_jakis.pdf</name> <content> JVBERi0xLjQKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMSAwIFIKL1Jlc291cmNlcyAy GVj IDAgUgovQ29udGVudHMgNCAwIFI+PgplbmRvYmoKNCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlR b2rlic9mzw5ndgggode+pgpzdhjlyw0kej... </content> <filesize>123123</filesize> <author></author> </Attachment> </Attachments> Opis poszczególnych pól struktury załączników (Attachments) <Attachment> <name>plik_jakis.pdf</name> <content> 11
JVBERi0xLjQKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMSAwIFIKL1Jlc291cmNlcyAy GVj IDAgUgovQ29udGVudHMgNCAwIFI+PgplbmRvYmoKNCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlR b2rlic9mzw5ndgggode+pgpzdhjlyw0kej... </content> <filesize>123123</filesize> <author></author> </Attachment> <name></name> <content></content> <filesize></filesize> <author></author> - nazwa pliku - binarne dane pliku zakodowane algorytmem base64 - wielkośd pliku w bajtach - opcjonalny autor danego pliku. Wymagane pola dla artykułów to: <id>, <name>, <language_id>, <short>, <full>, <publishfrom>, <category_id>. 3.3 Krok 3. Import zamówień publicznych W celu zaimportowania zamówieo publicznych z istniejącej SP BIP należy wejśd w narzędzia importu zamówieo publicznych i wgrad przygotowany plik XML. Przykład pliku XML importowania przetargów: <?xml version="1.0" encoding="utf-8"?> <Publiccontracts> <Publiccontract> <id>1234</id> <name>przetarg zaimportowany #1</name> <contractmode_id>1</contractmode_id> <contracttype_id>1</contracttype_id> <announcer>polska Izba Detektywów</announcer> <publisher>publikujacy</publisher> <state_id>19</state_id> <substate_id>380</substate_id> <community_id>3711</community_id> 12
<city_id>1061707</city_id> <street_id></street_id> <housenr>10</housenr> <flatnr>20</flatnr> <txt>dhv0ywogem5hamr1amugc2llihn6y3plz29sb3d5ihrla3n0ihbyemv0yxjndsx3awvjlg5vlcbpi HRkCg==</txt> <language_id>1</language_id> <author>pawel Importowy</author> <publishfrom>2010-01-01</publishfrom> <publishto>2012-01-01</publishto> <value>123123213</value> <bid_bond>10000</bid_bond> <contract_number></contract_number> <contract_subject></contract_subject> <cpvs>03117110-8,03142100-9,03100000-2</cpvs> </Publiccontract> </Publiccontracts> Opis poszczególnych pól struktury XML: <id></id> - identyfikator przetargu w istniejącej SP BIP <name></name> - tytuł zamówienia <contractmode_id></contractmode_id> -tryb zamówienia, który może przyjmowad następujące wartości: 1 - przetarg nieograniczony 2 - przetarg ograniczony 3 - negocjacje z ogłoszeniem 4 - negocjacje bez ogłoszenia 5 - dialog konkurencyjny 6 - zamówienie z wolnej ręki 7 - zapytanie o cenę 8 - licytacja elektroniczna 9 - koncesja na usługi <contracttype_id></contracttype_id> - rodzaj ogłoszenia, pole to może przyjmowad wartości: 1 - Ogłoszenie o zamówieniu 2 - Uproszczone ogłoszenie - DSZ 3 - Ogłoszenie o zamiarze zawarcia umowy 13
4 - Ogłoszenie o udzieleniu zamówienia 5 - Ogłoszenie o konkursie 6 - Ogłoszenie o wynikach konkursu 7 - Ogłoszenie o zmianie ogłoszenia 8 - Ogłoszenie o koncesji na usługi <announcer></announcer> - ogłaszający przetarg <state_id></state_id> - identyfikator województwa zgodnie z TERYT <substate_id></substate_id> - identyfikator powiatu zgodnie z TERYT <community_id></community_id> - identyfikator gminy zgodnie z TERYT <city_id></city_id> - identyfikator miejscowości zgodnie z TERYT <street_id></street_id> - identyfikator ulicy zgodnie z TERYT <housenr></housenr> - numer domu/budynku <flatnr></flatnr> - numer mieszkania/lokalu/biura <txt></txt> - pełna treśd przetargu, która musi byd zakodowana algorytmem base64, treśd może zawierad tagi HTML <language_id></language_id> - identyfikator wersji językowej: 1 - wersja polska, 2 - wersja angielska <author></author> - autor przetargu <publishfrom></publishfrom> - data publikacji w formacie RRRR-MM-DD; jednocześnie data od której dany przetarg jest widoczny na stronie podmiotowej <publishto></publishto> - data kooca publikacji, jeśli będzie ustawiona, to system SSDIP uwzględni ją później podczas archiwizacji danego przetargu <value></value> - wartośd przetargu <bid_bond></bid_bond> - wadium przetargu (w złotówkach) <contract_number></contract_number> - numer zgłoszenia <contract_subject></contract_subject> - przedmiot przetargu <cpvs></cpvs> - kody CPV oddzielone przecinkiem (np.03117110-8,03142100-9,03100000-2) Każdy rekord przetargu może także zawierad załączniki, których format jest taki sam jak w przypadku artykułów, np.: 14
<Publiccontracts> <Publiccontract> <id>1234</id> <name>przetarg zaimportowany #1</name> <contractmode_id>1</contractmode_id> <contracttype_id>1</contracttype_id> <announcer>polska Izba Detektywów</announcer> <publisher>publikujacy</publisher> <state_id>19</state_id> <substate_id>380</substate_id> <community_id>3711</community_id> <city_id>1061707</city_id> <street_id></street_id> <housenr>10</housenr> <flatnr>20</flatnr> <txt>dhv0ywogem5hamr1amugc2llihn6y3plz29sb3d5ihrla3n0ihbyemv0yxjndsx3awvjlg5vlcbpi HRkCg==</txt> <language_id>1</language_id> <author>pawel Importowy</author> <publishfrom>2010-01-01</publishfrom> <publishto>2012-01-01</publishto> <value>123123213</value> <bid_bond>10000</bid_bond> <contract_number></contract_number> <contract_subject></contract_subject> <cpvs>03117110-8,03142100-9,03100000-2</cpvs> <Attachments> <Attachment> <name>plik_jakis.pdf</name> <content> JVBERi0xLjQKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMSAwIFIKL1Jlc291cmNlcyAy GVj IDAgUgovQ29udGVudHMgNCAwIFI+PgplbmRvYmoKNCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlR b2rlic9mzw5ndgggode+pgpzdhjlyw0kej... </content> <filesize>123123</filesize> <author></author> </Attachment> 15
</Attachments> </Publiccontract> </Publiccontracts> Wymagane pola dla przetargów: <id>, <name>, <language_id>, <contractmode_id>, <contracttype_id>, <publishto>, <txt>. 3.4 Krok 4: Import ofert pracy W celu zaimportowania ofert pracy z istniejącej SP BIP należy wejśd w narzędzia importu przetargów i wgrad przygotowany plik XML. Przykład pliku XML importowania ofert pracy: <Joboffers> <Joboffer> <id>1234</id> <name>oferta pracy zaimportowana #1</name> <language_id>1</language_id> <author>pawel Importowy</author> <publishfrom>2010-01-01</publishfrom> <publishto>2012-01-01</publishto> <short>skrót oferty pracy importowanej</short> <full>dg8gamvzdcb0zxnrdcbvzmvydhkgchjhy3kglsbwzwxueqo=</full> <contact_person>robert Janas</contact_person> <joboffertype_id>1</joboffertype_id> <employmenttype_id>13</employmenttype_id> <education>1</education> <occupation>portier Informatyczny</occupation> <email>hr@firma.com</email> <phone>123456789</phone> <fax></fax> <author>robert Kowalski</author> <publisher></publisher> <deadline>2012-01-01</deadline> <state_id>19</state_id> 16
<substate_id>380</substate_id> <community_id>3711</community_id> <city_id>1061707</city_id> <street_id></street_id> <housenr>10</housenr> <flatnr>20</flatnr> </Joboffer> </Joboffers> Opis poszczególnych pól struktury XML: <id></id> <name></name> <language_id></language_id> <author></author> <publishfrom></publishfrom> <publishto></publishto> <short></short> <full></full> - identyfikator oferty pracy w systemie SP BIP - tytuł ogłoszenia - identyfikator wersji językowej: 1 - wersja polska, 2 - wersja angielska - autor oferty - data publikacji w formacie RRRR-DD-MM, jednocześnie data od której dana oferta jest widoczna na stronie podmiotowej - data kooca publikacji w formacie RRRR-DD-MM, jeśli będzie ustawiona, to system SSDIP uwzględni ją później podczas archiwizacji danej oferty pracy - skrótowy opis oferty pracy - pełny opis oferty pracy, który musi byd zakodowany algorytmem base64, opis może zawierad tagi HTML <contact_person></contact_person> - dane osoby do kontaktu <joboffertype_id></joboffertype_id> - forma zatrudnienia, która może przyjmowad następujące wartości: 1 - umowa o pracę na czas określony 2 - umowa o pracę na okres próbny 3 - umowa na czas wykonywania pracy 4 - umowa o pracę na czas nieokreślony 5 - umowa zlecenia 6 - umowa agencyjna 7 - umowa o dzieło 8 - umowa o pracę nakładczą 9 - inne <employmenttype_id></employmenttype_id> - rodzaj pracy, który może przyjmowad następujące wartości: 17
<education></education> <occupation></occupation> <email></email> <phone></phone> <fax></fax> <author></author> <deadline>2012-01-01</deadline> <state_id></state_id> <substate_id></substate_id> <community_id></community_id> <city_id></city_id> <street_id></street_id> <housenr></housenr> <flatnr></flatnr> 1 - wszystkie kategorie 2 - pracownik gospodarczy 3 - kadry /doradztwo personalne 4 - analityk 5 - badania i rozwój 6 - budownictwo 7 - geodezja i kartografia 8 - finanse / ekonomia 9 - księgowośd 10 - kadra zarządcza 11 - kontrola / audyt 12 - marketing / PR 13 - informatyka - administrator 14 - informatyka - programista 15 - informatyka - utrzymanie 16 - prawo 17 - edukacja 18 - tłumaczenia 19 - projektowanie /wdrażanie 20 - ochrona środowiska 21 - ochrona zdrowia 22 - inne - pole do podania szukanego hasła - wykształcenie, które może przyjmowad następujące wartości: 1 - podstawowe 2 - średnie 3 - wyższe - nazwa stanowiska - e-mail kontaktowy - telefon do kontaktu - fax do kontaktu - autor oferty - termin składania - identyfikator województwa zgodnie z TERYT - identyfikator powiatu zgodnie z TERYT - identyfikator gminy zgodnie z TERYT - identyfikator miejscowości zgodnie z TERYT - identyfikator ulicy zgodnie z TERYT - numer domu/budynku - numer mieszkania/lokalu/biura Każda oferta pracy może także zawierad załączniki, których format jest taki sam jak w przypadku artykułów, np.: 18
<Joboffers> <Joboffer> <id>1234</id> <name>oferta pracy zaimportowana #1</name> <language_id>1</language_id> <author>pawel Importowy</author> <publishfrom>2010-01-01</publishfrom> <publishto>2012-01-01</publishto> <short>skrót oferty pracy importowanej</short> <full>dg8gamvzdcb0zxnrdcbvzmvydhkgchjhy3kglsbwzwxueqo=</full> <contact_person>robert Janas</contact_person> <joboffertype_id>1</joboffertype_id> <employmenttype_id>13</employmenttype_id> <education>1</education> <occupation>portier Informatyczny</occupation> <email>hr@firma.com</email> <phone>123456789</phone> <fax></fax> <author>robert Kowalski</author> <publisher></publisher> <deadline>2012-01-01</deadline> <state_id>19</state_id> <substate_id>380</substate_id> <community_id>3711</community_id> <city_id>1061707</city_id> <street_id></street_id> <housenr>10</housenr> <flatnr>20</flatnr> <Attachments> <Attachment> <name>plik_jakis.pdf</name> <content> JVBERi0xLjQKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMSAwIFIKL1Jlc291cmNlcyAy GVj IDAgUgovQ29udGVudHMgNCAwIFI+PgplbmRvYmoKNCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlR b2rlic9mzw5ndgggode+pgpzdhjlyw0kej... 19
</content> <filesize>123123</filesize> <author></author> </Attachment> </Attachments> </Joboffer> </Joboffers> Wymagane pola dla ofert pracy to: <id>, <name>, <language_id>, <short>, <full>, <joboffertype_id>, <employmenttype_id>, <education>, <occupation>, <email>, <deadline>, <publishfrom>, <publishto>. 4. Zakończenie - sprawdzenie poprawności migracji danych Po zakooczonym imporcie danych: - kategorii - należy przejśd do listy kategorii i sprawdzid, czy importowane kategorie są tam umieszczone; - artykułów - należy przejśd do listy artykułów i sprawdzid, czy importowane artykuły są tam umieszczone; - zamówieo publicznych - należy przejśd do listy zamówieo publicznych i sprawdzid, czy importowane zamówienia publiczne są tam umieszczone.; - ogłoszeo o pracę - należy przejśd do listy ofert pracy sprawdzid, czy importowane ogłoszenia o pracę są tam umieszczone. Jeżeli proces importowania danych z istniejącej SP BIP do SSDIP przebiegnie niepoprawnie, system wyświetli komunikat o błędzie. 20