KANCELARYJNY SYSTEM PODATKOWY Podział bazy danych Opracował: Katowice, Styczeń 2013
1 Podział bazy danych cel Wraz z wersją 3.3.0 systemu KSP, nastąpiła zmiana architektury systemu z jednej do wielu baz danych. Do tej pory, wszystkie informacje dotyczące podatników znajdowały się w jednej bazie danych. Zmiana wprowadzona w wersji 3.0.0 powoduje, że każdy podatnik znajduje się w dedykowanej mu bazie danych, co niesie za sobą korzyści w użytkowaniu programu: Praca z danym podatnikiem przyśpieszy (rejestry z listami dokumentów będą mieć mniejszy plik do przetworzenia). Przenośność danego klienta pomiędzy systemami KSP (planowane w przyszłych wersjach). W związku z tym, do prawidłowego działania, potrzebne są odpowiednie kroki opisane w niniejszym dokumencie. Należy ściągnąć aktualizację systemu KSP w wersji 3.3.0 a także aplikację do podziału bazy danych. Aplikacja do podziału bazy danych systemu KSP znajduje się na stronie http://www.ksp.com.pl/centrumpobierania.aspx. Po kliknięciu w link oraz podaniu ścieżki do wybranego folderu na komputerze, plik wykonawczy zostanie zapisany w wybranej wcześniej lokalizacji. Bazę danych KSP należy podnieść do wersji 3.0.0 zgodnie z dotychczasowymi zasadami. 2 Zatrzymanie wszystkich programów Należy upewnić się, że wszystkie poniższe programy zostały wyłączone na komputerze, przed uruchomieniem aplikacji do podziału: System KSP u wszystkich użytkowników programu oraz na serwerze Szybki dostęp do KSP mini program startujący wraz z systemem KSP, znajdujący się w prawym dolnym pasku zadań na pulpicie (obok daty systemowej). Należy potwierdzić, zamknięcie systemu KSP i szybkiego dostępu w Menadżerze zadań (prawy przycisk myszki na głównym pasku zadań systemu Windows -> opcja Menadżera zadań -> zakładka procesy). Jeżeli znajdziemy tu proces KSP.exe lub KSPTray.exe oba procesy należy zamknąć za pomocą opcji Zakończ proces. 40-860 Katowice Strona 2
Należy zamknąć wszystkie programy i aplikacje, używające serwera bazy danych Firebird 40-860 Katowice Strona 3
3 Uruchamianie aplikacji do podziału bazy danych na serwerze Aplikację do podziału bazy danych należy uruchomić na SERWERZE, na którym znajduje się baza KSP. W tym celu należy najpierw program wypakować dostępnym na komputerze programem wypakowującym, a następnie uruchomić plik: KspDivider.exe, jako ADMINISTRATOR (prawy przycisk myszy -> uruchom jako Administrator). Po uruchomieniu programu, otrzymamy komunikat. Należy zapoznać się z jego treścią przed wykonaniem dalszych kroków. Jeżeli zgadzamy się z warunkami ostrzeżenia wybieramy przycisk OK. Pola do wypełnienia: Baza KSP - pole informacyjne dla użytkownika, w którym użytkownik ma możliwość zobaczenia czy proponowany plik bazy do podziału jest zgodny z prawdą (nazwa, rozszerzenie itp.) 40-860 Katowice Strona 4
UWAGA: Jeżeli Baza KSP ma inne rozszerzenie niż proponowane, należy w polu Baza KSP ręcznie zmienić rozszerzenie na poprawne. W innym wypadku podział bazy nie uda się. Serwer bazy danych należy wybrać lokalizację serwera KSP, którego bazę chcemy podzielić. Wybranie serwera spowoduje automatyczne wypełnienie pól: Baza KSP, Ścieżka podłączenia. Ścieżka podłączenia ścieżka, z której będzie korzystała aplikacja na stanowiskach klienckich w celu podłączenia się do bazy danych (przeważnie jest to ścieżka tożsama z zapisami w rejestrze systemu Windows, na każdym stanowisku klienta systemu KSP). Obsługiwane są formaty NetBeui oraz TCP/IP. Ścieżka fizyczna wypełniana przez użytkownika aplikacji do podziału bazy; opisane w dalszej części dokumentu. Krok pole pozwala na powrót do wybranego kroku, na którym program został zatrzymany. Domyślnie ustawiany jest krok: Kopiuj pliki. Liczba baz maksymalna ilość firm, która zostanie wydzielona z bazy KSP. Domyślnie ustawiane 0 oznacza, że będą to wszystkie firmy. Zaleca się pozostawienie domyślnej wartości, lecz zważywszy na to, że podział jest czasochłonny, można ustawić, ile firm powinno zostać wydzielonych. Przy ponownym uruchomieniu podziału, wydzielone firmy nie zostaną ponownie wydzielone. Ścieżka fizyczna pole służące do określenia fizycznej ścieżki do bazy danych KSP. Aplikacja do podziału bazy nie jest w stanie określić jej automatycznie, stąd użytkownik winien jest wprowadzić ją ręcznie. Ścieżka wprowadzana, nie jest w żaden sposób sprawdzana czy walidowana przez aplikację. Jeżeli stanowiska klienckie będą miały dostęp do katalogu bazy poprzez tzw. Udostępniony udział sieciowy, wystarczy taką ścieżkę skopiować z eksploratora Windows. Należy pamiętać, aby ścieżka była zakończona backshalsem( \ ); Nazwa serwera pole służące do określenia nazwy komputera (serwera), po której będą się łączyć stanowiska klienta bo baz danych systemu KSP. W przypadku, gdy dane stanowisko pełni rolę serwera oraz klienta, nazwa serwera powinna widnieć jako localhost ; czyli powinna być zgodna z nazwą serwera widniejąca w polu Serwer bazy danych. Jeżeli stanowiska klienta będą łączyć się do innego komputera, to pole powinno być wypełnione nazwą stanowiska serwera, po której komputery klienckie będą rozpoznawać go w sieci. Nazwa serwera w tym przypadku nie jest nazwą tożsamą z nazwą widniejącą w polu Serwer bazy danych. 40-860 Katowice Strona 5
W przypadku, gdy klient będzie się łączył poprzez zasoby zmapowane, podobnie wystarczy taką ścieżkę skopiować z eksploratora Windows z komputera klienta: 40-860 Katowice Strona 6
Natomiast, jeżeli serwer oraz klient to ten sam komputer, to w polu Ścieżka Fizyczna wystarczy skopiować Ścieżkę podłączenia. W tym przypadku, w polu serwera należy wspiać: localhost : Jeżeli wszystkie pola zostały wypełnione wybieramy opcję OK i cierpliwie czekamy na zakończenie podziału bazy danych. W tym czasie, nie można pod żadnym pozorem włączać systemu KSP, bądź wyłączać serwer Firebird. Po zakończeniu podziału zostanie wyświetlone okno o zakończeniu procesu, który należy zamknąć i przejść do następnego kroku, opisanego poniżej. UWAGA: Jeżeli w trakcie wykonywania podziału, wystąpi jakikolwiek błąd, prosimy o kontakt z biurem KSP pod numerem tel. 32 204 27 86. Nie próbować kolejny raz dzielić bazy. 4 Aktualizacja aplikacji na komputerach klientach Po podzieleniu bazy KSP, należy na każdym z komputerów - klientów, przed załączeniem systemu KSP skopiować i zastąpić pliki: S3Aktualizacja.exe oraz S3Aktualizacja.map (dostarczone wraz z aplikacją do podziału bazy) do katalogu Aktualizacja, znajdującego się w miejscu instalacji systemu KSP (np. C:\Program Files\KSP Win\Aktualizacja). Następnie, uruchamiając system KSP, podnieść wersję aplikacji do wersji 3.3.0. UWAGA: W razie pojawienia się błędu z podłączeniem do bazy danych, należy skopiować plik fbclient.dll dostarczony z aplikacją do dzielenia bazy, do katalogu Aktualizacja oraz do głównego katalogu instalacji systemu KSP, po czym ponownie uruchomić system KSP. UWAGA: Powyższy krok należy zrobić dla każdego komputera pracującego w trybie klienta KSP!!! W razie problemów prosimy o kontakt z biurem KSP pod numerem tel. 32 204 27 86. 40-860 Katowice Strona 7
Zakładając nową firmę/przedsiębiorcę, system KSP oczekuje dostępu do katalogu z bazą danych, gdyż tam znajduje się baza wzorcowa. Należy zagwarantować dostęp klienta do tego zasobu na serwerze np. poprzez udostępnienie zasobu sieciowo, bądź mapowanie, zgodnie z danymi wprowadzonymi w pole Ścieżka fizyczna. Po Aktualizacji klienta, przed uruchomieniem systemu KSP, należy usunąć odpowiednie klucze rejestru systemowego Windows. W polu uruchomienia w panelu Start należy wpisać polecenie regedit. W drzewie kluczy należy rozwinąć gałęzie HKEY_CURRENT_USER -> Software -> 3Soft -> KSP - > (numer generowany w zależności od ścieżki dostępu do pliku) -> KSP -> Params. W rozwinięciu gałęzi Params powinno się znajdować pole Ogólne, które należy usunąć. 40-860 Katowice Strona 8