The application example implements a visualization with the Logic Builder within the EcoStruxure Machine Expert software for monitoring and control purposes.
This section provides a brief description of each function. In addition, refer to the visualization screen.
Before you can communicate with the email server, you need to configure the communication settings and the credentials for authentication. In the visualization screen Settings, you can modify the required configuration parameter.
In case of TLS encryption accepting only trusted certificates the server certificate has to be known and rated as trusted. For more information about certificate management on the controller, refer to How to Manage Certificates on the Controller - User Guide.
In addition, some significant application parameter can be configured from the visualization screen too. These include:
oDefault email addresses for the recipients of emails generated on dedicated events
oWhitelist for filtering the mails to be downloaded from the server
oDirectory for saving downloaded email attachments
Sending an email from the controller can be done from the visualization screen Send email. Enter one or more recipients, the subject, and the content of the email, the file path for the attachment, the priority and then click the button Send email.
The status of the function block FB_SendEmail is displayed in the lower area of the visualization screen, where you can monitor the status of the sending request.
Further you have the possibility to trigger events which causes an automatic creation and sending of emails. Clicking the respective button, the email is generated and sent to the configured recipient.
Reception of emails can be controlled from the visualization screen Receive email. The reception is managed by the FB_Pop3EmailClient and provides three control commands which can be triggered by the respective buttons from the visualization.
Command |
Function |
---|---|
CheckInbox |
Requests the function block to connect to the server and to check for new unread emails. If the execution of the function block is completed successfully, the number of downloadable emails on the server is displayed. |
Receive |
Requests the function block to download the specified number of emails. If the execution of the function block is completed successfully, the received emails are listed in the table on the visualization. |
Delete |
Requests the function block to delete emails from the server. The emails to be deleted are specified by a unique ID. The value of the ID for deletion is updated with the ID of the selected email in the table. If the execution of the function block is completed successfully, the number of deleted emails is displayed. |
The status of the function block FB_Pop3EmailClient is displayed in the lower area of the visualization screen, where you can monitor the status of the requested command.
The table on the visualization lists the received emails. Emails with status = Ok have been downloaded to the controller and deleted from the server. Emails with a different status have been left on the server as new unread email. For the selected email in the list, the details are displayed in the associated fields in the visualization.
The application example implements a logic for auto processing.
The auto processing is executed in a chronological interval and controls the email client as follows:
oCheck whether new emails are in inbox
oDownloading new emails
oProcess the received emails, whereby emails are deleted or a response is created and sent
The auto processing can be activated from the visualization. The interval for executing the auto processing can be configured too. The control mask for the auto processing is displayed on each visualization screen.