Płatnik nie łączy się z bazą SQL Server Express? Najpierw sprawdź, czy działa właściwa usługa i czy program wskazuje poprawną nazwę instancji. Jeśli błąd pojawił się po aktualizacji, ustal także, czy program wymaga konwersji bazy; przed zmianami wykonaj kopię.

Jeżeli dopiero wybierasz typ bazy, zacznij od porównania Access czy SQL Server w Płatniku. Jeżeli jesteś na etapie pierwszej instalacji SQL, zobacz instalację Płatnika z bazą SQL Server.

Przed rozpoczęciem

Zanim zmienisz ustawienia SQL, przygotuj:

  • aktualną kopię zapasową bazy Płatnika,
  • nazwę komputera albo serwera,
  • nazwę instancji SQL, na przykład KOMPUTER\SQLPLATNIK,
  • informację, czy logowanie odbywa się kontem Windows czy kontem SQL,
  • konto z uprawnieniami administracyjnymi do Windows i SQL Server,
  • dokładną treść błędu z Płatnika.

ZUS w wymaganiach dla Płatnika 10.02.002 wymienia SQL Server Express jako jeden z obsługiwanych motorów baz danych. Sama instalacja SQL Server Express nie wystarczy: Płatnik musi wskazywać właściwą instancję, baza musi być dostępna, a użytkownik musi mieć uprawnienia.

Procedura krok po kroku

1. Ustal, czy problem dotyczy programu, czy bazy

Ustal, która sytuacja występuje:

  • Płatnik w ogóle się nie uruchamia,
  • Płatnik działa, ale nie może połączyć się z bazą,
  • Płatnik po aktualizacji wymaga konwersji albo zgłasza niezgodność wersji bazy.

Jeżeli komunikat mówi o wersji bazy albo konwersji, nie naprawiaj tego przez reinstalację programu. ZUS opisuje scenariusz, w którym po pobraniu aktualizacji program wykrywa potrzebę konwersji struktury bazy. W takim przypadku trzeba znać hasło, lokalizację bazy i pracować na koncie z odpowiednimi uprawnieniami.

2. Sprawdź usługę SQL Server

W SQL Server Express baza nie jest zwykłym plikiem otwieranym bezpośrednio przez Płatnika. Najpierw musi działać usługa SQL Server dla właściwej instancji.

Sprawdź:

  • czy usługa SQL Server (...) jest uruchomiona,
  • czy nazwa instancji zgadza się z konfiguracją Płatnika,
  • czy po restarcie komputera usługa startuje automatycznie,
  • czy na komputerze nie ma kilku podobnie nazwanych instancji,
  • czy ostatnia awaria Windows nie zatrzymała usługi albo nie zmieniła uprawnień.

Jeżeli Płatnik działał wczoraj, a dziś nie łączy się z bazą, sprawdź stan usługi przed zmianą konfiguracji programu.

3. Sprawdź nazwę serwera i instancji

Bardzo częstym źródłem błędu jest niewłaściwa nazwa instancji w konfiguracji, choć baza na dysku jest poprawna. Dla środowiska lokalnego nazwa może wyglądać inaczej niż dla stanowiska w sieci.

Przykłady, które trzeba rozróżnić:

  • .\SQLEXPRESS - instancja lokalna na tym samym komputerze,
  • KOMPUTER\SQLEXPRESS - instancja nazwana na konkretnym komputerze,
  • SERWER\SQLPLATNIK - instancja na komputerze pełniącym rolę serwera,
  • stary wpis po migracji, który wskazuje już nieistniejący komputer.

Nie zgaduj nazwy instancji. Sprawdź ją na komputerze, na którym działa SQL Server, i zapisz w dokumentacji administracyjnej.

4. Zweryfikuj logowanie i uprawnienia

Jeżeli instancja działa, ale Płatnik nadal nie łączy się z bazą, sprawdź logowanie. Problem może dotyczyć konta Windows, konta SQL albo hasła zapisanego w konfiguracji.

Sprawdź kolejno:

  1. Potwierdź, jakiego typu logowania używa środowisko.
  2. Sprawdź, czy konto nie zostało wyłączone albo hasło nie zostało zmienione.
  3. Ustal, czy problem dotyczy wszystkich użytkowników, czy tylko jednego stanowiska.
  4. Nie nadawaj na stałe uprawnień administratora tylko po to, żeby ukryć błąd konfiguracji.

Jeżeli problem pojawia się po aktualizacji programu i dotyczy konwersji bazy, wykonaj ją na koncie administratora Płatnika. ZUS wskazuje, że zwykły użytkownik może nie mieć uprawnień do konwersji struktury bazy.

5. Sprawdź sieć i firewall przy pracy wielostanowiskowej

W pracy wielostanowiskowej samo działanie SQL Server na komputerze-serwerze nie wystarczy. Stanowiska muszą jeszcze połączyć się z właściwą instancją.

Sprawdź:

  • czy komputer-serwer jest dostępny w sieci,
  • czy zapora Windows lub pakiet bezpieczeństwa nie blokuje połączenia,
  • czy po zmianie routera albo profilu sieci Windows nie zmieniły się reguły,
  • czy stanowiska używają tej samej nazwy serwera,
  • czy problem nie dotyczy tylko jednego komputera.

Jeżeli problem wystąpił po zmianach w sieci, nie przenoś od razu bazy. Najpierw ustal, czy inne stanowiska widzą serwer i czy usługa SQL odpowiada.

Backup i konwersja

Przy SQL Server Express backup musi być wykonany tak, żeby można było odtworzyć bazę, a nie tylko skopiować katalog programu. Sama kopia plików instalacyjnych Płatnika nie zabezpiecza danych płatnika.

Przed aktualizacją, konwersją albo większą naprawą:

  • wykonaj backup bazy narzędziami SQL albo zgodnie z procedurą firmy,
  • zapisz lokalizację backupu,
  • potwierdź, kto zna hasło i ma uprawnienia do odtworzenia bazy,
  • zamknij Płatnika na pozostałych stanowiskach,
  • nie wykonuj jednocześnie zmian w SQL, Windows i Płatniku, jeśli możesz rozdzielić te kroki.

Jeżeli po aktualizacji Płatnik prosi o konwersję bazy, nie pomijaj ostrzeżenia o backupie. Konwersja zmienia strukturę bazy i powinna być wykonana w kontrolowanym oknie serwisowym.

Najczęstsze błędy

Jeśli poprzednie kroki nie wyjaśniły błędu, wróć do tych częstych przyczyn:

  • brak wiedzy, jaka jest nazwa instancji,
  • zatrzymana usługa SQL Server,
  • próba pracy na starym adresie po migracji komputera,
  • backup katalogu programu zamiast backupu bazy,
  • konwersja wykonywana przez zwykłego użytkownika Płatnika,
  • diagnozowanie problemu tylko na jednym stanowisku bez sprawdzenia serwera,
  • zmiana kilku ustawień naraz bez notatki, co było zmienione.

Jeżeli błąd dotyczy wersji bazy, skorzystaj też z poradnika Program Płatnik nie jest w stanie rozpoznać wersji bazy danych.

Aktualność i weryfikacja

Wymagania ZUS poniżej dotyczą Płatnika 10.02.002. Ograniczenia edycji SQL Server Express sprawdzaj w dokumentacji Microsoft dla wersji silnika używanej w firmie.

Sprawdzaj: