Przejdź do głównej zawartości

Budowa formularza

Wszystkie formularze powstają na podstawie schematów XSD publikowanych przez MF. Wynikają z tego pewne konsekwencje:

  1. Nowe formularze mogą być dodane do programu, dopiero po opublikowaniu przez MF wersji produkcyjnych schematów XSD.

  2. Wszystkie nazwy pól formularza, opisy pól oraz typy stosowanych danych są narzucane przez schematy XSD - moduł e-F jedynie wyświetla nazwy i opisy pól (są one prezentowane bez żadnych zmian). Podobnie narzucane jest stosowanie dokładnie takich samych typów danych. Zdarzają się przypadki, że występują różnice pomiędzy typami danych narzuconymi przez schemat XSD a ich obrazami prezentowanymi w plikach PDF stanowiących załączniki do odpowiednich rozporządzeń. Dla przykładu, ta sama pozycja w schemacie jest zdefiniowana jako kwota zaokrągloną do dwóch miejsc po przecinku, a w pliku PDF opisana jest jako zaokrąglona do pełnych złotych (lub na odwrót).

    Podpowiedź

    W opisanym wyżej przypadku nadrzędny jest typ danych definicji XSD. Zmiana tego typu w e-Formularzu mogłaby spowodować, że utworzony plik XML nie przeszedłby pozytywnie walidacji przed wysyłką na serwer MF i formularza nie można byłoby wysłać.

Typ danych zdefiniowany w schemacie XSD określa wiele właściwości, w tym długość pól tekstowych. Również w tym przypadku, w formularzach, stosowana jest oryginalna długość pól tekstowych. W konsekwencji zdarza się na przykład, że długość pola "Ulica" jest znacznie mniejsza niż długość pola "Numer". Prosimy pamiętać, że wynika to z definicji schematu XSD.

Definicja XSD formularza składa się najczęściej w formularza głównego oraz wszystkich załączników i czasem załączników do załączników, natomiast ich pozycje/pola specyfikowane są jedno pod drugim, bez podziałów na sekcje i podsekcje znane z formularzy w formacie PDF. Dla ułatwienia wprowadzania danych w formularzu, pola grupowane i opisywane są analogicznie do formularza w formacie PDF. Formularz jest formatowany tak, aby był maksymalnie zbliżony do formularza w formacie PDF.

Dodawane są:

  • sekcje i podsekcje formularza z opisami przeniesionymi z formularza PDF,
  • wszystkie objaśnienia oraz dodatkowe opisy pól,
  • linki cytowanych fragmentów ustaw.

Poniżej przykład fragmentu schematu XSD:

PIT-36(26) - fragment schematu XSD

Poniżej zaprezentowano postać schematu w interfejsie programu. Widoczna jest prezentacja powyższych pól schematu XSD:

PIT-36(26) - przykładowy widok formularza

Uruchamianie e-Formularza

Ze względu na specyfikę wynikającą z dostarczanej przez moduł funkcjonalności, proces uruchamiania e-Formularza różni się od uruchamiania standardowych okien i modułów w systemie Wapro. Okno e-Formularza budowane jest dynamicznie podczas uruchamiania, w przeciwieństwie do innych obiektów, które są zdefiniowane na etapie projektowania i każdorazowo uruchamiane zgodnie z tą sama definicją.

Moduł e-F uruchamiany jest zawsze z programu źródłowego w kontekście wybranego rodzaju oraz wzoru formularza. W związku z tym każdorazowo musi dostosować się do aktualnej wersji wybranego schematu XSD, który jest wzorcem dla pliku XML, będącego ostatecznym wynikiem działania e-Formularza. Pliku, który najczęściej podpisany zostanie wysłany do MF.

W efekcie, każdorazowo podczas uruchamiania, e-Formularz musi pobrać aktualną definicję, aby na jej podstawie dynamicznie zbudować e-Formularz, który zostanie wyświetlony w interfejsie.

Warto wiedzieć

Podczas uruchamiania ładowana jest definicja głównego formularza, definicje załączników ładowane są podczas ich dodawania do formularza.

Ze względu na to, że schematy XSD, będące podstawą definicji e-Formularza, bardzo różnią wielkością (rozmiarem), czas ładowania tych definicji do e-Formularza będzie różny. Mniejsze formularze, mające mniej załączników, będą budowane szybciej od rozbudowanych formularzy (wielostronicowych we wzorach PDF), mających wiele załączników, które dodatkowo posiadają swoje załączniki. Największymi pod względem rozmiaru schematami XSD są schematy elektronicznych sprawozdań finansowych dla dużych firm. Są one dodatkowo najbardziej złożone, w związku z tym czas ich tworzenia jest najdłuższy.

Warto wiedzieć

Czas budowania e-Formularza zależy również od szybkości maszyny, na której jest budowany.