Przygotowanie plików XML do transferu do GUS

Przygotowanie plików XML do transferu do GUS
(aplikacja WalidatorXML)
1) Przeznaczenie aplikacji
Aplikacja WalidatorXML służy sprawdzeniu poprawności strukturalnej plików XML oraz
wytworzeniu pakietu wysyłkowego w postaci akceptowanej przez aplikację transferową
TransGUS.
Zbiory XML przygotowywane na potrzeby GUS muszą być zgodne ze strukturą
opublikowaną w postaci schematów XSD na stronie http://ankiet.stat.gov.pl/gminy.
Aplikacja WalidatorXML umożliwia kontrolę zbioru, a jednocześnie dokonuje jego
kompresji do standardu wymaganego przez GUS tworząc pakiet wysyłkowy.
2) Instalacja
Aplikacja WalidatorXML do poprawnego funkcjonowania wymaga zainstalowania w
systemie:
- środowiska .NET Framework w wersji co najmniej 2.0.50727
- polskiego pakietu językowego dla .NET Framework w wersji co najmniej 2.0.50727.
Instalator sprawdza obecność w/w składników w systemie i umożliwia automatyczne
pobranie ich z Internetu podczas instalacji, o ile nie znajdzie ich na dysku lokalnym w
katalogu, z którego jest uruchamiany.
Aplikacja Walidator XML została udostępniona na stronie internetowej w dwóch wersjach
instalacyjnych:
- minimalnej zawierającej tylko plik instalacyjny aplikacji WalidatorXML
- rozszerzonej zawierającej plik instalacyjny aplikacji WalidatorXML oraz dodatkowo
środowisko .NET Framework w wersji 2.0.50727 i polski pakiet językowy
Wersja minimalna przeznaczona jest dla osób, które posiadają już zainstalowane w
systemie wymagane składniki środowiska lub posiadają dostęp do Internetu i mogą
pobrać je w trakcie procesu instalacji. Wersja rozszerzona polecana jest dla osób, które
będą instalować aplikację WalidatorXML na komputerze bez wymaganych składników
środowiska i bez dostępu do Internetu.
Instalacja aplikacji (i składników środowiska) polega na uruchomieniu pakietu
instalacyjnego i postępowaniu dokładnie wg jego wskazówek (na takiej zasadzie jak w
innych instalatorach aplikacji dla systemu Windows).
3) Praca z aplikacją
Kontrola i przygotowanie do wysyłki zbioru XML przebiega w 3 krokach, których opis jest
prezentowany w polu „Wskazówki”
Krok 1: Wybór zbioru XML (przycisk „Wybierz”)
Wejściowy zbiór XML może mieć dowolną nazwę, odpowiedni standard nazewnictwa jest
wymagany dla przygotowanych pakietów wysyłkowych, ale czynność tę program realizuje
automatycznie.
Opcja „Dodatkowy plik XML” jest przeznaczona dla tych urzędów, które nie mają
możliwości przekazania jednego zbioru XML obejmującego całość danych z ewidencji
podatkowej nieruchomości. W takim przypadku można przekazać 2 zbiory XML i wówczas
należy tę opcję zaznaczyć podczas przekazywania drugiego z plików (będzie on
traktowany jako dodatkowy).
1
Uwaga! Opcji tej nie należy zaznaczać w sytuacji powtarzania transferu zbioru
przesłanego uprzednio w zwykłym trybie.
Krok 2: Kontrola poprawności zbioru XML
Aby uruchomić proces kontroli poprawności pliku XML należy wcisnąć przycisk „Kontrola”.
Jeśli w wyniku kontroli zwrócona zostanie informacja o poprawności pliku można dokonać
eksportu pakietu wysyłkowego (zob. Krok 3).
Jeśli kontrolowany plik XML zawiera błędy, wówczas pakiet wysyłkowy nie będzie mógł
być wytworzony. Aplikacja umożliwia wyświetlenie listy błędów zidentyfikowanych
podczas kontroli (przycisk „Błędy”), wraz z możliwością jej zapisu do pliku tekstowego
(przycisk „Zapisz” w oknie z listą). W oparciu o listę błędów należy przygotować
poprawny plik XML i powtórzyć operację jego kontroli.
Krok 3: Eksport zbioru XML
Należy wybrać lokalizację dla pliku wynikowego (aplikacja domyślnie proponuje
lokalizację, w której znajdował się wejściowy plik XML) oraz dokonać eksportu pakietu
wysyłkowego (przycisk „Eksportuj”). Przed zainicjowaniem eksportu można dołączyć
uwagi wpisując je w polu edycyjnym (z opcji tej należy korzystać tylko w niezbędnych
przypadkach, gdy przesyłany zbiór zawiera specyficzne rozwiązania wymagające
komentarza, w szczególności dla plików dodatkowych).
Wynikiem eksportu jest pakiet wysyłkowy p.gus, zawierający poprawny zbiór XML.
W przypadku zaznaczenia opcji „Dodatkowy plik XML”, w nazwie pakietu wysyłkowego
dodany zostanie znacznik „1”, p1.gus
Krok 1a: Wybór trybu
dla pliku dodatkowego
(opcjonalnie)
Krok 1: Wybór
zbioru XML
Krok 2: Kontrola
zbioru XML,
wylistowanie błędów
Krok 3: Eksport
pakietu wysyłkowego
Każdy z pakietów wysyłkowych należy przesłać do serwera zasobowego GUS przy użyciu
aplikacji TransGUS.
2