Instrukcja obsługi R2faktury

Moduł WWW dołączony jest do wersji instalacyjnej programu R2faktury. Podczas instalacji należy wybrać sposób INSTALACJA SZCZEGÓŁOWA i zaznaczyć komponent Moduł WWW - dostęp do programu przez internet. Wymagane pliki pojawią się w podkatalogu WWW. Główny plik modułu WWW to wR2firma.exe.

Aby uruchomić moduł WWW wszystkie pliki z folderu WWW należy samodzielnie skopiować do folderu BIN (równoległego do podkatalogu WWW), tam gdzie znajdują się już pliki R2firma.exe i R2firmaApi.dll. Uruchomienie systemu odbywa się właśnie w folderze BIN.

Moduł WWW musi zostać zainstalowany na komputerze pełniącym rolę serwera WWW. Taki komputer powinien być widoczny poza siecią lokalną firmy, tzn. mieć przydzielony publiczny numer IP oraz mieć otwarte odpowiednie porty.

Moduł WWW można uruchomić w trybie:

1. wolnostojącej aplikacji z wbudowanym serwerem WWW
   Korzystamy z niego przy pierwszych uruchomieniach modułu. Umożliwia łatwą weryfikację prawidłowej konfiguracji systemu. Aby go uruchomić korzystamy z pliku wR2firma GUI.bat znajdującego się w folderze BIN.

2. usługi (service) z wbudowanym serwerem WWW
   To jest docelowy tryb pracy modułu WWW. Po sprawdzeniu konfiguracji w opisanym wyżej trybie aplikacji, możemy zainstalować usługę wR2firma korzystając z pliku wR2firma SERVICE INSTALL.bat znajdującego się w folderze BIN. Zainstalowanie usługi jest czynnością jednorazową. Przy kolejnych restartach komputera usługa będzie już uruchamiana automatycznie, bez konieczności ingerencji ze strony użytkownika. Ewentualne błędy, które pojawią się w trakcie pracy modułu, zapisywane są do pliku wR2firma.log. W razie konieczności odinstalowania usługi korzystamy z pliku wR2firma SERVICE UNINSTALL.bat znajdującego się w folderze BIN.

Sam serwer wR2firma.exe może obsłużyć maksymalnie 15 jednoczesnych sesji (czyli zalogowanych użytkowników lub kontrahentów). W przypadku większych wymagań należy uruchamiać moduł pośredniczący wR2firmaRouter.exe (zamiast programu wR2firma.exe). Wtedy ograniczeniem jednoczesnej ilości sesji jest tylko fizyczna pamięć komputera. Moduł pośredniczący może również pracować w 2 wariantach:

1. wolnostojącej aplikacji
   Korzystamy z niego przy pierwszych uruchomieniach modułu. Umożliwia łatwą weryfikację prawidłowej konfiguracji systemu. Aby go uruchomić korzystamy z pliku wR2firmaRouter GUI.bat znajdującego się w folderze BIN.

2. usługi (service)
   To jest docelowy tryb pracy modułu WWW. Po sprawdzeniu konfiguracji w opisanym wyżej trybie aplikacji, możemy zainstalować usługę wR2firmaRouter korzystając z pliku wR2firmaRouter SERVICE INSTALL.bat znajdującego się w folderze BIN. Zainstalowanie usługi jest czynnością jednorazową. Przy kolejnych restartach komputera usługa będzie już uruchamiana automatycznie, bez konieczności ingerencji ze strony użytkownika. Ewentualne błędy, które pojawią się w trakcie pracy modułu, zapisywane są do pliku wR2firma.log. W razie konieczności odinstalowania usługi korzystamy z pliku wR2firmaRouter SERVICE UNINSTALL.bat znajdującego się w folderze BIN.

Aby korzystać z modułu WWW na tym samym komputerze, na którym go zainstalowano, należy w przeglądarce internetowej wpisać adres http://127.0.0.1 lub http://localhost.

Aby korzystać z modułu WWW na zewnątrz firmy, należy w oknie przeglądarki wpisać adres naszego serwera WWW, widoczny z zewnątrz, czyli np. http://80.53.206.100 (adres IP uzyskany od dostawcy internetu) lub http://r2faktury.naszafirma.pl (przukładowy adres symboliczny posiadany przez naszą firmę).

