You are on page 1of 37

RA Add-On for WinCC v1.

User Manual

Allottware CC
Reg No: 2004/028046/23
P.O. Box 12611, Vorna Valley, 1686, South Africa

Tel: +27 82 809 3262


Fax: +27 11 315 1464
Email: rallott@mweb.co.za
Web: www.allottware.co.za

Managing Members:
Reuben Allott
User Manual RA Add-On for WinCC v1.1

CONTENTS

1 INTRODUCTION....................................................................................................................................... 3
1.1 RA V1.1 OVERVIEW ............................................................................................................................. 3
1.2 SYSTEM REQUIREMENTS ...................................................................................................................... 3
1.3 ADDITIONAL HELP ............................................................................................................................... 3
2 GETTING STARTED ................................................................................................................................ 4
2.1 INSTALLATION...................................................................................................................................... 4
2.2 PROJECT CREATION .............................................................................................................................. 5
2.3 STANDARD PROJECT CONFIGURATIONS ............................................................................................... 6
2.4 RA NAVIGATION BUILDER ................................................................................................................... 8
2.5 PROJECT ACTIVATION ........................................................................................................................ 10
2.6 WEB NAVIGATOR ............................................................................................................................... 11
3 RA NAVIGATION BUILDER ................................................................................................................ 15
3.1 OVERVIEW ......................................................................................................................................... 15
3.2 TEMPLATE SELECTION ....................................................................................................................... 15
3.3 NAVIGATION CONFIGURATION ........................................................................................................... 16
3.4 BRANDING .......................................................................................................................................... 19
3.5 BUILDING ........................................................................................................................................... 19
4 RUNTIME FUNCTIONALITY............................................................................................................... 20
4.1 DEFAULT TEMPLATE .......................................................................................................................... 20
4.2 MAIN TOOL BUTTONS ........................................................................................................................ 20
4.3 DEFAULT MENUS ............................................................................................................................... 21
4.4 NAVIGATOR ....................................................................................................................................... 22
4.5 HELP PAGE ......................................................................................................................................... 23
4.6 LOOP-IN-ALARM ................................................................................................................................ 24
4.7 AUDIBLE ALARMS (HORN)................................................................................................................. 25
4.8 RA WINCC TAG DEBUGGER ............................................................................................................. 26
4.9 SPLIT-SCREEN CONFIGURATIONS ....................................................................................................... 27
4.10 HIERARCHICAL ALARM NAVIGATION ................................................................................................ 28
5 RA FACEPLATE BUILDER................................................................................................................... 29
6 RA RECIPE MANAGER......................................................................................................................... 30
7 INCLUDED SCRIPT LIBRARY ............................................................................................................ 31
8 WIZARDS ................................................................................................................................................. 32
8.1 RA WIZARDS ..................................................................................................................................... 32
8.2 HOW TO LOAD THE WIZARDS ............................................................................................................. 33
8.3 HOW TO USE THE WIZARDS ............................................................................................................... 34
8.4 EXAMPLE USAGE ............................................................................................................................... 35
9 CREATING YOUR OWN TEMPLATES .............................................................................................. 36
10 RA DEMO PROJECT.............................................................................................................................. 37

Rev: 2, 6 Feb 2005 Page 2 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

1 INTRODUCTION
1.1 RA v1.1 Overview

Allottware RA v1.1 is an attractive alternative to the Basic Process Control navigation system
that ships with SIMATIC WinCC v6.0.

The system builds menus and faceplates from a set of template files. You can edit the
standard template files or create your own templates altogether. The system supports split-
screen configurations and can be published correctly using the Web Navigator or Data
Monitor systems (unlike Basic Process Control).

RA v1.1 is aimed primarily at small to medium sized systems implemented as an integrated


Step7/WinCC project. The Faceplate Builder is designed to work with structured tags
generated automatically by the Step7 OS compilation of Function Blocks and instance Data
Blocks (if you are using Siemens PLC and Siemens HMI, then this is how your project
should already be structured).

You can also use the RA Faceplate Builder in a stand-alone WinCC system as long as you
use tag structures that mimic the structures created by Step7 function blocks. This is
described later.

