System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)

Подождите немного. Документ загружается.

Note

Procedures can be used in actions in Global Script and Graphics Designer.

In order to use a global tag defined in Global Script in an action in Graphics Designer, observe

the following:

In order that access can be made to the tag, it is necessary to call in the procedure in which

the tag is defined.

In order to use a global tag in picture-independent actions in Global Script, observe the

following:

In order that access can be made to the tag, at least one procedure in the module containing

the tag must be called in at least one global action.

Procedure - Action Restrictions

Global procedures valid for the entire project can only be created in Global Script. Graphics

Designer

can only be used to create picture-specific procedures and call in global procedures

in actions. Picture-specific procedures in Graphics Designer are defined in the declaration area

of an action.

A procedure is not executed without an action.

File Name and Procedure Name

The procedure name is entered in the first line of the procedure code. The procedure is

displayed in the navigation window and called in actions under this name. Procedures do not

have a file name of their own but are stored in a module.

Module names are assigned in the editor's navigation window. Use the "Save As" command

to save a module under another name in the project directory.

Since procedures in Global Script are valid for the entire project, procedure names must always

be unique. Module names can be used more than once within a project, e.g. in different

subdirectories or stored separately in the standard and project directories.

Displaying Procedures and Modules

If you save a module that contains at least one syntactically incorrect procedure, this will

be displayed in the navigation window with this adjacent symbol.

NOTICE

If a module contains a syntactically incorrect procedure, the module can no longer be loaded.

Procedures can no longer be called from the module.

If you save a module that contains only syntactically incorrect procedures, this will be

displayed in the navigation window with this adjacent symbol.

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

Procedures and Modules

Procedures are classified as standard or project procedures according to their assignment to

standard or project modules. Standard and project modules are located o the corresponding

tab controls in the Global Script navigation window.

Use the modules in order to compile procedures to practical function groups. Observe the

following when structuring the modules and procedures:

● The more modules that must be loaded when a picture is called in, the worse the

performance in Runtime.

● The larger a module, the more procedures are contained and, thus, the longer the loading

time for the module.

Organize the modules sensibly, e.g. a module with procedures for a specific system part/

picture.

See also

Multiple Use of Procedures and Actions (Page 23)

Renaming a Procedure or Module (Page 54)

Saving a Procedure (Page 52)

Protecting a Module with a Password (Page 51)

Adding Module-related Information (Page 49)

Using Standard and Project Procedures (Page 47)

How to Write Procedure Codes (Page 45)

Creating a New Procedure (Page 42)

Examples of VBScript (Page 734)

Modules and Procedures (Page 18)

1.9.2 Creating a New Procedure

Introduction

Standard projects and procedures can be programmed with Global Script in WinCC.

The type of procedure is defined by the assignment to a project or standard module. The

procedure to create standard or project procedures is identical.

On creating a new procedure, WinCC automatically assigns a standard name "procedure#",

which case # represents a continuos number. If the procedure is edited in the editing window,

assign the procedure a corresponding name via which the procedure can be called in an action

later. The name appears in the navigation window when the procedure is saved.

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

Note

Procedure names must be unique within a project. If a procedure with the same name already

exists, the module is identified as syntactically incorrect. Module names can be used twice

when the modules are stored in different directories.

Global procedures (valid for the for entire project) can only be programmed Global Script.

Procedures can be called via actions in Graphics Designer and picture-related procedures

created

in the declaration area of an action. Using a global action in Global Script, it is possible

to create procedures directly in the code which are then only applicable for this action.

An action must be programmed in order to call in a procedure.

Procedure

The following procedure describes the creation of a new procedure in Global Script:

1. Open Global Script.

2. In the navigation window, select the standard modules or project modules tab control

according to whether a standard procedure or project procedure is to be created.

3. Open an existing module or create a new module using the menu commands "File" > "New"

> "Project Module" or "File" > "New" > "Standard Module".

4. After having created a new module, the structure of a procedure without return value is

already entered in the editing window:

5. Enter the procedure name direct in the code: Sub "Procedure name".

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

6. To insert one procedure in an existing module: Select the module in the navigation window

and then select the "Insert New Procedure" context menu item.

