InTouch HMI Getting Started Guide

InTouch HMI

Getting Started Guide

The Schneider Electric industrial software business and AVEVA have

merged to trade as AVEVA Group plc, a UK listed company. The

Schneider Electric and Life is On trademarks are owned by

Schneider Electric and are being licensed to AVEVA by Schneider

Electric.

No part of this documentation shall be reproduced, stored in a

retrieval system, or transmitted by any means, electronic,

mechanical, photocopying, recording, or otherwise, without the

prior written permission of AVEVA. No liability is assumed with

respect to the use of the information contained herein.

Trademarks

Although precaution has been taken in the preparation of this

documentation, AVEVA assumes no responsibility for errors or

omissions. The information in this documentation is subject to

change without notice and does not represent a commitment on

the part of AVEVA. The software described in this documentation is

furnished under a license agreement. This software may be used or

copied only in accordance with the terms of such license

agreement.

ArchestrA, Avantis, DYNSIM, eDNA, EYESIM, InBatch, InduSoft,

InStep, IntelaTrac, InTouch, PIPEPHASE, PRiSM, PRO/II, PROVISION,

ROMeo, SIM4ME, SimCentral, SimSci, Skelta, SmartGlance, Spiral

Software, WindowMaker, WindowViewer, and Wonderware are

trademarks of AVEVA and/or its subsidiaries. An extensive listing of

AVEVA trademarks can be found at: http://sw.aveva.com/legal. All

other brands may be trademarks of their respective owners.

Publication Date: October 2018

Contents

Welcome to InTouch HMI ......................................................................... 5

Installing InTouch HMI .................................................................................. 5

InTouch Licensing ........................................................................................... 5

Working with InTouch HMI....................................................................... 7

Working with Traditional InTouch HMI................................................... 7

Creating Modern Applications with ArchestrA Graphics................. 8

Adding ArchestrA Symbols to Modern Applications .................... 9

Creating Managed Applications .............................................................10

Integrating ArchestrA Objects with InTouch...................................10

Working with the ArchestrA Symbol Editor....................................11

Comparing Different Types of InTouch Applications ......................15

Connectivity with OI Gateway and OPC ...............................................16

Creating Modern Applications...............................................................17

Creating a Modern Application...............................................................17

Editing a Modern Application..................................................................20

Adding Symbols to a Window .............................................................23

Creating InTouch Tags .............................................................................25

Creating a Window Script......................................................................27

Configuring Symbols...............................................................................29

Changing Symbol Labels........................................................................33

Running a Modern Application...............................................................34

Getting More Information About Modern Applications................37

Managing a Modern Application........................................................37

Configuring a Modern Application....................................................37

Creating Managed Applications............................................................39

Starting the ArchestrA IDE.........................................................................40

Starting the ArchestrA IDE from the Start Menu ..........................40

Creating a Galaxy ..........................................................................................40

Deploying Your Application Objects .....................................................42

Editing a Managed Application...............................................................43

4 Contents

Embedding ArchestrA Symbols into an InTouch Managed

Application Window ................................................................................46

Connecting Attributes to an ArchestrA Symbol................................48

Viewing InTouch Applications Remotely .............................................50

InTouch Access Anywhere......................................................................50

InTouch Web Client ..................................................................................51

Getting More Information.......................................................................53

Welcome to InTouch HMI

InTouch HMI continues the tradition of market leadership in

Human Machine Interface (HMI) applications. This booklet

gives you a quick overview of the major features of InTouch

HMI and explains the essential tasks to create several types of

InTouch applications.

Installing InTouch HMI

The simplified installation process makes installing InTouch

easier than ever.

The major decision you must make when you install InTouch

HMI is whether to install the InTouch development and

run-time components, or the run-time components alone.

The installation program guides you in selecting the features

you want, verifying or modifying your selections, installing

prerequisite software, and then installing InTouch HMI. For

detailed information about installation, refer to the Installation

Guide.

InTouch Licensing

A valid product license is required to enabled InTouch

functionality. The Schneider Electric License Server and

Schneider Electric License Manager are automatically selected

when you select Wonderware InTouch during installation.

Note If you are using a workgroup, the Schneider Electric

License Manager and License Server must be installed on the

same node.

You will need to activate your InTouch licenses before using

WindowMaker or WindowViewer. For detailed information

about license activation, refer to the Schneider Electric Licensing

6 Welcome to InTouch HMI

Guide. It is also available on the Schneider Electric License

Manager node as a PDF file, under the Schneider Electric start

directory, after installation is complete.

Working with InTouch HMI

This chapter describes the steps to create the following types

of InTouch HMI applications:

• Stand-alone Applications

• Modern Applications

• Managed Applications

Working with Traditional InTouch HMI

The following figure shows the components to create

stand-alone InTouch HMI applications, which consist of

Application Manager, WindowMaker, and WindowViewer.

You create and manage stand-alone applications with InTouch

Application Manager. You develop stand-alone applications

with WindowMaker and run them from WindowViewer. You

can switch directly between WindowMaker and WindowViewer

to test or run your applications and switch back to make

modifications to your applications.

Application

Manager

Stand-alone

Applications

Creates Manages

Starts

BuildsStarts Runs