NOTE: The RA Template builder generates a project using completely standard WinCC
graphics and scripts. You can copy the project to another computer that does not have RA
installed on it and the project will still work correctly, although you won’t be able to edit the
navigation menus.

1.2 System Requirements

The following software versions were used in testing. Other versions may or may not work
correctly:

Product Version (Revision Level)


Windows XP Professional 5.1.2600 Service Pack 2 Build 2600
MS Internet Explorer V6 + SP2
MS Internet Information Services IIS 5.1
Step7 Professional V 5.3 + SP1 (K5.3.1.0)
WinCC V6.0 + SP2 + Hotfix 3 (V6.0.2.3)
Web Navigator Server V6.0 + SP1 + Hotfix 2 (V6.0.1.2)
Web Navigator Client V6.0 + SP1 (V6.0.1.0)

1.3 Additional Help

You can find the latest online help at the official RA web site:

http://www.allottware.co.za/ra

Rev: 2, 6 Feb 2005 Page 3 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

2 GETTING STARTED
2.1 Installation

This getting started guide shows how to integrate a brand new WinCC project into an existing
Step7 project, apply the RA Template and publish it using the WinCC Web Navigator option.

It assumes that you already have Step7, WinCC, Web Navigator Server and corresponding
authorizations installed. Before installing Web Navigator you must have IIS installed. Please
refer to the Web Navigator/IIS documentation for this. When you install WinCC you must
select the Basic Process Control option.

RA v1.1 Add-On for WinCC is installed from the RA setup CD or from the setup.exe file
found in the RAv1.1.zip file downloaded from www.allottware.co.za. This is a standard
Windows installation:

You can accept the default installation path and just click next until the wizard has completed
the installation.

Rev: 2, 6 Feb 2005 Page 4 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

2.2 Project Creation

Open your Step7 project and


insert an OS server from the
“Insert New Object” context
menu.

Rename the OS to something


suitable, without characters such
as parentheses (brackets), and
then compile it. If you are
unfamiliar with compiling the
OS you can ignore this step.

Rev: 2, 6 Feb 2005 Page 5 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

2.3 Standard Project Configurations

Right-click on your OS and select “Open Object” to open your OS project with WinCC. If
you have correctly installed the RA v1.1 Add-On then you should see it in the tree just above
Web Navigator:

Before using the RA Template Builder you must apply a few project settings.

2.3.1 Project Properties

When you create an OS project in Step7 it


defaults to a multi-user project. This can
cause license errors if you are building a
single-user system and do not have a Server
authorization for WinCC.

Right-click on the very first node in the tree


(the name you gave to your OS) and change
the project to a single-user system.

Rev: 2, 6 Feb 2005 Page 6 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

2.3.2 OS Project Editor

The RA Template works with the standard alarm configurations generated by the Basic
Process Control editor. We don’t use the Basic Process Control navigation system though.

Open the Basic Process Control


editor from the context menu. If
you do not see the OS-
ProjectEditor add-on then you must
install the Basic Process Control
add-on from the WinCC install CD.

You do not need to make any


changes in the editor. Simply click
the OK button and it will generate
the standard alarm system
configuration. The Basic Process
Control pictures will also be
applied, but these will be
overwritten when the RA Template
is applied.

Rev: 2, 6 Feb 2005 Page 7 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

2.4 RA Navigation Builder

Right-click on “Navigation System” to open the


RA Template builder

The first time you open it the selection will be


blank.

Select the template you want for your project


from the drop-down list.

The navigation menus will be populated with


some default picture selections.

We explain later how to add new pictures into


the navigation menus, but for now you can
build the project with the default pictures.

Rev: 2, 6 Feb 2005 Page 8 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

On the “Branding” page you can select your


own image files to be incorporated into the
project, or you can leave the default images in
place.

On the “Build” page, select the option to delete


the Basic Process Control picture files. This
will delete all the files starting with “@” from
the GraCS folder. If you do not do this the
project will be activated with the BPC screen
template.

Click on “Build” to generate your project.

Rev: 2, 6 Feb 2005 Page 9 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

2.5 Project Activation

Activate the project from the File menu or with the


“Play” button.

The first time you run the project you will have to
define the start picture.

Select the “raMain.pdl” file.

If you want a split-screen configuration, select one


of the “raSplit_XxX” pictures.

The WinCC project should now be activated with


