Jeśli masz problem ze zrozumieniem jak działa setter/zadanie automatyczne, sprawdź opisy: SetterZadanie automatyczneWykonanie warunkoweParametry komponentów

Kategoria: Email

Dostępna od wersji: 1.0.5

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

Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Źródło szablonu*1.0.7Miejsce przechowywania szablonu email do wysłaniaTekst Lista wartości 
Ścieżka do szablonu *1.0.7Należy podać bezpośrednią ścieżkę do pliku na serwerzeTekst Pole edytowalne 
Nazwa szablonu *1.0.7Nazwa szablonu z konfiguracji procesuTekst Pole edytowalne 
Temat *1.0.5Tytuł wiadmości emal.Tekst Pole edytowalneMoże zawierać tagi szablonowemożliwe stosowanie znaczników "@" np "@processname@"  Patrz tabela Tab_1.
Do1.0.5Lista adresów email do wysłaniaTablica wartości tekstowych Pole edytowalneObsługuje kilka email podanych po "," lub ";". Możliwośc z skożystanai z tagów email. Patrz tabela Tab_1.
Kopia1.0.5Parametr opcjonalny. Lista adresów do wysłania kopii mailaTablica 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 kopia1.0.5Parametr opcjonalny. Lista adresów do wysłania ukrytej kopii mailaTablica wartości tekstowych Pole edytowalneObsługuje kilka email podanych po "," lub ";". Możliwośc z skożystanai z tagów email. Patrz tabela Tab_1. 
Nazwa zmiennej1.0.5Parametr opcjonalny. Nazwa zmiennej w szablonie, która mieści sie między znakami @ i @Tablica wartości tekstowych Lista wartościparametr przydatny gdy chcemy użyc jeden szablon na kilku procesacch i zmapować tag kótrego nie ma w aktualnym procesie.
Wartość zmiennej1.0.5Parametr opcjonalny. Wartość która ma zostać wstawiona w miejsce nazwy zmienej w  szablonieTablica wartości tekstowych Pole edytowalne 
Jedna wiadomość *1.0.5Wysyła jednego maila do kilku adresatów. W przypadku NIE każdy adresat jest traktowany osobno i dostaje osobnego maila. Domyślnie TAK.LogicznyTAK  
Informacja zwrotna - Udane wysłanie1.0.5Parametr opcjonalny. Zwraca liste adresów email "DO" które udały sie wysłać Zmienna Pole edytowalne 
Informacja zwrotna - Nieudane wysłanie1.0.5Parametr opcjonalny. Zwraca liste adresów email "DO" których nie udało się wysłaćZmienna Pole edytowalne 
Komentarz *1.0.5Dodaje komentarz o wysłanych i nie wysłanych mailach dla adresatów z listy "DO"LogicznyTAK  
Załączniki1.0.7Dodaje dokumenty procesu do maili jako załącznikiLogicznyNIE  
Klasa dokumentu [Załaczniki]1.0.7Parametr 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ówTablica wartości tekstowych Lista wartościKolejność klas dokumentów ma znaczenie przy dodawaniu załączników. Czyli najpier dodwane są dokumenty z klasy1 potem z klasy2 itp.
Prefix 1.0.XPrefix dodawany do nazwy wysyłanego pliku z wybranej klasy dokumentów.Tablica wartości tekstowych Pole edytowalneNp. 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.XZapisuje wysłaną wiadomość jako nowy dokument htmlLogicznyNIE Opcja umożliwa zapisanie wygenerowanej treści email jako dokument html dodany do archwium
Nazwa dokumentu *1.0.XNazwa klasy do której zapisać emailaTekst Pole edytowalneNazwa pliku. Można podać bez rozszerzenia to domyślnie doda się ".html".
Opis Dokumentu 1.0.XNazwa nowego dokumentu Telst Pole edytowalneNazwa utworzonego dokumentu html z treścią email
Klasa dokumentów *1.0.XOpis Dokumentu, gdy pusty to nazwa klasyTekst Lista wartościLista wyboru klas dokumentów z aktualnego systemu.
Załącz do procesu *1.0.XZałącza nowy dokument do istniejącego procesuLogicznyTAK  
Nagłówek email *1.0.XDodaje nagłówek email do treści wiadomościLogicznyNIE 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-mailTekst Pole edytowalneŚcieżka do własnego szablonu html z inforamcjami o mailu. Dla wartosci pustej używany jest domyślny szablon dostarczony wraz z wtyczką Patrz szablon nagłowka email
Zapisz jako nowa wersja dokumentu *1.0.XZapisuje jako nowa wersja dokumentu gdy wartości indeksów sie zgadzają z dokumentem już w archiwumLogicznyNIE  
1.0.XNazwa indeksu z klasy do której zapisujemy treść emailTablica wartości tekstowych Lista wartości 
Wartość indeksu1.0.XWartość która zostanie zapisane w indeksie podczas zapisywania dokumenty z treścią emailTablica wartości tekstowych Pole edytowalne 

 

 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

 

