Biblioteka podpisująca - instalacja i konfiguracja

Wersja biblioteki podpisującej pl_podpis wydana 24.08.2021 r. i jej kolejne wersje będą współpracować tylko i wyłączenie z wersjami aplikacji wydanymi po dniu 24.08.2021 r. W przypadku korzystania z wcześniejszych wersji aplikacji należy korzystać z wersji pl_podpis_210816.zip.

Funkcjonalność składania elektronicznego podpisu na dokumentach realizowana jest przez bibliotekę pl_podpis.

Wymagania techniczne

Biblioteka podpisująca domyślnie działa w wersji 64-bitowej. W celu wymuszenia wykorzystania 32-bitowej wersji biblioteki podpisującej należy utworzyć plik USWSjava.config, szczegóły poniżej.

Wymagania dla wersji 64-bitowej (domyślnie):

• .NET Framework w wersji 4.7.2 lub wyższej (wbudowany w Windows 10)
• Microsoft Visual C++ 2015-2019 Redistributable
• Visual C++ 2013 Redistributable x64
• Java 64-bitowa

Wymagania dla wersji 32-bitowej:

• .NET Framework w wersji 4.7.2 lub wyższej (wbudowany w Windows 10)
• Microsoft Visual C++ 2015-2019 Redistributable
• Visual C++ 2010 Redistributable x86
• Java 32-bitowa

W celu wymuszenia wykorzystania 32-bitowej wersji biblioteki podpisującej należy utworzyć plik USWSjava.config o zawartości:

            <?xml version="1.0" encoding="utf-8" ?>
            <configuration>
              <vidokConfigurations>
                <use64bitJava>false</use64bitJava>
              </vidokConfigurations>
            </configuration>

Instalacja

1. Wypakować zawartość paczki pl_podpis do katalogu aplikacji.
2. Utworzyć katalog C:\infosys_pity\PIT_WYSLANE\ (w przypadku instalacji serwerowych katalog powinien znajdować się lokalnie na stacjach roboczych operatorów).
3. Zainstalować JAVA odpowiednio w wersji 64 lub 32 bitowej.

Katalog C:\infosys_pity\PIT_WYSLANE\ jest wymagany nie tylko w przypadku aplikacji Kadry i Płace, a także w przypadku innych aplikacji wykorzystujących bibliotekę podpisującą - są w nim przechowywane pliki tymczasowe oraz ewentualne logi błędów.

Aplikacje wykorzystujące podpis

• Kadry i Płace
• Rejestr VAT
• Egzekucje
• Księgowość Budżetowa (wkrótce)

Konfiguracja

Uwaga! Ustawienia zaawansowane - tylko w przypadku problemów z działaniem podpisu na domyślnej konfiguracji.

USWS.dll.config

USWS.dll.config jest plikiem konfiguracyjnym biblioteki ViDOK.

Struktura

Fragment pliku USWS.dll.config odpowiedzialny za konfiguracje:

  <vidokConfigurations>
    <template_path>PIT_WZORCE\</template_path>
    <doc_path>C:\infosys_pity\PIT_WYSLANE\</doc_path>
    <certificate_name>EDeklaracje</certificate_name>
    <jvm32path></jvm32path>
    <jvm64path></jvm64path>
    <settings32>sdk_wrapper_210824\settings.xml</settings32>
    <settings64>sdk_wrapper_210824x64\settings.xml</settings64>
    <workDir></workDir>
    <RodzajBramki>Edeklaracje</RodzajBramki>
    <Sig_exe></Sig_exe>
    <madkom_ApiKey></madkom_ApiKey>
    <connectionString></connectionString>
    <Log>false</Log>
    <sign_timeout>60000</sign_timeout>
    <PauseGain>4000</PauseGain>
  </vidokConfigurations>

Opis

Odwołania do linii w pliku USWS.dll.config:

52. <template_path> - wskazuje ścieżkę względną do folderu w którym znajdują się wzorce,

53. <doc_path> - wskazuje lokalizację w której mają być zapisywane wysłane PIT-y,

54. <certificate_name> - przyjazna nazwa zainstalowanego certyfikatu do podpisu cyfrowego,

55. <jvm32path> - wskazuje lokalizację do biblioteki jvm.dll wirtualnej maszyny Javy (domyślna lokalizacji Javy). Ścieżka podawana explicite wtedy i tylko wtedy, gdy program sam nie znajdzie zainstalowanego środowiska Java (dla wersji 32-bitowej),

56. <jvm64path> - wskazuje lokalizację do biblioteki jvm.dll wirtualnej maszyny Javy (domyślna lokalizacji Javy). Ścieżka podawana explicite wtedy i tylko wtedy, gdy program sam nie znajdzie zainstalowanego środowiska Java (dla wersji 64-bitowej),

57. <settings32> - wskazuje lokalizacje pliku z ustawieniami do modułu podpisującego (dla wersji 32-bitowej),

58. <settings64> - wskazuje lokalizacje pliku z ustawieniami do modułu podpisującego (dla wersji 64-bitowej),

59. <workDir> - lokalizacja, w której moduł podpisujący zapisuje pliki,

60. <RodzajBramki> - wskazuje na typ serwera z jakim program ma się komunikować przy wysyłce deklaracji pojedynczych. Można podawać dwie wartości: Edeklaracje lub UBD.

61. <Sig_exe> - określa lokalizację programu podpisującego. Ścieżka bezwzględna podawana tylko w sytuacji, kiedy program podpisujący nie znajduje się w katalogu programu.

62.<madkom_ApiKey> - parametr używany w przypadku korzystania z obiegu dokumentów firmy Madkom.

63. <connectionString> - parametr używany w przypadku korzystania z obiegu dokumentów firmy Finn.

64. <Log> - odpowiada za aktywacje logowania zdarzeń. Przyjmuje wartości true lub false.

65. <sign_timeout> - określany w milisekundach (1000 = 1 sekunda), używany w przypadku kiedy występują problemy z automatycznym zamknięciem aplikacji podpisującej.

66. <PauseGain> - parametr wykorzystywany w przypadku formularzy PDF w aplikacji Podatki.

Uwaga!

• Brak którejkolwiek zmiennej, bądź brak folderu wskazanego w zmiennej spowoduje zgłoszenie wyjątku przez bibliotekę.
• W przypadku problemów z biblioteką podpisującą należy aktywować log zdarzeń. W tym celu edytujemy plik USWS.dll.config. W sekcji vidokConfigurations dodajemy element <Log>true</Log>. Log zdarzeń będzie zapisany w ścieżce wskazanej <doc_path>C:\infosys_pity\PIT_WYSLANE\</doc_path> (wskazany katalog musi istnieć, aplikacja nie utworzy go sama). Po rozwiązaniu problemu należy pamiętać o wyłączeniu logowania błędów.

Aktualizacja

W przypadku aktualizacji podpisu należy pamiętać, że wiele instalacji działało w konfiguracji 32-bitowej wersji. Zalecanym działaniem jest przejście całkowicie na wersje 64-bitową, doinstalowanie wymaganych bibliotek oraz JAVA 64-bit.

W przypadku gdy nie ma możliwości korzystania z 64-bitowej wersji należy utworzyć plik USWSjava.config zgodnie z instrukcją powyżej.