Zaawansowane wysłanie E-mail (z szablonem HTML) z konfiguracją serwera pocztowego

Jeśli masz problem ze zrozumieniem jak działa setter/zadanie automatyczne, sprawdź opisy: Setter, Zadanie automatyczne, Wykonanie warunkowe, Parametry komponentów

Podstawowe informacje

Kategoria: Email

Dostępna od wersji: 1.0.5

Opis

Zadanie wysyła maile według przygotowanego wcześniej szablonu ( podanego za pomocą ściezki do pliku na serwerze lub nazwy szablonu w konfiguracji procesu). Posiada predefiniowane tagi np: wyszukiwanie e-maili na podstawie identyfikatora roli lub automatyczne wstawianie wartości do szablonu w miejsce między znacznikami "@" i "@". Aplikacja ma możliwość dołączenia dokumentu z procesu jako załącznika w mailu. Konfiguracja serwera pocztowego znajduję się parametrach systemu. Od wesji 1.0.11 Jest możliwość zapisania treści wysłanego maila jako dokument w systemi PlusWorkflow

Parametry konfiguracyjne

Nazwa parametru	Od wersji	Opis	Typ parametru	Wartość domyślna	Rodzaj pola	Uwagi i ograniczenia
Źródło szablonu*	1.0.7	Miejsce przechowywania szablonu email do wysłania	Tekst		Lista wartości
Ścieżka do szablonu *	1.0.7	Należy podać bezpośrednią ścieżkę do pliku na serwerze	Tekst		Pole edytowalne	Szablon html który może zawierać specjalne tagi, które podmienią się na odpowiednie wartości. Patrz tabela Tab_2.
Nazwa szablonu *	1.0.7	Nazwa szablonu z konfiguracji procesu	Tekst		Pole edytowalne	Szablon html który może zawierać specjalne tagi, które podmienią się na odpowiednie wartości. Patrz tabela Tab_2.
Temat *	1.0.5	Tytuł wiadomości email.	Tekst		Pole edytowalne	Może zawierać tagi szablonowe możliwe stosowanie znaczników "@" np "@processname@" Patrz tabela Tab_2.
Do*	1.0.5	Lista adresów email do wysłania	Tablica wartości tekstowych		Pole edytowalne	Obsługuje kilka email podanych po "," lub ";". Możliwość z skorzystania z tagów email. Patrz tabela Tab_1.
Kopia	1.0.5	Parametr opcjonalny. Lista adresów do wysłania kopii maila	Tablica wartości tekstowych		Pole edytowalne	Obsługuje kilka email podanych po "," lub ";". Możliwość z skorzystania z tagów email. Patrz tabela Tab_1.
Ukryta kopia	1.0.5	Parametr opcjonalny. Lista adresów do wysłania ukrytej kopii maila	Tablica wartości tekstowych		Pole edytowalne	Obsługuje kilka email podanych po "," lub ";". Możliwość z skorzystania z tagów email. Patrz tabela Tab_1.
Nazwa zmiennej	1.0.5	Parametr opcjonalny. Nazwa zmiennej w szablonie, która mieści sie między znakami @ i @	Tablica wartości tekstowych		Lista wartości	parametr przydatny gdy chcemy użyc jeden szablon na kilku procesacch i zmapować tag kótrego nie ma w aktualnym procesie.
Wartość zmiennej	1.0.5	Parametr opcjonalny. Wartość która ma zostać wstawiona w miejsce nazwy zmienej w szablonie	Tablica wartości tekstowych		Pole edytowalne
Jedna wiadomość *	1.0.5	Wysyła jednego maila do kilku adresatów. W przypadku NIE każdy adresat jest traktowany osobno i dostaje osobnego maila. Domyślnie TAK.	Logiczny	TAK
Informacja zwrotna - Udane wysłanie	1.0.5	Parametr opcjonalny. Zwraca listę adresów email "DO" które udały się wysłać	Zmienna		Pole edytowalne
Informacja zwrotna - Nieudane wysłanie	1.0.5	Parametr opcjonalny. Zwraca listę adresów email "DO" których nie udało się wysłać	Zmienna		Pole edytowalne
Komentarz *	1.0.5	Dodaje komentarz o wysłanych i nie wysłanych mailach dla adresatów z listy "DO"	Logiczny	TAK
Załączniki	1.0.7	Dodaje dokumenty procesu do maili jako załączniki	Logiczny	NIE
Klasa dokumentu	1.0.7	Parametr opcjonalny. Gdy wartość pusta, to dodaje wszystkie dokumenty z procesu do maila (jeżeli włączono taką opcje), w przeciwnym razie dodaje tylko dokumenty z wybranej klasy dokumentów	Tablica wartości tekstowych		Lista wartości	Kolejność klas dokumentów ma znaczenie przy dodawaniu załączników. Czyli najpierw dodawane są dokumenty z klasy1 potem z klasy2 itp.
Prefix	1.0.11	Prefiks dodawany do nazwy wysyłanego pliku z wybranej klasy dokumentów.	Tablica wartości tekstowych		Pole edytowalne	Np. Dokument ma nazwę "fakt0001.pdf" a prefix "faktura-" to w email przyjdzie załącznik o nazwie "faktura-fakt0001.pdf" . Można zostawić pustą nazwę, to dokument doda się bez prefiksu,
Filtr po nazwie dokumentu	1.0.28	Wyrażenie regularne, które filtruje dokumenty z wybranej klasy do wysyłania w załączniku e-mail.			Pole edytowalne	Pole puste spowoduję pobranie wszystkich dokumentów z wybranej klasy Przykłady: nazwa pliku: IMG5822996601453555121.pdf wyrażenia regularne, które znajdą ten plik: ^IMG5.$ .pdf$ Link do strony, w której można testować regexa online: https://regex101.com/
Zapisz email *	1.0.11	Zapisuje wysłaną wiadomość jako nowy dokument html	Logiczny	NIE		Opcja umożliwia zapisanie wygenerowanej treści email jako dokument html dodany do archiwum
Nazwa dokumentu *	1.0.11	Nazwa nowego dokumentu	Tekst		Pole edytowalne	Nazwa pliku. Można podać bez rozszerzenia to domyślnie doda się ".html".
Opis Dokumentu	1.0.11	Opis Dokumentu, gdy pusty to nazwa klasy	Telst		Pole edytowalne	Nazwa utworzonego dokumentu html z treścią email
Klasa dokumentu *	1.0.11	Nazwa klasy do której zapisać emaila	Tekst		Lista wartości	Lista wyboru klas dokumentów z aktualnego systemu.
Załącz do procesu *	1.0.11	Załącza nowy dokument do istniejącego procesu	Logiczny	TAK
Nagłówek email *	1.0.11	Dodaje nagłówek email do treści wiadomości	Logiczny	NIE		Dodaje opcjonalnie domyślny nagłówek do dokumentu z informacjami Od kogo, Do kogo, temat wiadomości oraz lista załączników. Patrz szablon nagłówka email
Szablon nagłówka email	1.0.11	Ścieżka do niestandardowego szablonu HTML zawierającego tagi nagłówka wiadomości e-mail	Tekst		Pole edytowalne	Ścieżka do własnego szablonu html z informacjami o mailu. Możliwość użycia specjalnych tagów Patrz tabela Tab_3. Dla wartości pustej używany jest domyślny szablon dostarczony wraz z wtyczką Patrz Domyślny szablon nagłowka email
Zapisz jako nowa wersja dokumentu *	1.0.11	Zapisuje jako nowa wersja dokumentu gdy wartości indeksów sie zgadzają z dokumentem już w archiwum	Logiczny	NIE
Nazwa indeksu	1.0.11	Nazwa indeksu z klasy do której zapisujemy treść email	Tablica wartości tekstowych		Lista wartości	Lista wyboru po wybraniu klasy dokumentu do zapisu.
Wartość indeksu	1.0.11	Wartość która zostanie zapisane w indeksie podczas zapisywania dokumenty z treścią email	Tablica wartości tekstowych		Pole edytowalne
Nazwa Hosta	1.0.5	Adres serwera pocztowego	Tekst	mail.suncode.pl	Pole edytowalne
Port SMTP	1.0.5	Numer portu do wysyłania poczty	Tekst	587	Pole edytowalne
Włączenie autoryzacji połączenia	1.0.5		Logiczny	Tak	Pole edytowalne
Mail nadawcy	1.0.5	Adres maila z jakiego ma być wysłana poczta	Tekst	nadawaca@suncode.pl	Pole edytowalne
Login	1.0.5	Login do serwera pocztowego	Tekst	login_do_skrzynki	Pole edytowalne
Hasło	1.0.5	Hasło do serwera pocztowego	Tekst	******	Pole edytowalne	Pole nie jest szyfrowane
Włączenie protokołu SSL	1.0.5		Logiczny	NIE	Pole edytowalne
Włączenie protokołu TLS	1.0.5		Logiczny	NIE	Pole edytowalne
Źródło *	1.0.X	Wybór sposobu w jaki mają zostać odnalezione dokumenty, które będą wysłane w załącznikach	String		Pole edytowalne
ID pliku *	1.0.X	Id pliku potrzebne do wybrania plików, które chcemy wysłać w załącznikach	Tablica wartości tekstowych		Lista wartości