UWAGI:

1. W przypadku, gdy na komputerze jest już uruchomiony inny serwer WWW (działający na standardowym porcie 80), moduł WWW można skonfigurować do pracy na innym porcie. W tym celu w pliku konfiguracyjnym R2firma.ini (znajdującym się w folderze BIN) należy dopisać sekcję [www] z parametrem Port=NowyNumerPortu, przykładowo:
   [www]
Port=81
   wtedy w przeglądarce należy wpisać adres http://localhost:81 lub http://127.0.0.1:81

2. Jeśli chcemy łączyć się z modułem WWW połączeniem szyfrowanym (protokół https) należy:

   • w pliku konfiguracyjnym R2firma.ini w sekcji [www] wyzerować parametr Port i określić odpowiednio parametr SSLPort, przykładowo:
     [www]
Port=0
SSLPort=443

   • wgrać do folderu BIN uzyskane od zewnętrznego dostawcy pliki certyfikatów SSL (Cert.pem, Key.pem, Root.pem)

   • uruchomić program R2faktury i wprowadzić hasło klucza prywatnego (menu Ustawienia - Środowisko zakładka Inne).

3. lista wszystkich dostępnych parametrów pracy modułu WWW, które można wpisać do sekcji [www] w pliku R2firma.ini

   • Port - port, na którym nasłuchuje usługa wR2firma.exe w wersji nieszyfrowanej (http, domyślnie 80)

   • SSLPort - port, na którym nasłuchuje usługa wR2firma.exe w wersji szyfrowanej (https, domyślnie 0 czyli niedostęny)

   • SessionTimeout - czas bezczynności użytkownika, po którym sesja zostanie samoczynnie zamknięta (domyślnie 20 minut)

   • MaxSessions - limit liczby jednocześnie otwartych sesji dla jednego serwera wR2firma.exe (domyślnie 15, powyżej tej liczby należy stosować wR2firmaRouter.exe)

   • RouterPortFrom - dolny zakres portów lokalnych routera (domyślnie 2000)

   • RouterPortTo - górny zakres portów lokalnych routera (domyślnie 2050)

4. Jeśli korzystamy z systemu R2firma, to instalację modułu WWW wykonujemy jednorazowo dla całego systemu, tzn. nie powtarzamy ww. czynności dla modułu R2fk/R2księga. Program sam rozpozna na podstawie parametrów logowania do jakiego modułu (R2faktury, R2fk lub R2księga) chcemy się zalogować.

5. Pliki znajdujące się w folderze WWW są automatycznie aktualizowane wraz z główną aktualizacją programu R2firma.exe (menu Zbiory-Narzędzia-Aktulizacja programu). Aby skorzystać z pobranej aktualizacji modułu WWW, należy:

   • wyłączyć uruchomione wcześniej usługi:

     • jeżeli używany jest tylko wR2firma, należy odszukać usługę o nazwie wR2firma w oknie Zarządzanie Komputerem w sekcji Usługi i Aplikacje -> Usługi, kliknąć na niej prawym przyciskiem myszy i wyłączyć.

     • jeżeli używany jest wR2firmaRouter, należy:

       • wyłączyć usługę o nazwie wR2firmaRouter (opis j.w.)

       • usunąć proces wR2firma.exe (nacisnąć klawisze Ctrl-Alt-Del, wybrać Menadżera Zadań, w zakładce Szczegóły odnaleźć wR2firma.exe i nacisnąć przycisk Zakończ zadanie)

   • samodzielenie skopiować nową wersję wR2firma.exe i wR2firmaRouter.exe z folderu WWW do folderu BIN

   • włączyć ponownie usługę wR2firmaRouter lub wR2firma.

   UWAGA. Istnieje możliwość sprawdzenia bieżącej wersji modułu WWW. W tym celu należy na otwartej stronie logowania do modułu najechać myszką na nazwę programu (pole widoczne w lewym górnym rogu okna). Informacja o wersji modułu WWW widoczna będzie w hincie do tego pola.

Moduł WWW testowany był na następujących przeglądarkach:

• Mozilla Firefox (ver. 35.0 i nowsze)

• Microsoft Internet Explorer (ver. 10 i nowsze)

• Google Chrome (ver.40.0 i nowsze).