Zaawansowane wysłanie E-mail (z szablonem HTML)

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ł wiadmości emal.	Tekst		Pole edytowalne	Może zawierać tagi szablonowemoż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śc z skożystanai 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śc z skożystanai 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śc z skożystanai 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 liste adresów email "DO" które udały sie wysłać	Zmienna		Pole edytowalne
Informacja zwrotna - Nieudane wysłanie	1.0.5	Parametr opcjonalny. Zwraca liste 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 [Załaczniki]	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 najpier dodwane są dokumenty z klasy1 potem z klasy2 itp.
Prefix	1.0.X	Prefix dodawany do nazwy wysyłanego pliku z wybranej klasy dokumentów.	Tablica wartości tekstowych		Pole edytowalne	Np. Dokumetn ma nazwe "fakt0001.pdf" a prefix "faktura-" to w emailu przyjdzie załącznik o nazwie "faktura-fakt0001.pdf" . Można zostawić pustą nazwę, to dokument doda sie bez prefixu,
Zapisz email *	1.0.X	Zapisuje wysłaną wiadomość jako nowy dokument html	Logiczny	NIE		Opcja umożliwa zapisanie wygenerowanej treści email jako dokument html dodany do archwium
Nazwa dokumentu *	1.0.X	Nazwa klasy do której zapisać emaila	Tekst		Pole edytowalne	Nazwa pliku. Można podać bez rozszerzenia to domyślnie doda się ".html".
Opis Dokumentu	1.0.X	Nazwa nowego dokumentu	Telst		Pole edytowalne	Nazwa utworzonego dokumentu html z treścią email
Klasa dokumentów *	1.0.X	Opis Dokumentu, gdy pusty to nazwa klasy	Tekst		Lista wartości	Lista wyboru klas dokumentów z aktualnego systemu.
Załącz do procesu *	1.0.X	Załącza nowy dokument do istniejącego procesu	Logiczny	TAK
Nagłówek email *	1.0.X	Dodaje nagłówek email do treści wiadomości	Logiczny	NIE		Dodaje opcjonalnie domyślny nagłowek do dokumentu z inforamcjami Od kogo, Do kogo, temat wiadomości oraz lista załączników. Patrz szablon nagłowka email
Szablon nagłowka email	1.0.X	Ś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 inforamcjami o mailu. Możliwośc użycia specjalnych tagów Patrz tabela Tab_3. Dla wartosci 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.X	Zapisuje jako nowa wersja dokumentu gdy wartości indeksów sie zgadzają z dokumentem już w archiwum	Logiczny	NIE
Nazwa indeksu	1.0.X	Nazwa indeksu z klasy do której zapisujemy treść email	Tablica wartości tekstowych		Lista wartości
Wartość indeksu	1.0.X	Wartość która zostanie zapisane w indeksie podczas zapisywania dokumenty z treścią email	Tablica wartości tekstowych		Pole edytowalne

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@

Dane z formularza

Otrzymany E-mail

Informacja zwrotna na Formularzu

Change log

1.0.5

Dodanie komponentu

1.0.7

Dodanie możliwośc załączania plików do wiadomości email

1.0.X

Dodanie prefixu do załączników
Obsługa zapisywania treści email
Poprawa kolejności dołączania załączników do wiadomośc email

The license could not be verified: License Certificate has expired!