Micro Application Example - Siemens AG of Contents Micro Automation Set 21 - SOAP Beitrags-ID...

Micro Application Example

Wireless Data Communication based on GPRS

Web Visualization Using WinCC flexible and SOAP

Table of Contents

Micro Automation Set 21 - SOAP Beitrags-ID 22537809

V1.0 25.02.2008 2/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Note The Micro Automation Sets are not binding and do not claim to be complete regarding their configuration, equipment and any eventuality. The Micro Automation Sets 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 correctly used. These Micro Automation Sets do not relieve you of the responsibility of safely and professionally using, installing, operating and servicing equipment. When using these Micro Automation Sets, you recognize that Siemens cannot be made liable for any damage/claims beyond the liability clause described. We reserve the right to make changes to these Micro Automation Sets at any time without prior notice. If there are any deviations between the recommendations provided in these Micro Automation Sets and other Siemens publications – e.g. Catalogs – the contents of the other documents have priority.

Warranty, Liability and Support We do not accept any liability for the information contained in this document.

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 Micro Automation Set 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”). However, claims arising from a breach of a condition which goes to the root of the contract shall be limited to the foreseeable damage which is intrinsic to the contract, unless caused by intent or gross negligence or based on mandatory liability for injury of life, body or health. The above provisions do not imply a change in the burden of proof to your detriment.

Copyright© 2008 Siemens A&D. It is not permissible to transfer or copy these Micro Automation Sets or excerpts of them without first having prior authorization from Siemens A&D in writing.

For questions about this document please use the following e-mail-address:

[email protected]

Table of Contents


V1.0 25.02.2008 3/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Foreword Micro Automation Sets are functional and tested automation configurations based on A&D standard products for easy, fast and inexpensive implementation of automation tasks for small-scale automation. Each of the available Micro Automatic Sets covers a frequently occurring subtask of a typical customer problem on the low-end performance level.

The sets help you to obtain answers with regard to required products and the question of how they function when combined.

However, depending on the system requirements, a variety of other components (e.g. other CPUs, power supplies, etc.) can be used to implement the functionality on which this set is based. Please refer to the respective SIEMENS A&D catalogs for these components. The Micro Automation Sets are also available by clicking the following link:

http://www.siemens.de/microset

http://www.siemens.de/microset

Table of Contents


V1.0 25.02.2008 4/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Table of Contents

Table of Contents ......................................................................................................... 4

1 Micro Automation Set 21 and SOAP ............................................................. 5 1.1 Requirements ................................................................................................... 5 1.2 Benefits............................................................................................................. 5

2 Function Principle .......................................................................................... 6 2.1 Services for Remote Operation and Visualization ............................................ 6 2.2 Web-based Remote Operation with SOAP....................................................... 7 2.2.1 Variable Declaration and Write/Read Function with SOAP .............................. 7 2.2.2 Cyclic Reading by Means of JavaScript ........................................................... 9 2.2.3 Using Form Fields in the HTML Document..................................................... 10

3 Configuring the Startup Software ............................................................... 11 3.1 Preliminary Remarks ...................................................................................... 11 3.2 Downloading the Startup Code....................................................................... 11 3.3 Configuring Components ................................................................................ 12 3.4 Configuring the Network Neighborhood.......................................................... 12 3.5 Starting WinCC flexible SOAP Project at Central Station ............................... 13 3.6 Configuring Web Server at Central Station..................................................... 13 3.7 Configuring the Internet Explorer at Client Station ......................................... 14 3.8 Configuring the Name Resolution at Client Station ........................................ 15 3.9 Installing SOAP Toolkit 2.0 to Client Station................................................... 15

4 Live Demo...................................................................................................... 16 4.1 SOAP Web Interface “Simple” ........................................................................ 16 4.2 SOAP Web Interface “MAS21” ....................................................................... 17

Micro Automation Set 21 and SOAP


1 Micro Automation Set 21 and SOAP

1.1 Requirements

