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.
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.
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).
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.
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.
- Abort processing with error → Proces zostanie przerwany, założone transakcje wycofane i zgłoszony zostanie błąd przetwarzania procesu.
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.