Wonderware Guide To Creating Intouch Windows Programmatically

Wonderware Guide to Creating InTouch
Windows Programmatically
Wonderware Guide to Creating InTouch Windows Programmatically
Contents
Welcome .................................................................................................................................... 9
Documentation Conventions ...................................................................................................... 9
Technical Support ..................................................................................................................... 9
Chapter 1 Preparing an XML File...................................................................................... 11

About Preparing an XML File ................................................................................................... 11
Chapter 2 Using an XML File to Import a Window ......................................................... 13

About Using an XML File to Import a Window ........................................................................... 13
Preparing a Command File .................................................................................................... 14
Creating a Minimum Command File .................................................................................... 14
Sending Print Information to a File ...................................................................................... 14
Sending a Cross Reference to a File .................................................................................. 15
Creating a Log File ............................................................................................................ 15
Command Syntax.............................................................................................................. 15
Creating an Application ........................................................................................................... 17
Adding Tags to Newly Generated Application ............................................................................ 17
Deleting a Window .................................................................................................................. 17
Renaming a Window ............................................................................................................... 18
Importing a Window ................................................................................................................ 18
Handling Errors ................................................................................................................. 19
Missing SmartSymbols ...................................................................................................... 19
Missing ArchestrA Symbols................................................................................................ 19
Expressions, Tag Names, and Scripts ................................................................................ 19
Running WindowMaker from the Command Prompt .................................................................. 20
ArchestrA IDE Extension ......................................................................................................... 20
Running WindowMaker from Managed InTouc h Applications ..................................................... 20
Running DB Dump from the Command Prompt .......................................................................... 21
Running DB Dump for Managed InTouch Applications ............................................................... 22
Running DBLoad from the Command P rompt ........................................................................... 22
Running DBLoad for Managed InTouch Applications ................................................................. 23
Chapter 3 XML Formats...................................................................................................... 25

General XML File Format ........................................................................................................ 25
Using a Schema................................................................................................................ 25
XML File Header ............................................................................................................... 25
Extraneous XML Elements................................................................................................. 25
User-Supplied Text............................................................................................................ 26
Preserving Text White Space ....................................................................................... 26
3
Contents Wonderware Guide to Creating InTouch Windows Programmatically
Common Element Definitions ................................................................................................... 26

Color Elements ................................................................................................................. 26
RGB Elements ............................................................................................................ 26
Color Name Elements .................................................................................................. 26
Color Reference Elements ........................................................................................... 27
Color Value Elements .................................................................................................. 27
TextInfo Elements ............................................................................................................. 27
Point Elements .................................................................................................................. 28
Pen Elements ................................................................................................................... 28
Dimension Elements.......................................................................................................... 29
Expressions ...................................................................................................................... 29
Virtual Key Codes and Virtual Key Flags ............................................................................. 30
Window Element ..................................................................................................................... 32
Window Definition ............................................................................................................. 32
Activating Schema Validation ....................................................................................... 34
Window Scripts ................................................................................................................. 34
OnShow Window Script Element .................................................................................. 34
WhileShowing Window Script Element .......................................................................... 35
OnHide Window Script Element .................................................................................... 35
Window Objects ................................................................................................................ 35
Default Element Values................................................................................................ 36
Pen Style Limitations ................................................................................................... 37
Pen Dimensions .......................................................................................................... 37
Rectangle Object ......................................................................................................... 37
Rounded Rectangle Object .......................................................................................... 38
Ellipse Object .............................................................................................................. 40
Line Object.................................................................................................................. 41
Horiz ontal Line Object.................................................................................................. 41
Vertical Line Object ..................................................................................................... 42
Polyline Object ............................................................................................................ 43
Polygon Object ............................................................................................................ 44
Text Object ................................................................................................................. 45
Bitmap Object ............................................................................................................. 46
Trans parent Colors ...................................................................................................... 47
Bitmap Object Elements............................................................................................... 47
Button Object .............................................................................................................. 48
Smart Symbols ............................................................................................................ 50
Tag Replacement ........................................................................................................ 51
String Replacement ..................................................................................................... 51
SmartSymbol Example ................................................................................................ 51
ArchestrA Symbols ...................................................................................................... 52
CustomPropertyOverride ............................................................................................. 54
ArchestrA Symbol String Replacement Ty pe ................................................................. 55
Unsupported Window Objects ............................................................................................ 55
Window Animation Links .................................................................................................... 55
Script/Expression/ Tag Name Requirements Matrix ........................................................ 56
Discrete User Input ...................................................................................................... 57
Analog User Input ........................................................................................................ 59
String User Input ......................................................................................................... 60
Discrete Line Color ...................................................................................................... 61
Analog Line Color ........................................................................................................ 62
Discrete Alarm Line Color ............................................................................................ 63
Analog Alarm Line Color .............................................................................................. 64
Discrete Fill Color ........................................................................................................ 65
Analog Fill Color .......................................................................................................... 66
4
Contents Wonderware Guide to Creating InTouch Windows Programmatically
Discrete Alarm Fill Color .............................................................................................. 67

Analog Alarm Fill Color ................................................................................................ 68
Discrete Text Color ...................................................................................................... 70
Analog Text Color........................................................................................................ 70
Discrete Alarm Text Color ............................................................................................ 72
Analog Alarm Text Color .............................................................................................. 72
Vertical Slider .............................................................................................................. 74
Horiz ontal Slider .......................................................................................................... 75
Object Height .............................................................................................................. 75
Object Width ............................................................................................................... 76
Vertical Location.......................................................................................................... 77
Horiz ontal Location ...................................................................................................... 78
Vertical Percent Fill ...................................................................................................... 79
Horiz ontal Percent Fill .................................................................................................. 80
Discrete Pushbutton .................................................................................................... 81
Show Window Pushbutton ........................................................................................... 81
Hide Window Pushbutton ............................................................................................. 82
Visibility ...................................................................................................................... 82
Blink ........................................................................................................................... 83
Orientation .................................................................................................................. 84
Disable ....................................................................................................................... 85
Static Tooltip ............................................................................................................... 85
Dynamic Tooltip .......................................................................................................... 86
Discrete Value Display ................................................................................................. 86
Analog Value Display ................................................................................................... 87
String Value Display .................................................................................................... 87
Pushbutton Action Scripts .................................................................................................. 87
On Left Key Down/On Key Down .................................................................................. 88
While Left Key Down/While Key Down .......................................................................... 88
On Left Key Up/On Key Up .......................................................................................... 88
On Left Key Double Click ............................................................................................. 89
On Right Key Down/On Right Down .............................................................................. 89
While Right Key Down/While Right Down ...................................................................... 89
On Right Key Up/On Right Up ...................................................................................... 90
On Right Key Double Click ........................................................................................... 90
On Middle Key Down/On Middle Down ......................................................................... 90
While Middle Key Down/While Middle Down .................................................................. 90
On Middle Key Up/On Middle Up .................................................................................. 91
On Middle Key Double Click ......................................................................................... 91
On Mous e Over ........................................................................................................... 91
Left Key Equivalent ...................................................................................................... 92
Right Key Equivalent - Not Supported ........................................................................... 92
Middle Key Equivalent - Not supported ......................................................................... 93
Unsupported InTouch Features ................................................................................................ 93
Index ......................................................................................................................................... 94
5
© 2016 Schneider Electric Software, LLC. All rights reserved.
No part of this documentation shall be reproduced, stored in a ret rie val system, or transmitted by any
means, electronic, mechanical, photocopying, rec ording, or otherwise, without the prior written
permission of Schneider Electric Soft ware, LLC. No liability is assumed with respect to the use of the
information contained herein.
Although precaution has been taken in the preparation of this documentation, Schneider Electric
Software, LLC 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 Schneider
Electric Software, LLC. The software described in this documentation is furnished under a license
agreement. This software may be used or copied only in accordance wit h the terms of such license
agreement.
ArchestrA, A vantis, DYNS IM, eDNA, EYESIM, Foxboro, Foxboro E vo, I/A Series, InBatch, InduS oft,
InStep, IntelaTrac, InTouch, PIPEPHASE, PRiSM, PRO/ II, PROVIS ION, ROMeo, Schneider Electric,
SIM4ME, SimCentral, SimSci, Skelta, SmartGlance, Spiral Soft ware, VIS UAL FLA RE, WindowMaker,
WindowViewer, and Wonderware are trademarks of Schneider Electric SE, its subsidiaries, and
affiliated companies. An extensive listing of Schneider Electric Soft ware, LLC trademarks can be found
at: http://software.schneider-electric.com/legal/trademarks/. All other brands may be trademarks of
their respective owners.
Schneider Electric Soft ware, LLC
26561 Rancho Park way South
Lake Forest, CA 92630 U.S.A.
(949) 727-3200
http://software.schneider-electric.com/
Publication date: 11/21/2016
Contact Us
Contact Schneider Electric Software Technical Support
Avanti s Technical Support
Listing of regional and local country contacts: http://software.schneider -electric.com/support/avantis/
Technical support: http://softwares upport.schneider-electric.com/
For A vantis.PRO, A vantis Approvals, Avantis.DSS, and Condition Manager:
 Email: support.pro@avantis.net
 Phone (8:30 a.m. to 5:00 p.m. Monday to Friday, Eastern Ti me):
o Toll-Free U.S. and Canada: 1-888-262-7111
o Toll-Free EMEA: 1-800-4670-6466
o Direct dial: 1-905-632-0635
For A vantis. XA:
 Email: support.xa@avantis.net
 Phone (8:30 a.m. to 5:00 p.m. Monday to Friday, Eastern Time):
o Toll-Free EMEA: 1-800-4670-6466
o Direct dial: 1-905-632-4122
SimSci Technical Support
Listing of regional and local country contacts: http://software.schneider -electric.com/support/simsci/
Technical support: http://softwares upport.schneider-electric.com/
 Phone (USA 8:00 a.m. to 5:00 p.m. Central Time)
 Email U.S. and Canada: support.simsci@schneider-electric.com
Wonderware Technical Support
Listing of regional and local country contacts: https://www.wonderware.com/contact/contact -support/
Technical support: http://softwaresupport.schneider-electric.com/
 Priority email for Customer FIRS T Members: custfirstsupport@wonderware.com
 Email for customers without a support agreement: wwsupport@wonderware.com
 Phone
o Toll-Free North America and Latin Americ a: 1-800-966-3371
o Direct dial: 1-949-639-8500
InStep Technical Support
Cont act page: http://www.instepsoftware.com/contact-us
Technical support: https://support.instepsoft ware.com/
 Email: instepsupport@schneider-electric.com
 Phone (USA 8:00 a.m. to 5:00 p.m. Central Time)
o 1-312-894-7870
Schneider Electric – Smart Water Software Technical Support
 Help desk email: DK-HSO-Support@schneider-electric.com
 Help desk telephone hotline: +45 88 30 20 77 (09:00 to 16:00 Monday to Thurs day, Friday 09:00 to
15:00, Central European Time)
Contact Schneider Electric Software Learning Services
Cont act Software Learning Services for assistance regarding classes, schedule, offerings, frequently
asked questions, tuition, policies, and more.
 Email: software.training@schneider-electric.com
 Toll-Free U.S. and Canada: 1-866-998-7246
 Direct: 1-949-639-8508
 Fax: 1-949-639-1847
Welcome
You can import window definitions into InTouch applications using XML formatted files. How to create
an XML file is outside the scope of this guide.
This guide assumes you know how to create InTouch applic ations using WindowMaker.
This guide assumes you can create, format, and test XML files and know the general requirements for
using XML files.
You need to install Wonderware Application Server 3.1 before installing InTouch 10.1.050. If you have
InTouch 10.1 installed, uninstall it before installing InTouch 10.1.050.
You can view this guide online or you can print it, in part or whole, by using the print feature in Adobe
Acrobat Reader.
This guide assumes that you know how to use Microsoft Windows, including navigating menus, moving
from application to application, and moving objects on the screen. If you need help with these tasks,
see the Microsoft online help.
Documentation Conventions
This documentation uses the following conventions:
Convention Used for
Initial Capitals Paths and file names.
Bold Menus, commands, dialog box names, and dialog box

options.
Monospace Code samples and display text.
Technical Support
Wonderware Technical Support offers a variety of support options to answer any questions on
Wonderware products and their implementation.
Before you contact Technical Support, refer to the relevant section(s) in this docum entation for a
possible solution to the problem. If you need to contact technical support for help, have the following
information ready:
 The type and version of the operating system you are using.
 Details of how to recreate the problem.
 The exact wording of the error messages you saw.
 Any relevant output listing from the Log Viewer or any other diagnostic applications.
 Details of what you did to try to solve the problem(s) and your results.
 If known, the Wonderware Technical Support case number assigned t o your problem, if this is an
ongoing problem.
C HAPTER 1
Preparing an XML File
In This Chapter
About Preparing an XML File ......................................................................................................... 11
About Preparing an XML File

The following procedure describes how to create an XML file and import a window definition into an
InTouch application.
1. Create an XML file. This guide does not define the tools to use, or basic XML syntax.
2. Check the XML file for adherence to XML formatting standards. You can verify the syntax of your
XML file with the hel p of XML validation tools. To view your XML file, open it in Internet Explorer.
3. Prepare the tags in the application. You can use the InTouch DBDump and DB Load utilities to
extract, modify, and reload tags. For more information on DB Dump, DBLoad, and the CS V file, see
the InTouch Data Management Guide.
4. Prepare a WindowMaker command file to perform the functions you need to accomplish.
5. Exit from your InTouch application, WindowMaker, and WindowViewer.
6. Run the WindowMaker command file from a command line prompt, or run the command file from a
program or from an IDE extension.
7. Check for errors. If you defined an error log file, check it and check the ArchestrA Logger. If you
ran the command file from a program, check the return code.
The following sample files help you create and import window definitions using the XML import
functionality:
 Sample XML file that loads a window definition into an InTouch application.
 Sample command file.
 Two schema files. The import parser does not use these schema files. The schema files are more
restrictive than the XML import parser.
Note: Schema files are available in the InTouch installation folder aft er the installation is complete.
11
C HAPTER 2
Using an XML File to Import a Window
In This Chapter
About Using an XML File to Import a Window ................................................................................. 13
Preparing a Command File .......................................................................................................... 14
Creating an Application ................................................................................................................. 17
Adding Tags to Newly Generated Application ................................................................................. 17
Deleting a Window ........................................................................................................................ 17
Renaming a Window ..................................................................................................................... 18
Importing a Window ...................................................................................................................... 18
Running WindowMaker from the Command Prompt ........................................................................ 20
ArchestrA IDE Extension ............................................................................................................... 20
Running WindowMaker from Managed InTouc h Applications ........................................................... 20
Running DB Dump from the Command Prompt ................................................................................ 21
Running DB Dump for Managed InTouch Applications ..................................................................... 22
Running DBLoad from the Command P rompt ................................................................................. 22
Running DBLoad for Managed InTouch Applications ....................................................................... 23
About Using an XML File to Import a Window

