Konfiguracja > Integracja Azure Service Bus

Okno służy do konfiguracji publikacji zdarzeń integracyjnych KT-Plus do Azure Service Bus, np. zmian stanu dokumentów magazynowych, zdarzeń CRM, awiz, nadania numeru KSeF i zmian cenników. Otwiera się je z menu Konfiguracja → Integracja Azure Service Bus. Wymagane jest uprawnienie do edycji parametrów systemu (to samo co dla okna Konfiguracja → Parametry).

Parametry publikacji

•Publikacja zdarzeń do Azure Service Bus włączona – włącza zadanie publikacji w usłudze KT-Plus (parametr ASB_Enabled).

•Connection string – dane połączenia z przestrzenią nazw Azure Service Bus (zaczynają się od „Endpoint=sb://”). Wartość jest zapisywana w bazie w formie zaszyfrowanej (parametr ASB_ConnectionStringEnc), dzięki czemu nie jest widoczna w parametrach systemu. Opcja „Pokaż” odsłania wpisaną wartość. Zalecane jest użycie polityki dostępu z samym prawem wysyłania (Send).

•Źródło zdarzeń – identyfikator bazy umieszczany w komunikatach, np. ktplus://firma/produkcja. Musi być unikalny dla każdej bazy i podmiotu.

•Harmonogram publikacji – częstotliwość uruchamiania zadania w formacie crontab rozszerzonym o sekundy. Pola mają kolejność: sekunda, minuta, godzina, dzień miesiąca, miesiąc, dzień tygodnia. Domyślnie 0 * * * * * (co minutę), np. 0 */5 * * * * oznacza uruchamianie co 5 minut. Uwaga: klasyczny zapis */1 * * * * oznacza tu uruchamianie co sekundę. Przy zapisie okno sprawdza harmonogram i ostrzega, gdy zadanie byłoby uruchamiane częściej niż raz na minutę.

•Rozmiar paczki, Dzierżawa, Ponowienie od/do, Retencja – parametry techniczne zadania: liczba zdarzeń wysyłanych w jednym przebiegu, czas blokady pobranej paczki w sekundach, opóźnienie pierwszego i maksymalnego ponowienia po błędzie oraz liczba dni przechowywania wysłanych zdarzeń.

Typy zdarzeń

Tabela zawiera typy zdarzeń, które KT-Plus może wysyłać do Azure Service Bus:

•Aktywny – czy zdarzenia danego typu są rejestrowane i wysyłane. Nowe typy są domyślnie nieaktywne.

•Topic – nazwa tematu (topic) w Azure Service Bus, do którego trafiają zdarzenia.

•Priorytet – domyślny priorytet komunikatów: normal albo high.

Uwagi

•Zmiana włączenia publikacji i harmonogramu zaczyna działać po ponownym uruchomieniu usługi KT-Plus (ktplussrv). Pozostałe parametry są odczytywane przy każdym uruchomieniu zadania publikacji.

•Zmiana aktywności typów zdarzeń działa w programie, w którym ją zapisano, od razu, a w pozostałych uruchomionych programach najpóźniej po 60 sekundach.

•Jeżeli na serwerze ustawiono zmienną środowiskową KTPLUS_ASB_CONNECTION_STRING, ma ona pierwszeństwo przed connection stringiem zapisanym w bazie.

•Jeżeli okno informuje, że zapisanego connection stringa nie da się odszyfrować (np. po zmianie NIP właściciela programu), należy wprowadzić go ponownie i zapisać konfigurację.