INFO

Zadanie działa identycznie jak Zaawansowane wysłanie E-mail (z szablonem HTML). Różnica polega na skonfigurowaniu skrzynki pocztowej.

Przykładowa konfiguracja

Przykład

Ustawienia zadania automatycznego

Ustawienia szablonu

szablon.html

Treść szablonu

<h1>@zm1@</h1>
<br><hr>
<br><h3>@zm2@</h3>
<br><p>@zm3@</p>
<br>@processname@
<br>Nazwa procesu
<br>@processdescription@
<br>Opis procesu
<br>@processtype@
<br>Typ procesu
<br>@processstarttime@
<br>Godzina uruchomienia procesu
<br>@processstartday@
<br>Data uruchomienia procesu
<br>@activityname@
<br>Nazwa zadania
<br>@activitystarttime@
<br>Godzina uruchomienia zadania
<br>@activitystartday@
<br>Data uruchomienia zadania
<br>@historylink@
<br>Link do historii procesu
<br>@link#zadanie_1@
<br>Link do szczegółów zadania o podanym id definicji zadania,
<br>np. link#akceptacja_wniosku
<br>@taskuser#zadanie_1@
<br>@taskuser#prepare_email@
<br>@taskuser#autotask_send_advence_email@
<br>@taskuser#zadanie_4@
<br>Pełna nazwa uzytkownika, który wykonał zadanie o podanym id definicji zadania,
<br>np. taskuser#akceptacja_wniosku
<br>@realusername#kontrahent@
<br>Pełna nazwa użytkownika, którego identyfikator znajduje się w podanej zmiennej procesowej,
<br>np. realusername#zmienna
<br>@processname@
<br>@processdescription@
<br>@processdefid@
<br>@processpackageid@
<br>@processstarttime@
<br>@processstartday@
<br>@processscreatedtime@
<br>@processcreatedteday@
<br>@activityname@
<br>@activitydescription@
<br>@activitydefid@
<br>@activityid@
<br>@activitystarttime@
<br>@activitystartday@
<br>@activitycreatedtime@
<br>@activitycreatedday@
<br>@userfullname@
<br>@userfirstname@
<br>@userlastname@
<br>@useremail@
<br>@username@
<br>@usernumber@