You creat e a command file, and then run WindowMaker with the command file to import a window from
an XML file. In addition to importing a window, the command file can be used to:
 Create a new application.
 Delet e a window.
 Rename a window.
 Send print information to a file or printer.
 Send a cross reference to a file.
When the XML import is in progress, the following operations are not supported on a referenced
symbol:
 Deleting a symbol
 Renaming a symbol
 Swapping symbol names
However, you can perform these operations after the XML import is complete.
The following system level operations are not support ed:
13
Using an XML File to Import a Window Wonderware Guide to Creating InTouch Windows Programmatically
 Launching console sessions

 Switching focus to other applications
You can run the InTouch DB Dump and DB Load utilities from the command lin e. However, for managed
InTouch applications, run the DBDump and DB Load utilities from the ArchestrA IDE extension.
DBDump creates an export file containing tag information from an InTouch application. DB Load
imports tag information into an InTouch application. For more information about the DBDump and
DBLoad utilities, see the InTouch Data Management Guide.
Preparing a Command File

The WindowMaker command file is a text file. Commands are read from the file and then actions are
taken against the InTouc h application data set.
The command file uses the single-byte ANSI character set. You cannot use MultiByte Character Set
(MBCS) or Unicode characters.
Specifics of the text file syntax are:
 The 8-bit ANSI character set is used, but only characters under 127 are allowed. Most control
characters are stripped out.
 Lines that begin with the # character are treated as comments.
 Blank lines are ignored.
 Lines are terminated with a carriage return line feed (CRLF) sequence.
 Spaces can occur at the beginning of a line, at the end of a line, between the commands, the equal
character, and its argument.
 For any arguments requiring quotation marks, spaces are not allowed between the quot ation
marks and ot her text.
 All leading and trailing white space is removed before each line is processed.
 Each command starts with a period.
 Each command file must start with the WindowMaker command-file command
(.WINDOMAKE RCOMMANDFILE ).
A command file can contain multiple commands. If a command fails, the command processor
continues wit h the next command in the file.
Creating a Minimum Command File

An example of the minimum command file is:
.WINDOWMAKERCOMMANDFILE
.VERSION=1
Sending Print Information to a File

You can send a listing of the entire InTouc h application to a printer or to a text file. If the InTouch
window contains ArchestrA graphics then the output will be sent to an HTML file.
The following example command file prints application information to the printer named Printer01:
.VERSION=1
.PRINTAPPLICATIONINFORMATION
.OUTPUTTARGET=Printer
.OUTPUTTARGETNAME=Printer01
.GO
14
The following is an example command file that prints to a file. If the file exists, it is overwritten.
.VERSION=1
.PRINTAPPLICATIONINFORMATION
.OUTPUTTARGET=TextFile
.OUTPUTTARGETNAME=C:\MyApps\AppInfo.txt
.GO
Sending a Cross Reference to a File

You can create a cross reference and send it to a file. If the file exists, it is overwritten. No user
interaction is required.
An example command file:
.VERSION=1
.CROSSREFERENCE
.SEARCHFOR=TagName
.REFERENCETYPE=ByWindow
.OUTPUTFILE=C:\MyApps\AppCrossRef.Csv
.GO
Creating a Log File

You can log informational messages, warnings, and errors to a text file. If you do not specify this
command, the processing status is sent to the ArchestrA Logger. If the file already exists, it is
overwritten.
An example command file that logs errors to a file.
.VERSION=1
.COMMANDLOGFILE=C:\MyApps\LogFile.Txt
Ensure that the folder MyApps exists. If the folder MyApps does not exist, the log file is not created.
Command Syntax
The following table lists the commands you can use in a WindowMaker command file.
Command Description
.WINDOWMAKERCOMMANDFILE Identifies the file as being a WindowMaker

command file. If this command is not found,
the file is not processed and WindowMaker
exits with an error code.
.VERSION=1 This command indicates to WindowMaker

that the file is not too new to be read.
.COMMANDLOGFILE=<Full File Path> Information, warnings, and errors are logged

to this file. If the file already exists, it is
overwritten. If this command is omitted,
check the ArchestrA Logger for information
about the processing status.
.GO Runs the command. Required after a

command with one or more parameters.
15
Command Description
.WINDOWCREA TE Creates a window from an XML file.
.XMLFILEPA TH=<Full File Path> The full file path to an XML file containing a
window specification. Required when the
WINDOWCREA TE command is used.
.WINDOWDELE TE Delet es the specified InTouch application

window by name. An error is not generated
if the window name is not found.
.WINDOWNAME=<Window Name> Name of the window to delete. Required

when the WINDOWDELE TE command is
used.
.WINDOWRENAME Renames a window. If the 'old' name cannot

be found, the command issues a warning. If
the new name exists, an error message is
generated. If the window cannot be
renamed, an error occurs. If the old name
matches the new name, then nothing is
done.
.OLDWINDOWNAME=<Existing Window Current window name. Required when the

Name> WINDOWRE NAME command is used.
.NEWWINDOWNAME=<New Window Name> New window name. A window with this

name must not exist. Required when the
WINDOWRE NAME command is used.
.PRINTAPPLICA TIONINFORMA TION Prints or dumps the InTouc h application

data set to a text file. This is the same as
clicking the Print option on the File menu
commands from WindowMaker.
.OUTPUTTA RGE T=P rinter|TextFile Sends output to a printer or text file.
.OUTPUTTA RGE TNAME=<Print er Name of the printer or output file. If the file
Name>|<Full Text File Path> exists, it is overwritten.
.CROSS REFERE NCE Generat es cross reference information in

Comma Separat ed Variable (CSV ) format.
.SEARCHFOR= TagName|QuickFunctions Searches for tags or QuickFunctions by

name.
. REFERENCE TYPE= ByTagName|ByWindow Cross-references by tag or window name.
. OUTPUTFILE=<Full File Path> Full path to the output file. If the file exists, it
is overwritten.
16
Creating an Application
You can use a WindowMaker command file to create a new default InTouch application. You creat e a
blank application using the minimum command file. However, you cannot creat e a blank managed
InTouch application using the minimum command file. For more info rmation, see Creating a Minimum
Command File on page 14.
The command file must be placed in the folder where you want the application created. If the folder
contains an existing InTouch.ini file, the application is not generated.
The path to the new application folder cannot contain an embedded " -l" or "-L" string sequence. For
example, the folder C:\MyApps\App-Large cannot be created.
The created InTouch.ini file has contents similar to the following example. Window positions vary with
the screen resolution in which the application is shown. The application has the title and description
"Generated InTouch Application." The default language is English.
Example InTouch.ini file contents:
[InTouch]
AppMode=2
AppName0=Generated InTouch Application
AppName1=
AppName2=
AppName3=
AppDesc0=Generated InTouch Application
AppDesc1=
AppDesc2=
AppDesc3=
LanguageBase=English (United States)
LanguageBaseID=1033
InTouchView=0
SAOConverted=1
WinFullScreen=1
WinLeft=-4
WinTop=-4
WinWidth=1288
WinHeight=1004
SnapOn=1
Adding Tags to Newly Generated Application

A new InTouch application contains only system tags. If you need to add tags to an application before
importing a window, then:
1. Create a new application.
2. Run DBLoad to import tags to the new application.
3. Import the window.
For example:
WM.Exe C:\MyApps\App001 COMMANDFILE="C:\BlankFile.Txt"
DBLoad C:\MyApps\App001,C:\TagDumps\App001.Csv,0
WM.Exe C:\MyApps\App01 COMMANDFILE="C:\Commands.Txt"
Deleting a Window
If you add a window to an existing application that has a window with the same name, you must delete
the existing window. You can delete the existing window using the WindowMaker command file.
Important: An error message does not appear if the window selected to delete does not exist.
17
A message appears in the ArchestrA Logger if an existing window cannot be deleted. No user
interaction is required.
You enter a sequenc e of commands in your command file to delete a window from an InTouch
application. A command file can include several delete window command sequences.
The following example shows the command sequence to delete a window from an InTouch application:
.VERSION=1
.WINDOWDELETE
.WINDOWNAME=Window002
.GO
Renaming a Window
You can change the name of a window in an InTouch application.
You enter a sequenc e of commands in your command file to rename a window from an InTouch
application. A command file can include several rename window command sequences.
An error message does not appear if the window selected to be renamed does not exist.
If the new window name already exists, nothing is done, and a warning message is logged.
If the old name exists and the new name does not exist, but the rename fails for some other reason, an
error message is logged.
No user interaction is required. Warnings and error messages appear in the ArchestrA Logger.
If you rename a window with the name of an existing window, a warning message is logged in the log
file or the ArchestrA Logger. In the following example, renaming the Window005 to an existing window
Window006, logs a warning message in the log file or the Arc hestrA Logger.
.WINDOWRENAME
.OLDWINDOWNAME=Window005
.NEWWINDOWNAME=Window006
.GO
Importing a Window
You can import a window into an InTouch application. The full file path to the XML file containing a
single InTouch window's specification is required. The new window name is contained within the XML
file.
The window is not imported if:
 A window wit h the same name exists in the application.
 An unresolved error occurs in one of the window scripts.
 An unresolved error occurs trying to add any part of an object to the window.
User interaction may be required if:
 Elements specified in scripts or expressions contain errors or are missing.
 Scripts contain syntax errors.
It is possible that nothing is shown to allow a user to correct the problem. Examine the log file and the
ArchestrA Logger for details.
You enter a sequenc e of commands in your command file to import a window.
For example:
.WINDOWCREATE
.XMLFILEPATH=C:\WMCommandTest\WMCreateFile.Xml
18
.GO
A command file may contain more than one import window command and several create window
command sequences.
Handling Errors
Your XML file must follow general XML formatting rules. If you cannot open your XML file with Int ernet
Explorer, your XML file contains XML formatting errors. Fix all errors before using the file with
WindowMaker.
If you use a file containing general format errors, WindowMaker logs the error message " XML file could
not be loaded" in the ArchestrA Logger.
WindowMaker stops when any element is missing from a script, on any script error, or any other
element specification error occurs. For example:
 Missing tags
 Missing external WindowMaker script extension DLL
 Missing ActiveX cont rols
 Missing Wizard DLL
In some cases, such as for particular animation links or custom property overrides, no message box
appears if the tag is missing. A note is written to the ArchestrA Logger, the animation link and object
are not created, and the window is not created. In other cases, the script and ex pression parsing stops.
You are given an opportunity to create the tag, and if it is succ essfully created, processing continues.
Missing SmartSymbols
If a SmartSymbol template does not exist in the target application, the window is not imported. An error
message appears in the logger and the output text file.
If a SmartSymbol instance fails to be created for any reason, the window is not created. A
SmartSymbol import can fail even though the SmartSymbol template exists. There may be additional
information about the failure in the ArchestrA Logger.
Missing ArchestrA Symbols

If an ArchestrA Symbol reference does not exist in the Galaxy repository, the window is not created. An
error message appears in the ArchestrA Logger and the output text file.
The XML import process can fail even though the ArchestrA Symbol reference exists. Additional
information about the failure is logged in the ArchestrA Logger.
Expressions, Tag Names, and Scripts

When expressions, tag names, and scripts are required, they cannot be empty text, or text that is only
blanks. If these text items are not formulated correctly; the expression, tag name, or script do not pars e
correctly and result in an error.
In the case of tag names, the tag type must match the type expected for an object. In most cases, it is
possible to use dotfields to access tag properties. For example, the second bit of an integer tag
iTag005 can be accessed as:
iTag005.02
In this case, the tag and dot field evaluat es to a discrete value and can be used where a discrete tag
name is required, whereas the iTag005 alone would result in an error.
19
Running WindowMaker from the Command Prompt

You can run WindowMaker from the command prompt.
The command line is:
WM.EXE AppPath,Commandfile="Command.txt"
Parameters
AppPath
Defines the full path to the InTouch application. This parameter is optional if you are running
WindowMaker in the application’s folder.
CommandFile
Defines the full path to the command file. Quotation marks must enclose the pat h name. Extra
spaces are not allowed around the equal sign.
Suppose the InTouch application is in the C:\MyApps folder, and the command file is
C:\WMCommandFile.txt. The following example shows the WindowMaker command you enter from
the command prompt:
WM.EXE C:\MyApps,COMMANDFILE="C:\WMCommandFile.Txt"
Note: You cannot create managed InTouch applications from the command prompt.
ArchestrA IDE Extension

Use the ArchestrA IDE extension to run the InTouch XML import functionality for managed
applications. You can use the IDE extension to select a command file for the XML import process. After
you select a command file, WindowMaker starts up and the associated XML file is parsed.
Important: WindowMaker stops responding if you start a new console session or maximize an existing
console session when the XML import is in progress.
The ArchestrA IDE has a context menu item used to select a command file for the XML import. The
menu item Process InTouch Command File is shown in the context menu when you right click an
InTouchViewApp derived template. However, the menu item will not be shown, when you select:
 Multiple InTouchViewApp templates
 InTouchViewApp base template
 InTouchViewApp instance
If you migrate a managed InTouch application from older version of InTouch, then you must open the
InTouch application in WindowMak er at least once before processing the command file.
Running WindowMaker from Managed InTouch Applications

You can run WindowMaker from a managed InTouch application.
To run WindowMaker from a managed InTouch application
1. Open the ArchestrA IDE.
2. In the Template Toolbox, create a derived template from the InTouchViewApp template.
3. Associate an InTouch application with the derived template by creating a new InTouch application
or by importing an existing standalone InTouch application.
20
4. Right -click the derived template and then click Process InTouch Command File . The Open
InTouch Command File From: dialog box appears.
Note: The InTouchViewApp derived template must be configured in WindowMaker at least once,
before executing the Proce ss InTouch Command File command.
5. Browse to the location of the command file, and click Open. The WindowMaker starts up.
Running DBDump from the Command Prompt

