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 | ||
| Nazwa szablonu * | 1.0.7 | Nazwa szablonu z konfiguracji procesu | Tekst | Pole edytowalne | ||
| 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_1. | |
| 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. 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.X | Zapisuje jako nowa wersja dokumentu gdy wartości indeksów sie zgadzają z dokumentem już w archiwum | Logiczny | NIE | ||
| 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
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
Pakiet z przykładowym formularzem wykorzystującym aplikację
The license could not be verified: License Certificate has expired!
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
| TAG | OPIS |
| @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
| 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
