Zdarzenia - Powiadomienie w aplikacji jako efektor

Wstęp

Niniejszy dokument przedstawia konfigurację reguły zdarzenia, której efektem jest utworzenie powiadomienia (notyfikacji) wewnątrz aplikacji AMAGE. Efektor ten jest alternatywą (lub uzupełnieniem) efektora email - odbiorcy otrzymują komunikat bezpośrednio w panelu powiadomień interfejsu desktop i mobilnego.

Przykład przedstawia scenariusz, w którym zmiana stanu zdarzenia serwisowego na określony stan powoduje powiadomienie wyznaczonych użytkowników w aplikacji.

Procedura konfiguracji

Krok 1: Dostęp do konfiguracji zdarzeń

Konfiguracja zdarzeń dostępna jest w sekcji konfiguracyjnej systemu (Konfiguracja → Zdarzenia → Reguły zdarzeń) lub bezpośrednio z widoku modułu za pomocą ikony błyskawicy.

image 2026 08 31 23 55 52 544
Figure 1. Menu konfiguracji zdarzeń

Krok 2: Utworzenie nowej reguły

Po wybraniu przycisku (+) wypełniamy podstawowe dane reguły:

  • Nazwa - czytelna nazwa reguły, np. Powiadomienie - zakończona awaria,

  • Obiekt - typ obiektu, na którym definiujemy zdarzenie, np. Zdarzenie serwisowe (mod.AssetApi.model.service.ServiceEvent),

  • Typ zdarzenia - operacja wyzwalająca reakcję, np. Zmiana.

Krok 3: Wybór efektora Powiadomienie

W sekcji efektora edytora reguły wybieramy typ Powiadomienie. W sekcji tej dostępne są pola:

  • Wiadomość - treść powiadomienia; w treści można wykorzystywać dane przetwarzanego obiektu za pomocą notacji {{}},

  • Typ powiadomienia - informacyjne, decyzyjne, ostrzegawcze, błędu lub krytyczne,

  • Użytkownicy - lista odbiorców (do każdej z list dodawani są użytkownicy lub wydziały),

  • Wysyłaj jako powiadomienie na pełnym ekranie - opcja wyświetlenia powiadomienia w wyskakującym oknie pełnoekranowym, zwiększająca szansę na jego dostrzeżenie.

image 2026 08 31 23 55 03 396
Figure 2. Definicja efektora Powiadomienie

Krok 4: Treść powiadomienia z danymi obiektu

Treść powiadomienia formatowana jest z użyciem danych obiektu. Przykład dla zmiany stanu zdarzenia serwisowego:

Zdarzenie serwisowe #{{obj.eventNumber}} ({{obj.type.name}}) zostało oznaczone jako zakończone.
Produkt: {{obj.product.name}}

Pełna lista dostępnych pól obiektów opisana jest w dokumentacji mechanizmu zdarzeń (zakładka "Nowy obiekt" w szczegółach zdarzenia).

Krok 5: Skrypty sprawdzający i przygotowujący

Regułę można ograniczyć skryptem sprawdzającym - w przykładzie wywołujemy powiadomienie tylko wtedy, gdy zdarzenie zmienia stan na ZAKOŃCZONE:

(function(){
var state=_.get(ctx,"obj.state.name");
return state==="ZAKOŃCZONE";
})();

Skrypt przygotowujący w tym przypadku nie jest wymagany.

Krok 6: Zapis i weryfikacja

Po zapisaniu aktywnej reguły system tworzy powiadomienia w reakcji na zdarzenia obiektu. Odbiorcy widzą je w panelu powiadomień (ikona dzwonka) w interfejsie desktop i mobilnym - zgodnie z regułami notyfikacji systemowych (daty ważności, potwierdzanie, limit 50 niepotwierdzonych powiadomień).

W liście zdarzeń (Zdarzenia w sekcji konfiguracji) po wybraniu zdarzenia zakładka Dane przedstawia zrealizowane reakcje, w tym utworzone powiadomienie.

Efektor Powiadomienie nie zastępuje efektora email - reguła może mieć określony jeden typ efektora. Jeśli wymagane jest jednoczesne powiadomienie w aplikacji i na email, definiowane są dwie reguły (lub dwie instancje reguły) z tym samym obiektem i typem zdarzenia.
Ze względu na ciągły rozwój systemu niektóre ekrany mogą wyglądać nieznacznie inaczej, ale zachowują pełną funkcjonalność opisaną w tym dokumencie.