You use DB Dump to extract tag information from an InTouch application. You can run DB Dump from
the command prompt. You must stop WindowMaker before running DB Dump.
Commas are required between DB Dump command parameters. Parameters are position dependent. If
you want to omit a parameter bet ween included parameters, you must include a comma for the missing
parameter. The following example shows the syntax of the DB Dump command when you run it from
the command prompt:
DBDump AppPath,CsvPath,GroupTypes,OverwriteCsvFile, MessageBoxes
Parameters
AppPath
Defines the path to the InTouch application.
CsvPath
Defines the path to the export file containing tag definitions from the Tagname Dictionary of the
InTouch application.
GroupTypes
Specifies whether tags are grouped in the DBDump export file by InTouch tag types. 1 indicates
the tag database names should be sorted by tag group type. 0 indicates the tag names are not to
be sorted by type.
OverwriteCsvFile
Specifies if the export file should be overwritten. 1 indicates the export file should be overwritten. 0
indicates the export file should not be overwritten.
MessageBoxes
Specifies whether messages appear when the DB Dump utility exports the contents of the
application's Tagname Dictionary. 1 indicat es the message boxes are to be displayed. 0 indicat es
message boxes are not to be displayed.
21
Example
Suppose the InTouch application is located in the C:\MyInTouchApps\App001 folder and you want
to write the cont ents of the tag database to the C:\TagDumps\App001.csv file. You do not want any
message boxes to appear, and you want to overwrite the target export file if it exists. The command is:
DBDump C:\MyInTouchApps\App001,C:\TagDumps\App001.Csv,1,1,0
Running DBDump for Managed InTouch Applications

You can run DB Dump for managed InTouch applications.
To run DBDump for a managed InTouch application
2. In the Template Toolbox, right-click an InTouchViewA pp derived template, point to Export, and
then click DB Dump. The CSV File to Dump To: dialog box appears.
3. Type the name of the CSV file and click Save. The application tag data is successfully dumped into
the CSV file.
Running DBLoad from the Command Prompt

You use DB Load to import tag information int o an InTouch application. You can run DB Load from the
command prompt. You must stop WindowMaker before running DBLoad.
DBLoad command paramet ers are position dependent, if you want to omit a parameter bet ween
included parameters, you must include a comma for the missing parameter. The following example
shows the syntax of the DBLoad command when you run it from the command prompt:
DBLoad AppPath,CsvPath,MessageBoxes
Parameters
AppPath
Specifies the path to the InTouch application.
CsvPath
Specifies the path to the file containing tag definitions to be imported into an application's Tagname
Dictionary.
MessageBoxes
Specifies whether messages appear when the DB Load utility imports the contents of the import file
into the application's Tagname Dictionary. 1 indicates the message boxes are to be displayed. 0
indicates message boxes are not to be displayed.
22
Example
Suppose the InTouch application is located in the C:\MyInTouchApps\App001 folder and you want
to read the tag database information from the C:\TagDumps\App001.Csv file. You do not want the
message boxes to appear. The following example shows the DBLoad command you enter at the
command prompt:
DBLoad C:\MyInTouchApps\App001,C:\TagDumps\App001.Csv,0
Running DBLoad for Managed InTouch Applications

You can run DB Load for managed InTouch applications.
To run DBLoad for a managed InTouch application
2. In the Template Toolbox, right-click an InTouchViewA pp derived template, point to Import, and
then click DB Load. The CSV File to Load From: dialog box appears.
3. Browse to locat e the CSV file and click Open. The tag data is successfully loaded into the InTouc h
application.
23
C HAPTER 3
XML Formats
You can import a window and most window elements defined in an XML file. Tags cannot be imported
from an XML file. You must use the DBLoad utility instead.
In This Chapter
General XML File Format .............................................................................................................. 25
Common Element Definitions ........................................................................................................ 26
Window Element ........................................................................................................................... 32
Unsupported InTouch Features ..................................................................................................... 93
General XML File Format

Your XML file must comply with all general XML formatting rules. You should be able to open your
XML file with Int ernet Explorer. If not, your XML file cont ains formatting errors.
Using a Schema
You can validate the XML file against the schema file. Validating your XML file with the schema file
detects most XML formatting errors.
The schema is more restrictive than the XML input parser.
 The schema requires the order of elements to match the order listed in the tables in this guide.
 Element names and values are case sensitive.
 In some cases, the schema requires an element to be ex plicitly defined.
You invoke schema validation in the window element. For information about how to specify a schema,
see Window Definition on page 32.
XML File Header

The XML declaration must be included at the top of the file. The minimal declaration is:
<?xml version="1.0"?>
Extraneous XML Elements

The InTouch XML import functionality does not generate errors or warnings for undefined elements,
attributes, or nodes.
You must type everything correctly. If you mean to have an <ONRIGHTDOWN> action script, but
accidentally type <ONRITEDOWN>, no warning is generated, and your action script is not added to the
window object.
Warnings and errors are creat ed for XML definitions that are missing required elements.
25
XML Formats Wonderware Guide to Creating InTouch Windows Programmatically
User-Supplied Text
If your script uses XML field delimit er characters, the script text must be encapsulated within a CDA TA
element. Text in a CDA TA element is not parsed by the XML file import functionality.
You can ent er text without enclosing it within a CDA TA element provided the text does not contain any
XML field delimiter characters.
Preserving Text White Space

When text not in a CDA TA element is processed, the leading and trailing spaces are removed. As a
result, an element such as <Title> MyWindowName</Title> results in a window name of
'MyWindowName' without leading spaces.
To preserve leading and trailing white space in any text, enclose the text within a CDA TA element. For
example, an element <Title><![CDA TA[MyWindowName]]></Title> results in a window name of
"MyWindowName".
Common Element Definitions

Some elements or definitions are shared by many elements.
Color Elements
Color elements can be specified by RGB value, name, reference value, or integer value. The color
elements are R, G, B, Name, Ref, and Value. These elements are used in other elements. For
example, FillColor, TextColor, and BGCOLOR.
RGB Elements
You use RGB values to specify a color. The values assigned to RGB elements range from 0 to 255.
When an element is missing, a default is used. The default depends on the window object.
Examples:
<FillColor>
<R>192</R>
<G>192</G>
192
</FillColor>
<TextColor> <R>0</R><G>0</G>0 </TextColor>
Color Name Elements

You can specify a color using a name supported by Int ernet Explorer version 3.0 or lat er. The color
name is case sensitive and must match a known HTML color.
The following web sites have a list of the color names and values:
http://www. w3schools.com/html/html_colornames.asp
http://www.learningwebdesign.com/colornames.html
http://www.oreilly.com/catalog/ wdnut/excerpt/color_names.html
The following web sites have a list of the color names:
http://www.geocities.com/SiliconValley/Pines/6986/colortbl.html
Examples:
<FillColor>
<Name>White</Name>
</FillColor>
26
<TextColor> <Name>White</Name> </TextColor>
Color Reference Elements

You can specify a color using a hexadecimal color value. The color value must always contain six
hexadecimal digits.
The following web sites list colors by name and their corresponding hex adecimal values:
http://www. w3schools.com/html/html_colornames.asp
http://www.learningwebdesign.com/colornames.html
This web site has a list of non-dithering color values:
http://www.htmlgoodies.com/tutorials/colors/article.php/3479001
This site has 4096 colors and their hex codes:
http://yorktown.cbe.wwu.edu/sandvig/MIS31 4/Assignments/A03/ ColorHexCodes.asp
Examples:
<FillColor>
<Ref>#FF00FF</Ref>
</FillColor>
<TextColor> <Ref>#FF00FF</Ref> </TextColor>
Color Value Elements

You can specify a color using a positive integer color value. The value must be in the range 0 to
16777215.
Examples:
<FillColor>
<Value>16711935</Value>
</FillColor>
<TextColor> <Value>16711935</Value> </TextColor>
TextInfo Elements
You can specify how text appears on the screen with the TextInfo element.
The following elements are available for specifying text:
Elements Description
Font Name of font families, such as 'System' or

'Arial'.
FontStyle Values can be {Regular, Italic, Bold,

BoldIt alic}.
FontSize Need to indicate font size unit of meas ure.

Usually, points. Values can be 0 or larger.
Underline Underlined text: {true or false}.
Strikeout Struck out text: {true or false}.
TextColor Color element for text color.
27
TextJustify Text justification: {Left, Center, or Right}
Example:
<TextInfo>
Arial
<FontStyle>Regular</FontStyle>
<FontSize>12</FontSize>
<Underline>false</Underline>
<Strikeout>false</Strikeout>
<TextColor>
<R>0</R>
<G>0</G>
0
</TextColor>
<TextJustify>Left</TextJustify>
</TextInfo>
Point Elements
You use a point element to define the position of other elements. Point elements contain two elements,
X and Y. X and Y elements must contain values in the range -32000 and 32000.
X Left coordinate in pix els. Required.
Y Top coordinate in pixels. Required
Example:
<Point>
<X>10</X>
<Y>25</Y>
</Point>
Pen Elements
You use pen elements to specify the line characteristics of an object's border.
The following elements are available for specifying the pen element:
Field Description
PenColor Uses color elements: RGB element, name

element, reference element, or value element.
PenWidth Pen widt h in pixels. Values can be 1, 2, 4, 6, 9,

or 11.
PenStyle Values can be None, Solid, Dash, Dot,

DashDot, DashDotDot.
28
Example:
<Pen>
<PenColor>
<R>0</R>
<G>0</G>
0
</PenColor>
<PenWidth>4</PenWidth>
<PenStyle>Solid</PenStyle>
</Pen>
Dimension Elements
The dimension element contains elements to specify the coordinates of the upper left corner of an
object on the screen. The dimension element also includes elements to specify the width and height of
a rectangular object.
In WindowMaker, the coordinate limits are -32000 to +32000 in both the vertical and horizont al
directions. If you specify a combination of X and Y location with width or height values that plac e the
calculated coordinates outside of a (-32000, -32000, 32000, 32000) boundary, a warning appears and
the values are clamped to the maximum values. Height and widt h values should be positive.
You use the following elements within a dimension element to specify an area on the screen.
Left Left edge coordinate. Required.
Top Top edge coordinate. Required.
Width Width in pixels.
Height Height in pixels.
Example:
<Dimension>
<Left>4</Left>
<Top>4</Top>
<Width>632</Width>
<Height>278</Height>
</Dimension>
Expressions
You enclose expression text in CDA TA sections. This prevents XML delimiters, whi ch are valid in
expressions, from causing file parsing to fail.
Example:
<EXPRESSION>
<![CDATA[
First line of expression text
Second line of expression text
N-th line of expression text
]]>
</EXPRESSION>
29
Virtual Key Codes and Virtual Key Flags

Some InTouch animation links support keyboard input.
The XML parser translat es the name of a virtual key into its virtual key code. Also, the flags for the
modifier keys are specified using text instead of numeric bit combinations. Key names are not case
sensitive.
InTouch applications can use the virtual key names listed in the following table.
Key Represented Virtual Key Names
ADD Add
Alpha Keys A through Z
BACKSPACE Backspace
CANCEL CtrlBreak
CLEAR Clear
Copy Copy
Decimal Decimal
DELE TE Delet e
Divide Divide
DOWN ARROW Down
Empty string means no assignment. <Blank>
END End
ENTER Return
ESC Escape
Execute Execute
F1 F1
F2 F2
F3 F3
F4 F4
F5 F5
F6 F6
F7 F7
F8 F8
F9 F9
30
F10 F10
F11 F11
F12 F12
F13 F13
F14 F14
F15 F15
F16 F16
HELP Help
HOME Home
INSE RT Insert
LEFT ARROW Left
MULTIPY Multiply
Numeric keys 1 through 9
Numeric Keypad 0 NUMPA D0
NUM LOCK NumLock
PAGE UP PageUp
PAGE DOWN PageDown
PRINT SCREEN Print
RIGHT A RROW Right
SELECT Select
31
Separator Separator
SPACEBAR Space
SUB TRA CT Subtract
TAB Tab
UP ARROW Up
Two modifier keys are supported. Modifier keys can be specified separately or in combination for the
CKEYFLAGS element. The modified name is the element value. A modifier key is applied as long as
the modifier name is in the attribute value string.
Name Key Represented
CTRL CONTROL key must be pressed

with regular key.
SHIFT SHIFT key must be pressed with

regular key.
CTRL + SHIFT Both the CONTROL and SHIFT

keys must be pressed.
To generate a CTRL+A sequence, the XML is:

<VirtualKeyType>
<KeyCode>A</KeyCode>
<KeyFlags>CTRL</KeyFlags>
</VirtualKeyType>
Window Element
You can include only a single window element in your XML file. The window element must be the first
element specified in the XML file.
The window name must not match an existing window name in the InTouch application.
Window Definition
You can use the following elements to specify a window.
Title Window name as non-empty string.

Maximum of 32 characters and trailing
spaces are not counted. Required.
Comment Comment text. Maximum of 59

characters.
32
Dimension Required when using the optional

schema. When the schema is not
used, a default dimension is applied if
a dimension element is not included.
The default values are 4 4 632 278.
WindowStyle Window Type = {Replace | Overlay|

Popup}.
BackgroundColor Window background color specified by

a color element: RGB element, name
element, reference element, or value
element.
FrameStyle {Single | Double | None}.
TitleB ar Title bar enabled = {true | false}.
CloseButton Close window button enabled = {true |

false}
Can be enabled only when title bar is
enabled.
SizeControls Size controls enabled = {true | false}.
ScriptOnShow Script element.
ScriptWhileShowing Script element.
ScriptOnHide Script element.
ObjectList Objects contained by the window,

including SmartSymbols.
This example creates an empty window:

<?xml version="1.0" encoding="UTF-8"?>
<iw:InTouchWindow
xmlns:iw="http://www.wonderware.com/InTouch/Window"
xmlns:itc="http://www.wonderware.com/InTouch/Common"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.wonderware.com/InTouch/Window
wwInTouchWindow.xsd" Version="1">
<Title>ApplicationSecondWindow</Title>
<Comment>Main application window</Comment>
<Dimension>
<Left>4</Left>
<Top>4</Top>
<Width>632</Width>
</Dimension>
<BackgroundColor>
33
<R>192</R>
<G>192</G>
192
</BackgroundColor>
<WindowStyle>Overlay</WindowStyle>
<FrameStyle>Single</FrameStyle>
<TitleBar>true</TitleBar>
<CloseButton>True</CloseButton>
<SizeControls>true</SizeControls>
</iw:InTouchWindow>
Minimal example:
<iw:InTouchWindow
<Title>ApplicationSecondWindow</Title>
<Dimension><Left>4</Left><Top>4</Top>
<Width>632</Width>
<Height>278</Height></Dimension>
</iw:InTouchWindow>
Activating Schema Validation