the RA Template.

Rev: 2, 6 Feb 2005 Page 10 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

2.6 Web Navigator

Follow these steps to publish the project using the Web Navigator add-on:

1. Configure the Web Server


2. Publish the Pictures
3. Configure Users
4. Logon using MS Internet Explorer

NOTE:
If you have problems with the configuration make sure you have all the latest versions and
service packs of WinCC, Web Navigator, Windows and Internet Explorer. See section “1.2
System Requirements” for a list of tested software versions.

2.6.1 Configure the Web Server

Open the Web Configurator from the context


menu.

Accept all the defaults to create a new Web.


You must have IIS installed.

Rev: 2, 6 Feb 2005 Page 11 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

2.6.2 Publish the Pictures

Next open the Web Publishing Wizard.

Select all of the pictures.

Select all of the functions.

Select all of the bitmap image files.

Click “Finish” to create all the Web pictures.

Rev: 2, 6 Feb 2005 Page 12 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

2.6.3 Configure Users

Before you can use the Web Navigator client you must create users that have Web Navigator
access enabled for them, and select a start page for that use.

This is configured in the standard WinCC User Administrator application.

Open the WinCC User


Administrator.

Create any users and


password you require.

Select the Web Navigator


option and select the
“raMain.pd_” start picture
and the correct language.

You will not be able to select the start page before you have published your pictures (see the
previous section).

Rev: 2, 6 Feb 2005 Page 13 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

2.6.4 Logon using MS Internet Explorer

We will now access the WinCC Runtime via the Web Navigator system using Microsoft
Internet Explorer. Make sure the WinCC Runtime is activated on the WinCC machine.

Open an Internet Explorer window and type in the address “http://<COMPUTERNAME>/”,


where <COMPUTERNAME> is the computer name of the WinCC machine.

If you are using Internet Explorer on the same computer as WinCC you can use the address
“http://localhost/”. If the WinCC computer name is “WinCC_1” then type in
“http://wincc_1/”.

You will be prompted to login.

Enter one of the usernames you configured in


the previous step.

The first time you logon you will be prompted to


download and install the Web Navigator client
software. Follow the onscreen instructions to run
the client installation.

Once the client software has installed you will


