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

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

1.10.3 How to Edit Actions

Introduction

An action is edited in the same way as a procedure in the editor window of the editor or in the

Graphics Designer action editor.

In order that an action can be executed in Runtime, it requires a trigger. Actions which are

triggered by an event in Graphics Designer do not require the assignment of a trigger.

If an action is modified while Runtime is active, the change is applied when the picture is

reloaded

(in the case of actions in Graphics Designer) or the next time the action is called (in

the case of actions in Global Script).

Note

A change in the code in Runtime cannot be applied when another action is being carried out

at the same time.

A procedure call can be inserted in the action by dragging the procedure from the editor's

navigation

window and dropping in the corresponding position of the code in the editor window.

C scripts cannot be called in VBS actions.

Declaration Area in Actions

If you create actions in Graphics Designer, you can display the declaration area of the action

using the button

. When creating a new action, the "Option explicit" instruction is

automatically entered in the declaration area and cannot be deleted. The instruction is

necessary as it prevents errors caused by the incorrect notation of tags without declaration.

The instruction requires that tags are always defined in your code with the "Dim" instruction.

Do not use the instruction "Option explicit" in your code as this can cause Runtime errors.

In the declaration area, you can also make general settings which you want to use globally for

the current picture, e.g.:

● Tag Definitions

● Procedures which you only want to use in this picture

In the declaration area of the actions, you may define global tags independent of each other

in the areas "Event" and "Properties" of an object. There is no link between global tags of

identical names in both areas.

VBS for Creating Procedures and Actions

1.10 Creating and Editing Actions

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

System Manual, 11/2008,

Note

Always make sure that the procedures in the declaration area have correct syntax, i.e. with

"Sub" - "End Sub". Do not create directly executable codes in the declaration area as this

can cause Runtime errors.

If global tags are used in the declaration area of actions Graphics Designer, note that the

event-driven

and cyclic/tag-driven actions are processed separately in Runtime. There is no

synchronization of global tags between the two Runtime systems in Runtime. If

synchronization of tags is required, configure these using the DataSet object or internal

WinCC tags.

When making definitions in the declaration area, pay attention to the structure of the Script

files, as described under "Structure of VBScript files".

Functions for Editing Actions

The script editors provide the following functions to assist you in creating action code:

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, only a list of

standard properties is offered.

Example of full intellisense:

Dim Variable

Set Variable = ScreenItems ("Kreis1")

Variable.<Intellisense>

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.10 Creating and Editing Actions

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. Therefore, always check the scripts in

the Runtime environment and use a debugger, if necessary, to detect and eliminate errors.

The way to test scripts with a debugger is described in this documentation under the topics

"Diagnostics" > "Testing with the Debugger".

VBS for Creating Procedures and Actions

1.10 Creating and Editing Actions

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

System Manual, 11/2008,

Procedure

1. Open Global Script.

2. Double click on the action on the Action tab control in the navigation window.

3. Edit the action.

See also

Using Global Tags in VBS (Page 27)

Testing with the Debugger (Page 90)

Structure of VBScript Files (Page 97)

How to Rename an Action (Page 81)

Saving Actions (Page 67)

Protecting an Action with a Password (Page 66)

How to Edit Actions (Page 61)

Creating a New Action (Page 59)

Triggers (Page 69)

Creating and Editing Actions (Page 55)

Actions (Page 21)

1.10.4 How to add information to the action

Introduction

Related information can be added to every action in Global Script in order that the function of

an action can be recognized at a later date when editing. If several operators are involved in

configuring a project, you should provide action-related information for your colleagues.

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

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

version numbers can be individually assigned when editing an action. When an action 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. functionality of the action

It is also possible to define a password for the action. Further information on assigning

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

VBS for Creating Procedures and Actions

1.10 Creating and Editing Actions

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

System Manual, 11/2008,

Note

Additional information can only be made available actions in Global Script, not for actions in

Graphics Designer.

Procedure

1. Open Global Script.

2. Open the action for which information should be added.

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.

VBS for Creating Procedures and Actions

1.10 Creating and Editing Actions

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

System Manual, 11/2008,

See also

How to Rename an Action (Page 81)

Saving Actions (Page 67)

Protecting an Action with a Password (Page 66)

How to Edit Actions (Page 61)

Creating a New Action (Page 59)

Triggers (Page 69)

Creating and Editing Actions (Page 55)

Actions (Page 21)

1.10.5 Protecting an Action with a Password

Introduction

An action in Global Script can be protected against unauthorized access by assigning a

password to it. The password is a part of the action-related information.

Note

Only actions in Global Script can be assigned a password, not actions in Graphics Designer.

Procedure

1. Open Global Script.

Open the action to be protected by a password.

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

The "Properties..." dialog appears.

4. Select the "Password" check box.

5. Click the "Change" button. The "Enter Password" window opens.

6. Enter a password and confirm it.

7. Confirm your settings with OK.

Result

If an attempt is made to open the action, the system requests the password is entered.

Deactivate Password Protection

To clear the password protection, disable the "Password" check box.

VBS for Creating Procedures and Actions

1.10 Creating and Editing Actions

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

System Manual, 11/2008,

Change Password

To change the password, open in the Properties dialog and click the "Change" button. Then

enter the new password.

NOTICE

If you forget the action password, the action cannot be edited.

See also