The schema validation and proc essing are activated by placing specific data within the
InTouchWindow element. If you activat e the schema, you must place the InTouchCommon. Xsd and
InTouchWindow. Xsd files in the same folder as the XML file.
Example of using a schema:
<iw:InTouchWindow
</iw:InTouchWindow>
Example of not using a schema:
<InTouchWindow Version="1">
</InTouchWindow>
Window Scripts
You can create three types of window scripts in your XML import file: OnS how, WhileShowing, and
OnHide. You place the script elements within the window element.
Script text can be enclosed in a CDA TA section to prevent XML delimiter characters in the script from
interfering with XML file parsing.
OnShow Window Script Element

The OnS how script element contains the script text.
Example:
<ScriptOnShow><![CDATA[
First line of script text
Second line of script text
N-th line of script text
34
]]></ScriptOnShow>
Minimal example:
<ScriptOnShow>Single line of script text</ScriptOnShow>
WhileShowing Window Script Element

The WhileShowing script has two elements. The script text can be placed in a CDA TA section.
Text Text of the window script. Required.
FREQUENCY Script execution frequency in milliseconds.

Required when using the optional schema.
Default is 1000.
Example:
<ScriptWhileShowing>
<Text><![CDATA[
]]></Text>
<Frequency>1000</Frequency>
</ScriptWhileShowing>
Minimal example:
<ScriptWhileShowing>
<Text>Single line of script text</Text>
</ScriptWhileShowing>
OnHide Window Script Element

The OnHide window script has one element. The script text can be plac ed in a CDA TA section.
Example:
<ScriptOnHide>
<![CDATA[
]]>
</ScriptOnHide>
Minimal example:
<ScriptOnHide>Line of script text</ScriptOnHide>
Window Objects
Window objects are placed in an object list defined by the ObjectList element.
Example:
<?xml version="1.0" encoding="UTF-8"?>
35
<iw:InTouchWindow xmlns:iw="http://www.wonderware.com/InTouch/Window"
xsi:schemaLocation="http://www.wonderware.com/InTouch/Window.xsd"
Version="1">
<Title>Window0001</Title>
<Comment>Sample simple window</Comment>
<Dimension>
<Left>10</Left>
<Top>10</Top>
<Width>400</Width>
</Dimension>
<BackgroundColor>
<R>255</R>
<G>0</G>
255
</BackgroundColor>
<WindowStyle>Replace</WindowStyle>
<FrameStyle>Double</FrameStyle>
<TitleBar>true</TitleBar>
<SizeControls>true</SizeControls>
<ObjectList>
<Rectangle>
<Title>Rectangle1</Title>
<Pen>
<PenColor>
<Name>Black</Name>
</PenColor>
</Pen>
<Dimension>
<Left>100</Left> <Top>50</Top>
<Width>270</Width> <Height>80</Height>
</Dimension>
<FillColor>
<R>128</R> <G>128</G> 128
</FillColor>
</Rectangle>
</ObjectList>
</iw:InTouchWindow>
Each window object can contain animation links. A window object containing animation links includes
an animation links element.
<Animationlinks> </Animationlinks>
Default Element Values

When window object elements are not specified, the element values in the following table are used as
defaults.
Elements Default Value
FILLCOLOR <R>212</ R><G>208</G>

200
PENWIDTH 1
36
Elements Default Value
PENCOLOR Black
PENSTY LE Solid
CORNE RDIME NSION <Width>20</Width>

<Height>20</Height>
TE XTCOLOR Black
TE XTJUS TIFY Left
ROTA TION 0
FONT System
FONTS TY LE regular
FONTWEIGHT Ignored
FONTS IZE 10
UNDERLINE False
STRIKEOUT False
FLIP None
TRANSPA RENT <R>0</R><G>255</G> 0
Pen Style Limitations

If you specify a pen style other than solid, the pen width is forced to 1. To specify pen widths larger
than 1, the pen style option must be removed or set to SOLID.
Pen Dimensions
The dimension specification is for the centerline of an object. If an object's pen width is larger than 1,
then an object may not fit within the specified dimension. Instead, the pen width straddles the boundary
of the object. Some pixels are inside the object's boundary; others are outside of the boundary.
Rectangle Object
The following elements can be specified for a rectangle element.
FillColor Fill color of a rectangle. Specified with

a color element. Default is rgb(212,
208, 200).
Pen Pen element.
37
Dimension Location and size of an object.

Elements are top, left, widt h, height.
Top, left, width, and height values are
pixels. The resulting coordinates must
be within -32000 and +32000. Both
width and height cannot be zero.
Required.
An object is not created if the
Dimension element is assigned invalid
values or is missing values.
Title Object name. Optional.
Animationlinks Optional animation links list.
Example:
<Rectangle>
<Title>Rectangle1</Title>
<Pen>
<PenColor><Name>Black</Name></PenColor>
</Pen>
<Dimension>
<Left>100</Left> <Top>50</Top>
<Width>270</Width> <Height>80</Height>
</Dimension>
<FillColor>
<R>128</R> <G>128</G> 128
</FillColor>
<AnimationLinks> </AnimationLinks>
</Rectangle>
Minimal example:
<Rectangle>
<Dimension>
<Left>100</Left><Top>50</Top>
<Width>270</Width><Height>80</Height>
</Dimension>
</Rectangle>
Rounded Rectangle Object

The following elements can be specified for a rounded rectangle object.
FillColor Fill color. Specified by a color

element. Default is rgb(212, 208,
200).
Pen Pen element.
38

Top, left, width, and height values
are pixels. The resulting coordinat es
must be within -32000 and +32000.
Both width and height cannot be
zero. Required.
Dimension element is assigned
invalid values or is missing values.
CornerDimension Elements width and height. Corner

width cannot exceed the width of the
rectangle. Corner height cannot
exceed the height of the rectangle.
Corner widt h and corner height must
be at least 1. Default is 20, 20.
Example:
<RoundedRectangle>
<Title>RoundedRectangle1</Title>
<Pen>
</Pen>
<Dimension>
<Left>100</Left>
<Top>50</Top>
<Width>270</Width>
<Height>80</Height>
</Dimension>
<FillColor>
<R>128</R> <G>128</G> 128
</FillColor>
<AnimationLinks>
</AnimationLinks>
<CornerDimension>
<Width>8</Width>
<Height>8</Height>
</CornerDimension>
</RoundedRectangle>
Minimal example:
<RoundedRectangle>
<Dimension>
39
</Dimension>
</RoundedRectangle>
Ellipse Object
The following elements can be specified for an ellipse object.
Fillcolor Fill color. Specified with a color

element. Default is rgb(212, 208, 200).
Pen Pen element.

Required.
Dimension element is assigned invalid
values or is missing values.
Example:
<Ellipse>
<Title>Ellipse1</Title>
<Pen>
</Pen>
<Dimension>
<Left>100</Left>
<Top>50</Top>
<Width>270</Width>
<Height>80</Height>
</Dimension>
<FillColor>
<R>128</R> <G>128</G> 128
</FillColor>
<AnimationLinks>
</AnimationLinks>
</Ellipse>
Minimal example:
<Ellipse>
<Dimension>
40
</Dimension>
</Ellipse>
Line Object
The following elements can be specified for a line object. From and to points cannot be the same point.
Pen Pen element
Points Point elements. Must contain two.

Extra point elements are ignored.
Example:
<Line>
<Title>Line1</Title>
<Pen>
</Pen>
<Points>
<Point><X>50</X><Y>150</Y></Point>
</Points>
<AnimationLinks>
</AnimationLinks>
</Line>
Minimal example:
<Line>
<Points>
</Points> </Line>
Horizontal Line Object

The following elements can be specified for a horizont al line object. This res ults in a WindowMaker HV
Line object.
Pen Pen element.
41
Points Must contain two points. The Y

coordinate of the second point is
ignored and set to the Y coordinate of
the first point. Extra point elements are
ignored. Required.
An object is not created if the Points
element is assigned invalid values or is
missing values.
Example:
<HorizontalLine>
<Pen>
</Pen>
<Points>
</Points>
<AnimationLinks>
</AnimationLinks>
</HorizontalLine>
Minimal example:
<HorizontalLine>
<Points>
</Points>
</HorizontalLine>
Vertical Line Object

The following elements can be specified for a vertical line object. This will result in a WindowMaker HV
Line object.
Pen Pen element.
42
Points Must contain two points. The X

coordinate of the second point is
ignored and set to the X coordinate of
the first point. Extra point elements are
ignored. Required.
missing values.
Example:
<VerticalLine>
<Pen>
</Pen>
<Points>
</Points>
<AnimationLinks>
</AnimationLinks>
<VerticalLine>
Minimal example:
<VerticalLine>
<Points>
</Points>
<VerticalLine>
Polyline Object
You must define at least two points in order to load the polyline object. Using the same coordinates for
the two points is not recommended.
The following elements can be specified for a polyline object.
Points Point elements, at least two required.

missing values.
Pen Pen element.
43
Animationlinks Optional animation links list. Fill Color, Text

Color, Percent Fill, Value Display are not
permitted.
Example:
<Polyline>
<Title>polyline1</Title>
<Pen>
</Pen>
<Points>
</Points>
<AnimationLinks>
</AnimationLinks>
</Polyline>
Minimal example:
<Polyline>
<Points>
</Points>
</Polyline>
Polygon Object
You must define at least two points to load a polygon object. Using the same coordinat es for the two
points is not recommended.
The following elements can be specified for a poly gon object.
Points Cont ains Point elements. At least two

points are required. X and Y values
are in pix els.
FillColor Fill color of polygon object. Contains a

color element. Default is rgb(212, 208,
200).
Pen Pen element.
44
Animationlinks Optional animation links list. Text

Color, Value Display animation links
are not permitted.
Example:
<Polygon>
<Title>polygon1</Title>
<Pen>
</Pen>
<Points>
</Points>
<FillColor>
<R>128</R> <G>128</G> 128
</FillColor>
<AnimationLinks>
</AnimationLinks>
</Polygon>
Minimal example:
<Polygon>
<Points>
</Points>
</Polygon>
Text Object
The following elements can be specified for a text object.
TextString Displayed text string. Required.

Text object is not created if the
Textstring element is assigned an
invalid value or is missing a value.
TextInfo Defines how the text will be shown.
Rotation Defines orientation of the text in

degrees. Possible values:{0, 90,
180, 270}. Default is 0.
45

Top, left, width, and height values
are pixels. The resulting
coordinates must be wit hin -32000
and +32000. Both widt h and height
cannot be zero. Required. Object is
not created if the Dimension
element is assigned invalid values
or is missing values.
Example:
<Text>
<Title>text1</Title>
<TextString>This is some text to display</TextString>
<Dimension>
</Dimension>
<TextInfo>
Arial
<TextColor>
<R>0</R>
<G>0</G>
0
</TextColor>
</TextInfo>
<Rotation>0</Rotation>
<AnimationLinks>
</AnimationLinks>
</Text>
Minimal example:
<Text>
<TextString>This is some text to display</TextString>
<Dimension>
</Dimension>
</Text>
Bitmap Object
If a source image is specified, it must exist. Supported graphic file formats are: JP G, JPEG, BMP, TIF,
PCX, BIF, and TGA.
A bitmap without a specified source image appears as a default rectangle element on a window.
46
Transparent Colors
The InTouch internal application object data structure for bitmaps contai ns a Boolean field indicating
that transparent color should be applied. Anot her field stores the actual transparent color.
In WindowMaker, if you create a new bitmap object, it initially has a default transparent color that is
black and is unavailable. After you select the transparent color tool, you have applied a permanent
transparent color to the bitmap object. From the transparent color tool, there is no visual cue that the
transparent color has been assigned to a bitmap.
For bitmap objects imported from an XML file, the transparent color node for a bitmap is an optional
entry, but if it is present, the transparent color is enabled and the transparent color is assigned to the
bitmap object. There is no mechanism for the end user to open the window in WindowMaker, to select
the bitmap object, and then to disable the transparent color.
Bitmap Object Elements

The following elements can be specified for a bitmap object.
Title Bitmap object name. Optional.
Fillcolor Interior RGB color of the bitmap object.

Cont ains a color element. Default is rgb(0,
0, 0).
SourceImage Path to the bitmap file. Default is Null.
Trans parent RGB color for trans parent color. Default is

rgb(0, 255, 0).
Pen Defines the line around the bitmap object.
Dimension Location and size of an object. Elements

are top, left, width, height. Top, left, width,
and height values are pixels. The resulting
coordinates must be wit hin -32000 and
+32000. Both widt h and height cannot be
zero. Required.
An object is not created if the Dimension
missing values.
Example:
<Bitmap>
<Title>bitmap1</Title>
<Pen>
</Pen>
<Dimension>
47
<Left>100</Left>
<Top>50</Top>
<Width>270</Width>
<Height>80</Height>
</Dimension>
<FillColor>
<R>128</R>
<G>128</G> 128
</FillColor>
<Transparent>
<R>0</R> <G>128</G> 255
</Transparent>
<SourceImage>C:\MyPictures\hello.jpg</SourceImage>
<AnimationLinks>
</AnimationLinks>
</Bitmap>
Example:
<Bitmap>
<Dimension>
</Dimension>
<SourceImage>C:\MyPictures\hello.jpg</SourceImage>
</Bitmap>
Example with empty SourceImage node:
<Bitmap>
<Dimension>
</Dimension>
<FillColor>
<R>128</R> <G>128</G> 128
</FillColor>
<SourceImage></SourceImage>
</Bitmap>
Minimal example:
<Bitmap>
<Dimension>
</Dimension>
</Bitmap>
Button Object
The following elements can be specified for a button object.
Title Button object name. Optional.
TextString Displayed caption. Default string is

"Text".
TextInfo Defines how the caption is shown.
48
Animationlinks Optional animation links list. Line

Color, Fill Color, Text Color, Percent
Fill, Orientation animation links are
not permitted.

Required.
Example:
Button>
<Title>button1</Title>
<TextInfo>
Arial
<TextColor>
<R>0</R>
<G>0</G>
0
</TextColor>
</TextInfo>
<Dimension>
</Dimension>
<TextString>Stop All Robots</TextString>
<AnimationLinks>
</AnimationLinks>
</Button>
Minimal example:
<Button>
<Dimension>
</Dimension>
</Button>
49
Smart Symbols
A SmartSymbol templat e must be defined in the application before importing a window that uses the
SmartSymbol template. If the SmartSymbol template does not exist, the import fails, and the window is
not created.
Multiple SmartSymbols can be specified for a window. Each SmartSymbol is declared in a separate
<SmartSymbol> </SmartSymbol> element.
The following elements can be specified fo r a Smart Symbol.
SymbolName SmartSymbol name. Required.