be able to view the project (the WinCC Runtime
must also

Rev: 2, 6 Feb 2005 Page 14 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

3 RA NAVIGATION BUILDER

3.1 Overview

The main goal of the Navigation Builder is to apply the selected screen template to your
project and build the navigation menus for the pictures in your plant.

A library of scripts and pictures is also added to your project. Most of these scripts are used
by the navigation system to display pictures and faceplates.

You can also create your own templates that can be applied to new projects. This is useful for
OEM or System Integrators that implement many projects with their own branding and
special functionalities (you can download new templates from the RA website at
www.allottware.co.za/ra).

3.2 Template Selection

The first configuration is to select the main template to apply. Select the template from the
drop-down list.

Rev: 2, 6 Feb 2005 Page 15 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

3.3 Navigation Configuration

3.3.1 Overview
In the navigation tree you build your menu
hierarchy by adding containers and sub-
containers. All operations are performed from
the right-click context menu.

All your pictures are displayed at the bottom.


Drag and drop the pictures onto the containers
in the tree to add them to your menus.

You can also use drag and drop to move


containers around in the tree. When you build
the template your menu structure will be
compiled according to this tree.

3.3.2 Context Menu

The functions of the context menu are as follows:

Menu Item Description


Add Container Add a new container to the tree (on the same level as the selected one)
Add Sub-Container Add a new container to the tree (as a child on the selected container)
Add Back Button Add a “Back” button. In runtime this is a menu button that will return to the parent menu.
Edit Container Edit the selected container
Delete Container Delete the selected container
Cut Cut the selected container from the tree for pasting
Paste Paste the cut container before the selected node
Paste Into Paste the cut container as a child of the selected node
Apply Access to All Apply the selected access level to the selected container and all of its children
Picture Name Display the picture name in the tree
Descriptions Display the picture names & titles in the tree
Titles Only Display only the picture titles in the tree
Save Menu Save the selected menu to a file
Load Menu Load a previously saved menu file into the selected menu

Rev: 2, 6 Feb 2005 Page 16 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

3.3.3 Editing Containers

There are four type of menu buttons you can create:

1. Standard Buttons either open a submenu or picture or are


simply descriptive labels
2. “Back” buttons are buttons that return to the previous or
parent menu
3. Copied objects are any graphic object copied from another
picture
4. Script buttons are menu buttons that perform some C-Script
action

Every menu button has a caption and an authorization. The caption is


simply the text to be displayed on the menu button.

The authorization is the standard WinCC user authorization that is


required to click on the button. Click on the ellipses button (…) to open
the WinCC user authorization selection dialog.

3.3.3.1 Label/Button

If you select a picture on a standard button then that picture will be


opened when the menu button is clicked. If you specify a picture title it
will be displayed in the main picture title bar. If you do not specify a
picture title, the picture name will be used.

If you select no picture then the menu item appears simply as a text
label.

Select this option to include this picture in the automatic slide show
(see the section on the Navigator window for more details).

Menu items can be linked to alarm status tags that are linked to alarm
groups configured in the WinCC Alarm Logging editor.

Please refer to the alarm logging help for more information on the
implementation of these status tags.

You can create a hierarchical alarm navigation system using these


status tags.

In runtime an indicator will light up on the left-hand side of the menu


button when an alarm has been triggered in the alarm group.

Rev: 2, 6 Feb 2005 Page 17 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

3.3.4 Back Button

A back button has no setting other than the caption text. In runtime the button will replace the
current menu with the parent menu (return to previous menu).

3.3.5 Copied Object

When you select a copied object the builder does not


create a menu button. Instead it copies the graphic
object you have specified into your menu picture.

You can specify whether to place the object where the


button would be placed (inline) or provide your own X
and Y coordinates.

This can be used for example to insert a logo image on


the menu.

3.3.6 C-Script

If you select C-Script you can enter a C-Script


function to be executed in the Mouse Action
event of the button.

The “Compile” button will compile the script and


inform you of any compilation errors in the
script.

You can paste any valid C-Script code from


WinCC pictures in here.

Rev: 2, 6 Feb 2005 Page 18 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

3.4 Branding

On the “Branding” page you can select your


own image files to be incorporated into the
project, or you can leave the default images in
place.

This allows you to brand the template


differently for different projects without having
to create entirely separate templates just for
different company logos.

Click on “Replace” to select a new image file.


Click on “Original” to revert to the original
image.

3.5 Building

On the “Build” page, select the option to delete


the Basic Process Control picture files. This
will delete all the files starting with “@” from
the GraCS folder. If you do not do this, the
project will be activated with the BPC screen
template.

If you select “Create non-existent mimics” then


any picture names found in the navigation tree
that do not exist will be created for you.

Click on “Build” to generate your project.

Rev: 2, 6 Feb 2005 Page 19 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

4 RUNTIME FUNCTIONALITY
4.1 Default Template

The default template is described here. It is possible that you have a different template that
was created by someone else.

User Name
Picture Title The user name
The name of the currently logged on
currently displayed
picture is shown here

Navigation buttons
Menu Selection and Current time
The four main menus
are selected here:
Mimics, Alarms, Alarms
Reports and System The latest active or
unacknowledged alarms
Click here to open the
main alarm window

Main Menu
Select pictures Mimic Area
and sub-menus Pictures are
from here. displayed in this
main area

4.2 Main Tool Buttons

Open the main mimic menu Log on

Open the alarms menu Silence horn (if configured)

Open the trends/reports menu Open system help page

Display previous page in the page history


Open the system menu
(back button)

Click on the logo to open the project welcome picture.


Right-click to open the Global Script Diagnostics window.

Rev: 2, 6 Feb 2005 Page 20 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

4.3 Default Menus

When you apply the template to your project for the first time the following default mimics
are added to your menu system.

4.3.1 Mimics

Mimic Description
Project Overview This is a blank mimic to be used as your main starting page
Help This is an HTML-based help system for your project
Legend This shows and explains the main symbols and colours used in your project
Test This is a blank page to be used for testing purposes

4.3.2 Alarms

Alarm Page Description


Incoming All currently unacknowledged alarms
Current All currently active alarms
Alarms High/Low Alarms & Warnings
Process Process control alarms
Operations Operator actions (manual device control, set point change, user logon)
System Control system alarms & messages (PLC & OS equipment & communications)

4.3.3 Trends & Reports

Report Page Description


Main Trends Opens a trend page that the user cannot edit in runtime
User Trends Opens a trend page that the user can edit in runtime
Floating Trends Opens a floating trend window that can be edited in runtime

4.3.4 System

Function Description
Global Script Diag This opens the Global Script diagnostics window, used primarily for debugging scripts
Tag Debugger This opens the WinCC Tag Debugger application, which is described later in the document
Shut Down This shuts down the WinCC runtime
Restart PC This shuts down the WinCC runtime and reboots the computer
Project Editor This opens the WinCC Explorer program
Graphics Editor This opens the WinCC Graphics Editor, with the currently displayed picture
C-Script Editor This opens the WinCC C-Script Editor
VB-Script Editor This opens the WinCC VB-Script Editor
User Admin This opens the WinCC User Administrator
Windows Explorer This opens a Windows Explorer window
Task Manager This opens the Windows Task Manager
Calculator This opens the Calculator program
It is possible to disable faceplates if there are scripts in your project which attempt to open non-
Fix Popups
existent faceplates. This button fixes that scenario.

Rev: 2, 6 Feb 2005 Page 21 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

4.4 Navigator

If you click on the main picture title bar in runtime you will
get a drop-down list of all the pictures in the project. Simply
select the picture to open it in the main window.

Currently the builder does not correctly compile one of the


functions, so if you add pictures to the project you must
manually compile the function before this navigator drop-
down will list all the pictures correctly.

Open the C-Script function “raNavigator” from the WinCC


Explorer.

Compile the function by clicking on the “Compile” button

Save the function by clicking on the “Save” button.

These three buttons control the automatic slide-show function.


From left to right:
Play – this starts the slide show
Stop – this stops the slide show
Close – this closes the navigator window

The pictures that are included in the automatic slide show are
specified in the properties dialog of the RA Navigation
Builder.

When the slide show is started, the picture is automatically


changed every 10 seconds.

Rev: 2, 6 Feb 2005 Page 22 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

4.5 Help Page

Click the Help button to display the system help file:

The default help file is blank. The intention is for you to replace it with your own help file for
your project.

The help file is stored in the following location:

<Your WinCC Project Folder> \ RA \ Help \ Index.html

This is a standard HTML text file. You can edit this file or replace it with your own file.

Rev: 2, 6 Feb 2005 Page 23 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

4.6 Loop-in-Alarm

4.6.1 Runtime
Loop-in-Alarm is a standard WinCC alarm logging function that allows you to open a picture
or faceplate for the selected alarm. Select the alarm in the alarm-logging list and click on the
loop-in-alarm button on the alarm control toolbar:

Loop-in-Alarm tool button

The faceplate for the device


that triggered the alarm is
opened up when the alarm
is selected in the alarm list
and the loop-in-alarm button
is pressed.

4.6.2 Configuration

In the alarm-logging editor select the message you want


to add this functionality to and open the properties dialog.

Enter the device name (tag name) as the parameter and


select the function “raLoopInAlarm”. This function is part
of the RA Script library and will open the faceplate for
the supplied tag name.

You must create the faceplate with the RA Faceplate


Builder for this function to work correctly.

Rev: 2, 6 Feb 2005 Page 24 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

4.7 Audible Alarms (Horn)

WinCC V6.0 makes it very simple to configure audible alarms. When a certain alarm is
triggered the system will write a tag to the PLC to sound a physical horn, or the PC will play
a sound file through the computer speaker.

Some functionality has been included in the template project already to make this even
simpler.

First, you must decide which alarm classes or groups (as configured in the WinCC Alarm
Logging editor) will trigger an audible alarm.

Next open the WinCC Horn Editor:

Select the alarm message class that is to trigger an Select the “RA-HORN” tag again, and select the sound
audible alarm, and select the tag “RA-HORN” (this tag file to play when an alarm is triggered (*.wav – the
is created by the template builder and is already linked template builder copies several example files into the
to the template pictures). project for you).

In runtime when an alarm is triggered (of the class you selected in the Horn
editor) the selected sound file will be played until the tag “RA-HORN” is
switched off.

The “Horn” button flashes red. Click this button to turn off the “RA-HORN”
tag and thus silence the sound file.

NOTE:
If you want to trigger a tag in the PLC for a horn connected to the PLC, then substitute the
tag “RA-HORN” with your own PLC tag. You will have to edit the template picture shown
above to be able to switch off the tag from WinCC.

Rev: 2, 6 Feb 2005 Page 25 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

4.8 RA WinCC Tag Debugger

The WinCC Tag Debugger is a simple utility for reading and writing runtime tag values in
various formats. It is intended for testing purposes.

Open the Tag Debugger from the “Tag Debugger” menu


in the default System menu.

Click on the ellipses (…) button to select the tag you


want to inspect. The regular WinCC tag selection dialog
is opened.

Once you select a tag its value will be displayed


dynamically in the bottom section.

If you select an analog value you can edit it in Decimal,


Octal or Hexadecimal.

Use the Binary Structure to toggle individual bits on and


off.

You can also edit text tags.

Rev: 2, 6 Feb 2005 Page 26 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

4.9 Split-Screen Configurations

It is possible to use the template in split-screen configurations. You need to configure your
video system with a desktop stretched across multiple monitors.

The most common configuration is to have two screens side by side. The default template
size is 1024x768 pixels, for which we normally use the picture “raMain.pdl” as the main
picture. With two screens it is 2048x768, and we simply open two copies of “raMain.pdl”
side by side. Do to this you need another picture file that displays the “raMain.pdl” picture
twice on one picture.

There are a few pre-configured pictures in the default template that do this already. Simply
select the one you want as the start picture for the project.

Picture Usage
raMain Standard single-screen configuration
raSplit_1x2 Two screens, one next to the other
raSplit_2x1 Two screens, one above the other
raSplit_2x2 Four screens, two rows by two columns

Open the computer properties in the WinCC


Explorer and select one of the start pictures listed
above.

Rev: 2, 6 Feb 2005 Page 27 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

4.10 Hierarchical Alarm Navigation

The Navigation Builder can be used


to create a hierarchical alarm
navigation menu.

This makes it easy to navigate


through the menu to the plant area
affected by current alarm activity:
drill down following the flashing
icons on the menu buttons until you
get to the relevant picture.

First you must configure the User


Defined alarm group messages to
match your plant and mimic
hierarchy.

Connect an internal status tag to


each alarm group as shown on the
left.

In the navigation builder enable the


“Menu item is linked to Alarm
Group Status tag” option and select
the same status tag in this dialog for
the menu button.

This is demonstrated in the RA Demo Project.

Rev: 2, 6 Feb 2005 Page 28 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

5 RA FACEPLATE BUILDER

The RA Faceplate Builder simplifies the process of creating device-specific faceplates. Each
faceplate is associated with an FB in Step7 and the corresponding tag structure created in
WinCC by the OS Compilation of the Step7 data.

The Faceplate Builder is explained in more detail in the accompanying document “RA
Faceplate Builder v1.1”.

You can get the latest revision of this document from www.allottware.co.za.

Rev: 2, 6 Feb 2005 Page 29 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

6 RA RECIPE MANAGER

The RA Recipe Manager is a simple recipe system include with RA v1.1. It is explained in
more detail in the accompanying document “RA Recipe Manager v1.1”.

You can get the latest revision of this document from www.allottware.co.za.

Rev: 2, 6 Feb 2005 Page 30 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

7 INCLUDED SCRIPT LIBRARY

There are many scripts included in the template project. Many of these scripts are used by the
template navigation and faceplate systems, and should not be edited or used directly in your
project.

There are several useful string manipulation functions and system functions that deal with the
registry, tag values and the operating system.

Please read the header blocks in the actual scripts for more detailed information.

The main functions you will use are:

Function Description
This is a blank function created by the template builder. Insert code in
ProjectStartup here that is to be executed at project startup. This function will
execute once only, and does not execute on WebNavigator clients.
This opens a picture in the main window. You must use this function to
raOpenPicture ensure compatibility with split-screen configurations and Web
Navigator.
raOpenPictureWithTagPrefix Open a picture. Apply a tag prefix to the entire picture.
raPopup Open a picture in a poup window.
Open a device faceplate. The faceplates are created with the RA
raPopupDevice
Faceplate Builder.
raLoopInAlarm Open a device faceplate from the alarm list (see Loop-in-Alarm section)

Rev: 2, 6 Feb 2005 Page 31 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

8 WIZARDS

Several Dynamic Wizards are available for the RA WinCC Template. These make certain
configurations in the graphics editor easier. When using the RA WinCC Template
framework, certain operations, like displaying a mimic or opening a popup faceplate, must be
done using the functions provided by the template. This ensures that the project remains fully
compatible with split-screen and Web Navigator configurations, as well as maintains
functionality such as the paging history.

Using Dynamic Wizards means that you do not need to know what functions or scripting to
use to perform these operations.

8.1 RA Wizards

The following wizards are included with the RA WinCC Template:

• Open Picture - Use this to open a new mimic in the main mimic window. You can select
the .PDL filename to diplay, and optionally supply a title to display as the mimic caption
(if no title is specified, the mimic filename is used).
• Open Picture (Tag Prefix) – Use this to open a new mimic in the main window with a
tag prefix assigned to the entire mimic.
• Open Popup - Use this to open a new popup window. You can select the .PDL filename
to open in the popup window, and optionally supply a title and tag prefix to apply to the
windwo).
• Open Popup (Device) - Use this to open a new popup window for a structured-tag
device. The structured tag must be selected, which must conform to the PCS7-style
naming conventions (this includes text tags that indicate what .PDL file to use).