This description requires that you have read and understood the basic document on Micro Automation Set 21 “Set21_DocTech_vXdY_en.pdf”.

NOTE

In addition to the SIMATIC MicroBox PC “Central Station“ you will need a client PC with the following software components: Table 1-1

No. Description Type/Version

1. Operating system Windows XP Professional with Service Pack 2

2. SOAP Toolkit Microsoft SOAP Toolkit V2.0 SP2 3. Internet browser

V1.0 25.02.2008 5/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Microsoft Internet Explorer 4. WinCC flexible Sm@rtAccess No separate software; license

1.2 Benefits

Micro Automation Set 21 demonstrates the options of local operation and control on the part of the Central Station based on the incoming and outgoing process data via GPRS.

This additional document describes how to provide remote clients with the actual values that are available at the Central Station.

There, only standard software components from WinCC flexible and Microsoft Windows XP Professional are used. Figure 1-1

Mic

ro A

utom

atio

n Se

t 21

Basic Document Additional Document "SOAP"

Remote Station 1 Remote Station n Central Station

SINAUT MICRO SCWinCC flexible

Client Station

INTERNET

S7-200MD 720-3

S QC

S

S7-200MD 720-3

S

S QC

GPR

S

GPRS

Function Principle


2 Function Principle

2.1 Services for Remote Operation and Visualization

Sm@rtService and Sm@rtAccess To operate the control room configured in WinCC flexible from a remote place, WinCC flexible provides the services “Sm@rtService” and “Sm@rtAccess”.

Sm@rtAccess and Sm@rtService are the two options of WinCC flexible allowing you to establish communication between and with HMI systems via TCP/IP connections (e.g. LAN).

Therefore, Micro Automation Set 21 enables the operation of the WinCC flexible control room “Central Station” via the Internet or a local network. Figure 2-1

V1.0 25.02.2008 6/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Sm@rtService

Remote control via InternetExplorer (desktop view)

Remote control via Sm@rtClient application

(application view + hardware layout)

Sm@rtAccess

Data access via WinCC flexible client project

Data access via web service (SOAP) with

Internet Explorer

Described in this Document

Sm@rtAccess “SOAP” WinCC flexible provides options of using the web service (SOAP). The web service (SOAP) is based on the Simple Object Access Protocol. It enables you to access the variables of an operator panel from an external application (e.g. Internet Explorer, Microsoft Excel) via Intranet/Internet. Figure 2-2

Client StationCentral Station

INTERNET

SINAUT Micro SC

WinCCflexible

Variable rangefor localvisualization

Variable rangefor localvisualization

Variable rangeis made accessiblevia the web server

Creation of references tovariables on the remote server

with the help of SOAP Toolkit and Java Script

Creation of references tovariables on the remote server

with the help of SOAP Toolkit and Java Script

Variable rangeis made accessiblevia the web server

GetValue

SetValue

Process Value&

Acknowledgement

Function Principle


2.2 Web-based Remote Operation with SOAP

The linking of local input/output fields contained in an HTML form at the client station with the WinCC flexible variables at the server station shall be explained taking the example of the HTML file “startmas21simple.html”. Figure 2-3

2.2.1 Variable Declaration and Write/Read Function with SOAP

V1.0 25.02.2008 7/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Table 2-1

Line Description

9 The subsequent script is a VBScript. 10 • Declare variable (read) for filling level of Remote Station “IS”.

• Initialize variable with WinCC flexible variable structure. • Specify variables to be read always in the format

“ “ “(variable folder)\\(variable name)“ “ “. 11 • Declare and initialize variable (read) for starting the simulation

program of Remote Station “IS”. 12 • Declare and initialize variable (write) for starting the simulation

program of Remote Station “IS”. • Specify variables to be written always in the format

“ “ “(variable folder)\\(variable name)“ “ “. Create constant with the content of the file RuntimeAccess.wsdl on the “MiniWeb” web server.

15

16 Create constant with the content of the user name for logging on the “MiniWeb” web server.