An object is not created if the name
does not match a SmartSymbol
template name in the application, or
the name is missing.

Required.
TagReplace Instance tag replacement.
StringReplace Instance string replacement.
Example:
<SmartSymbol>
<SymbolName>MyCoolSymbol</SymbolName>
<Dimension>
</Dimension>
<TagReplace>
<Find>Tag001</Find>
<Replace>Tag007</Replace>
</TagReplace>
<StringReplace>
<Find>Find This Text</Find>
<Replace>Replace it with this text</Replace>
</StringReplace>
</SmartSymbol>
Minimal example:
<SmartSymbol>
<Dimension>
50
</Dimension>
</SmartSymbol>
Tag Replacement
The tags within a SmartSymbol instance can be replaced. You should only replace tags within a
SmartSymbol instance that currently exists in the application.
Tag replacement is case insensitive and the entire tag name string must match. You can add one or
more < TagReplace> elements to the SmartSymbol node to replace multiple tags.
For example:
<TagReplace>
<Find>Tag1</Find>
<Replace>DTagA</Replace>
</TagReplace>
<TagReplace>
<Find><![CDATA[Tag1]]></Find>
<Replace><![CDATA[DTagA]]></Replace>
</TagReplace>
If the tag names specified for replacement do not exist in an application, the SmartSymbol is not
created. Also, the window containing the SmartSymbol is not created.
The replaced tag's type must be the same as the original tag's type.
String Replacement
Strings can be replaced wit hin a SmartSymbol instance. String replacements are case sensitive and
the entire source string must match. Multiple string replac ement elements can be used within a single
SmartSymbol element.
<StringReplace>
<FIND>
<![CDATA[Open]]>
</FIND>
<REPLACE>
<![CDATA[Off]]>
</REPLACE>
</StringReplace>
<StringReplace>
<FIND>Open</FIND>
<REPLACE>Off</REPLACE>
</StringReplace>
SmartSymbol Example
This is an example of a SmartSymbol element containing tag and string replacement elements.
<SmartSymbol>
<Dimension>
</Dimension>
<TagReplace>
<Find>DTag1</Find>
<Replace>DTagA</Replace>
</TagReplace>
<TagReplace>
51
<Find>ATag001</Find>
<Replace>ATag002</Replace>
</TagReplace>
<StringReplace>
<Find><![CDATA[Open]]> </Find>
<Replace><![CDATA[On]]> </Replace>
</StringReplace>
<StringReplace>
<FIND>
<![CDATA[Closed]]>
</FIND>
<REPLACE>
<![CDATA[Off]]>
</REPLACE>
</StringReplace>
</SmartSymbol>
ArchestrA Symbols
An ArchestrA Symbol must be defined in the Galaxy before you import a window that uses the
ArchestrA Symbol reference. If the ArchestrA Symbol reference does not exist, the import fails, and the
window is not created.
You can specify symbols from an Instance or from the Graphic Toolbox in the symbol reference.
However, you cannot specify Template symbols in the symbol reference.
Multiple ArchestrA Symbols can be specified for a window. Each ArchestrA Symbol is declared in a
separate <ArchestrASymbol> </ArchestrASymbol> element.
The following elements can be specified for an Arc hestrA Symbol.
SymbolReference Referenc e to look up the symbol

in the Galaxy. Required.
An object will not be created if the
ArchestrA symbol specified by the
symbol reference does not exist
or if the symbol referenc e field is
missing or empty.
52
Dimension The location and size of an object.

The Dimension sub- elements are
top, left, width, and height.
Required.
Specifying width and height is
optional. If width and height are
not specified, the original width
and height of the Arc hestrA
Symbol is used. If only width is
specified, then the height is
calculated using the aspect ratio
and vice versa. For example, if
the original width was 200 and
height was 100, and if you specify
width as 100, the height is
changed to 50.
invalid values or does not contain
a value. A window containing this
symbol is also not created.
Title The text name for an element.

Optional.
This name should be unique
within the XML file; otherwise, it is
ignored.
Flip The flip type of an element.

Optional.
Rotation The rotation angle of an element.

Optional.
StringReplace One or more string replacement

nodes. Optional.
CustomPropertyOverride One or more custom property

overrides. Optional.
AnimationLinks The list of animation links.

Optional.
Specifying Line Color, Fill Color,
Text Color, Percent Fill,
Orientation, Slider, Tooltip,
ValueDisplay, Blink or UserInput
is not permitted.
53
<ArchestrASymbol>
<Title>EmbedSym1</Title>
<Dimension>
<Left>200</Left>
<Top>200</Top>
<Width>150</Width>
</Dimension>
<Flip>None</Flip>
<SymbolReference>ButtonChromeMomentaryRed</SymbolReference>
<AnimationLinks>
</AnimationLinks>
<StringReplace>
<Find>LABEL</Find>
<Replace>OFF</Replace>
</StringReplace>
</ArchestrASymbol>
Minimal example:
<ArchestrASymbol>
<Dimension>
<Left>200</Left>
<Top>200</Top>
</Dimension>
</ArchestrASymbol>
CustomPropertyOverride
You can override only those custom properties which are already defined for the ArchestrA Symbol.
To override multiple custom properties, add one or more <CustomPropertyOverride> elements to the
ArchestrA Symbol node.
Example:
<ArchestrASymbol>
<Title>EmbedSym1</Title>
<Dimension>
<Left>200</Left>
<Top>200</Top>
<Width>150</Width>
</Dimension>
<Flip>None</Flip>
<AnimationLinks>
</AnimationLinks>
<CustomPropertyOverride> <CustomPropertyName>cp1</CustomPropertyName>
<OverrideValue>DTagA</OverrideValue>
<IsConstant>false</IsConstant>
</CustomPropertyOverride>
</ArchestrASymbol>
In this example, cp1 is the name of the existing custom property. The override is applied to the custom
property with the new value set to DTagA. IsConstant is an optional field used to indicate whether the
value should be interpret ed as a constant. The IsConstant flag is only applicable if the type of the
custom property is String, Time, or Elapsed Time. The IsConstant flag is set to false by default.
54
Note: If the tag name specified for OverrideV alue does not exist in the tag database, the ArchestrA
Symbol referenc e is not created on the window and import for that particular window fails. Error
messages are logged in the log file or in the ArchestrA Logger.
ArchestrA Symbol String Replacement Type

The existing strings can be replaced within the ArchestrA Symbol instance. The string replacements
are case sensitive. You can use multiple string replacement nodes within a single ArchestrA Symbol
node.
<StringReplace>
<FIND>
<![CDATA[Open]]>
</FIND>
<REPLACE>
<![CDATA[Off]]>
</REPLACE>
</StringReplace>
<StringReplace>
<FIND>Open</FIND>
<REPLACE>Off</REPLACE>
</StringReplace>
Unsupported Window Objects

Cell, Symbol, Real-Time Trend, and Historical Trend objects cannot be import ed. If elements for
unsupported objects are included in the XML file, they are ignored.
Window Animation Links

Window object animation links are declared within the <Animationlinks> </Animationlinks> element.
There can be zero or more animation links within a window element.
Not all elements support all animation link types. The ArchestrA Symbols support the following
animation links:
 ObjSize_Height
 ObjSize_Width
 Location_Vert
 Location_Hori
 TPus hB_Disc
 TPus hB_Action
 TPus hB_ShowWin
 TPus hB_HideWin
 Misc_Visib
 Misc_Disable
For more information about Window Animation Links, see the InTouch documentation.
Some animation link types prevent other animation link types from being created. Animation link
processing occurs in the order specified in the XML file.
55
Script/Expression/Tag Name Requirements Matrix

Each animation link has a control field. The control field can be a script, an expression, or a tag name.
Some control fields are limited by the type of tags or expressions allowed. The following table lists the
control field required for each animation link and any limitation of the control field.
Animation Link
Type Control Field Control Field Limit
Discrete User Input Tag Discrete tag
Analog User Input Tag Analog tag
String User Input Tag String tag
Discrete Line Color Expression Discrete expression
Analog Line Color Expression Analog expression
Discrete Alarm Line Tag Discrete tag alarm status

Color
Analog Alarm Line Tag Analog tag alarm status

Color
Discrete Fill Color Expression Discrete expression
Analog Fill Color Expression Analog expression
Discrete Alarm Fill Tag Discrete tag alarm status

Color
Analog Alarm Fill Tag Analog tag alarm status

Color
Discrete Text Color Expression Discrete expression
Analog Text Color Expression Analog expression
Discrete Alarm Tag Discrete tag alarm status

Text Color
Analog Alarm Text Tag Analog tag alarm status

Color
Vertical Slider Tag Valid analog tag
Horiz ontal Slider Tag Valid analog tag
56
Animation Link
Type Control Field Control Field Limit
Object Size Height Expression Analog value
Object Size Width Expression Analog value
Vertical Location Expression Valid expression
Horiz ontal Location Expression Valid expression
Vertical Percent Fill Expression Analog value
Horiz ontal Percent Expression Analog value

Fill
Discrete Touch Tag Discrete value

Pushbutton
Action Touch Script Valid script

Pushbutton
Show Window Window Window must exist.

Touch Pushbutton Name
Hide Window Window Window must exist.

Touch Pushbutton Name
Visibility Expression Discrete value
Blink Expression Discrete value
Orientation Expression Analog value
Disable Expression Discrete value
Tooltip Expression String tag
Discrete Value Expression Discrete expression

Display
Analog Value Expression Analog expression

Display
String Value Expression String expression

Display
Discrete User Input

The following elements can be specified for a discrete us er input animation link.
57
Message Message text to user. Default is no

message text. Required if the optional
schema is used.
InputOnly If input only: {true, false}. Default is

false.
OnMessage On message text for user. Default is On.

Cannot be empty text.
OffMessage Off message text for user. Default is Off.

Cannot be empty text.
SetPrompt Set prompt message text for user.

Default is On. Cannot be empty text.
ResetPrompt Reset prompt message text for user.

Default is Off. Cannot be empty text.
KeyAssignment Virtual key element. Default is no

assignment. An empty string means no
assignment occurs.
Expression Discrete tag. Required. Object is not

created if invalid or missing.
Example:
<UserInputDiscrete>
<Title>UserInputDiscrete1</Title>
<InputOnly>false</InputOnly>
<KeyAssignment>
<KeyCode>F1</KeyCode>
<KeyFlags>Ctrl</KeyFlags>
</KeyAssignment>
<Message>Pump Valve State</Message>
<Expression><![CDATA[dTag001]]></Expression>
<OnMessage>On Message Text</OnMessage>
<OffMessage>Off Message Text</OffMessage>
<ResetPrompt>
<![CDATA[Reset Prompt Text]]>
</ResetPrompt>
<SetPrompt>Set Prompt Text</SetPrompt>
</UserInputDiscrete>
Minimal example:
<UserInputDiscrete>
<Expression>dTag001</Expression>
</UserInputDiscrete>
58
Analog User Input

The following elements can be specified for an analog user input animation link.
Message Message text to user. Required if

optional schema is used. Default
is no message text.
InputOnly If input only: true, false. Default

is false.
MinAnalogValue Minimum floating point value

allowed. Required if optional
schema is used. Default is 0.0
MaxAnalogValue Maximum floating point value

allowed. Required if optional
schema is used. Default is 100.0.
Must be larger than the value
assigned to the
MINA NALOGVALUE element.
KeyPadEnabled Specifies whether a keypad is

visible. Possible values are Yes
or No. The default is No.
KeyAssignment Virtual key element, empty

string, or abs ent. Default is no
assignment. Empty string means
no assignment occurs.
Expression Analog type tag name. Required.

Object is not created if invalid or
missing.
Example:
<<UserInputAnalog>
<Title>UserInputAnalog1</Title>
<KeyAssignment>
</KeyAssignment>
<Message>Flush Pump Speed</Message>
<Expression>aTag001</Expression>
<KeyPadEnabled>false</KeyPadEnabled>
<MinAnalogValue>0.0</MinAnalogValue>
<MaxAnalogValue> 100.0</MaxAnalogValue>
</UserInputAnalog>
Minimal example:
59
<UserInputAnalog>
<Expression><![CDATA[aTag001]]></Expression>
<MinAnalogValue>0.0</MinAnalogValue>
<MaxAnalogValue>100.0</MaxAnalogValue>
</UserInputAnalog>
String User Input

You should use either EchoEnabled or EchoMode, but not both. EchoMode allows you to specify the
password mode, whereas the EchoE nabled allows only the states enabled or disabled.
You use the Echo Character element to control how user input is shown during run time. Possible
values are Yes, No, and Password.
 If the element is set to Yes, then during run time the string characters are shown in the input edit
box. Input can only be enabled. Password character and encryption are disable d.
 If the element is set to No, then during run time the input characters are not shown in the input edit
box. Input can only be enabled. Password character and encryption are disabled.
 If the element is set to Password, then during run time the password character is shown instead of
the password typed by the user. A password character is optional, but if specified, cannot be
empty. The default password character is an asterisk. Encryption is optional and is off by default.
Input only is mandatory and is forc ed on.
If the elements do not match these criteria, then default options are used.
You can specify the following elements for a string user input animation link.
Message Message text to user. Required if

optional schema is used. Default is no
message text.
InputOnly If input only: {true, false}. Default is

false.
EchoCharacters Echo characters: no, yes, password.

Required if optional schema is used.
Default is yes.
KeyPadEnabled If keypad is visible: true, false. Default

is false.
PasswordCharacter Password character. Default is "*"
EncryptEnabled Encryption enabled: yes, no. Default

is no.
KeyAssignment Virtual key element, empty string, or

absent. Default is no assignment.
Empty string means no assignment
occurs.
60
Expression Message-type tag. Required. Object

is not created if invalid or missing.
Example:
<UserInputString>
<Title>UserInputString1</Title>
<KeyAssignment>
</KeyAssignment>
<Message>Select Pump</Message>
<Expression>mTag001</Expression>
<EchoCharacters>true</EchoCharacters>
<EncryptEnabled>false</EncryptEnabled>
<PasswordCharacter>*</PasswordCharacter>
</UserInputString>
Minimal exam ple:
<UserInputString>
<Message>Select Pump</Message>
<Expression>mTag001</Expression>
<EchoCharacters>true</EchoCharacters>
</UserInputString>
Discrete Line Color

The following elements can be specified for a discrete line color animation link.
Oncolor Cont ains a color element. Default is

rgb(0,0,0).
Offcolor Cont ains a color element. Default is