Rev: 2, 6 Feb 2005 Page 32 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

8.2 How to Load the Wizards

I haven't yet figured out how to automatically load the RA Wizards for you yet, so you'll have
to load them manually before you can use them.

First, you must copy the Dynamic Wizard files from the RA CD, in the following location:

< CDROM >\RA\RA\runimage\templates\@Default\WScripts\Wscripts.enu

Paste these files into the WinCC wizard folder:

< SYSTEM >\Program Files\Siemens\WinCC\WScripts\Wscripts.enu

Next, install the optional "Dynamic Wizard Editor" from the WinCC CD, and open it:

Click on the compile button as shown above, and the RA Wizards will become available.

Rev: 2, 6 Feb 2005 Page 33 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

8.3 How to Use the Wizards

The Wizards are accessed from the WinCC Graphics Editor. If the Dynamic Wizard window
is not visible, enable it from the "View"-> "Toolbars" menu option:

You will then see the Dynamic Wizard toolbar:

You must have a picture opened. Select an object, such as a button, and then double-click on
the Dynamic Wizard you wish to run. You will be prompted to fill in certain parameters, such
as tag names or picture names, and then the Wizard will fill in any scripting or dynamics
required.

Rev: 2, 6 Feb 2005 Page 34 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

8.4 Example Usage