Zadania związane z komponentem

Aktualne

Archiwalne

 

 

 

 

 

Szczegółowy opis działania:

Zadania automatyczne służy do wysyłania maili z wcześniej przygotowanego szablonu, który musi znaleźć się na serwerze.  Szablon powinien mieć rozszerzenie HTML i może zawiera znaczniki HTML/CSS które są interpretowane przez popularne serwery pocztowe (GMAIL, WP itp) . Zadanie te ma duże możliwości konfiguracyjne

W parametrach "Do", "Kopia [opcjonalnie]"  oraz  "Ukryta kopia [opcjonalnie]" zamiast konkretnych adresów e-mail, można wykorzystać odpowiednie tagi, które pobiorą automatycznie adresy e-mail użytkowników systemu Plusworkflow. Np tag "ROLE_<Identyfikator roli>" pobierze wszystkie e-maile użytkowników którzy mają rolę o identyfikatorze podanym jako parametr <Identyfikator roli>. Lista dostępnych tagów i opis znajduję się w tabelce 1 poniżej. 

W parametrze "Temat" oraz w pliku szablonu można stosować tagi oznaczone z przodu jak i z tyłu znakiem "@". np znacznik @processname@ spowoduje, że każde wystąpienie tego znacznika  zostanie podmienione na nazwę procesu który był wykonywany. Ponadto parametry "Nazwa zmiennej [opcjonalnie]" oraz  "Wartość zmiennej [opcjonalnie]" pozwalają na definiowanie własnych tagów i przypisanie do nich zmiennych z procesu. Parametry te muszą mieć te samą długość, jest to przypisanie 1:1. Np gdy w szablonie pojawi się tag @moja_zmienna_z_procesu@ to w parametrze "Nazwa zmiennej [opcjonalnie]" musi pojawić się wartość "moja_zmienna_z_procesu", a w parametrze "Wartość zmiennej [opcjonalnie]" zmienna z aktualnego procesu z której to wartość zostanie odczytana i wstawiona zamiast tego tagu. Tagi jakie można wykorzystać do automatycznego wstawiania danych w Temacie oraz Treści maila zawiera tabela 2 poniżej.

 W parametrach "Informacja zwrotna - Udane wysłanie [opcjonalnie]" oraz "Informacja zwrotna - Nie udane wysłanie [opcjonalnie]" pozwala w zmiennej z procesu zapisać informacje na jakie adresy e-mail udało się wysłać maile a dla jakich nie.

Parametr "Czy włączyć komentarz" spowoduje, że na zakończenie zadania automatycznego będzie dodane dwa komentarze informujące na które adresy e-mail udało się wysłać mail a na które nie.




 Tabela 2. Tagi używane w szablonie i temacie maila

TAGOPIS
@processname@

Nazwa procesu

@processdescription@

Opis procesu

@processdefid@Identyfikator definicji procesu
@processpackageid@Identyfikator pakietu z którego pochodzi proces.

@processtype@

Typ procesu

@processstarttime@

Godzina uruchomienia procesu

@processstartday@

Data uruchomienia procesu

@processscreatedtime@Godzina utworzenia procesu
@processcreatedteday@Data utworzenia procesu

@activityname@

Nazwa zadania

@activitydescription@Opis zadania
@activitydefid@Identyfikator definicji zadania
@activityid@Identyfikator zadania

@activitystarttime@

Godzina uruchomienia zadania

@activitystartday@

Data uruchomienia zadania

@activitycreatedtime@Godzina utworzenia zadania
@activitycreatedday@Data utworzenia zadania
@userfullname@Pełna nazwa użytkownika który wykonuje to zadanie
@userfirstname@Imie użytkownika który wykonuje to zadanie
@userlastname@Nazwisko użytkownika który wykonuje to zadanie
@useremail@Adres e-mail użytkownika który wykonuje to zadanie
@username@Login użytkownika który wykonuje to zadanie
@usernumber@Numer użytkownika w systemie który wykonuje to zadanie
@<id_zmiennej>@Wartość zmiennej procesu o podanym identyfikatorze (<id_zmiennej>)

@historylink@

Link do historii procesu

@link#<activityDefId>@

Link do szczegółów zadania o podanym id definicji zadania,

np. link#akceptacja_wniosku

@taskuser#<activityDefId>@

Pełna nazwa użytkownika, który wykonał zadanie o podanym id definicji zadania,

np. taskuser#akceptacja_wniosku

@realusername#<zmienna_procesu>@

Pełna nazwa użytkownika, którego identyfikator znajduje się w podanej zmiennej procesowej,

np. realusername#zmienna


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