The dialog "New Procedure" is displayed:

7. Enter a procedure name and select whether the procedure should have a return value

parameter. The definition of a tag for the return value is then entered in the code (Dim

RetVal).

8. Confirm your settings with OK.

Note

A new procedure can also be entered directly in a module. In the case of procedures without

return

value, always begin with the instruction "Sub " and <Procedure Name> and conclude

with "End Sub". In the case of procedures with return value, always begin with the instruction

"Function " and <Procedure Name> and conclude with "End Function". The new procedure

is displayed in the navigation window when the module is saved.

See also

Creating and Editing Procedures (Page 39)

Multiple Use of Procedures and Actions (Page 23)

Renaming a Procedure or Module (Page 54)

Saving a Procedure (Page 52)

Protecting a Module with a Password (Page 51)

Adding Module-related Information (Page 49)

Using Standard and Project Procedures (Page 47)

How to Write Procedure Codes (Page 45)

Modules and Procedures (Page 18)

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

1.9.3 How to Write Procedure Codes

Introduction

Procedure codes are written in the Global Script editor window.

The code of each procedure can call in other procedures via their procedure names.

Procedures can be created with or without return values. Use the return value, e.g. to obtain

information

that the procedure has been executed successfully (e.g. 0 = fault, 1 = successfully

executed).

If a procedure (module) used in a picture is modified, the modification is applied the next time

the picture is loaded. This means that a picture currently displayed only works with the modified

procedure after the picture has been reloaded.

Functions in Global Script

Global Script provides the following functions to support the creation of procedure codes:

Intellisense and Highlight Syntax

During text entry, context-sensitive lists appear containing the properties, methods, and objects

possible at the current code position. If you insert an element from the list, the required syntax

is also indicated automatically.

Note

Full intellisense for all objects can only be utilized in the Graphics Designer if the list is

accessed

using the object name and the result is assigned to a tag. Otherwise, you are only

offered a list of standard properties.

Example of full intellisense:

Dim Variable

Set Variable = ScreenItems ("Kreis1")

Variable.<Intellisense selection>

If picture window limits are exceeded during addressing, it is once again only the standard

properties which are offered since the picture of the picture window is not loaded.

General VBS Functions

Use the "Function List" context menu command in the editor window to display a list of general

VBS functions.

Lists of Objects, Properties and Methods

Using the context menu in the editing window you can view a list of the possible objects by

calling the "Object List" command in Graphics Designer. Global Script only provides the

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

HMIRuntime object in this list because there is no direct access to the objects of Graphics

Designer.

Use the "Properties/Methods" context menu command to call in a list of possible properties

and methods.

The same lists can be called in with the key combination <CTRL + SPACEBAR> but according

to the context of the script.

Code Templates

In the Code templates tab in the Navigation window of the Editor, you will find a selection of

frequently

used instructions, e.g. for loops and conditional instructions. The templates can be

inserted in the procedure codes by means of drag&drop.

If you insert a code template into your code, it is important to note that, for example, conditions

in the templates are identified by "_XYZ_". You must replace these placeholders with the

appropriate information.

Selection Dialogs

If WinCC tags or objects are used in the code, the following selection dialogs are available for

use:

●

Opens a tag selection dialog returns the selected tag name as the return value.

●

Opens a tag selection dialog and returns the tag name with an associated reference.

●

Opens a picture/object browser in which a picture/object can be selected whose name

is then used for the return value.

● Opens a picture selection dialog for pictures and returns the picture name, with the server

prefix if necessary.

Syntax Check

Global Script supports you by providing a syntax check which you can perform after the code

has

been created. Syntax errors in the code are displayed in the output window of the editor.

You can move to the erroneous point in the code directly by double-clicking the error in the

output window.

Note

The syntax check can only detect syntax errors in the code. Programming errors, such as

missing

references, only become visible in Runtime. You should therefore also always check

your scripts in the Runtime environment.

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

Changing a Procedure

If a procedure is modified while Runtime is active, the modification becomes effective at the

following times:

● Procedures called from actions or other procedures in pictures become active following a

picture change.

● Procedures in Global Script become active directly after being called again.

Procedure

1. Open Global Script.

