Components > Communication

With this component it is possible to send and receive e-mails. The component is unvisible. The component sends and receives emails through local mail servers or Internet mail servers. The required user names and passwords for the used e-mail inbox are entered in the properties of the e-mailer. The dispatch of any file attachments, as well as e.g. Snapshots of the camera archive are also possible.

The SMTP connection must be possible.

Data points of the component

Name	Type	Function
Active	Bidirectional	Enables or disables the e-mailer.
To address	Input	Destination address of the e-mail. If there are multiple addresses, they are separated by ; and spaces.
Attachment	Input	The complete path and file name of the attachment to be sent must be entered here as text.
Check for new e-mail	Input	Checks for new e-mails.
BCC address	Input	BCC address(es) to which the e-mail is sent.
Subject	Input	Subject of the e-mail
CC address	Input	CC address(es) to which the e-mail is sent.
Diagnosis [Text]	Output	Error messages are output here. Attention: Diagnostic or debug outputs are only intended for use in the event of an error. Please use only after consultation with the support team! If used, these can considerably impair the performance of the service.
E-mail file attachments [Text]	Output	Outputs the file name of the file attachments as text. The file attachments are saved in the project folder on the server.
E-mail Content [Text]	Outbox	The content of the received e-mail is output here as text.
Extended Diagnosis	Input	All debug events are output at the output "Diagnosis [Text]". Attention: Diagnostic or debug outputs are only intended for use in the event of an error. Please use only after consultation with the support team! If used, these can significantly affect the performance of the service.
Pop3 Retrieval - Current Message	Output	Output of the current message being processed.
Pop3 Retrieval - Number of messages in mailbox	Output	Total number of messages in the mailbox
Pop3 Retrieval - Progress	Outbox	Shows the processing progress from 0-100%.
Pop3 Retrieval - In Progress	Output	On signal = in progress; Off signal = finished
Pop3 Account User	Input	Pop3 account username
Pop3 account password	Input	Password for the Pop3 account
Signature	Input	Signature of the e-mail
SMTP account user	Input	Here you can change the user name for the outgoing mail server.
SMTP Account Password	Input	Allows you to change the password for the outgoing mail server.
Text	Input	Text of the e-mail
Trigger	Input	The channel is triggered via any command. This can be set in the properties. Any event: Any input signal at the trigger input sends the e-mail. On or Off: A True or False at the trigger input triggers the e-mail.
Value	Input	Value for the predefined text with a placeholder formatted with {{ }}.

"Trigger" sends the e-mail with the defined text. Values at the data point "Value" can be adopted in the e-mail text if the placeholder is formatted with {{ }} in the text. Example: {{#0.0°C}}

Properties of the component

Name	Standard	Function
Filter Tokens		Filters the e-mails with a certain subject text. The e-mail content and file attachment are only output for these e-mails! For filtering, the "Mail content output format" must be set to "Plain text".
Add path to attachments		Output of the storage path of the attachment at the data point "E-mail file attachments [Text]".
Account Settings	...	Settings such as user name and password. See picture below
Send Timeout [s]	100	If sending is unsuccessful, it will continue to be attempted for the set time.
Send Trigger Selection	Send on or off	Determines at which input signal the e-mail is sent. Send directly: E-mail is sent when the text or attachment changes. Send on: E-mail is sent with an ON edge. Send on Off: E-mail is sent with an OFF edge. Send on or Off: E-mail is sent with an ON or OFF edge.
Mail content output format	Plain text	Switch option from plain text to XML. If Filter Token is used, "Plain Text" must be set here.
Standard To Addresses		Here you can enter a default address that should always be used if no other entries have been made. If there are several addresses, they are separated by ; and spaces.
Standard CC addresses		A standard can be entered here that should always be used if no other entries have been made. If there are several addresses, they are separated by ; and spaces.
Standard BCC addresses		Here you can enter a standard that should always be used if no other entries have been made. If there are several addresses, they are separated by ; and spaces.
Standard Subject		Here you can enter a standard that should always be used if no other entries have been made.
Standard Text		A default text can be entered here that should always be used if no other entries have been made.
Standard Signature		Here you can enter a standard that should always be used if no other entries have been made.
Standard Attachments		A standard can be entered here that should always be used if no other entries have been made.
Delete attachment after sending		If this option is set, the file sent as an attachment is deleted. ATTENTION: The attachment will also be irrevocably deleted if the sending of the e-mail fails!
Filter Token [Subject]		Filters the e-mails with a certain subject text. The e-mail content and file attachment are only output for this e-mail! For filtering, the "Mail Content Output Format" must be set to "Plain Text".
Encoding	System Default	Setting option for the character set to be used: UTF8, UTF7, UTF32, Unicode (UTF16), System Default (e.g. ISO-8859-1), Unicode big endian (UTF16BE) and ASCII.
Active		Switches the e-mailer On/Off

Logging in to the Google Account where 2-factor authentication is active:

1.Sign in to the Google Portal

2.Select the "Security" function and there, under "To sign in to Google" --> "Two-step confirmation".

3.Select app passwords and generate a password (app = email; device = Windows computer).

Account settings

General Settings:

A valid sender email address and name must always be entered.

Incoming:

Set the server address, port, SSL/TLS and login information as specified by the e-mail server.

Outgoing:

Set the server address, port, SSL/TLS and login information as specified by the e-mail server.

Option:

Retrieve only the latest: ticked = only the mails of the last x days are retrieved. At least 1 day should be set here.

Check for messages every (min.): If 0, there is no automatic query.

Sample templates:

Download link: Send emails - with emailer, camera archive, fault report manager

General information about sample templates (SCADAComp):

Download the desired SCADAComp file and unzip the ZIP file into an empty folder. In the EisBär editor ribbon, select the "Import components" option under "Project" and load the template. If a conversion is necessary because the EisBär version is newer, confirm the process with YES. To retain functionality, select the "Create new networks" option as the copy rule when pasting.

eMailer

eMailer