WindowViewerWindowMaker

Starts

8 Working with InTouch HMI

Creating Modern Applications with ArchestrA

Graphics

A Modern application uses the same components as

stand-alone InTouch applications. Modern applications

combine the familiar workflow of stand-alone InTouch

applications with the capability inherent in ArchestrA symbols.

The following figure summarizes the workflow of creating,

building, and running stand-alone and Modern applications.

Modern InTouch applications give you the capability to easily

integrate ArchestrA symbols directly into your applications.

You simply drag ArchestrA or Situational Awareness Library

symbols from WindowMaker’s ArchestrA Graphic Toolbox into

Modern application windows. All configuration steps to

configure symbols are completed from InTouch

WindowMaker. You can also access selected ArchestrA

Symbols from an InTouch Modern application using the

InTouch Web Client.

Creating Modern Applications with ArchestrA Graphics 9

Adding ArchestrA Symbols to Modern Applications

After you have created a Modern

application, WindowMaker’s

ArchestrA Graphic Toolbox

includes separate folders

containing the ArchestrA Symbol

Library and Situational Awareness

Library of predefined symbols. The

ArchestrA Symbol Library contains

realistic symbols of standard

industrial objects.

Situational Awareness Library

symbols are configurable symbols

designed to enhance an operator's

situational awareness of current

process conditions using highly

efficient visual techniques and

best practices.

Situational Awareness Library symbols have a

simplified look and provide minimum visual

detail to efficiently convey their functional

purpose and status without showing irrelevant

information to operators.

Most Situational Awareness Library symbols

are designed as Symbol Wizards that

incorporate multiple visual and functional configurations in

each symbol. Selecting a configuration for a symbol is a simple

matter of selecting options from a list without the burden of

extensive design work. Also, Situational Awareness Library

symbols provide faster application run-time performance

because of their lightweight design and simple appearance.

10 Working with InTouch HMI

Creating Managed Applications

You have a choice of how you create your InTouch

applications. You can create stand-alone and Modern InTouch

applications with the Application Manager and develop them

with WindowMaker.

InTouch HMI shares the ArchestrA Integrated Development

Environment (IDE) with Wonderware Application Server. You

can also create managed InTouch applications from the

ArchestrA IDE using ArchestrA symbols and automation

objects.

The ArchestrA IDE includes a suite of graphic tools and

automation objects to build simple or complex system

environments. Using automation objects, you can integrate

your InTouch applications much more easily into the

Wonderware System Platform. Also, you can embed pre-built

ArchestrA and Situational Awareness Library symbols into your

applications or use a wide assortment of tools from the

ArchestrA Graphic Toolbox to create your own symbols.

Using the ArchestrA IDE to manage your InTouch applications,

you can:

• View which applications are running on individual Galaxy

nodes.

• Use a central repository to manage applications.

• Deploy application changes to WindowViewer nodes

running InTouch applications.

Integrating ArchestrA Objects with InTouch

An ArchestrA Galaxy is your specific production environment

to run your managed InTouch applications. A Galaxy includes

all computers and components. It is a collection of platforms,

engines, application objects, templates, instances, and

attributes you define as the parts of your specific application.

This collection is stored in a Galaxy database on a node called

the Galaxy Repository (GR).

Creating Managed Applications 11

ArchestrA manages your InTouch applications with a specific

type of ArchestrA object called the InTouchViewApp

application object, which is derived from the ArchestrA

$InTouchViewApp base template.

After you derive a new InTouchViewApp template from the

$InTouchViewApp base template, you can associate the

InTouchViewApp template with an InTouch application by:

• Creating a new InTouch application.

• Importing a stand-alone InTouch application.

An InTouchViewApp template represents one specific InTouch

application at design time and cannot be executed at run time.

You deploy an instance of your derived InTouchViewApp

template to a target node to run your InTouch applications.

The target node is the node on which the managed InTouch

application can run in WindowViewer. To distribute your

InTouch application, you can create multiple instances of the

same InTouchViewApp template and deploy them to multiple

nodes.

Working with the ArchestrA Symbol Editor

You can create ArchestrA symbols from basic elements such as

rectangles, lines, circles, or text much like graphics created

from WindowMaker. The ArchestrA Symbol Editor also

includes other graphic tools to create more complex drawing

elements like closed curves, chords, and Windows controls.

ArchestrA Symbols are graphics

you can add to a Modern

application window to visualize

data in a production process. You

create ArchestrA symbols in the

ArchestrA Symbol Editor. You

select a basic graphical object

called an element from the Tools

panel and place it on the drawing

area called the canvas.

12 Working with InTouch HMI

Then, you can change the appearance of your drawn elements

either by accessing their properties directly, or by modifying

their physical appearance. You can configure the elements or

the symbol with animations.

The following figure shows the various tools and palettes of

the ArchestrA Symbol Editor that you use to create and

customize symbols

When you embed an ArchestrA symbol into an InTouch

window and the symbol is contained in an Automation

template, you can easily create a new instance of the

Automation object. The embedded symbol automatically

references the new object.

The following figure shows the integration of the ArchestrA

IDE with traditional InTouch components. The figure shows the

steps to create a managed InTouch application with the