2. Open the module containing the procedure to be edited.

3. After double clicking on the procedure in the navigation window, the cursor skips to the

beginning of the required procedure.

4. Edit the procedure.

If you create a procedure with a return parameter, e.g. to program recurring evaluations or

reviews, indicate the return value with "procedurename = RetVal" at the end of the

procedure.

See also

How to Write Procedure Codes (Page 45)

Multiple Use of Procedures and Actions (Page 23)

Renaming a Procedure or Module (Page 54)

Saving a Procedure (Page 52)

Protecting a Module with a Password (Page 51)

Adding Module-related Information (Page 49)

Creating a New Procedure (Page 42)

Modules and Procedures (Page 18)

Creating and Editing Procedures (Page 39)

1.9.4 Using Standard and Project Procedures

Introduction

Use the drag&drop function in the navigation window or the context menu to insert a procedure

in the current code.

Project procedures can only be used within the current project, standard procedures are

available for all projects on the computer.

Procedures, once created, can be used in other projects or on other computers. To do this,

copy the module containing the procedures in the appropriate project or standard directory.

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

Using Procedures in Graphics Designer and Global Script

Procedures defined in Global Script can be called in actions in Global Script and Graphics

Designer.

On executing the action in Runtime, the entire module which contains the procedure

is loaded.

Please observe the following in order to use a global tag defined in a procedure in Global

Script:

When using Graphics Designer, always call the procedure in which the tag is defined so that

the tag can be used. I the procedure is not called in, the corresponding module is not loaded

and access cannot be made to the tag.

In the case of picture-independent actions in Global Script, at least one procedure in the module

containing the tag must be called in at least one global action.

Note

In the general declaration part of screens, no check is made whether a procedure or function

name

has already been assigned. Therefore, a name could occur several times and it is not

defined which function will be executed. This is standard behavior of the MS Scripting Engine.

Procedure

1. Open the procedure or action in which the procedure should be inserted.

2. Use the drag&drop function to move the procedure to be inserted from the navigation

window to the correct position in the code.

3. Place the cursor at the position in the code where you would like to insert teh procedure.

4. Mark the procedure in the navigation window with the mouse.

5. Choose pop-up menu command "Transfer Procedure Retrieval".

See also

Creating and Editing Procedures (Page 39)

Multiple Use of Procedures and Actions (Page 23)

Renaming a Procedure or Module (Page 54)

Saving a Procedure (Page 52)

Protecting a Module with a Password (Page 51)

Adding Module-related Information (Page 49)

How to Write Procedure Codes (Page 45)

Creating a New Procedure (Page 42)

Modules and Procedures (Page 18)

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

1.9.5 Adding Module-related Information

Introduction

Related information can be added to each module in order to quickly recognize the functionality

the module or the procedures contained in it when edited at a later date. If several operators

are involved in configuring a project, you should provide module-related information for your

colleagues.

When a new module is created, the creation date is entered in the module-related information

automatically and is unchangeable. The Module is also assigned the version number 1.0. The

version numbers can be individually assigned when editing a module. When a module is

changed and saved, the current date of change is entered automatically and is unchangeable.

The following information can be added:

● "Created by"

● "Changed by"

● "Comments" e.g. module functionality/procedures contained

It is still possible to define a password for the module. Further information on assigning

passwords is provided in "Protecting Modules with a Password".

Procedure

1. Open Global Script.

2. Select the module in which information is to be added in the navigation window.

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

Click the button "Info/Trigger" in the toolbar or choose the pop-up menu command "Info".

The "Properties..." dialog appears.

4. Enter the required information.

Note

The "Info/Trigger" dialog can also be called if an open procedure is selected in the navigation

window.

The information stored in this dialog is always valid for the entire module and all the

procedures contained in it.

See also

Multiple Use of Procedures and Actions (Page 23)

Renaming a Procedure or Module (Page 54)

Saving a Procedure (Page 52)

Adding Module-related Information (Page 49)

Using Standard and Project Procedures (Page 47)

How to Write Procedure Codes (Page 45)

Creating a New Procedure (Page 42)

Modules and Procedures (Page 18)

Creating and Editing Procedures (Page 39)

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,