Operator OUTPUT POST umożliwia przetworzenie strumienia danych znajdującego się na magistrali wejściowej na wiadomość e-mail, która zostaje wysłana do określonych adresatów. Operator ten może działać w dwóch podstawowych trybach:
- wysłanie pojedynczego maila zawierającego całość danych zgromadzonych na magistrali,
- wysłanie osobnego maila dla każdego rekordu znajdującego się na magistrali.
Adresaci poczty mogą być ustaleni na podstawie informacji zawartej w magistrali wejściowej lub określeni w sposób trwały, co pozwala na elastyczne zarządzanie odbiorcami wiadomości.
Wiadomość e-mail może być skonstruowana z wykorzystaniem różnych źródeł danych: parametrów projektowych, bitów magistrali, a także parametrów globalnych, co pozwala na dużą elastyczność i personalizację treści wiadomości. Dzięki temu można dynamicznie budować temat, treść, adresatów czy inne elementy maila, dopasowując je do specyfiki przetwarzanych danych.
Operator umożliwia również dodanie do wiadomości załączników. Załączniki mogą pochodzić z różnych źródeł:
- mogą być bezpośrednio przesyłane jako dane binarne lub tekstowe, które znajdują się na jednym z bitów magistrali,
- mogą być generowane na podstawie danych magistrali w formie plików, takich jak XLSX, CSV lub XML, które następnie są dołączane do wiadomości e-mail.
Dzięki tym funkcjom OUTPUT POST pozwala na automatyzację wysyłki spersonalizowanych powiadomień, raportów oraz zestawień, które mogą być przesyłane bezpośrednio z poziomu procesu przetwarzania danych w systemie GRAVITY. Operator doskonale sprawdza się zarówno w prostych scenariuszach powiadamiania, jak i w bardziej zaawansowanych rozwiązaniach integracyjnych, gdzie wiadomości e-mail są elementem całego procesu biznesowego.
Przykład projektu GRAVITY z użyciem operatora OUTPUT POST.
WYBÓR I TWORZENIE KONTA POCZTOWEGO
Przejdź na zakładkę Email account we właściwościach operatora.
Jeśli masz już utworzone połączenie z skrzynką pocztową, wybierz je z listy wyboru Email account. Pola połączenia zostaną wypełnione zgodnie z wybranym połączeniem.
Możesz zmienić dane połączenia do skrzynki pocztowej za pomocą przycisku Edit.
Jeśli nie masz jeszcze zdefiniowanego swojego połączenia z kontem pocztowym w systemie, możesz je dodać za pomocą przycisku Add.
Po uzupełnieniu danych nowego połączenia możesz je przetestować przyciskiem Test sending. Jeśli konfiguracja jest poprawna, zostanie wysłany e-mail na konto użyte w konfiguracji.
Połączenie możesz zapisać w systemie za pomocą przycisku Save.
Po zapisaniu połączenie będzie dostępne w systemie pod nazwą podaną w polu Name.
KONFIGURACJA DZIAŁANIA OPERATORA
W zakładce EMAIL PROPERTIES zadeklarujesz sposób wysyłki e-maila, odbiorców wiadomości, oraz zachowanie systemu w przypadku błędu.
W pierwszym kroku określ, w jaki sposób chcesz wysyłać korespondencję mailową.
Opcja SEND MODE:
- Single mail → jeden mail dla całego strumienia danych magistrali
- Mail for each record → dla każdego rekordu strumienia danych operator wyśle niezależnego maila (zostanie wysłanych tyle maili, ile jest rekordów na magistrali).
To są dwa zupełnie różne sposoby podejścia do procesu z użyciem operatora OUTPUT POST. Wybór podejścia zależy od rodzaju procesu.
Możesz wysyłać pocztę do ustalonych stałych odbiorców (opcja RECIPIENTS MODE = CONSTANT) lub na adres, który znajduje się na magistrali danych wejściowych (RECIPIENTS MODE = From Busbar).
Podczas przetwarzania danych w operatorze OUTPUT POST system GRAVITY może wymagać określenia sposobu postępowania w przypadku wystąpienia błędu.
Możesz to skonfigurować, ustawiając opcję Action after failed na jeden z dwóch wariantów postępowania:
- Continue processing → informacja o błędzie będzie widoczna w logach wykonania, jednak nie spowoduje to przerwania procesu, wycofania ewentualnych transakcji i zgłoszenia błędu przetwarzania. Proces będzie kontynuowany mimo wystąpienia błędu wysyłki.
- Abort processing with error → proces zostanie przerwany, założone transakcje zostaną wycofane, a błąd przetwarzania procesu zostanie zgłoszony.
W tym trybie możesz zapisać na magistrali danych informacje o statusie wysyłki (pole Column for result status), gdzie możliwe wartości to: SENT - wysłano, FAIL - niepowodzenie.którego wartością jest tablica obiektów JSON zawierająca szczegóły wysyłki dla poszczególnych adresatów.
Dodatkowo możesz zapisać szczegóły wysyłki w polu Column for result details, którego wartością jest tablica obiektów JSON zawierająca szczegóły wysyłki dla poszczególnych adresatów.
[{"Recipient":"piotr.piotrowski@company.com","Status":"SENT","StatusInt":1,"Details":"Sent"}]
Pole Recipient handling steruje sposobem wysyłki wiadomości e-mail do adresatów. Możesz wybrać opcję wysyłki zbiorowej (Bulk sending) lub wysyłki indywidualnej (Individual for each recipient). W trybie zbiorowym wystąpienie błędu, np. w domenie jednego z odbiorców, spowoduje przerwanie wysyłki wiadomości również do pozostałych adresatów.
Ponieważ serwer SMTP nie zwraca informacji o dostarczeniu wiadomości w czasie rzeczywistym, system może zgłosić jedynie podstawowe błędy, takie jak nieprawidłowy format adresu e-mail lub nieprawidłowa domena serwera odbiorcy. W przypadku gdy serwer odbiorcy istnieje, ale wskazany adres e-mail nie istnieje, system GRAVITY nie jest w stanie wykryć błędu, ponieważ informacja ta przekazywana jest asynchronicznie w formie wiadomości zwrotnej.
KONFIGURACJA WIADOMOŚCI
W zakładce Message zdefiniujesz tytuł, treść korespondencji mailowej oraz określisz, czy e-mail ma być wysłany w formacie HTML czy TEXT.
Zarówno tytuł (Subject) jak i treść wiadomości e-mail (Content) może być parametryzowana prze dane pochodzące z magistrali, parametry projektu oraz zmienne systemowe.
Aby użyć parametru w polu Subject kliknij w przycisk wstawiania parametrów, co spowoduje wyświetlenie okna wyboru parametrów.
Po rozwinięciu listy masz do dyspozycji parametry systemowe, parametry projektu oraz bity magistrali. Wybór zatwierdzasz przyciskiem Insert.
Aby wstawić parametry w polu Content, rozwiń listę parametrów, wybierz element i zatwierdź wstawienie przyciskiem zaznaczonym na czerwono na zrzucie ekranu poniżej.
Masz do dyspozycji parametry projektu, dane magistrali oraz funkcję GET_AGGR, która wykonuje wskazaną agregację na wybranym bicie magistrali.
Parametry systemowe oraz bity magistrali zostaną wstawione jako tekst w formacie %nazwa%.
Parametry projektu zostaną wstawione jako tekst @nazwa.
Agregacja bitów magistrali jako GET_AGGR("SUM", "groupingField").
Aby ułatwić wprowadzanie treści wiadomości e-mail w polu Content, w przypadku wysyłki w formacie HTML (przełącznik Content is HTML), możesz skorzystać z przycisku edytora HTML, który otwiera dedykowane okno edycji HTML.
KONFIGURACJA DODAWANIA ZAŁĄCZNIKÓW WIADOMOŚCI
W zakładce Attachments możesz dołączyć jako plik załącznika przetwarzany strumień danych lub plik utworzony na podstawie bitu magistrali (opcja dostępna tylko w przypadku konfiguracji pola Send mode=Mail for each record).
Aby dodać załącznik na podstawie strumienia danych magistrali, zaznacz opcję Attach all data as a file i wybierz format, w jakim mają zostać przesłane dane.
Aby dodać plik jako załącznik na podstawie bitu magistrali, przenoszącego dane tekstowe lub binarne, wybierz opcję Add attachment based on bit, a następnie wskaż odpowiedni bit magistrali w polu Source bit.
Nazwa pliku (File name) może zostać sparametryzowana podobnie jak wiadomość.
Możesz utworzyć dowolną ilość załączników na podstawie magistrali danych.