Instalacja i konfiguracja komponentów do komunikacji z użyciem Azure Service Bus Relay
Konfigurację komponentów potrzebnych do drukowania paragonów na drukarce fiskalnej należy przeprowadzić w trzech miejscach:
- Portal Azure - konfiguracja Azure Service Bus Relay,
- Business Central,
- maszyna z systemem Windows (maszyna z dostępem do Internetu lub VM na Azure) - na tej maszynie będzie działała usługa BCAgentService, która umożliwia dostęp do zasobów lokalnych.
Podczas konfiguracji usług na Azure Portal zostaną zdefiniowane parametry, które zostaną wykorzystane w dalszych krokach konfiguracji połączenia. Definiowanie i wykorzystywanie parametrów zawsze będzie zaznaczone podkreśleniem w niniejszej instrukcji.
Konfiguracja komponentów w Azure Portal
Aby skonfigurować komponenty w witrynie Azure Portal:
- Utwórz zasób. Szczegółowe informacje na ten temat zamieszczono w artykule Create a Relay namespace using the Azure portal.
Nazwa zasobu musi być unikalna w całym Azure Portal. Nazwa może zawierać na przykład nazwę klienta.
Ważne
Jeden zasób może zawierać w sobie konfigurację dla wielu drukarek, dlatego dla danej instalacji klienta nie trzeba tworzyć więcej niż jednego zasobu Relay.
Parametr nazwa przestrzeni nazw ma taką samą wartość jak nazwa zasobu Relay.
Parametr adres przestrzeni nazw ma taką samą wartość jak nazwa zasobu Relay, wraz z suffixem ".servicebus.windows.net", czyli "nazwa przestrzeni nazw.servicebus.windows.net".
Porada
Dodatkowe informacje na ten temat zamieszczono w artykule Get started with Relay Hybrid Connections WebSockets in .NET na stronie Microsoft Learn.
Porada
Opisane poniżej kroki należy powtórzyć dla każdej nowej drukarki.
- W widoku zasobu Relay, z paska nawigacyjnego znajdującego się po lewej stronie, przejdź do Entities, a następnie Hybrid Connections. Utwórz nowe połączenie hybrydowa.
Ważne
Konfiguracja każdej drukarki wymaga indywidualnego połączenia hybrydowego, dlatego nazwa może wskazywać np. na lokalizację danej drukarki.
Nazwa Hybrid Connection to wartość parametru nazwa Hybrid Connection.
W widoku nowego połączenia hybrydowego przejdź do Settings, a następnie wybierz Shared access policies. Utwórz dwa nowe elementy Policy:
- z nazwą Sender i zanaczonym polem Send (wartość parametru nazwa Sender policy to Sender),
- z nazwą Listener i zanaczonym polem Listen (wartość parametru nazwa Listener policy to Listener).
W widoku każdego elementu Policy skopiuj Primary Key.
- Skopiowane Primary Key z Sender to wartość parametru klucz Sender policy.
- Skopiowane Primary Key z Listener to wartość parametru klucz Listener policy.
Konfiguracja w Dynamics 365 Business Central
Poniższa procedura wyjaśnia, w jaki sposób można skonfigurować usługę Azure Service Bus Relay w Dynamics 365 Business Central.
Skonfiguruj drukarkę fiskalną zgodnie z informacją zamieszczoną w artykule Konfiguracja drukarki fiskalnej.
Wybierz ikonę
, wprowadź Drukarki fiskalne, a następnie wybierz powiązane łącze.Na otwartej stronie Kartoteka drukarki fiskalnej wybierz akcję Konfiguracja Azure Relay.
Na otwartej stronie Konfiguracja usługi Azure Service Bus Relay wypełnij wymagane pola według poniższej instrukcji:
Przestrzeń nazwy Azure Relay - nazwa przestrzeni nazw.
Nazwa połączenia hybrydowego - nazwa Hybrid Connection.
Nazwa zasad dostępu współdzielonego - nazwa Sender policy.
Klucz wspólny - klucz Sender policy.
Konfiguracja usługi BCAgentService na maszynie z systemem Windows
Poniższa procedura wyjaśnia, w jaki sposób można skonfigurować usługę BCAgentService na maszynie z systemem Windows.
Ważne
Przed przystąpieniem do konfiguracji pobierz odpowiedni plik BCAgentService 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 BCAgentService będzie powoływała się na tą lokalizację i pobierała z niej biblioteki, więc zmiana lokalizacji nie będzie możliwa po utworzeniu usługi.
- Rozpakuj plik BCAgentService.zip do wybranej lokalizacji na maszynie z systemem Windows.
- Uruchom powershell z uprawnieniami administratora.
- Aby sprawdzić, że biblioteki nie są zablokowane, uruchom poniższą komendę:
Get-ChildItem -Path <plugin folder path> -Recurse | Unblock-File
gdzie:
- <plugin folder path> - ścieżka do folderu z bibliotekami
przykład:
Get-ChildItem -Path C:\BCAgent_Service\Plugins -Recurse | Unblock-File
- Aby zezwolić na wykonywanie niepodpisanych skryptów, uruchom poniższą komendę:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
- Aby utworzyć usługi, pobierz Skrypt instalacyjny, a następnie uruchom poniższą komendę:
Install-BCAgentService.ps1 <exe path> -namespace <namespace url> -connectionName <hybrid connection> -keyName <policy name> -key <policy key> -pluginfolder <plugin folder path>
gdzie:
- <exe path> - ścieżka do pliku BCAgentService.exe znajdującego się w wybranej ścieżce dla agenta,
- <namespace url> - adres przestrzeni nazw
- <hybrid connection name> - nazwa Hybrid Connection
- <policy name> - nazwa Listener policy
- <policy key> - klucz Listener policy
- <plugin folder path> - ścieżka do folderu z bibliotekami, który znajduje się w folderze agenta.
Przykładowa komenda może mieć postać:
Install-BCAgentService.ps1 C:\BCAgent_Service\BCAgentService.exe -namespace customername.servicebus.windows.net -connectionName shoplocation -keyName Listener -key 1a2b3c4d5e -pluginfolder C:\BCAgent_Service\Plugins
Testowanie konfiguracji
Poniższa procedura wyjaśnia, w jaki sposób przetestować połączenie pomiędzy Dynamics 365 Business Central a drukarką fiskalną za pomocą skonfigurowanego agenta.
W systemie Dynamics 365 Business Central wybierz ikonę
, wprowadź Drukarki fiskalne, a następnie wybierz powiązane łącze.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 Azure Service Bus Relay; - drukarka fiskalna jest inaczej skonfigurowana w stosunku do ustawień w Dynamics 365 Business Central; - konfiguracja Azure Relay po stronie Dynamics 365 Business Central jest niepoprawna.
- Gdy test połączenia zakończy się pomyślnie, możesz wydrukować paragon testowy. W tym celu wybierz akcję Drukuj paragon testowy na stronie Kartoteka drukarki fiskalnej .
Uwaga
Drukowanie paragonu testowego zalecane jest tylko w momencie, jeżeli drukarka fiskalna pracuje w trybie szkoleniowym.