ArchestrA IDE.

Creating Managed Applications 13

1 Create a managed InTouch application in the ArchestrA IDE

by deriving a template from the $InTouchViewApp base

template.

You create a managed application on one node of the

Galaxy with WindowMaker. Then, you deploy it to one or

more target nodes running WindowViewer.

2 Open the managed application in WindowMaker.

3 Develop your InTouch application in WindowMaker. If

needed, switch to WindowViewer to test the application.

4 Save the changes to the InTouch application.

5 Derive an instance of the managed application and select

the nodes to deploy the application.

6 Deploy the InTouch application to the target nodes

running WindowViewer in the Galaxy.

7 Run the application in WindowViewer on target nodes.

After you build your managed application from the ArchestrA

IDE, you can publish it. A published InTouch application is no

14 Working with InTouch HMI

longer associated with the InTouchViewApp template and

cannot be edited from the ArchestrA IDE. But, a published

InTouch application can still communicate with the Galaxy by

any embedded ArchestrA symbol. You can write data back to

the Galaxy or visualize Galaxy data with the ArchestrA symbol.

Comparing Different Types of InTouch Applications 15

Comparing Different Types of InTouch

Applications

The following table shows some major similarities and

differences between different types of InTouch applications.

Tasks

Types of InTouch Applications

Stand-Alone Modern Managed

Main Use Tag based and

native symbols

Tag based and

ArchestrA

symbols

Object based and

ArchestrA symbols

Create an

Application

Manager

Application

Manager

ArchestrA IDE

•New

applications

•Import

stand-alone

applications

• Import

SmartSymbols

Edit an

Application

WindowMaker

started from

Application

Manager

WindowMaker

started from

Application

Manager

WindowMaker

started from the

ArchestrA IDE

Delete an

Application

Delete folder and

remove from

Application

Manager

Delete from

Application

Manager

Delete

InTouchViewApp

template

Publish an

Application

Yes, from

WindowMaker

Yes, from

Application

Manager

Yes, from

ArchestrA IDE

Create

ArchestrA

Symbols

No Yes Yes

Incorporate

ArchestrA

Symbols

No Yes, can be

added, edited,

and viewed from

an application

Yes, can be added,

edited, and viewed

from the ArchestrA

IDE

Incorporate

ArchestrA

Objects

No No Yes

16 Working with InTouch HMI

Connectivity with OI Gateway Communication

Driver and OPC

OI Gateway (Operations Integration Supervisory Gateway

Communication Driver) is included with the InTouch HMI.

When the InTouch HMI is installed, an InTouch Access Name is

created for OI Gateway, pointing by default to the localhost.

OI Gateway streamlines OPC (OLE for Process Control) and

OPC UA (Unified Architecture) setup, enhancing device

integration. OI Server Manager also is included, providing the

SMC (System Management Console) as an interface for

configuring the Gateway and OPC.

OI Gateway requires configuration using the SMC (System

Management Console). OPC and OPC UA Servers require a

separate installation.

Creating a Modern Application 17

Creating Modern

Applications

You create and build Modern InTouch applications using the

familiar workflow of stand-alone InTouch applications.

The major difference between Modern and stand-alone

applications is the ability to incorporate ArchestrA symbols

directly into Modern applications. When you are creating a

window for a Modern application, you simply drag ArchestrA

or Situational Awareness Library symbols directly from

WindowMaker’s ArchestrA Graphic Toolbox into a window.

All configuration steps to use ArchestrA Graphics are

completed from InTouch WindowMaker. You do not need to

use the ArchestrA IDE to create a Modern application

containing ArchestrA or Situational Awareness Library

symbols.

Creating a Modern Application

You create a Modern InTouch application from InTouch

Application Manager.

To create a Modern application

1 Click Start on your Windows desktop and click InTouch

to start Application Manager.

2 Select New by one of the following methods:

18 Creating Modern Applications

a Select New from the File menu.

b Right-click within Application Manager and select

New

from the shortcut menu.

c Select the

New icon from the menu bar.

d Press the Ctrl + N keys.

The Create New Application wizard appears with

options to create a Modern application, Modern

application from template, or legacy application.

Creating a Modern Application 19

3 Select Modern InTouch Application.

Select Modern InTouch Application and the Use

application template

option to create a Modern

application from an application template.

The Application Template Browser will appear.

Select your application template and click

OK.

4 Click

Next.

The Create New Application wizard updates to show a

field to enter a base directory path to save InTouch

applications.

5 Click

Browse and select a directory path.

6 Click Next.

The

Create New Application wizard updates to show a

field to enter the name of the folder for the new Modern

application being created.

It also updates with fields to select the application target

resolution.

7 Type the name of the folder and specify a target resolution

if different than the default screen resolution.

Options for the target resolution are as follows:

20 Creating Modern Applications

a Click the Select target resolution dropdown menu to

view a list of predefined target resolutions.

b Click the

Select target resolution dropdown menu

and select

Custom. The Pixel width and height fields

become editable. The boundary limits are 150x150 to

10000x10000.

8 Click

Next.

The Create New Application wizard updates to show

fields to enter a name and a description of a new Modern

application.

9 Type “Chocolate Milk” as the name of the Modern