Function Principle


V1.0 25.02.2008 8/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Line Description

17 Create constant with the content of the password assigned to the user name for logging on to the “MiniWeb” web server.

19+27 Create function for reading all declared (read) variables. 21+13 • Declare variable for the SOAP object

• Create SOAP client object. Here starts the creation of the client-to-server connection with the help of Microsoft SOAP Toolkits.

22 Here you specify the “path” to the server-sided file “RuntimeAccess.wsdl” for the SOAP client object.

23+24 Here you give the SOAP client the necessary information for logging on to the Sm@rtAccess (SOAP) service of the WinCC flexible server.

25+26 • Here you assign a value to input/output fields created in the HTML site.

• The value to be assigned will be read from the WinCC flexible tag management via the SOAP connection.

• As read command always use (SOAP object).GetValue((variable folder+variable name)).

29+40 Create function for writing all declared (write) variables. When calling up this function, the name of the calling input/output field and the actual value will be transferred.

30-33 See 21 to 24. 34+38 Execute the IF instruction only if the “ENTER“ key in the

input/output field has been pressed. 35+37 Execute the IF instruction only if the field name of the input/output

field corresponds to “in_out_start_demo”. Here you can add later on several input/output fields in the HTML document and always assign a unique field to the write command.

36 • Here a value will be read from the input/output fields created in the HTML site.

• The value read will be written into a variable from the WinCC flexible tag management via the SOAP connection.

• As write command always use (SOAP object).SetValue((variable folder+variable name), (value)).

Function Principle


2.2.2 Cyclic Reading by Means of JavaScript

Figure 2-4

V1.0 25.02.2008 9/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Table 2-2

Line Description

42 The subsequent script is a JavaScript. 43-46 Declaring and/or initializing variables.

This function will be started upon the first call of the HTML site. This function is the trigger to initialize the timer.

48 ff.

52 ff. This function initializes the timer with 10 seconds. 59 ff. This function terminates the timer.

This is the main function whereby the timer controls the refreshment of the reading values.

66

Once the timer is terminated, the function for reading all of the implemented variables will be called up.

68 ff.

The time to refreshment of all of the implemented variables is indicated in the status bar in the lower left corner of the Explorer. The timer counts down by ”1” every second. The function “StartTheTimer“ calls itself up automatically every 1000ms.

73 ff.

Function Principle


2.2.3 Using Form Fields in the HTML Document

Figure 2-5

Table 2-3

V1.0 25.02.2008 10/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Line Description

The event onLoad, i.e. the first opening of this HTML site, calls up the function ReadAllValues() from the VBScript Chapter 2.2.1.

84

The form name of the document is “Soap“. Through this form name you can address all form fields existing therein.

85

Here you create the input/output field “out_fill_level” for the output of the actual filling level. The property „readonly“ allows only reading access to the field (reading from the view of the calling function).

97

Here, the input/output field “in_out-start_demo” for starting the simulation program in the Remote Station “IS” is generated. Read and write access to this field is possible. When writing a new value into this field and pressing the “ENTER” key, the function WriteThisValue() will be called up. In the course of this, field name and actual value are passed on.

106

Configuring the Startup Software


V1.0 25.02.2008 11/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

3 Configuring the Startup Software

3.1 Preliminary Remarks

For the startup, we offer you a software example with the Startup Code for download. The software example supports you during the first steps and tests with this Micro Automation Set. It enables quick testing of the hardware and software interfaces between the products described in the Micro Automation Sets.

The software example is always related to the components used in the set and shows their principal interaction. However, it is not a real application in the sense of technological problem solving with definable properties.

3.2 Downloading the Startup Code

The software example is available on the HTML page from which you downloaded this document. Table 3-1

No. File name Contents

1. MAS21_WinCCFlex_SOAP_V1d0_en.hmi

Project file for WinCC flexible with activated “SOAP” service

2. MAS21_WinCCFlex_SOAP_V1d0_en.fwx

