View Source

Jeśli masz problem ze zrozumieniem jak działa setter/zadanie automatyczne, sprawdź opisy: Setter, Zadanie automatyczne, Wykonanie warunkowe, Parametry 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 parametru	Od wersji	Opis	Typ parametru	Wartość domyślna	Rodzaj pola	Uwagi i ograniczenia
Skrzynka pocztowa *	1.0.49	Skrzynka pocztowa zdefiniowana w konfiguracji systemu.	Tekst		Lista rozwijana
Ź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żyć jeden szablon na kilku procesach i mapować tag których nie ma w aktualnym procesie.
Wartość zmiennej	1.0.5	Parametr opcjonalny. Wartość która ma zostać wstawiona w miejsce nazwy zmiennej 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 sie 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
Źródło *	1.0.33	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.33	Id pliku potrzebne do wybrania plików, które chcemy wysłać w załącznikach	Tablica wartości tekstowych		Lista wartości
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.
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.	Tablica wartości tekstowych		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/
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 prefiks "faktura-" to w email przyjdzie załącznik o nazwie "faktura-fakt0001.pdf" . Można zostawić pustą nazwę, to dokument doda się bez prefiksu,
Zapisz email *	1.0.11	Zapisuje wysłaną wiadomość jako nowy dokument html	Logiczny	NIE		Opcja możliwa 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ć emalia	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łowka 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

Dostępne Wtyczki i Moduły (Uniwersalne komponenty PWE Home) > Zaawansowane wysłanie E-mail (z szablonem HTML) > advanced_mail_pl.png

Ustawienia zadania automatycznego

Dostępne Wtyczki i Moduły (Uniwersalne komponenty PWE Home) > Zaawansowane wysłanie E-mail (z szablonem HTML) > AutotaskSendAdvanceEMailExample.png

Ustawienia szablonu

szablon.html

<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

Dostępne Wtyczki i Moduły (Uniwersalne komponenty PWE Home) > Zaawansowane wysłanie E-mail (z szablonem HTML) > FormSendAdvanceEmailExampleINPUT.png

Otrzymany E-mail

Dostępne Wtyczki i Moduły (Uniwersalne komponenty PWE Home) > Zaawansowane wysłanie E-mail (z szablonem HTML) > EmailSendAdvanceEmailExampleOUTPUT1.png

Dostępne Wtyczki i Moduły (Uniwersalne komponenty PWE Home) > Zaawansowane wysłanie E-mail (z szablonem HTML) > EmailSendAdvanceEmailExampleOUTPUT2.png

Informacja zwrotna na Formularzu

Dostępne Wtyczki i Moduły (Uniwersalne komponenty PWE Home) > Zaawansowane wysłanie E-mail (z szablonem HTML) > FormSendAdvanceEmailExampleOUTPUT.png

1.0.5

Dodanie komponentu

1.0.7

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

1.0.11

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

1.0.14

Błąd przy budowaniu adresów email gdy pusta wartość parametru.

1.0.16 (obowiązująca dokumentacja)

Wysyłanie zaszyfrowanego załącznika (deszyfracja podczas wysyłania)
Wysłanie E-mail poprawa logów o Niepowodzenie i Powodzeniu wysłania

1.0.49

Dodano nowy parametr "Skrzynka pocztowa"

1.0.62

Dodanie obsługi tagów @@rows@@ oraz @@end_rows@@ w szablonie

If you have trouble understanding how the action works, check the descriptions: Application, Setter , Conditional execution , Component parameters

Category: Email

Available from version: 1.0.5

The task sends e-mails according to a predefined template (specified via the path to a file on the server or the name of the template in the process configuration). It has predefined tags, e.g. searching for e-mails on the basis of a role identifier or automatically inserting values into the template between the "@" and "@" tags. The application has the possibility to attach a document from the process as an attachment in an email. The configuration of the mail server can be found in the system configuration section (Mailbox configuration). As of version 1.0.11, it is possible to save the content of a sent e-mail as a document in the PlusWorkflow system.