application in the Name field.

10 If you want, enter an optional description of the

application in the

Description field.

The description appears in the Description column of

Application Manager’s list of applications.

11 Click

Finish.

A horizontal bar shows the progress of creating a new Modern

application.

After a Modern application is created, it appears in Application

Manager’s list of applications. The

Application Type column

identifies the application as Modern.

Editing a Modern Application

Opening and editing a Modern application is similar to a

stand-alone InTouch application. You open a Modern

application from the InTouch Application Manager and edit it

in WindowMaker.

This section demonstrates the basic steps to build a Modern

application. The figure below shows a window from a simple

Modern application that combines and mixes the ingredients

to make chocolate milk. Complete the procedures in this

section to learn the over all workflow to build Modern

applications.

Editing a Modern Application 21

In the window, the Alarm Viewer control and the lines that

represent pipes are traditional InTouch graphic elements. All

other graphics elements shown in the window are ArchestrA or

Situational Awareness library symbols that can be used in

Modern applications.

22 Creating Modern Applications

To edit a Modern application

1 Open InTouch Application Manager.

2 Double-click on the Chocolate Milk application to edit it.

The first time you open an InTouch application in

WindowMaker no windows have been created.

3 Right-click on Windows in the Windows & Scripts area

of WindowMaker and select New Window from the

shortcut menu.

4 Assign “Mixing Station” as the name of the window in the

Name field of the Window Properties dialog box.

5 Set the width and height of the window by entering values

in the

Window Width and Window Height fields.

6 Change the default background of the window to a lighter

color by clicking

Window Color and selecting a color

from the

Standard Palette.

Editing a Modern Application 23

7 Click OK.

The window you created appears in WindowMaker.

Continue with the next procedure to add symbols to the

window.

Adding Symbols to a Window

Modern applications use a drag and drop method to add

symbols from the ArchestrA Graphic Toolbox to a window.

This procedure explains how to add the following symbols to

the window you created earlier:

• Situational Awareness Library

• 3 valves (Valves folder, SA_Valve_2Way)

• 1 vessel (Equipment folder, SA_Tank_Vessel)

• 1 meter (Meters folder, SA_Meters)

• 1 simple trend (TrendPen folder, SA_Trend)

• 1 agitator (Equipment folder, SA_Agitator_Settler)

• ArchestrA Symbol Library

• 3 rocker switches (Switch folder, RockerSwitch)

• InTouch Wizards

• 1 alarm viewer control (AlarmViewerCtrl)

• InTouch Graphic Toolbar

• 3 lines that represent pipes

24 Creating Modern Applications

To add symbols to a Modern Application

1 If necessary, open the Mixing Station window you created

in WindowMaker.

2 Expand the Situational Awareness Library folder in the

ArchestrA Graphic Toolbox to show the list of folders.

3 Open the

Valves folder and select the SA_ISA_2WValve

symbol.

4 Keeping your left mouse key pressed, drag the symbol to

the open window and release the key at the approximate

location where you want to place the symbol.

5 Select the symbol and place it precisely where you want it

to appear in the window.

6 Repeat steps 3-5 and add the remaining ArchestrA and

Situational Awareness Library symbols listed on the

previous page.

The list of symbols on the previous page includes the

folders in the ArchestrA Graphic Toolbox where the

symbols are located.

7 Click the

Wizards icon from the WindowMaker menu bar

and select AlarmViewerCtrl from the ActiveX Controls

group.

8 Click

OK and place the Alarm Viewer control near the top

of the window.

9 Select the Line tool from the WindowMaker graphic tool

bar.

10 Draw three lines that represent the two input pipes and the

output pipe.

11 Click

Line from the menu bar and select a thicker line type

to make your lines look more like pipes.

Editing a Modern Application 25

12 Arrange the graphic elements on your window to look like

the following example of a chocolate milk mixing station.

Creating InTouch Tags

Like a traditional stand-alone InTouch application, a Modern

application represents an industrial process using data

associated with InTouch tags.

In this simple application, tag data will be shown or used to set

the state of the symbols that represent the equipment of a

mixing station.

This procedure explains how to create the following tags for a

mixing station Modern application:

Tag Tag Type

Symbol

Association

Tank_Level Memory Integer Mixing Tank

Valve_Chocolate Memory Discrete Chocolate Valve

Valve_Milk Memory Discrete Milk Valve

Valve_Outlet Memory Discrete Outlet Valve

Agitator_RPM Memory Integer Tank Agitator

26 Creating Modern Applications

To create InTouch tags

1 On the Special menu, click Tagname Dictionary.

2 Click

New. The Tagname field clears.

3 Type Tank_Level in the

Tagname field.

4 Click Type to show the various types of InTouch tags.

5 Select

Memory Integer as the type of tag.

6 Click

Alarms near the top of the Tagname Dictionary to

expand the dialog box to show fields to set alarm

conditions.

7 Select

High and set 1400 in the Alarm Value field.

8 Click

Save.

9 Repeat steps 2-4 to create the three valve tags.

a Enter the name of the valve tag in the

Tagname field.

b Set the tag type to Memory Discrete for all three valve

tags.

c Click

Save to save each valve tag.

