OUTPUT POST

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,
• lub 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 czy 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 pierwszą 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 klikając przycisk Edit.

Pamiętaj, że jeśli połączenie jest już wykorzystane na innym operatorze to on również będzie działał na zmodyfikowanym połączeniu.

Jeśli nie masz jeszcze zdefiniowanego Twojego połączenia z kontem pocztowym w systemie możesz je dodać wykorzystując przycisk 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 które użyte w konfiguracji.

Połączenie możesz zapisać w systemie korzystając z przycisku Save.

Po zapisaniu połączenie będzie dostępne w systemie pod nazwą jaka została podana w polu Name.

Więcej o tworzeniu połączenia z kontem pocztowym

KONFIGURACJA DZIAŁANIA OPERATORA

W zakładce EMAIL PROPERTIES zadeklarujesz sposób wysyłki e-maila, odbiorców wiadomości, oraz zachowanie systemu podczas 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).

Pamiętaj, że używając opcji Single mail w polu Send mode nie będziesz mógł użyć bitów magistrali aby sparametryzować pola Subject oraz Content.

To są dwie kompletnie różne strategie pojmowania procesu z operatorem OUTPUT POST. Obie drogi postępowania mogą oddać Tobie nieocenione usługi dla niezależnych procesów.

Korzystając z wariantu SEND MODE = MailForEachRecord możesz np. generować automatycznie w wyznaczonych przez Ciebie interwałach czasowych, bez zaangażowania swoich pracowników, salda dla wszystkich swoich kontrahentów. Zaś z trybu SEND MODE = SingleMail możesz przygotować raport na podstawie zdiagnozowanej sytuacji wykrytej automatycznie (alarm wewnętrzny).

Możesz wysyłać pocztę do ustalonych stałych odbiorców (opcja RECIPIENTS MODE = CONSTANT) lub na adres, który znajduje się na szynie danych wejściowych (RECIPIENTS MODE = From Busbar).

Podczas przetwarzania danych w operatorze OUTPUT POST GRAVITY możesz stanąć przed dylematem w jaki sposób przetwarzać dane w przypadku pojawienia się błędu.

Możesz to zaprojektować 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 z pominięciem faktu błędu wysyłki.

W trybie tym możesz wprowadzić na magistralę danych informacje o statusie wysyłki (pole Column for result status)

statusy:

SENT - wysłano

FAIL - niepowodzenie

oraz o szczegółach wysyłki (pole Column for result details)

wartością jest tablica obiektów JSON przechowująca szczegóły wysyłki dla adresatów

[{"Recipient":"piotr.piotrowski@company.com","Status":"SENT","StatusInt":1,"Details":"Sent"}]

Pole Recipient handling steruje sposobem wysyłki maili dla adresatów. Możesz wybrać opcję wysyłki zbiorowej Bulk sending lub Individual for each recipient. Wybierając tryb zbiorowy pojawienie się błędu np. w domenie jednego z odbiorców spowoduje przerwanie wysyłki maila również dla istniejących odbiorców.

• Abort processing with error → Proces zostanie przerwany, założone transakcje wycofane i zgłoszony zostanie błąd przetwarzania procesu.

Ponieważ server SMTP nie zwraca na bieżąco informacji o dostarczeniu wiadomości, system jest w stanie zgłosić tylko podstawowe błędy takie jak: nieprawidłowy format adresu, nieprawidłowa domena serwera odbiorcy, itp. Jeśli serwer odbiorcy istnieje, a nie istnieje podany adres email, system GRAVITY nie jest w stanie wykryć błędu, ponieważ serwer odbiorcy nie informuje o tym fakcie na bieżąco, tylko asynchronicznie mailem zwrotnym z informacją o braku wskazanego adresata.

KONFIGURACJA WIADOMOŚCI

W zakładce Message zdefiniujesz tytuł, treść korespondencji mailowej oraz określisz czy mail ma być wysłany w formacie HTML czy TEXT.

Zarówno tytuł (Subject) jak i treść emaila (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 wywołanie okna parametrów.

Rozwijając listę masz do dyspozycji parametry systemowe, projektu oraz bity magistrali. zatwierdzasz wybór przyciskiem Insert.

Aby wstawić parametry w polu Content rozwiń listę parametrów wybierz element i zatwierdź wstawienie przyciskiem stawiania.

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 @nawa Agregacja bitów magistrali jako GET_AGGR("SUM", "groupingField")

Aby wygodniej wprowadzać treść emaila w pole Content, gdy wysyłasz wiadomość w formacie HTML (przełącznik Content is HTML), możesz użyć przycisku edytora HTML, który otwiera okno edytora 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 w jakim formacie mają być przesłane dane.

Dodanie pliku jako załącznika na podstawie bitu magistrali, który transportuje dane tekstowe lub binarne, tworzysz klikając opcję Add attachment based on bit. Następnie wybierasz odpowiedni bit magistrali (Source bit).

Nazwa pliku (File name) może zostać sparametryzowana podobnie jak wiadomość.

Możesz utworzyć dowolną ilość złączników na podstawie magistrali danych.