Parameter name	From version	Description	Parameter type	Default value	Field type	Notes and restrictions
Mailbox *	1.0.49	Mailbox defined in the system configuration	Text		Value list
Template source *	1.0.7	Storage location of the email template to be sent	Text		Value list
Template path *	1.0.7	Provide a direct path to the file on the server	Text		Editable field	Html template, which can contain special tags to be replaced with the corresponding values. See table Tab_2.
Template name *	1.0.7	Name of the template from the process configuration	Text		Editable field	Html template, which can contain special tags to be replaced with the corresponding values. See table Tab_2.
Subject *	1.0.5	Email subject	Text		Editable field	May include template tags - possible use of "@" tags e.g. "@processname@" See table Tab_2.
To	1.0.5	List of e-mail addresses to send the message to	Text array		Editable field	Supports multiple emails given after "," or ";". Possibility to use email tags. See table Tab_1.
Copy	1.0.5	Optional parameter. List of addresses to send a copy of the email	Text array		Editable field	Supports multiple emails given after "," or ";". Possibility to use email tags. See table Tab_1.
Hidden copy	1.0.5	Optional parameter. List of addresses to send a blind copy of the email	Text array		Editable field	Supports multiple emails given after "," or ";". Possibility to use email tags. See table Tab_1.
The name of the variable	1.0.5	Optional parameter. The name of a variable in the template between the @ and @ characters.	Text array		Value list	Parameter useful when you want to use one template on several processes and map tags that are not present in the current process.
The value of the variable	1.0.5	Optional parameter. The value to be inserted in place of the variable name in the template	Text array		Editable field
One message to everyone *	1.0.5	Sends one email to several addressees. If NO, each addressee is treated separately and gets a separate email.	Logical	YES
Feedback - Successful sending	1.0.5	Optional parameter. Returns a list of email addresses that have been successfully sent	Variable		Editable field
Feedback - Failed sending	1.0.5	Optional parameter. Returns a list of "To" email addresses that have not been successfully sent	Variable		Editable field
Comment *	1.0.5	Adds commentary on sent and unsent emails for recipients on the "To" list	Logical	YES
Attachments *	1.0.7	Adds process documents to emails as attachments	Logical	NO
Source *	1.0.33	Selection of the method by which documents to be sent in attachments are to be found. Possible values: Document class File ids	Text		Editable field
File ids *	1.0.33	Parameter needed to select the files you want to send in attachments	Text array		Value list
Document class	1.0.7	Optional parameter. When the value is empty, it adds all documents from the process to the mail (if this option is enabled), otherwise it adds only documents from the selected document classes	Text array		Value list	The order of document classes matters when adding attachments. That is, documents from class1 are added first then from class2 etc.
Filter by document name	1.0.28	A regular expression that filters documents from a selected class for sending in an e-mail attachment	Text array		Editable field	A blank field will result in the retrieval of all documents from the selected class. Examples: file name: IMG5822996601453555121.pdf regular expressions that will find this file: ^IMG5.$ .pdf$ Link to a site where you can test regex online: https://regex101.com/
Prefix	1.0.11	Prefixes added to the name of the uploaded file from the selected document classes.	Text array		Editable field	E.g. When the document has the name "fact0001.pdf", and the prefix parameter has been set to the value "invoice-", the attachment named "invoice-fact0001.pdf" will come in the email. If the parameter is not set, the document will be added without the prefix,
Save email *	1.0.11	Saves the sent message as a new html document	Logical	NO		This option allows you to save the generated email content as an html document added to the archive.
Document name *	1.0.11	Name of the new document	Text		Editable field	File name. You can specify it without extension, in which case it will add ".html" by default.
Document description	1.0.11	Document description. If it is empty, then the class name will be written in the description	Text		Editable field	The name of the html document created with the email content.
Document class *	1.0.11	The name of the class to which to write the email	Text		Value list	List of document class selections from the current system.
Attach to the process *	1.0.11	Attaches a new document to an existing process	Logical	YES
Email header *	1.0.11	Adds an email header to the body of the message	Logical	NO		Adds an optional default header to the document with information From Whom, To Whom, the subject of the message and a list of attachments. See email header template
Email header template	1.0.11	Path to custom HTML template containing email header tags	Text		Editable field	Path to custom html template with email information. Possibility to use special tags See table Tab_3. For blank value the default template provided with the plugin is used See Default email header template
Save as new version of the document *	1.0.11	Saves as new version of document when index values match with document already in archive	Logical	NO
Index name	1.0.11	The name of the index from the class to which we are saving the email content	Text array		Value list	Selection list after selecting the class of document to be saved.
Index value	1.0.11	The value that will be stored in the index when saving the email content documents	Text array		Editable field

Dostępne Wtyczki i Moduły (Uniwersalne komponenty PWE Home) > Zaawansowane wysłanie E-mail (z szablonem HTML) > advanced_mail_en.png