10 Create the Agitator_RPM tag using the same steps (2-8)

used to create the Tank_Level tag.

a Enter Agitator_RPM as the name of the tag.

b Set the tag type to Memory Integer.

c Select

High and set the Alarm Value field to 1500.

Editing a Modern Application 27

Creating a Window Script

A window script sets the operating conditions of the

Chocolate Milk application while it is running in

WindowViewer:

• When the Chocolate or Milk valves are open and the

Outlet valve is closed, the tank fills with ingredients.

• When the Chocolate or Milk valves are open and the

Outlet valve is open, the tank volume remains constant.

• When the Chocolate and Milk valves are closed and the

Outlet valve is open, the chocolate milk empties from the

tank.

• When the mixing tank level is less than 1500 liters and the

chocolate or milk values are open, the tank begins to fill

with ingredients.

• When is the tank level is greater than 500 liters and the

outlet valve is closed, the agitator begins to rotate.

• When the tank level falls to less than 500 liters and the

outlet valve is open, the agitator stops.

28 Creating Modern Applications

To create a window script

1 Right-click on a blank area of the Mixing Station window to

show a shortcut menu.

2 Select

Window Scripts from the shortcut menu.

3 Type or copy the following windows script into the Scripts

dialog box.

4 Set the Condition Type field to While Showing.

5 Set the

Every field to a value between 500-700

milliseconds.

The window script will run periodically at the interval you

set in the Every field.

6 Click

Validate to see if there are any errors in the script.

7 Correct any script errors and click

OK.

Editing a Modern Application 29

Configuring Symbols

ArchestrA symbols contain custom properties that extend the

standard properties of a symbol. In this sample application,

you must assign tags to custom properties to show the current

value of a tag or set the states when the equipment

represented by a symbol is active or inactive.

Most Situational Awareness Library symbols are also Symbol

Wizards. In addition to custom properties, Symbol Wizards

contain Wizard Options to configure their appearance and

functionality.

This procedure explains how to assign values to the custom

properties and Wizard Options listed in the following tables.

30 Creating Modern Applications

Symbol Custom Properties

Symbol Wizards

Symbol Custom Property Assigned Values

Chocolate

Rocker Switch

Value Valve_Chocolate

Milk Rocker

Switch

Value Valve_Milk

Outlet Rocker

Switch

Value Valve_Outlet

Chocolate Valve EquipmentStateActive Valve_Chocolate

Milk Valve EquipmentStateActive Valve_Milk

Outlet Valve EquipmentStateActive Valve_Outlet

Mixing Tank LabelVisible True

Tank Agitator PV Agitator_RPM

PVRangeFullScaleMax 3000

PVRangeFullScaleMin 0

Tank Volum e

Meter

PV Tank_Level

PVRangeFullScaleMax 1500

PVRangeFullScaleMin 0

Tank Volum e

Trend

Pen Tank_Level

Pen_RangeFullScaleMax 1500

Pen_RangeFullScaleMin 0

Alarm Client None N/A

Symbol Wizards Wizard Options

Assigned

Values

Chocolate Rocker

Switch

None-ArchestrA symbol N/A

Milk Rocker Switch None-ArchestrA symbol N/A

Editing a Modern Application 31

To configure custom properties and Wizard Options

1 Double-click on the Chocolate rocker switch to show the

Edit Symbol Properties dialog box.

Outlet Rocker

Switch

None-ArchestrA symbol N/A

Chocolate Valve ActuatorType Digital

Milk Valve ActuatorType Digital

Outlet Valve ActuatorType Digital

Mixing Tank QualityStatusIndicator False

Tank Agitator PVNumericDisplay True

EngUnits True

EngUnitsType StaticText

QualityStatusIndicator False

Tank Vol ume

Meter

Type Level

Tank Vol ume

Trend

SymbolMode Advanced

YAxisRangeType ClipOutOf

RangeValues

PlotType Line

Label True

LabelType StaticText

GridVerticalTimePeriod

Scale

True

GridVerticalTimePeriodSc

aleUnits

True

TimePeriod True

Alarm Client None N/A

Symbol Wizards Wizard Options

Assigned

Values

32 Creating Modern Applications

2 Select Value from the Name field.

3 Click the

Browse button at the right of the Default Value

field to show the Select Tag dialog box.

4 Select the Valve_Chocolate tag and click OK.

The current value of the Valve_Chocolate tag is associated

to the Chocolate rocker switch’s Value custom property.

5 Repeat steps 1-4 for the other two rocker switch symbols

and assign the tag shown in the Symbol Custom Properties

table to each symbol’s Value custom property.

6 Double-click on the Chocolate valve to show the

Edit

Symbol Properties

dialog box.

Editing a Modern Application 33

7 Using steps 1-4, assign the Valve_Chocolate tag to the

symbol’s EquipStateActive custom property.

8 Click the

Wizard Options tab.

9 Select ActuatorType from the Name field.

10 Set the

Value field to Digital and click OK.

11 Repeat steps 1-10 and assign values to the custom

properties and Wizard Options of the remaining symbols

of the Chocolate Milk application.

Changing Symbol Labels

The Symbol Wizards used in the Chocolate Milk application

