Cover
E-Mail Notification with WinCC Runtime Professional WinCC Professional V11 Application Description May 2012
Applications & Tools Answers for industry.
Siemens Industry Online Support This document is taken from Siemens Industry Online Support. The following link takes you directly to the download page of this document: http://support.automation.siemens.com/WW/view/en/58983189 Caution: The functions and solutions described in this entry are mainly limited to the realization of the automation task. In addition, please note that suitable security measures in compliance with the applicable Industrial Security standards must be taken, if your system is interconnected with other parts of the plant, the company’s network or the Internet. More information can be found under entry ID 50203404. http://support.automation.siemens.com/WW/view/en/50203404.
If you have any questions about this document, please contact us at the following e-mail address:
Copyright Siemens AG 2012 All rights reserved
mailto:
[email protected]
For further information on this topic, you may also actively use our Technical Forum in the Service & Support Portal. Share your questions, suggestions or problems and discuss them with our strong forum community: http://www.siemens.com/forum-applications
2
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
s
Task
1
Solution
2
Functional Mechanisms of this Application
3
Startup of the Application
4
Settings
5
Operating the Application
6
Literature
7
History
8
Copyright Siemens AG 2012 All rights reserved
E-Mails WinCC RT Professional
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
3
Warranty and Liability
Warranty and Liability Note
The application examples are not binding and do not claim to be complete regarding configuration, equipment and any eventuality. The application examples do not represent customer-specific solutions. They are only intended to provide support for typical applications. You are responsible for ensuring that the described products are used correctly. These application examples do not relieve you of your responsibility to use sound practices in application, installation, operation and maintenance. When using these application examples, you recognize that we will not be liable for any damage/claims beyond the liability clause described. We reserve the right to make changes to these application examples at any time and without prior notice. If there are any deviations between the recommendations provided in this application example and other Siemens publications – e.g. catalogs – the contents of the other documents have priority. We do not accept any liability for the information contained in this document.
Copyright Siemens AG 2012 All rights reserved
Any claims against us – based on whatever legal reason – resulting from the use of the examples, information, programs, engineering and performance data etc., described in this Application Example shall be excluded. Such an exclusion shall not apply in the case of mandatory liability, e.g. under the German Product Liability Act (“Produkthaftungsgesetz”), in case of intent, gross negligence, or injury of life, body or health, guarantee for the quality of a product, fraudulent concealment of a deficiency or breach of a condition which goes to the root of the contract (“wesentliche Vertragspflichten”). The damages for a breach of a substantial contractual obligation are, however, limited to the foreseeable damage, typical for the type of contract, except in the event of intent or gross negligence or injury to life, body or health. The above provisions do not imply a change in the burden of proof to your disadvantage. It is not permissible to transfer or copy these application examples or excerpts thereof without express authorization from Siemens Industry Sector.
4
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
Preface
Preface Objective of this application Compared to WinCC V11 Runtime Advanced V11, WinCC Runtime Professional V11 offers no standard function for sending emails. The aim of this application is to send emails automatically or manually from WinCC Runtime Professional V11.
Core topics of this application The following main points are discussed in this application: •
manual sending of an email via an interface.
•
automatic sending of an email for individual messages (bit message, analog message).
•
automatic sending of an email for messages of a message group.
Validity
Copyright Siemens AG 2012 All rights reserved 58983189_E-Mails_WinCC_Professional_RT_EN.doc
This application is valid for the WinCC Runtime Professional V11 product.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
5
Table of Contents
Table of Contents Warranty and Liability ................................................................................................. 4 Preface .......................................................................................................................... 5 Table of Contents......................................................................................................... 6 1
2
Copyright Siemens AG 2012 All rights reserved
3
4
5
6
6
Task..................................................................................................................... 8 1.1
Overview .............................................................................................. 8
1.2
Description of the automation task....................................................... 8
Solution............................................................................................................... 9 2.1
Overview of the general solution.......................................................... 9
2.2
Description of the core functionality ................................................... 10
2.3
Software components used................................................................ 11
2.4
Alternative solutions Event Notifier .................................................... 13
2.5
Alterative solutions VB Script ............................................................. 14
Functional Mechanisms of this Application ................................................. 15 3.1
General overview ............................................................................... 15
3.2 3.2.1 3.2.2 3.2.3 3.2.4
Detailed overview ............................................................................... 17 Email with individual recipient ............................................................ 17 Email with shift-dependent recipient .................................................. 18 Assigning the email address via shift management........................... 19 Initialization at start of Runtime .......................................................... 20
Startup of the Application............................................................................... 22 4.1
Preparation......................................................................................... 22
4.2
Commissioning the example project .................................................. 23
Settings............................................................................................................. 26 5.1 5.1.1 5.1.2
Setting of the SMTP server ................................................................ 26 Changing and saving data ................................................................. 27 Resetting changes.............................................................................. 27
5.2 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6
Setting and managing the recipient addresses.................................. 29 Loading addresses ............................................................................. 31 Creating new address ........................................................................ 31 Deleting address ................................................................................ 32 Setting shift email address ................................................................. 33 Setting shift times ............................................................................... 34 Saving and resetting of changes........................................................ 34
Operating the Application............................................................................... 36 6.1
Overview ............................................................................................ 36
6.2 6.2.1 6.2.2 6.2.3 6.2.4
Description of the operation ............................................................... 36 Scenario 1: Sending emails manually ................................................ 36 Scenario 2: sending email in the event of bit messages.................... 37 Scenario 3: Sending email by message group .................................. 39 Scenario 4: sending email for analog messages ............................... 40
7
Literature .......................................................................................................... 42
8
History............................................................................................................... 42
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
Copyright Siemens AG 2012 All rights reserved
Table of Contents
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
7
1 Task
1
Task
1.1
Overview
Introduction Since not all machines of a plant can be continuously monitored by the staff, pending messages from the SCADA system can often not be responded to quickly. An e-mail notification is to alleviate this problem. Overview of the automation task The figure below provides an overview of the automation task. Figure 1-1
Copyright Siemens AG 2012 All rights reserved
SCADA System
1.2
Description of the automation task If a message appears, an email is to be sent to the respectively responsible member of staff. Setting the email user account and maintaining the email recipient is to be possible while Runtime is running. The stored data is to be saved non-volatile and loaded when Runtime is started. The email recipient is to be set shift by shift. Additionally, it is to be possible to change the times of the shift when Runtime is running. For test purposes, the sending of emails is also to be possible with free email providers.
8
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
2 Solution
2
Solution
2.1
Overview of the general solution
Schematic layout The following figure gives a schematic overview of the most important components of the solution:
Copyright Siemens AG 2012 All rights reserved
Figure 2-1
Advantages The application on hand offers the following advantages: •
You are using a standardized means of communication via email notification. Messages can therefore be send to all email clients, e.g. also to smartphones.
•
You increase safety, since it can be quickly reacted to the event. Even also if the machine operator is absent.
•
An email notification sends information directly to the executing department such as sales or workshop. The required activities can be implemented instantly since the necessary information is instantly available and does not need to be read on the SCADA system first.
•
You can change the email addresses directly on the SCADA system and save it reliably via the non-volatile management. This makes you flexible and protects you from data loss.
•
Through our tests of free email providers you save time-consuming tests and reach your goal faster.
•
With our extensive templates you reduce the configuration phase for email notifications to a minimum.
Topics not covered by this application This application does not contain any descriptions on the following issues: •
Installation of SIMATIC WinCC Professional.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
9
2 Solution
•
Installation of SIMATIC WinCC Runtime Professional.
•
Configuration and commissioning of SIMATIC WinCC Runtime Professional.
The following basic knowledge is assumed: Assumed knowledge Basic knowledge of the SIMATIC WinCC Professional software product is assumed.
2.2
Description of the core functionality
Overview and description of the user interface The figure below shows the configuration of the SMTP data and the setting and management of the recipient email addresses.
Copyright Siemens AG 2012 All rights reserved
Figure 2-2
What does the application example perform? In this application the following components are included:
10
•
A DLL file (Dynamic Link Library) to access the operating system resources. They are necessary to send emails.
•
Scripts to send emails in WinCC Runtime Professional.
•
Task planer for the initialization of the data (SMTP configuration, shifts).
•
Task planer for the shift change.
•
User interface for the configuration of the SMTP data.
•
A user interface for the management of recipient addresses and for the assignment of shift-specific addresses and the setting of shift times.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
2 Solution
Principle of the core functionality Figure 2-3
Manual
Occurrence of an individual message
Occurrence of an individual message belonging to a group
State of group changes Email addresses Early shift
Late shift
Active email address
Night shift
Copyright Siemens AG 2012 All rights reserved
Setting of active shift
Email
The application example shows the following application options: •
manual sending of an email via an interface.
•
automatic sending of an email for individual messages (bit message, analog message).
•
automatic sending of an email for messages of a message group.
The email recipient address that is automatically assigned depends on the active shift. Overview and description of the user interface In this example, the following operator screens were configured:
2.3
•
SMTP Configuration: This screen is used for the configuration of the SMTP server and for setting and managing the email recipient addresses.
•
Examples for sending emails: In this screen, the different application options for sending emails are explained.
Software components used The application document was generated using the following components:
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
11
2 Solution
Standard software components Table 2-1 Component
Qty.
MLFB / order number
SIMATIC WinCC Professional V11 SP2
1
6AV2103-0AA01-0AA7
SIMATIC WinCC Runtime Professional V11 SP2
1
6AV2105-0XX01-0DU8
Note
Internet access and email accounts This is only a selection of tested free email providers. If required, a company internal email service can also be used. Table 2-2 Provider
Supported email provider
web.de
Yes
Copyright Siemens AG 2012 All rights reserved
gmx.net yahoo.com yahoo.de freenet.de
SSL
No
Yes
No
Yes
No
SMTP smtp.web.de mail.gmx.net
smtp.mail.yahoo.com Yes
No smtp.mail.yahoo.de
Yes
No mx.freenet.de
googlemail.com
No
hotmail.de
No
No No
smtp.googlemail.com Smtp.live.com
Version 03/2012
Sample files and projects The following list includes all files and projects used in this example. Table 2-3 Component
12
Note
58983189_Emails_WinCC_Professional_RT.zip
This zipped file contains the WinCC Professional project and the DLL file.
58983189_Emails_WinCC_Professional_RT_en.pdf
This document.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
2 Solution
2.4
Alternative solutions Event Notifier For SIMATIC WinCC V7.0 SP2 Upd4 there is the Event Notifier V7.0 SP2. http://support.automation.siemens.com/WW/view/en/54064299 The SIMATIC WinCC/Event Notifier option offers a calendar-based user interface in the style of Microsoft Office for the simple and secure planning of notifications of selected persons in defined time windows. The option consists of a calendar control and editors with which notifications and contacts can be configured and managed as potential targets for notifications. Notifications are assigned to immediately selectable events in the WinCC message system at the time of configuration. Contacts can also be recruited at Runtime from the WinCC user administration.
Copyright Siemens AG 2012 All rights reserved
A communication service editor makes it possible to establish the communication service via email service at the time of configuration, i.e. the notification triggered at a certain event in the WinCC message system is generally sent via email. The email can be directed as text message (SMS) to your mobile phone via provider gateway if the respective contact has been set up accordingly and the person has enabled this service from his/her provider. If several people or groups of people are created in parallel for one and the same time window in the calendar control, various escalation times can be realized via the specification (= dead time before notification) of escalation steps.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
13
2 Solution
2.5
Alterative solutions VB Script A VB function was created as an alternative solution toANSI-C. This function also makes it possible to send emails.
Advantages •
No additional DLL file required.
•
Clear and simple configuration.
Disadvantage •
Cannot be used for messages.
The figure below shows the call of the “SendEmailVB” VB function.
Copyright Siemens AG 2012 All rights reserved
Figure 2-4
Table 2-4 Attribute
14
Note
From
In this field the email address of the sender is entered.
Recipient
In this field the email address of the recipient is entered.
BCC
In this field the email address is entered to which a copy is to be sent. This email address is not included in the header of the email.
CC
In this field the email address is entered to which a copy is to be sent.
Subject
In this field the subject of the email is specified.
Message
In this field the message of the email is specified.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
3 Functional Mechanisms of this Application
3
Functional Mechanisms of this Application
3.1
General overview
Figure 3-1 Runtime Start Loading shift data
Loading SMTP data
Runtime Configuration
Configuration Email addresses
SMTP Early shift
Late shift Email trigger
Night shift
Copyright Siemens AG 2012 All rights reserved
WinCC tag memory Windows file system
Use shift address
yes
Setting of active shift Active email address
no Save changes
yes
Save changes Email is sent to active email address
Sent email so set email address
Changes are written into the file
Status is written into log file
yes
Changes are written into the file
Explanation After the Runtime start, the configuration and shift data is loaded and written into the WinCC tag management (if data already exists). This data can be changed after the Runtime start and subsequently saved in the files. (see chapter: 5.1 Setting of the SMTP server and 5.2 Setting and managing the recipient addresses) If an email is to be sent, the following is distinguished: •
email with individual recipient The email address of the recipient is directly specified on the function.
•
email with individual recipient The email address of the recipient is directly specified on the function. The function uses the active email address that is assigned via shift management. When calling this function an email with the entered subject and text is sent to the assigned email address.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
15
3 Functional Mechanisms of this Application
The following is necessary: Internet/intranet connection
•
Configured SMTP server
•
Entered mandatory parameters “address”, “subject” and “text”
The send status (the reply by the email server) is saved in a file, independent from the selected function. This functionality is to provide an overview of sent emails and simplifies diagnostics in the event of an error. This file is stored under the “Report.txt” name in the temp folder of the operating system.
Copyright Siemens AG 2012 All rights reserved
Note
•
16
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
3 Functional Mechanisms of this Application
3.2
Detailed overview
3.2.1
Email with individual recipient
Email trigger
yes Active email address
Use shift address
no
Copyright Siemens AG 2012 All rights reserved
Email is sent to set email address
Email is sent to active email address
Status is written into log file
Explanation The “SendEmailIndividual” function is provided for the sending of emails with individual recipients. This function sends an email to the email address transmitted in the call. The function call looks as follows: Figure 3-2
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
17
3 Functional Mechanisms of this Application
Table 3-1 Parameter
Note Here the email address of the recipient is specified
Address Subject
Here the subject of the email is specified.
Message
Here the message of the email is entered.
These parameters are transmitted as string and have to be separated from each other with the “_” character. e.g.
[email protected]_Test email_This is a test email
This function is executed irrespective of the shift management.
Note
3.2.2
Email with shift-dependent recipient
Copyright Siemens AG 2012 All rights reserved
Figure 3-3
Email trigger
yes Active email address
Use shift address
no
Email is sent to set email address
Email is sent to active email address
Status is written into a log file
Explanation The “SendEmailShift” function is provided for the sending of emails with shiftdependent recipients. This function sends an email to the email address of the active shift. This is why no email address must be transmitted. This email address is automatically assigned the “Shift_Change” task.
18
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
3 Functional Mechanisms of this Application
The function call looks as follows: Figure 3-4
Table 3-2
Copyright Siemens AG 2012 All rights reserved
Parameter
Note
Subject
Here the subject of the email is specified.
Message
Here the message of the email is entered.
These parameters are transmitted as string and have to be separated from each other with the “_” character. e.g.
[email protected]_Test email_This is a test email
3.2.3
Assigning the email address via shift management
Configuration Email addresses
Early shift
Late shift
Night shift
Setting of active shift Active email address
Explanation The automatic assignment of the active email address was realized via the “Shift_Change” task in the task planner.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
19
3 Functional Mechanisms of this Application
Structure of the task: •
Cyclic reading of the current system time.
•
Comparison of the readout system time with the set shift times.
•
The email address with the respective shift is assigned as active email address.
The setting of the shift times and addresses is performed via the “Recipient List” faceplate (see chapter: 5.2 Setting and managing the recipient addresses)
3.2.4
Initialization at start of Runtime Figure 3-5
Runtime Start Loading of SMTP data
Loading of shift data Runtime
Configuration
Configuration
Copyright Siemens AG 2012 All rights reserved
Email addresses SMTP Early shift Late shift Night shift WinCC tag memory Setting of active shift Active email address
Explanation When starting Runtime the configuration and shift dates are loaded in the WinCC tag management. This is performed via the “Initialization” task in the task planner. At the start of Runtime, the “Start_initialisation” tag is set in the start screen which triggers the task. Structure of the task: •
Reads SMTP data from the “SMTP_config.txt” file and writes it into the WinCC tag management.
•
Reads shift settings from the “Email_shifts.txt” file and writes it into the WinCC tag management.
The following data is loaded:
20
•
SMTP server name
•
Name of the sender (can be selected as desired)
•
Email address of the sender
•
Login name
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
3 Functional Mechanisms of this Application
•
Password
•
Set shift addresses
•
Set shift times
Prerequisites: Files have been created
•
File path has been specified or adjusted (Variable: “Storage_path”)
Copyright Siemens AG 2012 All rights reserved
•
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
21
4 Startup of the Application
4
Startup of the Application
4.1
Preparation
Requirements Install SIMATIC WinCC Professional V11.0 SP2. Make sure that there is a connection to the internet/intranet. General information The storage place of the “Email.dll” DLL file included has to be adjusted to the target computer path. The DLL file is located in the project folder of the sample project in the “UserFiles” subfolder. The path has to be adjusted at the following location in the scripts.
Copyright Siemens AG 2012 All rights reserved
Figure 4-1
The start value of the internal “storage path” tag has to be adjusted. The tag defines the storage path of the configuration files. Figure 4-2
22
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
4 Startup of the Application
4.2
Commissioning the example project
Copyright Siemens AG 2012 All rights reserved
Table 4-1 No.
Action
1
Unzip the “58983189_Emails_WinCC_Professio nal_RT.zip” file. The file contains the demo project and the “Email.dll” in the “UserFiles” folder.
2
Start the sample project by double clicking the “58983189_Emails_WinCC_Professio nal_RT.ap11” file.
3
Open the “Runtime settings” of Runtime Professional.
4
Select “Services”.
5
Enable the “Scheduled tasks in runtime” service if not already done.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
Remarks
23
4 Startup of the Application
Copyright Siemens AG 2012 All rights reserved
No.
24
Action
6
Open the “Scripts C Scripts” folder of Runtime Professional.
7
Open the “SendEmailIndividual” script and adjust the path of the DLL file.
8
Repeat step 7 for the “SendEmailShift” script.
9
Open the “HMI tags Email Setting tags” folder of Runtime Professional.
Remarks
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
4 Startup of the Application
No.
Remarks
Select the “storage path” tag and adjust the storage path under Properties Properties Values Start value as desired.
Copyright Siemens AG 2012 All rights reserved
10
Action
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
25
5 Settings
5
Settings For the sending of emails various settings have to be made that are not provided by default from WinCC Professional. Special faceplates have been created for this purpose with which you can conveniently make these settings. These settings can furthermore be adjusted while Runtime is running.
5.1
Setting of the SMTP server The “SMTP server” (Simple Mail Transfer Protocol) or also email server is a server with which emails can be sent. For the receipt of an email “POP3 servers” or “IMAP servers” are used. For the setting of the data, the following faceplate with the name “SMTP Settings” was created:
Copyright Siemens AG 2012 All rights reserved
Figure 5-1
Table 5-1 Attribute
26
Note
Server name
In this field, the address of the email server is entered.
Sender name
In this field the displayed sender name is entered. This name can be selected freely, e.g. “Hall1” etc.
Email address
In this field the email address of the sender is entered.
Login
In this field the login name is entered (this often corresponds with the email address).
Password
In this field the password for the authentication is entered.
Reload
By clicking this button all changes are reset to the last memory state.
Save password
Via this checkbox it is specified whether the password is saved.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
5 Settings
NOTICE
5.1.1
All configuration data is saved unencrypted.
Changing and saving data This is how you change the saved SMTP configuration. Table 5-2 Action
Remarks
Copyright Siemens AG 2012 All rights reserved
Make the desired changes.
Click the “Save” button to permanently save the changes. You can specify whether the password is to be saved via the "Save password" checkbox.
Save
5.1.2
By clicking this button all changes are saved. Notice: The previous data is irrevocably lost.
Resetting changes This is how you reload the saved SMTP configuration.
Note
This is only possible as long as it has not been saved.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
27
5 Settings
Table 5-3 Action
Remarks
Copyright Siemens AG 2012 All rights reserved
Press the “Reload” button.
28
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
5 Settings
5.2
Setting and managing the recipient addresses There are two options for setting the email address of the recipient. The function of an individual address can be either specified directly or a shift-dependent email address can be used. •
Individual address
This address is directly specified when calling the function and can be selected as desired. This address cannot be changed during runtime. •
Shift-dependent address
For this purpose the “Recipient List” faceplate was created especially. This block makes it possible to conveniently and easily set and manage your recipient email addresses. Interface of the faceplate:
Copyright Siemens AG 2012 All rights reserved
Figure 5-2
Table 5-4 Attribute
Note
Recipient list
The desired email address can be selected in this field after loading it.
Load
By clicking this button all saved emails are loaded and displayed in the recipient list.
Add
By clicking this button an input window opens in which the new email address can be entered.
Delete
By clicking this button the selected email address can be deleted from the database.
Early, late and night shift
The currently set email addresses are displayed in these fields.
Select
By clicking this button, the email address selected in the recipient list is accepted as the current shift address.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
29
5 Settings
Attribute Times
In these fields the currently set shift times can be seen. They can be adjusted by clicking the desired field.
Reset
By clicking this button all changes on the shift settings are reset to the last memory state.
Save
By clicking this button all changes are saved in a file. Notice: The previous data is irrevocably deleted.
After a change of screen, a change of language or a change in the recipient addresses (add, delete), the recipient list has to be reloaded.
Copyright Siemens AG 2012 All rights reserved
Note
Note
30
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
5 Settings
5.2.1
Loading addresses Table 5-5 Action
Remarks
Select the “Load” button.
Copyright Siemens AG 2012 All rights reserved
5.2.2
Creating new address Table 5-6 Action
Remarks
Click the “Add” button.
Enter the new email address.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
31
5 Settings
Action
Remarks
Save the new address by clicking the “OK” button.
5.2.3
Deleting address Table 5-7 Action
Remarks
Copyright Siemens AG 2012 All rights reserved
Load the email addresses and select the email address you want to delete.
Click the “Delete” button.
32
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
5 Settings
Action
Remarks
Confirm the deleting of the address with the “Yes” button.
5.2.4
Setting shift email address Table 5-8
Copyright Siemens AG 2012 All rights reserved
Action
Remarks
Load the email addresses and select the new email address you want to delete.
Click the “Select” button of the shift to be changed.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
33
5 Settings
5.2.5
Setting shift times Table 5-9 Action
Remarks
Select the times to be changed and enter the new time.
Copyright Siemens AG 2012 All rights reserved
5.2.6
Saving and resetting of changes
Saving Table 5-10 Action
Remarks
Click the “Save” button.
34
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
5 Settings
Resetting Table 5-11 Action
Remarks
Copyright Siemens AG 2012 All rights reserved
Click the "Reset” button.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
35
6 Operating the Application
6
Operating the Application
6.1
Overview The sample project contains two operating screens. •
Configuration of the SMTP data and setting the shift addresses/times.
•
Example for triggering emails.
6.2
Description of the operation
6.2.1
Scenario 1: Sending emails manually
Description In the sample project buttons have been configured that send emails in the “click” event. The email is sent via the “SendEmailindividual” function. Instruction Copyright Siemens AG 2012 All rights reserved
Table 6-1 No.
36
Action
1
Go to “001_Thema > 001_2_Email_Trigger_Example” screens in the configuration and select the “Manual C Script” button.
2
Replace the “Address” parameter of the “SendEmailIndividual” function under “Properties > Properties > Click” with your recipient address.
3
Select the “Manual VB Script” button and replace the “Recipient” parameter of the “SendEmailVB” function by your recipient address under “Properties > Properties > Click”.
Remarks
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
6 Operating the Application
Copyright Siemens AG 2012 All rights reserved
No.
Action
3
Start Runtime.
4
Click the “Example” button.
5
Click the “Example for sending emails” button.
6
Click the “Manual C Script” or the “Manual VB Script” button to send an email to the set email address.
Remarks
Requirement: SMTP configuration was performed as described in chapter 5.1 Setting of the SMTP server. 7
6.2.2
If all settings have been carried out properly, an email has now been sent.
Scenario 2: sending email in the event of bit messages
Description In the example project, a button was configured that inverts a tag in the “click” event. If a tag has a rising edge, a bit message is triggered. As soon as this message is triggered, an email is sent to the active email address via the “SendEmailShift” function.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
37
6 Operating the Application
Instruction Table 6-2
Copyright Siemens AG 2012 All rights reserved
No.
38
Action
1
Start Runtime.
2
Click the “Example” button.
3
Click the “Example for sending emails” button.
4
Click the “Single alarm” message. This creates a bit message that sends an email to the active email address as coming event.
5
If all settings have been carried out properly, an email has now been sent.
Remarks
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
6 Operating the Application
6.2.3
Scenario 3: Sending email by message group
Description In the example project, a button was configured that inverts a tag in the “click” event. If a tag shows a change in value, a bit message is triggered. As soon as the message is triggered, the status of a message group is changed. This in turn causes the execution of the “Email_Alarm_Group” task. This task sends an email to the active shift via the “SendEmailShift” function. Instruction Table 6-3
Copyright Siemens AG 2012 All rights reserved
No.
Action
1
Start Runtime.
2
Click the “Example” button.
3
Click the “Example for sending emails” button.
4
Click the „Group alarm” message. This creates a bit message that is a member of a member group.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
Remarks
39
6 Operating the Application
No.
6.2.4
Action
5
Triggering the bit message causes a status change of the message group. This status is monitored via the “Email_Alarm_Group” task that sends an email to the active email address if there is a change in value.
5
If all settings have been carried out properly, an email has now been sent.
Remarks
Scenario 4: sending email for analog messages
Description
Copyright Siemens AG 2012 All rights reserved
A slide control was configured in the example project via which the value of an integer tag can be changed. If the tag exceeds the set limit value, an analog message is triggered. This analog message triggers the “SendEmailShift” function for a coming event, which in turn sends an email to the active email address. Instruction Table 6-4 No.
40
Action
1
Start Runtime.
2
Click the “Example” button.
3
Click the “Example for sending emails” button.
Remarks
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
6 Operating the Application
Action
4
Select the “Analog alarm” slide control and change the value of the tag. If the limit value (50) is exceeded an analog alarm is triggered that sends an email to the active email address.
5
If all settings have been carried out properly, an email has now been sent.
Remarks
Copyright Siemens AG 2012 All rights reserved
No.
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189
41
7 Literature
7
Literature
Internet Links The following list is by no means complete and only provides a selection of appropriate sources. Table 7-1
Copyright Siemens AG 2012 All rights reserved
Topic
8
Title
\1\
Reference to this document
http://support.automation.siemens.com/WW/view/en/58983189
\2\
Siemens Industry Online Support
http://support.automation.siemens.com
\3\
WinCC Professional V11.0 SP2 manual
http://support.automation.siemens.com/WW/view/en/57341024
History Table 8-1 Version V1.0
42
Date 04/2012
Revisions First edition
E-Mails WinCC RT Professional V1.0, Entry ID: 58983189