Make sure the Dynamic Wizard toolbox is open and select a button in the WinCC Graphics
Editor. The following example shows how to use the wizard to open a device faceplate.

Select the “Open Popup (Device)” wizard.

Double-click to run the wizard.

Select the action on which to open the faceplate. Here


we select “Mouse click” which will respond when the
user clicks the button with any mouse button.

Now click on the button (…) to select the tag from the
WinCC tag selection dialog.

Click Next when you have selected a tag.

The wizard displays the tag name for confirmation.

Click Finish to generate the script required to open the


device faceplate for the selected tag.

Rev: 2, 6 Feb 2005 Page 35 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

9 CREATING YOUR OWN TEMPLATES

This will be addressed in the next release.

Rev: 2, 6 Feb 2005 Page 36 of 37 RA Add-On for WinCC


User Manual RA Add-On for WinCC v1.1

10 RA DEMO PROJECT

The RA Demo Project is an example implementation of the RA Template project using the
Navigation & Faceplate builder in an integrated Step7/WinCC environment.

The project includes examples of: Step7/WinCC integration, function blocks with
corresponding faceplates, process and system diagnostics, AS-triggered alarming and many
WinCC scripting examples.

More detailed help on the RA Demo Project will be included in the next release.

Please visit www.allottware.co.za for the latest information.

Demo project with faceplates, trending & alarming all published to the web

Rev: 2, 6 Feb 2005 Page 37 of 37 RA Add-On for WinCC

You might also like