have their Label Wizard Option set to True and the LabelType

Wizard Option set to StaticText. With this symbol

configuration, you can use the InTouch Substitute Strings

function to assign a visible static label for the symbols in the

Mixing Station window.

Symbol Current String

Application

Label

Chocolate Valve Label Chocolate

Milk Valve Label Milk

Outlet Valve Label Outlet

Mixing Tank Label Chocolate Milk

Agitator Label Agitator

EU RPM

Tank Meter Labe l Tank Vol ume

EU Liters

Trend Label Tank Volume

34 Creating Modern Applications

To change symbol labels

1 Right-click on the Chocolate valve symbol to show the

shortcut menu.

2 Select

Substitute and Substitute Strings from the

shortcut menu.

The Substitute Strings dialog box appears with fields to

substitute the current strings of the symbol.

3 Type Chocolate in the Label field and click OK.

The Chocolate label appears above the valve symbol.

4 Repeating steps 1-3, assign labels to the remaining

symbols you added to the Mixing Station window.

Running a Modern Application 35

Running a Modern Application

After you have finished, your Mixing Station window should

look like the following example.

You view a running Modern application from WindowViewer.

In this example, a window script begins running when viewing

the application. The script assigns states and values to the

assigned InTouch tags associated with the symbols shown in

the application’s window.

The following example shows the Chocolate Milk application

immediately after starting it in WindowViewer. All of the valves

are closed and the mixing tank is empty.

36 Creating Modern Applications

Typically, Situational Awareness Library symbols use fill

shading to indicate their current state. Open the Chocolate or

Milk valve by selecting a rocker switch. Notice the change in

the fill color that indicates the valve is open. Also, the fill color

of the agitator and meter symbols change to indicate they are

in an active state or showing a value.

When the tank volume reaches 500

liters, the agitator starts and its

current RPM appears next to the

agitator. Alarms occur if the tank

volume exceeds 1400 liters or the

agitator exceeds 1500 RPM. You manage alarms as you would

in a stand-alone InTouch application by selecting options from

the shortcut menu of the Alarm Viewer control.

Getting More Information About Modern Applications 37

Getting More Information About Modern

Applications

This section explained the basics of working with ArchestrA

symbols, custom properties, and Wizard Options to build a

Modern application. The InTouch HMI Modern Application

Guide provides more information that you need to manage

and configure your Modern applications.

Managing a Modern Application

The InTouch HMI Modern Application Guide includes a set of

concise procedures to manage your Modern applications from

InTouch Application Manager.

• Exporting and importing Modern applications

• Migrating to a Modern application

• Publishing a Modern application

• Deleting a Modern application

Configuring a Modern Application

The InTouch HMI Modern Application Guide explains how to

configure Modern applications using WindowMaker functions.

• Configuring Modern application languages

• Configuring the Application Style Library

• Configuring Alarm Priority Mapping

• Exporting ArchestrA graphics from a Modern application

• Importing ArchestrA graphics to a Modern application

• Exporting ArchestrA symbol text strings from a Modern

application

• Importing ArchestrA symbol text strings to a Modern

application

• Configuring NAD support

38 Creating Modern Applications

Creating Managed

Applications

When you install InTouch HMI, you can install several sample

applications. You can examine these sample applications to

understand how scripts, animations, and graphics work

together to provide a visual interface for your production

environment.

The following figure shows a portion of a window from the

InTouch reactor demonstration application.

The reactor application demonstrates how you manage an

application with the ArchestrA IDE and includes ArchestrA

symbols and objects.

The analog meter next to the product storage tank shows the

current volume of liquid stored in the tank. The meter is not

part of the standard reactor application.

This section describes the essential tasks to create a managed

InTouch application by showing how to embed this meter into

the Reactor application.

40 Creating Managed Applications

Starting the ArchestrA IDE

You can start the ArchestrA IDE from the Windows Start

menu.

Starting the ArchestrA IDE from the Start

The following procedure shows the steps to start the

ArchestrA IDE from a computer running Microsoft Windows 7

and later versions of Windows.

To start the ArchestrA IDE from the Windows Start

1 Click the Windows Start button.

2 Click the ArchestrA IDE icon from the list.

The

Connect to Galaxy dialog box appears.

Creating a Galaxy

After you start the ArchestrA IDE, the Connect to Galaxy

dialog box appears. The first time you start the ArchestrA IDE

you need to create a Galaxy, which is an ArchestrA database.

After that, you can select the Galaxy in which you are

developing managed applications each time you start the

ArchestrA IDE.

To create a Galaxy

1 Start the ArchestrA IDE. The Connect to Galaxy dialog

box appears.

Creating a Galaxy 41

2 Click New Galaxy. The New Galaxy dialog box appears.

3 Complete the fields of the

New Galaxy dialog box by

doing the following:

a Type the node name of the computer that serves as the

Galaxy Repository (GR). This is the computer where the

SQL Server database server is running.

b Type the name of the Galaxy that you are creating.

c Select

Reactor_Demo_InTouch. cab as the type of

Galaxy from the drop-down list of the Galaxy Type

box.

This is a custom Galaxy that includes the InTouch Reactor

Demo application.

4 Click Create. The New Galaxy dialog box shows the