rgb(0,0,0).
Expression Discrete tag or expression. Required.

Object is not created if the expression
element values are missing or invalid.
Example:
<LineColorDiscrete>
<Title>LineColorDiscrete1</Title>
<Expression>
<![CDATA[dTag001]]>
</Expression>
<OnColor><Name>Green</Name></OnColor>
<OffColor><Name>Red</Name></OffColor>
</LineColorDiscrete>
Minimal example:
61
<LineColorDiscrete>
</LineColorDiscrete>
Analog Line Color

The required breakpoint values must have increasing values. If this is not the case, a warning is
logged, and the offending value is one plus the previous value.
The object containing the animation link is not created if a required value is missing or invalid.
You can specify the following elements for an analog line color animation link.
Color1 Cont ains a color element. Default is

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).
Values Constant analog values. Must contain

nine Value elements. Required.
Expression Analog tag or ex pression. Required.
Example:
<LineColorAnalog>
<Title>LineColorAnalog1</Title>
<Colors>
<Color1><Name>White</Name></Color1>
62
<Color2><Name>Red</Name></Color2>
<Color3><Name>Orange</Name></Color3>
<Color4><Name>Yellow</Name></Color4>
<Color5><Name>Green</Name></Color5>
<Color6><Name>Blue</Name></Color6>
<Color7><Name>Cyan</Name></Color7>
<Color8><Name>Magenta</Name></Color8>
<Color9><Name>Violet</Name></Color9>
<Color10><Name>Black</Name></Color10>
</Colors>
<Values>
<Value>10.0</Value>
<Value>20.0</Value>
<Value>30.0</Value>
<Value>40.0</Value>
<Value>50.0</Value>
<Value>60.0</Value>
<Value>70.0</Value>
<Value>80.0</Value>
<Value>90.0</Value>
</Values>
</LineColorAnalog>
Minimal example:
<LineColorAnalog>
<Values>
<Value>10.0</Value>
<Value>20.0</Value>
<Value>30.0</Value>
<Value>40.0</Value>
<Value>50.0</Value>
<Value>60.0</Value>
<Value>70.0</Value>
<Value>80.0</Value>
<Value>90.0</Value>
</Values>
</LineColorAnalog>
Discrete Alarm Line Color

The following elements can be specified for a discrete alarm line color animation link.
NormalColor Cont ains a color element. Default is

rgb(0,0,0. )
AlarmColor Cont ains a color element. Default is

rgb(0,0,0. )

created if expression is invalid or missing.
63
Example:
<LineColorDiscreteAlarm>
<Title>LineColorDiscreteAlarm1</Title>
<Expression>
<![CDATA[dTag001]]>
</Expression>
<NormalColor><Name>Black</Name></NormalColor>
<AlarmColor><Name>Red</Name></AlarmColor>
</LineColorDiscreteAlarm>
Minimal example:
<LineColorDiscreteAlarm>
</LineColorDiscreteAlarm>
Analog Alarm Line Color

The following elements can be specified for an analog alarm line color animation link.
Value: LOLOCOLOR Cont ains a color element. Default is

rgb(0,0,0).
Value:LOCOLOR Cont ains a color element. Default is

rgb(0,0,0).
Value: Cont ains a color element. Default is

NORMALCOLOR rgb(0,0,0).
Value:HICOLOR Cont ains a color element. Default is

rgb(0,0,0).
Value: HIHICOLOR Cont ains a color element. Default is

rgb(0,0,0).
Deviation: Cont ains a color element. Default is


MINORCOLOR rgb(0,0,0).

MAJORCOLOR rgb(0,0,0).
ROC: Cont ains a color element. Default is

ROC: ROCCOLOR Cont ains a color element. Default is

rgb(0,0,0).
Expression Analog tag. Required. Object is not

created if expression is invalid or missing.
64
Example of a value alarm:

<LineColorAnalogAlarm>
<Title>LineColorAnalogAlarm1</Title>
<Expression>
<![CDATA[aTag001]]>
</Expression>
<Value>
<LoLoColor><Name>Red</Name><LoLoColor>
<LoColor><Name>DarkRed</Name><LoColor>
<HiColor><Name>DarkGreen</Name></HiColor>
<HiHiColor><Name>Green</Name></HiHiColor>
</Value>
</LineColorAnalogAlarm>
Example of a deviation alarm:
<Expression>
<![CDATA[aTag001]]>
</Expression>
<Deviation>
<MinorColor><Name>Green</Name></MinorColor>
<MajorColor><Name>Red</Name></MajorColor>
</Deviation>
Example of a ROC alarm:
<Expression>
<![CDATA[aTag001]]>
</Expression>
<ROC>
<ROCColor><Name>Red</Name></ROCColor>
</ROC>
Discrete Fill Color

The following elements can be specified for a discrete fill color animation link.
OnColor Cont ains a color element. Default is

rgb(0,0,0).
OffColor Cont ains a color element. Default is

rgb(0,0,0).

Object is not created if the expression is
invalid or missing.
65
Example:
<FillColorDiscrete>
<Title>FillColorDiscrete1</Title>
<Expression>
<![CDATA[dTag001]]>
</Expression>
</FillColorDiscrete>
Minimal example:
<FillColorDiscrete>
</FillColorDiscrete>
Analog Fill Color

The object containing the animation link is not created if a required value is missing or invalid.
You can specify the following elements for an analog fill color animation link.

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).
Values Constant analog values. Must contain nine

value elements. Required.
66
Example:
<FillColorAnalog>
<Title>FillColorAnalog1</Title>
<Colors>
</Colors>
<Values>
<Value>10.0</Value>
<Value>20.0</Value>
<Value>30.0</Value>
<Value>40.0</Value>
<Value>50.0</Value>
<Value>60.0</Value>
<Value>70.0</Value>
<Value>80.0</Value>
<Value>90.0</Value>
</Values>
</FillColorAnalog>
Minimal example:
<FillColorAnalog>
<Values>
<Value>10.0</Value>
<Value>20.0</Value>
<Value>30.0</Value>
<Value>40.0</Value>
<Value>50.0</Value>
<Value>60.0</Value>
<Value>70.0</Value>
<Value>80.0</Value>
<Value>90.0</Value>
</Values>
</FillColorAnalog>
Discrete Alarm Fill Color

The following elements can be specified for a discrete alarm fill color animation link.
67

rgb(0,0,0).

rgb(0,0,0).

created if the expression is invalid or
missing.
Example:
<FillColorDiscreteAlarm>
<Title>FillColorDiscreteAlarm1</Title>
<Expression>
<![CDATA[dTag001]]>
</Expression>
</FillColorDiscreteAlarm>
Minimal example:
<FillColorDiscreteAlarm>
</FillColorDiscreteAlarm>
Analog Alarm Fill Color

The following elements can be specified for an analog alarm fill color animation link. The objec t
containing the animation link is not created if a required value is missing or invalid.
Value: LoLoColor Cont ains a color element. Default is

rgb(0,0,0).
Value: LoColor Cont ains a color element. Default is

rgb(0,0,0).
Value: NormalColor Cont ains a color element. Default is

rgb(0,0,0).
Value: HiColor Cont ains a color element. Default is

rgb(0,0,0).
Value: HiHiColor Cont ains a color element. Default is

rgb(0,0,0).

NormalColor rgb(0,0,0).
Deviation: MinorColor Cont ains a color element. Default is

rgb(0,0,0).
68
Deviation: MajorColor Cont ains a color element. Default is

rgb(0,0,0).
ROC: NormalColor Cont ains a color element. Default is

rgb(0,0,0).
ROC: ROCColor Cont ains a color element. Default is

rgb(0,0,0).

missing.
Example of a value alarm:

<FillColorAnalogAlarm>
<Title>FillColorAnalogAlarm1</Title>
<Expression>
<![CDATA[aTag001]]>
</Expression>
<Value>
</Value>
</FillColorAnalogAlarm>
Example of a Deviation Alarm:
<Expression>
<![CDATA[aTag001]]>
</Expression>
<Deviation>
</Deviation>
Example of a ROC Alarm:
<Expression>
<![CDATA[aTag001]]>
</Expression>
<ROC>
</ROC>
69
Discrete Text Color

The following elements can be specified for a discrete text color animation link.
OnColor Cont ains a color element. Default is

rgb(0,0,0).
OffColor Cont ains a color element. Default is

rgb(0,0,0).
Expression String tag expression. Required.
Example:
<TextColorDiscrete>
<Title>TextColorDiscrete1</Title>
<Expression>
<![CDATA[dTag001]]>
</Expression>
</TextColorDiscrete>
Minimal example:
<TextColorDiscrete>
</TextColorDiscrete>
Analog Text Color

The following elements can be specified for an analog text color animation link. The object containing
the animation link is not created if a required value is missing or invalid.

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).
70

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).

rgb(0,0,0).
Values Constant analog values. Must contain

nine value elements. Required.
Expression Analog tag expression. Required.
Example:
<TextColorAnalog>
<Title>TextColorAnalog1</Title>
<Colors>
</Colors>
<Values>
<Value>10.0</Value> <Value>20.0</Value>
<Value>90.0</Value>
</Values>
</TextColorAnalog>
Minimal example:
<TextColorAnalog>
<Values>
<Value>10.0</Value>
<Value>20.0</Value>
<Value>30.0</Value>
<Value>40.0</Value>
<Value>50.0</Value>
71
<Value>60.0</Value>
<Value>70.0</Value>
<Value>80.0</Value>
<Value>90.0</Value>
</Values>
</TextColorAnalog>
Discrete Alarm Text Color

The following elements can be specified for a discrete alarm text color animation link.

rgb(0,0,0).

rgb(0,0,0).

missing.
Example:
<TextColorDiscreteAlarm>
<Title>TextColorDiscreteAlarm1</Title>
<Expression>
<![CDATA[dTag001]]>
</Expression>
</TextColorDiscreteAlarm>
Minimal example:
<TextColorDiscreteAlarm>
</TextColorDiscreteAlarm>
Analog Alarm Text Color

The following elements can be specified for an analog alarm text color animation link.
Value: LoLoColor Cont ains a color element. Default is

rgb(0,0,0).
Value: LoColor Cont ains a color element. Default is

rgb(0,0,0).
Value: NormalColor Cont ains a color element. Default is

rgb(0,0,0).
72
Value: HiColor Cont ains a color element. Default is

rgb(0,0,0).
Value: HiHiColor Cont ains a color element. Default is

rgb(0,0,0).

NormalColor rgb(0,0,0).
Deviation: MinorColor Cont ains a color element. Default is

rgb(0,0,0).
Deviation: MajorColor Cont ains a color element. Default is

rgb(0,0,0).
ROC: NormalColor Cont ains a color element. Default is

rgb(0,0,0).
ROC: ROCColor Cont ains a color element. Default is

rgb(0,0,0).

missing.
Example:
<TextColorAnalogAlarm>
<Title>TextColorAnalogAlarm1</Title>
<Expression>
<![CDATA[aTag001]]>
</Expression>
<Value>
</Value>
</TextColorAnalogAlarm>
Example of a Deviation Type Alarm:
<Expression>
<![CDATA[aTag001]]>
</Expression>
<Deviation>
</Deviation>
Example of a ROC Type Alarm:
73
<Expression>
<![CDATA[aTag001]]>
</Expression>
<ROC>
</ROC>
Vertical Slider
You can specify the following elements for a vertical slider animation link.
Referenc eLocation Vertical referenc e: top, middle, bottom.

Default is bottom.
TopValue Top value. Cannot be the same as

BottomValue. Default is 0.
BottomValue Bottom value. Default is 100.
UpwardMovement Upward movement. Must range from 0

to 32767. Out of range values are
clamped and an error message is
logged. Default is 50.
DownwardMovement Downward movement. Must range

from 0 to 32767. Out of range values
are clamped and an error message is

is invalid or missing.
Example:
<SliderVertical>
<Title>SliderVertical1</Title>
<ReferenceLocation>Bottom</ReferenceLocation>
<TopValue>10.0</TopValue>
<BottomValue> 110.0</BottomValue>
<UpwardMovement> 20.0</UpwardMovement>
<DownwardMovement> 120.0</DownwardMovement>
<Expression> <![CDATA[aTag001]]> </Expression>
</SliderVertical>
Minimal example:
<SliderVertical>
</SliderVertical>
74
Horizontal Slider
The following elements can be specified for a horizont al slider animation link.
Referenc eLocation Referenc e location: left, center, right.

Default is left.
LeftValue Left value of a slider. Default is 0.
RightValue Right value of a slider. Default is 100.
LeftMovement Left horizontal movement. Must range

RightMovement Right horizontal movement. Must range


invalid or missing.
Example:
<SliderHorizontal>
<Title>SliderHorizontal1</Title>
<ReferenceLocation>Left</ReferenceLocation>
<LeftValue>10.0</LeftValue>
<RightValue>120.0</RightValue>
<LeftMovement>20.0</LeftMovement>
<RightMovement>150.0</RightMovement>
<Expression>
<![CDATA[aTag001]]>
</Expression>
</SliderHorizontal>
Minimal example:
<SliderHorizontal>
</SliderHorizontal>
Object Height
The following elements can be specified for an object height animation link. An object height animation
link cannot be us ed with an orientation animation link.
75
SizeAnchor Defines where on the object the anchor

is located. Values can be bottom,
middle, top. Default is bottom.
SizeMin Value at minimum height. Default is 0.
SizeMax Value at maximum height. Default is

100. Must be greater than the value
assigned to the SizeMin element.
MinPercent Minimum percentage height. Default is

0. Range is from 0 to 100.
MaxPercent Maximum percentage height. Default is

100. Must be more than minimum
percent. Range is from 0 to 100.
Expression Analog tag name or expression.

Required. Object is not created if the
expression is invalid or missing.
Example:
<ObjectSizeHeight>
<Title>ObjectSizeHeight1</Title>
<SizeMin>0.0</SizeMin>
<SizeMax>100.0</SizeMax>
<MinPercent>0.0</MinPercent>
<MaxPercent>100.0</MaxPercent>
<SizeAnchor>Top</SizeAnchor>
</ObjectSizeHeight>
Minimum example:
<ObjectSizeHeight>
</ObjectSizeHeight>
Object Width
The following elements can be specified for an object size width animation link. An object width
animation link cannot be used with an orientation animation link.
SizeAnchor Defines where on the object the anchor is

located. Values can be: {Left, center,
right}. Default is left.
76
SizeMin Value at minimum widt h. Default is 0.
SizeMax Value at maximum width. Default is 100.

