DOKUMENTACJA 2016-07-14 - T-Soft

JPK
DOKUMENTACJA
2016-07-14
BIURO USŁUG INFORMATYCZNYCH "T-SOFT" s.c.
30-702 Kraków
ul. Romanowicza 17
1. Ogólne
Program do generowania jednolitego pliku kontrolnego jest przewidziany
do uruchomienia na komputerach z zainstalowanym systemem z rodziny
Windows (od systemu Windows XP w górę). Program będzie działał
zarówno na systemach 32-bitowych jak i 64-bitowych. Wymagania
sprzętowe są zgodne z wymaganiami systemowymi.
2. Wymagane programy
Do prawidłowego działania programu do generowania JPK Potrzebne są
następujące programy:
 Microsoft .NET Framework 4
 baza danych PostgreSQL
 Microsoft OLE DB Provider for Visual FoxPro 9.0
3. Instalacja
Opis instalacji został podzielony na instalację programu jak i dodatkowych
komponentów.
3.1. Microsoft .NET Framework 4
Framework 4.0 jest już zwykle zainstalowany na komputerze. W razie
problemów proszę pobrać go z wykorzystaniem witryny internetowej
(https://www.microsoft.com/pl-pl/download/details.aspx?id=17851).
Zaleca się również pobranie aktualizacji do tego frameworka z
wykorzystaniem mechanizmu Windows Update (lub ręczną instalacją jeśli
mechanizm Windows Update z jakiś powodów jest niedostępny).
3.2. Baza danych PostgreSQL
Jeśli na serwerze lub komputerze pełniącym jego funkcję jest już
zainstalowana baza PostgreSQL to należy się upewnić, że jest to wersja 9.
Instalacja polega na ściągnięciu wybranej bazy danych ze strony
producenta (https://www.postgresql.org/). Dla programu jest to zupełnie
nieistotne na jakim serwerze uruchomimy silnik bazy danych (czyli serwer
może być np. na Linuxie). Instalując bazę należy zapamiętać hasło
użytkownika oraz numer portu, który wybraliśmy. Jeśli na serwerze działa
firewall to należy dodać do jego wyjątków port bazy danych.
3.3. Microsoft OLE DB Provider for Visual FoxPro 9.0
Należy pobrać ze strony producenta (https://www.microsoft.com/enus/download/details.aspx?id=14839) plik instalacyjny (msi lub msm - jest
to bez znaczenia). A następnie go uruchomić. Jedyną istotną kwestią jest
ustawienie instalacji dla wszystkich użytkowników systemu.
3.4. JPK
Po pobraniu pliku jpk.zip należy go rozpakować do docelowej lokalizacji
(np. c:\ts01\PRG\JPK).
4. Pierwsze uruchomienie
Uruchamiając program po raz pierwszy należy wykonać następujące
czynności.
 Przygotować pustą bazę danych o dowolnej nazwie – tylko ten
parametr określamy (na screenie przykład stworzenia bazy z
poziomu pg_admina)
uruchomić program jpk.exe (jeśli klient chce mieć więcej niż jedną
bazę jpk to powinien w takiej sytuacji uruchamiać program ze skrótu
tak zbudowanego, że 'element docelowy' nie znajduję się w ścieżce
'rozpocznij w' a każda instancja programu ma swój folder 'rozpocznij
w' na wzór programu FK)
 uzupełnić konfigurację

 od tego momentu program za każdym razem będzie łączył się do

bazy danych o określonych koordynatach
chcąc zmienić parametry należy odnaleźć w katalogu z bazą plik
'configurePostgres.dat', jest to zwykły plik tekstowy, w którym
można zmienić wszystkie parametry poza hasłem (hasło jest
przechowywane w formie zaszyfrowanej więc jedyny sposób na jego
zmianę to skasowanie pliku i ponowna konfiguracja)
5. Opis funkcji
Po uruchomieniu programu należy skonfigurować program.
Z głównego menu należy wybrać konfiguracja a następnie:
 konfiguracja danych jednostki
wszystkie pola z wyjątkiem 'REGON' oraz 'Numer lokalu' są polami
obowiązkowymi. Brak ich wypełnienia skutkować będzie błędem
podczas generowania jpk (błąd będzie na tyle czytelny, że
użytkownik sam zorientuje się co nie gra).
 Konfiguracja urzędu skarbowego – należy wybrać właściwy urząd
skarbowy
 następnie należy skonfigurować ścieżki lub parametry baz danych
poszczególnych programów (FK, FR, GM). W zależności od
programu będą to inne ścieżki (przykład dla FK)
pole nazwa (kod) służy określeniu tego co w danej ścieżce przechowujemy
– jest to nazwa własna, którą nigdzie nie wykorzystujemy (poza nazwą
pliku do zapisu). Poprzez ścieżkę rozumiemy folder, w którym znajduję się
dany rodzaj pliku(ów). Dodając parametry (dla nowego programu FR)
dodajemy parametry na wzór okna do zapisu konfiguracji połączenia
Po zapisaniu ścieżek bądź parametrów możemy przejść do tworzenia
właściwego pliku JPK. Wybieramy z menu program, z którego chcemy
generować jpk a następnie z dolnego menu wybieramy generuj JPK.
Otworzy się nam wtedy okno wyboru zakresu dat.
Po prawidłowym wybraniu zakresu dat (dat końcowa musi być większa
lub równa od początkowej a mniejsza bądź równa dacie bieżącej).
Następnie wskazujemy gdzie zapisać plik. W razie błędów formalnych
pliku zostaniemy o tym poinformowani.
6. Uwagi dodatkowe
Na administratorze systemu spoczywa obowiązek wykonywania kopii
zapasowej. Kopię można wykonać zarówno z poziomu pg_admina
(graficzny interfejs użytkownika dla bazy danych dostarczony z
PostgreSQL) jak i za pomocą wiersza poleceń (przykładowy skrypt :
ścieżka_do_pg_dump\pg_dump.exe --host adres_serwera --port 5432
--username "postgres" --no-password --format tar --blobs --verbose --file
„ścieżka_do_zapisu_kopii\nazwa_pliku.backup” „nazwa_bazy”
Pogrubioną czcionką zaznaczyłem elementy, które trzeba dostosować we
własnym zakresie). Po reszte informacji odsyłam na stronę producenta
bazy danych (czyli np. można znaleźć tam zasady robienia kopii a także
inne mechanizmy backupu).
7. Zmiany
 2016-07-14 wersja 1.0.0.