Runtime file for WinCC flexible with activated “SOAP” service

3. HTML_Client_V1d0.zip SOAP client in form of HTML files with Java Script. Simple version.

4. HTML_Client_MAS21_V1d0.zip

SOAP client in form of HTML files with Java Script. Complex version, especially for MAS21.



3.3 Configuring Components

The chapter below shows the following configuration:

• “MiniWeb” web server by Central Station

• SOAP client by Client Station

In the basic document you will find the description of the configuration of the SINAUT Micro SC Server and the S7-200 Remote Stations. Use the file from Chapter 3.2, which has been adapted to the SOAP service, as WinCC flexible project. Table 3-2

No. Device Component Basic Document Additional Document

5. SINAUT Micro SC Yes No

6. WinCC flexible1 Yes No

7.

Central Station

Web Server No Yes

8. Installation, wiring Yes

V1.0 25.02.2008 12/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

No

9. Parameterizing the S7-200 controller Yes No

10.

Remote Station

Log-on procedure Remote Stations Yes No

11. Installation SOAP Toolkit No Yes

12.

Client Station

Creating SOAP client No Yes

13. All Configuring network neighborhood No Yes

1) Use the project file (Chapter 3.2) provided separately

3.4 Configuring the Network Neighborhood

To demonstrate the functionality of SOAP, configure the infrastructure of all Ethernet stations as follows: Figure 3-1

Client Station

Central Station

SINAUT Micro SC

WinCCflexible

IP Address (ext., fix):Provider-dependent

LAN

INTERNET

IP Address: 192.168.2.55

IP Address (ETH1): 192.168.2.127

WAN

IP Address (int.):192.168.2.X



3.5 Starting WinCC flexible SOAP Project at Central Station

Table 3-3

No. Instructions Remarks

1. Start the WinCC flexible Runtime file listed in Table 3-1, No. 2.

MAS21_WinCCFlex_SOAP_V1d0_en.MAS21 Central Station.fwx

2. Make sure that the Remote Stations and Micro SC work properly.

Description in basic document “Set21_DocTech_vXdY_en.pdf”

3.6 Configuring Web Server at Central Station

Table 3-4


1. Navigate to the folder C:\Program Files\Siemens\SIMATIC WinCC flexible\WinCC flexible 2007 Runtime\WebContent.

V1.0 25.02.2008 13/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

2. Extract the file

“startmas21simple.html” listed in Table 3-1, No. 3 into the folder “WebContent”.

3. Restart the “MiniWeb“ web server

from WinCC flexible. For this purpose, terminate the web server by right-clicking the icon and selecting the option “Exit”.

4.

To restart the “MiniWeb“ web server, navigate to the folder C:\Program Files\Siemens\SIMATIC WinCC flexible\WinCC flexible 2007 Runtime\. Double-click the file “MiniWeb.exe“.

The start of WinCC flexible Runtime automatically activates the web server, too. (Provided that the option “Sm@rtAccess: Web Service (SOAP)” has been selected). The table above describes the manual procedure to terminate and start the web server.

Note



The root directory of the “MiniWeb” web server is “C:\..\WebContent”. The autostart HTML file is “start.html”. Do NOT overwrite or delete this file before you have made a backup copy.

Note

3.7 Configuring the Internet Explorer at Client Station

Table 3-5


1. Open the Internet Explorer to add the server name of the Central Station to the Trusted Sites list.

2.

V1.0 25.02.2008 14/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

For this, open the Internet Options via “Extras/Internet Options”. Select the “Security” tab and mark the “Trusted Sites” icon, Click the button “Sites...”.

3.

Deactivate the checkbox „Require server verification (https:) for all sites in this zone“. Enter “mas21server” into the input line “Add this Web site to the zone:”. Click the button “Add”. Close all open windows with “OK”.



3.8 Configuring the Name Resolution at Client Station

Table 3-6


1. Set the name resolution for your web server. For this, navigate to the directory C:\WINDOWS\system32\drivers\etc.