Must be larger than SizeMin.
MinPercent Minimum percentage width. Default is 0.

Range is from 0 to 100.
MaxPercent Maximum percentage width. Default is

100. Must be more than MinPercent.
Range is from 0 to 100.

invalid or missing.
Example:
< ObjectSizeWidth>
<Title>ObjectSizeWidth1</Title>
<SizeMin>0.0</SizeMin>
<SizeMax>100.0</SizeMax>
<MinPercent>0.0</MinPercent>
<MaxPercent>100.0</MaxPercent>
<SizeAnchor>Center</SizeAnchor>
</ObjectSizeWidth>
Minimum example:
<ObjectSizeWidth>
</ObjectSizeWidth>
Vertical Location
The following elements can be specified for a vertical location animation link. An objec t vertical location
MinValue Value at top. Default is 0. Cannot

be the same value as at bottom.
MaxValue Value at bottom. Default is 100.

Cannot be same value as at top.
DecreaseMovement Vertical movement upward.

Default is 0. Cannot be less than
0.
77
IncreaseMovement Vertical movement downward.

Default is 100. Cannot be greater
than 100.
Expression Analog tag or ex pression.

Required. Object is not created if
the expression is invalid or
missing.
Example:
<LocationVertical>
<Title>LocationVertical1</Title>
<Expression>
<![CDATA[aTag001]]>
</Expression>
<MinValue>0.0</MinValue>
<MaxValue>100.0</MaxValue>
<DecreaseMovement>0</DecreaseMovement>
<IncreaseMovement>100</IncreaseMovement>
</LocationVertical>
Minimal example:
<LocationVertical>
</LocationVertical>
Horizontal Location
The following elements can be specified for a horizont al location animation link. An object horiz ontal
location animation link cannot be used with an orientation animation link.
MinValue Value at left. Default is 0.

Cannot be same value as at
right end.
MaxValue Value at right. Default is 100.

Cannot be same value as at
left end.
DecreaseMovement Horiz ontal movement to left.

Default is 0. Must not be less
than 0.
IncreaseMovement Horiz ontal movement to right.

Default is 100. Must not be
greater than 100.
78
Expression Analog tag or ex pression.

Required. Object is not created
if the expression is invalid or
missing.
Example:
<LocationHorizontal>
<Title>LocationHorizontal1</Title>
<Expression>
<![CDATA[aTag001]]>
</Expression>
<MinValue>0.0</MinValue>
<MaxValue>100.0</MaxValue>
<DecreaseMovement>0</DecreaseMovement>
<IncreaseMovement>100</IncreaseMovement>
</LocationHorizontal>
Minimal example:
<LocationHorizontal>
</LocationHorizontal>
Vertical Percent Fill

The following elements can be specified for a vertical percent fill animation link. A vertical percent fill
FillDirection Defines the direction of motion. Possible

values are: {Up, down}. Default is up.
Required.
FillColor Solid fill color element. Default is rgb(0, 0,

0).
FillMin Defines minimum value. Default is 0.
FillMax Defines maximum value. Default is 100.

Must be more than the minimum fill.
FillMinPercent Defines minimum value as a percentage.

Default is 0. Range from 0 to 100.
FillMaxPercent Defines maximum value as a percentage.

Default is 100. Range from 0 to 100. Must
be more than the minimum percentage.
79
Example:
<PercentFillVertical>
<Title>PercentFillVertical1</Title>
<FillMin>0.0</FillMin>
<FillMax>100.0</FillMax>
<FillMinPercent>0</FillMinPercent>
<FillMaxPercent>100</FillMaxPercent>
<FillColor><Name>Purple</Name></FillColor>
<FillDirection>Up</FillDirection>
</PercentFillVertical>
Minimal example:
<PercentFillVertical>
<FillDirection>Up</FillDirection>
</PercentFillVertical>
Horizontal Percent Fill

The following elements can be specified for a horizont al perc ent fill animation link. A horizontal percent
fill animation link cannot be used with an orientation animation link.
FillDirection Left, right. Default is right.
FillColor Cont ains a color element. Default is rgb(0, 0,

0).
FillMin Value at minimum fill. Default is 0.
FillMax Value at maximum fill. Default is 100. Must

be more than the minimum fill.
FillMinPercent Minimum percent to fill object. Default is 0.

Range from 0 to 100.
FillMaxPercent Maximum percent to fill object. Default is

100. Range from 0 to 100. Must be more than
the minimum percent fill.
Expression Analog tag or ex pression. Required. Object

is not created if the expression is invalid or
missing.
Example:
<PercentFillHorizontal>
<Title>PercentFillHorizontal1</Title>
<FillMin>0.0</FillMin>
<FillMax>100.0</FillMax>
<FillMinPercent>0</FillMinPercent>
<FillMaxPercent>100</FillMaxPercent>
<FillColor><Name>Purple</Name></FillColor>
80
<FillDirection>Right</FillDirection>
</PercentFillHorizontal>
Minimal example:
<PercentFillHorizontal>
<FillDirection>Left</FillDirection>
</PercentFillHorizontal>
Discrete Pushbutton
The following elements can be specified for a discrete pushbutton animation link.
ButtonType Type of discrete button: {direct,

reverse, toggle, reset, or set}.
Required. Object is not created if
invalid or missing.
Expression Discrete type tag or expression.

Required. Object is not created if the
expression element is invalid or
missing.
KeyAssignment Virtual key element, empty string, or

absent. Default is no assignment. An
empty string means no assignment
occurs.
Example:
<ButtonDiscreteValue>
<Title>ButtonDiscreteValue1</Title>
<ButtonType>Reverse</ButtonType>
<KeyAssignment>
<KeyFlags>Shift</KeyFlags>
</KeyAssignment>
<Expression>
<![CDATA[dTag001]]>
</Expression>
</ButtonDiscreteValue>
Minimal example:
<ButtonDiscreteValue>
<ButtonType>Reverse</ButtonType>
<Expression><![CDATA[dTag001]]></Expression>
</ButtonDiscreteValue>
Show Window Pushbutton

If a named window does not exist at the time the link is generated, a warning is logged. The link is
generated wit hout any action for the window. At least one o f the named windows must exist, or the
ShowWindow animation link is not imported.
81
You can specify the following elements for a show window pushbutton animation link.
Element Description
WindowName Name of window to show. There must be at

least one window name specified or this
animation link is not added to the object.
Example:
<ButtonShowWindow>
<Title>ButtonShowWindow1</Title>
<WindowName>
<![CDATA[Window006]]>
</WindowName>
<WindowName>Window007</WindowName>
<WindowName><![CDATA[SliderWindow]]></WindowName>
</ButtonShowWindow>
Hide Window Pushbutton

If a named window does not exist at the time the link is generated, a warning is logged. The link is
generated wit hout any action for the window. At least one of the named windows must exist, or the
HideWindow animation link is not imported.
The following elements can be specified for a hide window pushbutton animation link.
Element Description
WindowName Name of window to hide. There must be at

least one window name specified or this
animation link is not added to the object.
Example:
<ButtonHideWindow>
<Title>ButtonHideWindow1</Title>
<WindowName>
<![CDATA[Window001]]>
</WindowName>
<WindowName>Window002</WindowName>
<WindowName> <![CDATA[SliderWindow]]> </WindowName>
</ButtonHideWindow>
Visibility
The following elements can be specified for a visibility animation link.
82
State Defines if the object can be seen.

Possible values are: {On, off}. Default is
on. Required if optional schema is used.

invalid or missing.
Example:
<Visibility>
<Title>Visibility1</Title>
<State>On</State>
</Visibility>
Minimal example:
<Visibility>
<State>On</State>
</Visibility>
Blink
The following elements can be specified for a blink animation link. The animation link blinks when the
expression is true.
BlinkAttribute {Invisible, visible}. Default is visible.
BlinkSpeed Defines the rate the object blinks. Possible

values are: {Slow, medium, fast}. Default is
medium.
TextColor Defines the color of the text that blinks.

Cont ains a color element. Default is
rgb(0,0,0)
LineColor Cont ains a color element. Default is

rgb(0,0,0)
FillColor Cont ains a color element. Default is

rgb(0,0,0)
Expression Discrete tag or expression. Required. Object

is not created if the expression is invalid or
missing.
Example:
<Blink>
<Title>Blink1</Title>
83
<TextColor><R>0</R><G>0</G>0</TextColor>
<LineColor><R>0</R><G>0</G>0</LineColor>
<FillColor><R>0</R><G>255</G>0</FillColor>
<BlinkAttribute>Invisible</BlinkAttribute>
<BlinkSpeed>Slow</BlinkSpeed>
</Blink>
Minimal example:
<Blink>
<BlinkAttribute>Visible</BlinkAttribute>
<BlinkSpeed>Fast</BlinkSpeed>
</Blink>
Orientation
The following elements can be specified for an orientation animation link. An orientation animation link
cannot be used with slider, size, location, or percent fill animation links.
X Horiz ontal offset from object center point.

Optional. Default is 0.
Y Vertical offset from object center point.

Optional. Default is 0.
CWMax Value at maximum clockwise rotation. Default

is 100.
CWRotation Clockwise rotation. Default is 360. Must range

from 0 to 360.
CWROTA TION+ CCWROTA TION cannot
exceed 360.
CCWMax Value at maximum counter clockwise rotation.

Default is 0.
CCWRotation Counter clockwise rotation. Default is 0. Must

range from 0 to 360.
CWRotation+CCWRotation cannot exceed 360.
Expression Analog tag or ex pression. Required. Object is

not created if the ex pression is invalid or
missing.
Example:
<Orientation>
<Title>Orientation1</Title>
<X>0</X> <Y>0</Y>
<CWMax>100.0</CWMax>
<CWRotation>360.0</CWRotation>
84
<CCWMax>0.0</CCWMax>
<CCWRotation>0.0</CCWRotation>
</Orientation>
Minimal example:
<Orientation>
</Orientation>
Disable
The following elements can be specified for a disable animation link.
State {On, off}. Default is On. Required if the

optional schema is used.

invalid or missing.
Example:
<Disable>
<Title>Disable1</Title>
<State>On</State>
</Disable>
Minimal example:
<Disable>
<State>On</State>
</Disable>
Static Tooltip
The following elements can be specified for a static tooltip animation link.
Message Static text message. Required. Object is

not created if invalid or missing.
Example:
<TooltipStatic>
<Title>TooltipStatic1</Title>
<Message>
<![CDATA[ Click here to win a million dollars!
]]>
</Message>
</TooltipStatic>
85
Dynamic Tooltip
The following elements can be specified for a dynamic tooltip animation link.
Expression Expression element. Required. Object is

not created if the ex pression is invalid or
missing.
Example:
<TooltipTag>
<Title>TooltipTag1</Title>
<Expression>
<![CDATA[sTag001]]>
</Expression>
</TooltipTag>
Discrete Value Display

The following elements can be specified for a discrete value animation link.
OnMessage The string to display when the value of

the animation link is True. Default text
is On
OffMessage The string to display when the value of

the animation link is False. Default text
is Off

Example:
<ValueDisplayDiscrete>
<Title>ValueDisplayDiscrete1</Title>
<Expression>
<![CDATA[dTag001]]>
</Expression>
<OnMessage>
<![CDATA[Pump is On]]>
</OnMessage>
<OffMessage>
<![CDATA[Pump is Off]]>
</OffMessage>
</ValueDisplayDiscrete>
Minimal example:
86
< ValueDisplayDiscrete>
</ValueDisplayDiscrete>
Analog Value Display

The following elements can be specified fo r an analog value animation link.

invalid or missing.
Example:
<<ValueDisplayAnalog>
<Title>ValueDisplayAnalog1</Title>
<Expression>
<![CDATA[aTag001]]>
</Expression>
</ValueDisplayAnalog>
String Value Display

The following elements can be specified for a string value animation link.
Expression Message tag or expression. Required.

Example:
<ValueDisplayString>
<Title>ValueDisplayString1</Title>
<Expression>
<![CDATA[sTag001]]>
</Expression>
</ValueDisplayString>
Pushbutton Action Scripts

Pushbutton action script elements are declared wit hin a button action script element, which is 0
declared within an animation links element.
Example:
<AnimationLinks>
<ButtonActionScripts>
<OnLeftDown>
<![CDATA[
87

]]>
</OnLeftDown>
</ButtonActionScripts>
</AnimationLinks>
On Left Key Down/On Key Down

Do not use both OnLeft Down and OnKeyDown animation links in the same object.
Example:
<OnLeftDown>
<![CDATA[
]]>
</ONLEFTDOWN>
While Left Key Down/While Key Down

The following elements can be specified for an WhileLeftDown or WhileK eyDown animation link.
Text Script text. Required.
Frequency Script execution frequency in

milliseconds. Range from 1 to 360000.
Required if optional schema is used.
Default is 1000.
Do not use WhileLeftDown and WhileKey Down animation links in the same object.
Example:
<WhileLeftDown>
<Text>
<![CDATA[
]]>
</Text>
</WhileLeftDown>
<
On Left Key Up/On Key Up

You place the text of a script in the OnLeftUp element. Do not use OnLeftUp and OnKeyUp animation
links in the same object.
Example:
<OnLeftUp>
<![CDATA[
88
]]>
</OnLeftUp>
On Left Key Double Click

You place the text of a script in the OnLeftDoubleClick animation link.
Example:
<OnLeftDoubleClick>
<![CDATA[
]]>
</OnLeftDoubleClick>
On Right Key Down/On Right Down

You place the text of a script in the OnRightDown element. Do not use OnRight Down and
OnRightKey Down animation links in the same object.
Example:
<OnRightDown>
<![CDATA[
]]>
</OnRightDown>
While Right Key Down/While Right Down

The following elements can be specified for an WhileRightKeyDown or WhileRightDown animation link.
Text Script text. Required

milliseconds. A number bet ween 1 and
360000. Default is 1000.
Do not use both WhileRightDown and WhileRightKeyDown animation links in the same object.
Example:
<WhileRightDown>
<Text>
<![CDATA[
]]>
</Text>
</WhileRightDown>
89
On Right Key Up/On Right Up

You place the text of a script in the OnRightUp and OnRightKey Up elements. Do not use both
OnRight Up and OnRightKeyUp animation links in the same object.
Example:
<OnRightUp>
<![CDATA[
]]>
</OnRightUp>
On Right Key Double Click

You place the text of a script in the OnRightDoubleClick element.
Example:
<OnRightDoubleClick>
<![CDATA[
]]>
</OnRightDoubleClick>
On Middle Key Down/On Middle Down

