Table of Contents

Instalacja i konfiguracja komponentów do komunikacji z użyciem lokalnego agenta

Konfigurację komponentu wymaganą do drukowania paragonów na drukarce fiskalnej należy przeprowadzić na maszynie z systemem Windows (maszyna z dostępem do internetu lub VM na Azure), gdzie będzie działała usługa IntegroFiscalAgentWorker, która umożliwia dostęp do zasobów lokalnych.

Konfiguracja lokalnego agenta do komunikacji z drukarką fiskalną

Poniższa procedura wyjaśnia, w jaki sposób można skonfigurować usługę IntegroFiscalAgentWorker na maszynie z systemem Windows.

Ważne

Przed przystąpieniem do konfiguracji pobierz odpowiedni plik IntegroFiscalAgentWorker z katalogu Additional Components dostępnym na Portalu produktów IT.integro.

Ważne

Należy wybrać odpowiednią lokalizację dla usługi. Nazwa maszyny nie może zawierać białych znaków. Usługa IntegroFiscalAgentWorker będzie powoływała się na tą lokalizację i pobierała z niej biblioteki, więc zmiana lokalizacji nie będzie możliwe po utworzeniu usługi.

  1. Rozpakuj plik IntegroFiscalAgentWorker.zip do wybranej lokalizacji na maszynie.
  2. Skonfiguruj parametr urls w pliku appsettings.json znajdującym się w rozpakowanym katalogu. Parametr urls określa, pod jakim adresem jest dostępny agent. Przykład podania parametru *urls *w pliku appsettings.json:
{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "urls": "http://<adres_IP_maszyny>:<port_komunikacji>"
}

gdzie:

  • <adres_IP_maszyny> - Określa adres IP maszyny, na której będzie zdefiniowany agent, przy czym powinien to być adres statyczny przypisany do tej maszyny;
  • <port_komunikacji> - Określa port, na którym będzie nasłuchiwał skonfigurowany agent, przy czym powinien on być otwarty w zaporze danej maszyny.
  1. Uruchom powershell z uprawnieniami administratora.
  2. Aby utworzyć usługę, uruchom poniższą komendę:
New-Service -Name IntegroFiscalAgent -DisplayName "Integro Fiscal Local Agent" -BinaryPathName <exe path> -Description "Allows to reach On-Prem resourcs from Business Central through Web API." -StartupType Automatic

gdzie:

  • <exe path> - Określa ścieżkę do pliku IntegroFiscalAgentWorker.exe znajdującego się w wybranej ścieżce dla agenta.
  1. Aby uruchomić usługę, wykonaj następującą komendę:
Start-Service IntegroFiscalAgent
  1. Aby zatrzymać usługę, wykonaj następującą komendę:
Stop-Service IntegroFiscalAgent
Uwaga

Aby usunąć usługę, wykonaj następującą komendę: dla powershell >= 6.0: powershell Remove-Service IntegroFiscalAgent ; dla powershell < 6.0: powershell sc.exe delete IntegroFiscalAgent

Logowanie błędów

Usługa IntegroFiscalAgentWorker rejestruje błędy w dzienniku zdarzeń przy pomocy poleceń UniversalRequestHandler.

Konfiguracja agenta w trybie development do komunikacji z drukarką fiskalną

Jeśli aplikacja IntegroFiscalAgentWorker jest uruchomiana w trybie Development z wiersza poleceń (na potrzeby testów), to pod adresem i portem, na którym hostowany jest agent, dostępna jest strona diagnostyczna. Z tej strony można w łatwy sposób wysyłać żądania do agenta.

Poniższa procedura wyjaśnia, w jaki sposób można uruchomić aplikację IntegroFiscalAgentWorker na maszynie z systemem Windows do celów testowych.

  1. Uruchom wiersz poleceń z uprawnieniami administratora.
  2. W celu uruchomienia aplikacji, uruchom poniższą komendę:
IntegroFiscalAgentWorker.exe --environment Development --urls "http://<adres_IP_maszyny>:<port_komunikacji>"

gdzie:

  • <adres_IP_maszyny> - adres IP maszyny, na której będzie zdefiniowany agent, powinien to być adres statyczny przypisany do tej maszyny,
  • <port_komunikacji> - port, na którym będzie nasłuchiwał skonfigurowany agent, powinien on być otwarty w zaporze danej maszyny.

Cała komunikacja z drukarką będzie teraz wyświetlana w wierszu poleceń.

Konfiguracja w Dynamics 365 Business Central

Poniższa procedura wyjaśnia, w jaki sposób skonfigurować drukarkę fiskalną w Dynamics 365 Business Central do komunikacji z pomocą IntegroFiscalAgentWorker.exe.

  1. Skonfiguruj wstępnie drukarkę fiskalną zgodnie z informacją zamieszczoną w artykule Konfiguracja drukarki fiskalnej.

  2. Wybierz ikonę Lightbulb that opens the Tell Me feature, wprowadź Drukarki fiskalne, a następnie wybierz powiązane łącze.

  3. Na otwartej stronie Kartoteka drukarki fiskalnej wypełnij wymagane pola według poniższej instrukcji:

  • Korzystaj z sieci lokalnej - Wybierz odpowiednią opcję.
  • URL agenta lokalnego - Ustaw adres URL według wzoru http://<adres_IP_maszyny>:<port_komunikacji>. Jest to ten sam adres url, który został ustawiony w konfiguracji agenta lokalnego.

Testowanie konfiguracji

Poniższa procedura wyjaśnia, w jaki sposób przetestować połączenie pomiędzy Dynamics 365 Business Central a drukarką fiskalną z pomocą przygotowanej usługi agenta.

  1. Wybierz ikonę Lightbulb that opens the Tell Me feature, wprowadź Drukarki fiskalne, a następnie wybierz powiązane łącze.

  2. Na otwartej stronie Kartoteka drukarki fiskalnej wybierz akcję Testuj połączenie.

Uwaga

Błędy, jakie mogą się pojawić przy testowaniu połączenia oznaczają, że: - drukarka nie jest poprawnie połączona z maszyną, na której działa usługa agenta do komunikacji; - drukarka fiskalna jest inaczej skonfigurowana w stosunku do ustawień w Dynamics 365 Business Central; - konfiguracja po stronie Dynamics 365 Business Central jest niepoprawna.

  1. Gdy test połączenia zakończy się pomyślnie, możesz wydrukować paragon testowy. W tym celu wybierz akcję Drukuj paragon testowy na stronie Kartoteki drukarki fiskalnej.
Uwaga

Drukowanie paragonu testowego zalecane jest tylko wtedy, gdy drukarka fiskalna pracuje w trybie szkoleniowym.

Zobacz też

Konfiguracja drukarki fiskalnej