progress of creating a new Galaxy.

5 Click Close after the new Galaxy is created.

6 Click

Connect to connect to the Galaxy you created.

The ArchestrA IDE dialog box appears.

7 Click the

Template Toolbox tab.

42 Creating Managed Applications

8 If necessary, click the ReactorDemo folder to show the

objects within it.

The

Template Toolbox shows the $ReactorDemo derived

template. You can use this derived template to create a

managed application or edit the application within

WindowMaker.

Note You can create a Managed InTouch application from and

application template. The procedure is similar to creating a Modern

InTouch application from a template. See the InTouch HMI and

ArchestrA Integration Guide for details.

Deploying Your Application Objects

Deploying your Galaxy copies the objects from your ArchestrA

development environment to a run-time environment. Until

you deploy your application’s objects from the IDE, you cannot

run your managed applications.

The pane at the bottom left of ArchestrA IDE includes three

tabs to show different views of your Galaxy objects. Selecting

the

Deployment tab shows the current status of all objects

that are part of your application. An orange square next to an

object indicates the object is undeployed.

To deploy your application’s objects

1 In the Deployment pane, right click on the name of the

Galaxy at the top of the list of application objects.

2 Select

Deploy from the shortcut menu.

The Deploy dialog box appears with options.

Editing a Managed Application 43

3 Accept the default options and click OK.

4 Click Close after all of your objects have been deployed.

The orange square next to each object is gone, indicating

that your application’s objects are deployed.

Editing a Managed Application

You edit a managed InTouch application by starting

WindowMaker from the ArchestrA IDE.

To start WindowMaker from the ArchestrA IDE

1 Open the ArchestrA IDE.

2 Click the Template Toolbox tab to show the set of

folders containing ArchestrA automation objects.

3 If necessary, click on the

ReactorDemo folder to expand

the list of automation objects within it. You see the

$ReactorDemo template.

44 Creating Managed Applications

4 Double-click on the $ReactorDemo template.

WindowMaker starts as the default editor. The figure

below shows WindowMaker after you initially open the

Reactor demonstration application for editing.

The Windows & Scripts area lists the windows that are

part of the Reactor demonstration application. This figure

shows the

Windows to Open dialog box to select the

windows you want to edit. You may have to open the

Windows to Open dialog box. Steps 5 and 6 explain how

to open the dialog box and select the Reactor application

windows.

5 Click

File, and then Open Window to show the Windows

to Open

dialog box.

Editing a Managed Application 45

6 Select the Main, Menu, and Reactor Display windows

from the list and click OK. Together, these windows make

up the main Reactor demonstration screen.

The following figure shows the portion of the Reactor

Demo window containing graphics that represent the

components of a reactor.

7 Increase the text size of the OUTPUT caption to the right of

the tank by doing the following:

a Click on the OUTPUT caption to select it and show the

text box sizing handles.

b Using your mouse, click on a sizing handle and keep the

mouse button pressed.

c Move the mouse to increase the size of the text box.

d Release the mouse button when the text is the size you

want.

8 Save your changes to the window.

9 Click

File, and then Exit. WindowMaker closes and you

return to the ArchestrA IDE. The Check In dialog box

appears.

46 Creating Managed Applications

10 Type a comment if you want, and then click OK.

11 Click

Close after the application is checked in.

You have made a round trip from the ArchestrA IDE to

WindowMaker and back to the ArchestrA IDE again. Now that

you understand the steps to edit a managed application from

WindowMaker, the next section explains how to embed an

ArchestrA symbol in an application window.

Embedding ArchestrA Symbols into an InTouch

Managed Application Window

You can embed an ArchestrA Symbol into the windows of your

managed InTouch application. You cannot embed ArchestrA

Symbols into windows of stand-alone applications.

The embedded symbol appears with its original name

appended by a number. The number increments each time you

embed the same symbol again.

To embed an ArchestrA Symbol from the Graphic

Toolbox

1 Open the ArchestrA IDE.

2 Double-click on the $ReactorDemo derived template to

open it in WindowMaker.

3 Show the main Reactor window.

4 On the

Edit menu, click Embed ArchestrA Symbol. The

Galaxy Browser appears.

5 Click the Graphic Toolbox icon. The symbols that belong to

the Graphic Toolbox are listed in the left pane.

6 Expand the list of the

ArchestrA Symbol Library folder.

Embedding ArchestrA Symbols into an InTouch Managed Application Window 47

7 Expand the Analog Meters folder. The meter symbols

within the folder appear in the right pane of the Galaxy

Browser.

8 Click on the AnalogMeter90Degree symbol and click

OK.

WindowMaker reappears.

9 Click to the right of the tank in the Reactor window to

embed the meter symbol. The meter symbol appears at

the window location you selected.

10 Click on the meter to select it. Sizing handles appear

around the border of the symbol.

11 Using your mouse, move the sizing handles to change the

size of the meter.

12 Reduce the size of the meter and position it near the top of

the tank.

Tip Press the SHIFT key to maintain the vertical and horizontal

perspective when you resize the meter.

13 Click the Runtime icon to run the application in

WindowViewer.

14 Verify the size of the meter and that it is aligned with the

top of the tank.