You put the text of a script in the OnMiddleKey Down element. Do not use OnMiddleDown and
OnMiddleKey Down animation links in the same object.
Example:
<OnMiddleDown>
<![CDATA[
]]>
</OnMiddleDown>
While Middle Key Down/While Middle Down

The following elements can be specified for an WhileMiddleKeyDown or WhileMiddleDown animation
link.
Text Script text. Required

milliseconds. A number bet ween 1 and
360000. Required if optional schema is
used. Default is 1000.
Do not use WhileMiddleDown and WhileMiddleK eyDown animation links in the same object.
Example:
90
<WhileMiddleDown>
<Text>
<![CDATA[
]]>
</Text>
</WhileMiddleDown>
On Middle Key Up/On Middle Up

You place the text of a script in the OnMiddleK eyUp and OnMiddleUp animation links. Do not use
OnMiddleUp and OnMiddleKey Up animation links in the same object.
Example:
<OnMiddleUp>
<![CDATA[
]]>
</OnMiddleUp>
On Middle Key Double Click

You place the text of a script in the OnMiddleDoubleClick element.
Example:
<OnMiddleDoubleClick>
<![CDATA[
]]>
</OnMiddleDoubleClick>
On Mouse Over
The following elements can be specified for an OnMouseOver animation link.
Text Script text. Required.
Timeout Timeout in milliseconds. Required if optional

schema is used. Default is 250.
Example:
<OnMouseOver>
<Text>
<![CDATA[
]]>
</Text>
91
<Timeout>250</Timeout>
</OnMouseOver>
Left Key Equivalent

The following elements can be specified for a Left Key equivalent animation link.
KeyCode Virtual key code name or empty string.

Required. An empty string means no
assignment occurs.
KeyFlags Virtual key flag combination or empty string.

assignment occurs. Disabled if no Key Code is
specified.
Example for "CTRL+B":

<LeftKey>
<KeyCode>B</KeyCode>
</LeftKey>
Example of a No Key Flag Modifier for "L":
<<LeftKey>
<KeyCode>L</KeyCode>
</LeftKey>
Example of a Both Key Flag Modifiers for CTRL+SHIFT+F7:
<LeftKey>
<KeyFlags>CtrlShift</KeyFlags>
</LeftKey>
Right Key Equivalent - Not Supported

The right key equivalent is not supported by the InTouch XML import functionality.
The following elements can be specified for a right key equivalent animation link.

assignment occurs.

assignment occurs. Disabled if no Key Code is
specified.
Example:
<RightKey>
92
</RightKey>
Middle Key Equivalent - Not supported

The middle key equivalent is not supported by the InTouc h XML import functionality.
The following elements can be specified for a middle key equivalent animation link.

assignment occurs.

assignment occurs. Disabled if no Key Code
is specified.
<MiddleKey>
</MiddleKey>
Unsupported InTouch Features

Wizards and ActiveX controls cannot be imported using the XML import functionality.
You cannot import tags or the tag database using the XML import functionality. You can create a file
containing tag definitions and use the DBLoad utility to import them to an application's Tagname
Dictionary. For more information about using DBLoad, see the InTouch Data Management Guide. For
information about running DBLoad from the command prompt, see Running DBLoad from the
Command Prompt on page 22.
93
Index
A
alarmcolor element
discrete alarm fill color • 67
discrete alarm line color • 63
discrete alarm text color • 72
animation links
bitmap objects • 47
button objects • 48
ellipse objects • 40
hv line objects • 41
line objects • 41
polygon objects • 44
polyline objects • 43
rectangle objects • 37
rounded rectangle objects • 38
text objects • 45
vertical line objects • 42
ArchestrA IDE Extension • 20
B
blinkattribute element • 83
blinkspeed element • 83
bottomvalue element, vertical slider • 74
buttondiscretevalue element • 81
buttonhidewindow element • 82
buttonshowwindow element • 81
buttontype element • 81
C
ccwmax element • 84
ccwrotation element • 84
CDA TA
user supplied text • 26
window scripts • 34
cell objects, unsupported • 55
ckeyflags element • 92
color elements • 26
colors
RGB element • 26
colors element • 66
COMMA NDLOGFILE command • 15
commands
COMMA NDLOGFILE • 15
GO • 15
NEWWINDOWNAME • 15
OLDW INDOW NAME • 15
OUTP UTFILE • 15
OUTP UTTA RGE T • 15
OUTP UTTA RGE TNAME • 15
PRINTAPPLICA TIONINFORMA TION • 15
REFERE NCE TYPE • 15
SEARCHFOR • 15
VERSION • 15
WINDOWCREA TE • 15
WINDOWDELE TE • 15
WINDOWMAKERCOMMA NDFILE • 15
WINDOWNAME • 15
WINDOWRE NAME • 15
XMLFILEPA TH • 15
cornerdimension element • 36
cornerdimension element • 38
CROSSREFE RENCE command • 15
cwmax element • 84
cwrotation element • 84
D
declaration, XML • 25
decreasemovement element
horizontal location • 78
vertical location • 77
deviation element • 64
dimension elements
definition • 29
smartsymbols • 50, 52
text objects • 45
downwardmovement element • 74
E
echo character element • 60
echocharacters element • 60
encryptenabled element • 60
examples
analog alarm fill color • 68
analog alarm line color • 64
analog alarm text color • 72
analog fill color • 66
analog line color • 62
analog text color • 70
analog user input • 59
analog value display • 87
blink animation • 83
deviation alarm • 64
dimension element • 29
disable animation • 85
discrete fill color • 65
discrete line color • 61
discrete pushbutton • 81
discrete text color • 70
discrete user input • 57
discrete value display • 86
dynamic tooltip animation • 86
expression • 29
hide window pushbutton • 82
horizontal line objects • 41
horizontal percent fill • 80
horizontal sliders • 75
ini file • 17
key code strings • 30
left key equivalent • 92
line objects • 41
object height • 75
object width • 76
on left key double click • 89
on left key down • 88
on left key up • 88
on middle key double click • 91
on middle key down • 90
on middle key up • 91
on mous e over • 91
on right key double click • 90
on right key down • 89
on right key up • 90
onhide • 35
onshow window script • 34
orientation animation • 84
pen elements • 28
RGB elements • 26
ROC alarm • 64
show window • 81
smartsymbols • 50, 51
static tooltip animation • 85
string value display • 87
text objects • 45
user input string • 60
vertical percent fill • 79
vertical slider • 74
visibility animation links • 82
while left key down • 88
while middle key down • 90
while right key down • 89
whileshowing • 35
window elements • 32
XML declaration • 25
expression elements
analog value display • 87
blink • 83
disable animation • 85
dynamic tooltip • 86
horizontal sliders • 75
object width • 76
orientation animation • 84
string value displays • 87
expressions • 29
F
file header, XML • 25
fillcolor element
blink element • 83
fillcolor element
default value • 36
fillcoloranalog element • 66
fillcoloranalogalarm element • 68
fillcolordiscrete element • 65
fillcolordiscretealarm element • 67
filldirection element
fillmax element
fillmaxpercent element
fillmin element
fillminpercent element
flip element • 36
font element • 36
fontsize element • 36
fontstyle element • 36
fontweight element • 36
framestyle elements • 32
frequency element
whileshowing window • 35
G
GO command • 15
H
highcolor element • 64
hihicolor element • 64
historical trend objects, unsupported • 55
I
increasemovement element
inputonly element
K
keyassignment element
keycode element • 92
keypadenabled element • 59, 60
L
leftmovement element • 75
left value element • 75
linecolor element • 83
locationhorizontal element • 78
locationvertical element • 77
locolor element • 64
lolocolor element • 64
M
majorcolor element • 64
maxanalogvalue element • 59
max value element
message elements
static tooltip animation links • 85
minanalogvalue element • 59
minorcolor element • 64
minvalue element
N
NEWWINDOWNAME command • 15
normalcolor element • 64
O
objectlist elements • 32
objects, windows • 35
objectsizeheight element • 75
objectsizewidth element • 76
offcolor element
offmessage elements
discrete user inputs • 57
OLDW INDOW NAME command • 15
oncolor element
onleftdown element • 88
onleftup element • 88
onmessage elements
OUTP UTFILE command • 15
OUTP UTTA RGE T command • 15
OUTP UTTA RGE TNAME command • 15
P
passwordcharacter element • 60
pen color elements • 28
pen dimensions • 37
pen element
definition • 28
ellipse object • 40
line objects • 41
polygon object • 44
rectangle object • 37
rounded rectangle object • 38
pen style elements • 28
pen width elements • 28
pencolor element • 36
penstyle element
limitations • 37
penwidth element
limitations • 37
percentfillhorizontal element • 80
percentfillvertical element • 79
point element • 28
points element
line objects • 41
PRINTAPPLICA TIONINFORMA TION command • 15
Process InTouch Command File • 20
R
real-time trend objects, unsupported • 55
referencelocation element
horizontal slider • 75
REFERE NCE TYPE command • 15
resetprompt element
RGB elements • 26
rightmovement element • 75
right value element, horizontal slider • 75
ROC element • 64
roccolor element • 64
rotation element • 36, 45
S
schemas
limitations • 25
script elements
on mous e over • 91
whileshowing window element • 35
scripts • 34
SEARCHFOR command • 15
setprompt element • 57
sizeanchor element
object width element • 76
sizecontrols element • 32
sizemax element
object width • 76
sizemaxpercent element
object width • 76
sizemin element
object width • 76
sizeminperc ent element
object width • 76
smartsymbols
example • 51
string replacement • 51
stringreplace element • 50
tag replacement • 51
soruceimage element • 47
state element
disable animation links • 85
strikeout element • 36
string replacement • 51
stringreplace elment • 50
symbol objects, unsupported • 55
symbolname element • 50, 52
T
tag replacement, smartsymbols • 51
tagreplace element • 50, 52
text, user supplied • 26
textcolor element
blink element • 83
textcoloranalog element • 70
textcoloranalogalarm element • 72
textcolordiscretealarm element • 72
textinfo element
text objects • 45
textjustify element • 36
textstring element
text objects • 45
timeout element • 91
title element
line objects • 41
text objects • 45
tooltipstatic element • 85
tooltiptag element • 86
topvalue element • 74
transparent colors, bitmap objects • 47
transparent element
U
underline element • 36
upwardmovement element • 74
user supplied text • 26
V
value element
linecoloranalogalarm element • 64
valuedisplayanalog element • 87
valuedisplaydiscrete element • 86
valuedisplaystring element • 87
values element • 66
VERSION command • 15
virtual key codes • 30
virtual key flags • 30
visibility element • 82
W
whileleft down element • 88
window elements
backgroundcolor element • 32
comment element • 32
definition • 32
dimension element • 32
framestyle element • 32
objectlist • 32
sizecontrols • 32
title element • 32
titlebar element • 32
windowstyle element • 32
window objects
cornerdimension • 36
explanation • 35
fillcolor element • 36
flip element • 36
font element • 36
fontsize element • 36
fontstyle element • 36
fontweight element • 36
pencolor element • 36
penstyle element • 36
penwidth element • 36
rotation element • 36
strikeout element • 36
textcolor element • 36
textjustify element • 36
transparent element • 36
underline element • 36
window scripts
definition • 34
WINDOWCREA TE command • 15
WINDOWDELE TE command • 15
WINDOWMAKERCOMMA NDFILE command • 15
WINDOWNAME command • 15
windowname element • 81, 82
WINDOWRE NAME command • 15
windowstyle elements • 32
X
X element • 28, 84
XML
declaration • 25
extraneous elements • 25
file header • 25
XMLFILEPA TH command • 15
Y
Y element • 28, 84

Wonderware Guide To Creating Intouch Windows Programmatically

Uploaded by

Copyright:

Available Formats

Wonderware Guide To Creating Intouch Windows Programmatically

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Wonderware Guide To Creating Intouch Windows Programmatically

Uploaded by

Copyright:

Available Formats

Wonderware Guide to Creating InTouch

Chapter 1 Preparing an XML File...................................................................................... 11

Chapter 2 Using an XML File to Import a Window ......................................................... 13

Chapter 3 XML Formats...................................................................................................... 25

Common Element Definitions ................................................................................................... 26

Discrete Alarm Fill Color .............................................................................................. 67

Convention Used for

Initial Capitals Paths and file names.

Bold Menus, commands, dialog box names, and dialog box

Monospace Code samples and display text.

About Preparing an XML File

About Using an XML File to Import a Window

 Launching console sessions

Preparing a Command File

Creating a Minimum Command File

Sending Print Information to a File

Sending a Cross Reference to a File

Creating a Log File

.WINDOWMAKERCOMMANDFILE Identifies the file as being a WindowMaker

.VERSION=1 This command indicates to WindowMaker

.COMMANDLOGFILE=<Full File Path> Information, warnings, and errors are logged

.GO Runs the command. Required after a

.WINDOWCREA TE Creates a window from an XML file.

.WINDOWDELE TE Delet es the specified InTouch application

.WINDOWNAME=<Window Name> Name of the window to delete. Required

.WINDOWRENAME Renames a window. If the 'old' name cannot

.OLDWINDOWNAME=<Existing Window Current window name. Required when the

.NEWWINDOWNAME=<New Window Name> New window name. A window with this

.PRINTAPPLICA TIONINFORMA TION Prints or dumps the InTouc h application

.OUTPUTTA RGE T=P rinter|TextFile Sends output to a printer or text file.

.CROSS REFERE NCE Generat es cross reference information in

.SEARCHFOR= TagName|QuickFunctions Searches for tags or QuickFunctions by

. REFERENCE TYPE= ByTagName|ByWindow Cross-references by tag or window name.

Adding Tags to Newly Generated Application

Missing ArchestrA Symbols

Expressions, Tag Names, and Scripts

Running WindowMaker from the Command Prompt

ArchestrA IDE Extension

Running WindowMaker from Managed InTouch Applications

Running DBDump from the Command Prompt

Running DBDump for Managed InTouch Applications

Running DBLoad from the Command Prompt

Running DBLoad for Managed InTouch Applications

General XML File Format

XML File Header

Extraneous XML Elements

Preserving Text White Space

Common Element Definitions

Color Name Elements

<TextColor> <Name>White</Name> </TextColor>

Color Reference Elements

Color Value Elements

Font Name of font families, such as 'System' or

FontStyle Values can be {Regular, Italic, Bold,

FontSize Need to indicate font size unit of meas ure.

Underline Underlined text: {true or false}.

Strikeout Struck out text: {true or false}.

TextColor Color element for text color.

TextJustify Text justification: {Left, Center, or Right}