How to Rename an Action (Page 81)

Saving Actions (Page 67)

How to add information to the action (Page 64)

How to Edit Actions (Page 61)

Creating a New Action (Page 59)

Triggers (Page 69)

Creating and Editing Actions (Page 55)

Actions (Page 21)

1.10.6 Saving Actions

Introduction

Before an action can be run in Runtime, it must be saved. Save an action as any other Windows

file using the "File" > "Save" commands or the corresponding icon.

Note

Actions in Graphics Designer are automatically applied on closing the action editor with the

picture. Functions can only be saved in the Graphics Designer if they have the correct syntax.

If an action with errors should still be retained and exited, however, enter the comments.

A list of all the possible syntax errors is available in the Appendix under " Basic Principles of

VBScript".

In order to save an action under a different name, e.g. to use an action as a basis for another

action, use the "Save As" command.

Note that, when using "Save As", only the file name is changed and not the action name.

VBS for Creating Procedures and Actions

1.10 Creating and Editing Actions

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

System Manual, 11/2008,

Prior to Saving

Before saving an action, check the code is syntactically correct. The syntax errors in the code

are

displayed in the output window of Global Script. Double click on an error line to access the

error position in the code directly.

Note

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

missing references, only become visible in Runtime. Therefore, always check the scripts in

the Runtime environment and use a debugger, if necessary, to detect and eliminate errors.

If actions are saved without running a syntax check beforehand, the editor comments that a

syntactically incorrect action will be saved which cannot subsequently be run in Runtime.

Syntactically incorrect actions are displayed with the adjacent icon in the navigation window.

Procedure

Click the button "Syntax Check" in the toolbar.

2. If errors are displayed in the lower part of the editor window, double click on the error line

and correct the error in the code. Repeat steps 1 and 2 until the code is correct.

Save the action by clicking "Save" in the toolbar.

See also

Actions (Page 21)

How to Rename an Action (Page 81)

Protecting an Action with a Password (Page 66)

How to add information to the action (Page 64)

How to Edit Actions (Page 61)

Creating a New Action (Page 59)

Triggers (Page 69)

Creating and Editing Actions (Page 55)

VBS for Creating Procedures and Actions

1.10 Creating and Editing Actions

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

System Manual, 11/2008,

1.10.7 Triggers

1.10.7.1 Triggers

Definition and use

Triggers are used to execute actions at Runtime. To do this, a trigger is linked to an action,

forming the triggering event for calling the action. Actions without triggers will not be carried

out.

The triggers defined for an action are displayed in the Global Script navigation window .

Trigger types

The following trigger types are available:

Acyclic triggers

They consist of the specification of date and time. The action specified by such a trigger is

performed once at the date and time specified.

Cyclic triggers

They consist of the specification of a time interval and start time. The following types of cyclic

triggers are available:

● Default cycle. The start of the first time interval coincides with the start of Runtime. The

length of the interval is determined by the cycle.

● Hourly. The start of the interval is specified as minute and second. The length of the interval

is an hour.

● Daily. The start of the interval is specified by the time (hour, minute and second) festgelegt.

The length of the interval is a day.

● Weekly. The start of the interval is specified by the day of the week (Monday, Tuesday,

etc.) and the time. The length of the interval is a week.

VBS for Creating Procedures and Actions

1.10 Creating and Editing Actions

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

System Manual, 11/2008,

● Monthly. The start of the interval is specified by the day and time. The length of the interval

is a month.

● Annual. The start of the interval is specified by the day, month and time. The length of the

interval is a year.

Time-controlled triggers are used for actions Global Script and for actions to make graphic

objects dynamic.

Tag triggers

They consist of one or more specified tags. The action associated with such a trigger is

performed each time a change in the value of one of these tags is detected.

How the tag values are queried may be customized for each tag. Select from the following

modes:

● Cyclic query of the tag value: Specify a standard cycle. The tag value is queried at the

defined intervals (e.g. every 2 seconds). The action is triggered when the system detects

a change of the tag value.

Depending on the size of the cycle, it is possible that the tag value is changed but it is not

detected by the system.

If, for example, a cycle of 5 minutes has been set, the tag value may change several times

within

the 5 minute period but only the value set when the next query is made is detected.

The value changes between the two queries are not registered.

● Changes in the tag value: Each change in the tag value is detected by the system. The

action is executed each time the tag value changes.

Tag triggers are used for actions Global Script and for actions to make graphic objects dynamic.

Event-driven

When an action is configured related to an event on a graphic object, the action is triggered

when a specific event has occurred, e.g. following a mouse click or the change of the

background color due to another action.

Animation cycle

As of WinCC V7.0, the "animation cycle" trigger art is available for the dynamization of objects

with VBS. The animation cycle allows you to switch actions on and off in Runtime and to change

the time, in which the trigger is executed.

You can find additional information in the "" section.

Effects of triggers on actions

If the action is associated with only one trigger, then the action is performed as soon as the

triggering event occurs.

However, an action may be associated with multiple triggers, such as a cyclic trigger and a

tag trigger. Here the action is performed whenever one of the two triggering events occurs. If

two events occur simultaneously, then the action is executed twice sequentially. If two tag

triggers fire at the same time, the action will be performed only once.

VBS for Creating Procedures and Actions

1.10 Creating and Editing Actions

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

System Manual, 11/2008,