2. Open the “hosts” file using Notepad.

3.

V1.0 25.02.2008 15/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Add to the list the IP address and the server name of the Central Station. (Here: “mas21server”.) Save and close the document.

3.9 Installing SOAP Toolkit 2.0 to Client Station

Table 3-7


1. Make sure that Microsoft SOAP Toolkit 2.0 has been installed. Otherwise proceed with No. 2.

2. Download the installation file from

http://www.microsoft.com/downloads. For this, search by the terms “Soap Toolkit 2/3.0 new supported toolkit”.

3. Install the software by following the installation instructions of the wizard.

http://www.microsoft.com/downloads

Live Demo


4 Live Demo

4.1 SOAP Web Interface “Simple”

The HTML SOAP client “simple“ does not show the entire functionality of WinCC flexible interfaces. Here, the main focus is on a function test of all stations. The following variables will be visualized.

• Fill level of Remote Station “Inspection Shaft (IS)” (read)

• Button for starting the simulation program at the Remote Station “Inspection Shaft (IS)” (read/write)

Starting SOAP Web Interface “Simple” Table 4-1


4. Start the Internet Explorer.

V1.0 25.02.2008 16/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

5. Enter the web server address and the

specified HTML site into the address line. http://mas21server/startmas21simple.html.

Confirm with “Enter”.

Operating the SOAP Web Interface “Simple” Figure 4-1

1

23

Table 4-2

No. Description

Displaying the actual fill level of the Remote Station “Inspection Shaft“. Being refreshed every 10 seconds.

1

Starting the simulation program. Enter the value “1” and confirm with “Enter”. Being reset automatically.

2

3 Remaining time to refresh all values.

http://mas21server/startmas21simple.html

http://mas21server/startmas21simple.html

Live Demo


4.2 SOAP Web Interface “MAS21”

The HTML SOAP client “MAS21“ shows nearly the entire functionality of WinCC flexible interfaces.

Starting the SOAP Web Interface “MAS21” Table 4-3


1. Perform the steps described in Chapter 3.6 at the Central Station. Use the HTML and GIF files from Table 3-1, No. 4.

2.

V1.0 25.02.2008 17/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

Start the Internet Explorer at the Client Station.

3. Enter the web server address and the specified HTML site into the address line. http://mas21server/startmas21.html.

Confirm with “Enter”.

http://mas21server/startmas21.html

Live Demo


Operating the SOAP Web Interface “MAS21” The layout of the web visualization screens is the same as that of the WinCC flexible operator screens in the basic document Set21_DocTech_vXdY_en.pdf Chapter 5.1.

The operation is nearly identical. Exceptions are explained below.

For the Live Demo use the relevant chapter from the basic document.

Web Visualization - Application View Figure 4-2

V1.0 25.02.2008 18/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

1

1

2

3

3

4

4

Table 4-4

No. Description

Switches (not pushbuttons) are assigned a value (0 or 1) via the keyboard. This value is sent to the Central Station by pressing the “Enter” key.

1.

2. Alarm messages will not be displayed. 3. Dry run of the pumps will not be indicated. 4. The pushbutton “Refresh Data“ updates

• the process variables in the WinCC flexible Central Station • the process variables on these web visualization screens

Live Demo


Web Visualization - Communication View Figure 4-3

V1.0 25.02.2008 19/19

Cop

yrig

ht ©

Sie

men

s A

G 2

008

All

right

s re

serv

ed

Set

21_S

OA

P_D

ocTe

ch_v

1d0_

en.d

oc

1

1

Table 4-5

No. Description

1. The pushbutton “Refresh Data“ updates • the process variables in the WinCC flexible Central Station • the process variables on these web visualization screens

Micro Application Example - Siemens AG of Contents Micro Automation Set 21 - SOAP Beitrags-ID...

Documents

Transcript of Micro Application Example - Siemens AG of Contents Micro Automation Set 21 - SOAP Beitrags-ID...