15 Click the

Development icon to return to WindowMaker.

48 Creating Managed Applications

Connecting Attributes to an ArchestrA Symbol

You can connect ArchestrA Symbol attributes to InTouch tags

by overriding the custom properties of an embedded

ArchestrA Symbol.

Custom properties expose the attributes of an ArchestrA

Symbol to InTouch. The custom properties may or may not be

used internally by the animations of the ArchestrA Symbol.

To connect an ArchestrA Symbol to an attribute

1 Double-click on the embedded meter. The Edit Custom

Properties

dialog box appears.

2 Select the Value property. Do the following to associate

an ArchestrA attribute to the meter:

a Remove the three hyphens from the Default Value

field.

b Click the browse button of the Default Value box. The

Select Tag dialog box appears.

c In the

Tag Source field, select Default Galaxy. The

Galaxy Browser dialog box appears with

StorageTank_001 listed in the

Instances column.

d Select StorageTank_001 to show a list of attributes.

e Select the ProdLevel attribute from the list and click

OK.

The Edit Custom Properties dialog box shows the

StorageTank_001 ProdLevel attribute assigned to the

Value property of the meter symbol.

Connecting Attributes to an ArchestrA Symbol 49

f Select the Max property from the Edit Custom

Properties

dialog box.

g Type 10000 in the

Default Value box.

h Click

OK to close the Edit Custom Properties dialog

box.

Any animation in the ArchestrA Symbol configured with

the selected custom property now uses the object

attribute value during processing.

3 Select the meter symbol you embedded.

4 Click Special, and then Substitute Strings to show the

Substitute Strings dialog box. Do the following to

change the labels that appear on the meter:

a Type the word Volume in the Label box.

b Type Liters in the Units box, and then click OK.

The face of the meter shows the labels you changed.

5 Save your work in WindowMaker.

6 Test your managed InTouch application by switching to

WindowViewer and running the Reactor application.

50 Creating Managed Applications

The analog meter symbol

you embedded in the

Reactor window shows the

same tank volume value as

the digital read-out at the

bottom of the tank.

During testing, changes

can be made to a symbol

even without checking in

the symbol. These

changes are propagated

to all places the symbol is

used and that switching to WindowMaker and then back to

WindowViewer accepts these changes. This is the quickest way

to develop a managed InTouch application with ArchestrA

symbols. After you place your application into production, you

can designate specific computers just to run your applications

in WindowViewer.

These procedures explained some of the essential steps to

create a managed application with the ArchestrA IDE. The next

section includes a set of tables that list other important tasks

and the books within the InTouch library that describes how to

complete these tasks.

Viewing InTouch Applications Remotely

InTouch HMI offers two methods to view InTouch applications

or graphics remotely.

• InTouch Access Anywhere

• InTouch Web Client

InTouch Access Anywhere

InTouch Access Anywhere provides you with remote access to

Wonderware InTouch applications from almost all devices that

support an HTML5 compatible web browser. Using InTouch

Access Anywhere, you can show WindowViewer running your

applications within a web browser on mobile phones, tablets,

laptops or desktop computers.

Viewing InTouch Applications Remotely 51

InTouch Access Anywhere is available as a separate installer.

For more information on how to install, configure and use

InTouch Access Anywhere, refer to the InTouch Access

Anywhere Server Administrator Guide.

InTouch Web Client

The InTouch Web Client feature allows you to view selected

ArchestrA graphics used within an InTouch HMI application on

any HTML5 compatible web browser. A built-in Web Server

provides web browsers access to application graphics, from

any Microsoft Windows client or server operating system

without the use of Remote Desktop Protocol (RDP) or Internet

Information Services (IIS) for Microsoft Windows Server.

You can view application graphics in a web browser for both

modern and managed applications. Using the InTouch Web

Client you can:

• Toggle between WindowMaker and the Web Client easily

with the Web Client Fast Switch

• View graphics on multiple devices and multiple screen

sizes

• Pan and zoom application graphics

52 Creating Managed Applications

• Host InTouch application graphics on external websites

The InTouch Web Client is licensed separately but installed as

part of the Wonderware InTouch HMI installation. For more

information on how to configure and use the InTouch Web

Client, refer to the Viewing InTouch Application Graphics in a

Web Browser guide.

Getting More Information

The InTouch HMI product library consists of a set of user

guides and an online help system. The design of InTouch

product information uses a task-based approach. This means

that books and help are organized by the typical tasks to build

an application using the InTouch HMI.

The following figure shows some of the typical tasks that are

part of developing an InTouch application. Each user guide

describes the specific tasks to set up functional aspects of an

InTouch application. The tasks to set up each of these

functional components are described in individual user guides

or in a chapter of a user guide.

The InTouch library is offered in two different media:

• Portable Document File (PDF), which can be viewed with

Adobe

Reader

. Each user guide is included on the

InTouch installation DVD as a PDF file.

• Online help, which can be viewed while an InTouch

application is running. The help is context-sensitive and is

also linked to all online InTouch information.

InTouch

Application

Set

Alarms

Enforce

Security

Write

Scripts

Draw

Graphics

Embed

Symbols

Use ArchestrA

Objects

Access Remote

Data

Define