InTouch 10.1 Readme file:///media/rhandsome/Toshiba/Wonderware/Do...

Wonderware® InTouch® HMI Version 10.1

Readme
Last revision: 01/30/2009

This document contains important information about Wonderware® InTouch HMI Version 10.1. Review this
document for known issues and changes to InTouch 10 documentation included on this CD.

Important!
1. If you are using managed InTouch applications with ArchestrA symbols, before installing
Wonderware Application Server 3.1, run the ArchestrA Symbol Analysis and Repair Utility and
ensure all issues reported by the utility are addressed.

2. If InTouch 10.0x and Application Server 3.0x are installed on the same node, they both must
be upgraded to Application Server 3.1 and InTouch 10.1.

3. If your version of Wonderware Application Server is older than version 3.0, you must upgrade
it before upgrading to InTouch 10.1.

4. Galaxies with ArchestrA Symbols or InTouchViewApp Objects containing ArchestrA Symbols

that leverage the Runtime Language Switching functionality, must always be modified on the
same language operating system and InTouch language version with which it was initially
developed. Attempts to modify these components in a different language operating system,
or a different InTouch language version may result in unexpected behavior and is not
presently supported. Published applications running in an operating system langauage
different from the originally developed language are supported. Refer to Known Issues CRs
L00088974, L00088993, and L00088998.

5. The antivirus software exclusions list has been updated. Click this Antivirus Software
Exclusions link for details.

About This Release

Antivirus Software Exclusions

System Requirements

Resolved Issues – InTouch 10.1

Known Issues – InTouch 10.1

InTouch Documentation Issues

InTouch Documentation

About This Release

Version 10.1 of Wonderware® InTouch HMI includes the following enhancements and new features:

Language Switching for ArchestrA Symbols

You can switch to localized strings for ArchestrA Symbols. This includes any configuration-time changes to support

1 of 10 04/28/2015 04:57 PM
InTouch 10.1 Readme file:///media/rhandsome/Toshiba/Wonderware/Do...

the extracting and importing of text strings.

You can localize the following strings:

Text constant custom properties

Text graphics
Text overrides of custom properties in WindowMaker

You can also add, edit, and remove the locale data from the Symbol Editor.

Licensing
InTouch licensing now accounts for Terminal Service sessions. The licensing system now enforces per session
licensing to prevent running unlicensed copies of InTouch within Terminal Server Sessions.

Non-Administrator Interactive User

At a high level, this feature allows InTouch run-time functionality to be run by users who do not have
administrative rights on the computer. It does not provide this support for configuration operations.

Functionality is available for the following operating systems:

Windows XP SP3 (Power user)

Windows 2003 SP2, R2 + SP2 (Power user)

Windows Vista SP1 (Standard user with the UAC enabled)

Well-known Client Control Support

The Symbol Editor has been extended to allow new Graphic Objects to appear in the Symbol Editor tool palette.

Printing Enhancements
Several printing features are added to the InTouch HMI:

Saving and Printing a Tag Cross-Reference List

Printing Scripts

Printing Information about WindowMaker Objects

Printing Information about InTouch Windows
Printing Window Information from a Command Prompt

Deployed File Management

You can add additional files in a managed InTouch application so they are deployed and available at run time.

< top of document >

Antivirus Software Exclusions

Configure your antivirus software to prevent archive files from being scanned. Also, antivirus software should not
scan files in the following ArchestrA folders (ensure subfolders of the listed directories are also excluded):

C:\Program Files\ArchestrA\

2 of 10 04/28/2015 04:57 PM
InTouch 10.1 Readme file:///media/rhandsome/Toshiba/Wonderware/Do...

C:\Program Files\Common files\ArchestrA\

C:\Program Files\FactorySuite\ (may not exist in newer installations)
C:\Program Files\Wonderware\
C:\InSQL\Data\
C:\Documents and Settings\All Users\Application Data\ArchestrA

From Application Server Platform objects:

History Store Forward directory: (if not default)

From Application Server Engine objects:

Checkpoint directory location (if not default)

<InTouch Application folder path> including:

C:\Documents and Settings\All Users\Application Data\ArchestrA\

<SMC Logger Storage file path>. The default is:

C:\Documents and Settings\All Users\Application Data\ArchestrA\LogFiles\

SQL Server database files of type:

.mdf

.ldf

< top of document >

System Requirements
This section describes the hardware and software requirements to install Wonderware® InTouch HMI Version 10.1.

Hardware Requirements

Software Requirements

Other Software Requirements

Hardware Requirements
The following lists show the recommended specifications to install Wonderware® InTouch HMI Version 10.1. These
recommendations are for development systems. Run-time requirements may be different, depending on the
InTouch application and other factors.

Computer with 1.2 gigahertz (GHz) or faster processor

512 MB of memory minimum, 1 gigabyte (GB) or greater recommended

At least 4 GB of available disk space

Super VGA (1024 × 768) or higher-resolution video adapter and monitor

CD-ROM or DVD drive for installation

Keyboard
Mouse or compatible pointing device

3 of 10 04/28/2015 04:57 PM
InTouch 10.1 Readme file:///media/rhandsome/Toshiba/Wonderware/Do...

Software Requirements
The following table lists the supported operating systems that can be installed on computers that run InTouch
server and client components.

Product Name Components

ArchestrA ArchestrA Galaxy

WindowMaker WindowViewer
Operating Systems IDE Run Time Repository

Windows Vista Business

● ● ● ● ●
(See Vista Restrictions)

Windows Vista Business SP1

● ● ● ● ●
(See Vista Restrictions)

Windows Vista Enterprise

● ● ● ● ●
(See Vista Restrictions)

Windows Vista Enterprise SP1

● ● ● ● ●
(See Vista Restrictions)

Windows Vista Ultimate

● ● ● ● ●
(See Vista Restrictions)

Windows Vista Ultimate SP1

● ● ● ● ●
(See Vista Restrictions)

Windows 2003 Standard Server R2 ● ● ● ● ●

Windows 2003 Standard Server

● ● ● ● ●
SP2

Windows 2003 Enterprise Server

● ● ● ● ●
R2

Windows 2003 Enterprise Server

● ● ● ● ●
SP2

Windows XP Professional SP3 ● ● ● ●

Windows XP Tablet ● ● ●

Note:

InTouch HMI version 10.1 does not support any version of the Microsoft Windows 2000 operating
system. If you attempt to install or upgrade the InTouch HMI on a computer running Microsoft Windows
2000, an error dialog box appears during the installation procedure.

Microsoft Windows 2003 Standard Server R2 is the recommended operating system to run InTouch
server components.
Microsoft Windows XP Professional SP3 is the recommended operating system to run InTouch client
components.

Vista Restrictions

InTouch HMI version 10 or later can run under Windows Vista Enterprise, Windows Vista Business, or
Windows Vista Ultimate. The Windows Vista Home Basic and Home Premium editions are not
supported.

You can run InTouch only on computers running a 32-bit operating system. You cannot run InTouch on a
computer running a 64-bit operating system.

4 of 10 04/28/2015 04:57 PM
InTouch 10.1 Readme file:///media/rhandsome/Toshiba/Wonderware/Do...

Windows Vista does not support a dedicated single-node server configuration that runs one or more
databases for an InTouch HMI system.

If a computer runs Windows Vista as part of an InTouch system, it cannot be configured to be both an
InTouch and ArchestrA alarm provider. The computer running Windows Vista can be either an InTouch or
ArchestrA alarm provider, but not both simultaneously.

Windows Vista does not support NetDDE for InTouchView applications. By design, an InTouchView
application does not serve data to any other source, including InTouch itself. When WindowViewer
starts, it verifies if the application is an InTouchView application. When WindowViewer detects an
InTouchView application, it does not register to become a DDE server.

ArchestrA graphics make use of the client layer when accessing InTouch tags, and appear as a
third-party client trying to access WindowViewer as a data server. As a result, ArchestrA symbols cannot
communicate with InTouch tags when used with an InTouchView license. Windows Server 2003 and
Windows XP Pro still support NetDDE.

InTouch HMI cannot be configured to run as a Windows Vista service. Windows Vista security prevents
started Windows services from interacting with desktop objects. When the InTouch HMI is installed on a
computer running Windows Vista, scripts do not run correctly if they include the InTouch ActivateApp()
and SendKeys() functions. These functions interact with desktop objects by starting Windows programs
and sending keystrokes to these programs.

Other Software Requirements

The following list describes other third-party software required for Application Server version 3.1.

Microsoft .NET Framework 3.5

Microsoft .NET Framework 3.5 must be installed on every computer that hosts an InTouch version 10.1
component. The InTouch installation program stops if .NET Framework 3.5 is not installed on the target
computer. A dialog box appears requesting that you install .NET Framework 3.5. If you click Install
Prerequisites, the installation program automatically installs .NET Framework 3.5.

Microsoft SQL Server 2005

Microsoft SQL Server 2005 SP1 or SP2 database must be installed on the same computer as the
ArchestrA Galaxy Repository.

< top of document >

Resolved Issues in Wonderware® InTouch HMI

Version 10.1
Wonderware® InTouch HMI Version 10.1 resolves the following issues. The issues are listed by their Change
Request number:

L00034858: For an action script, double-clicking text within the double quotes selects additional text beyond
the double-quotes, when a colon (:) follows the text. (See SR1036163)

5 of 10 04/28/2015 04:57 PM
InTouch 10.1 Readme file:///media/rhandsome/Toshiba/Wonderware/Do...

L00037488: You can instantiate a SmartSymbol that references a tag that does not exist. (See SR#2351687)

L00039308: The InfoAppTitle function does work with non-administrator user rights. (See SR 1036792)

L00041099: Printscreen and Printwindow functions do not work if WindowViewer is running as service.

L00048778 Placing an apostrophe (single quote) in the comment text box of a discrete alarm tag (OnMsg)
causes the Alarm DB Logger to fail to log an alarm.

L00067243: Control label text is scrambled when created using the Wizard Graphics and saved as a
SmartSymbol. (See SR 23514920)

L00071647: The OnShow script in an ArchestrA Symbol appears to run, but the script does not set an
attribute. (See SR14811879)

L00072300: When a client control is deleted and a new version of the client control is imported from a remote
IDE, an ArchestrA Symbol referencing the client control will show Version 1 on the remote IDE
and Version 2 on the Galaxy Repository IDE. This is a mismatch of versions. (See SR103112086)

L00073550: The graphic element reference list is incomplete, or it is corrupted. The error message "Failed to
get Graphic element reference list" appears in the SMC logger. (See SR23515471)

L00075206: Customized graphic text is lost after group change. (See SR14811926)

L00075269: The RegisterEngine number decreases when a new connection is made using remote desktop
(TSE) to the Application Server. (See SR 16310052)

L00075763: Custom property links for ArchestrA symbols do not accept the following special characters that
can be used in InTouch tag names: _(underscore), -(hyphen), $(dollar), %(percent), and
&(ampersand).

L00075800: MX References do not start in scripting; .InputSource in ArchestrA Symbols does not start in
scripting. The MX References do work on display the link and in a custom property. (See
SR15010810)

L00076011: Graphic symbol custom property overrides are lost after group change. (See SR 14811926)

L00076900: Warning "Could not find embedded graphics" appears after a template and its instances of a
Galaxy are exported as an aaPKG file, and are then re-imported into a new Galaxy. (See
SR33430263)

L00081430: License enforcement of Terminal Service Edition does not work. Too many WindowViewer sessions
are permitted to open.

L00081739: The Graphic toolbox pop-up window and the Graphics tab preview window thumbnails show "not
found" when an application object instance containing symbols with date time picker is imported
in a new Galaxy.

L00083495: SPC Pro does not work when WindowViewer is started up directly on a computer with a standard
user login.

L00085207: If you are using the SPC Control Chart on the Windows Vista operating system, you need to
specify a System Data Source Name (DSN) and make sure that all application users can write to
the folder in which the database file resides.

1) The ODBC data source needs to be created as a System DSN and not as a User DSN. As
application creator must be admin/power-user and application user can be standard user, it is
likely these will be different users. A User DSN won't work for standard user and gives errors in
the SMC.

2) If you are using a database file (such as a Microsoft Access MDB file), then application creator
must ensure that the application user can write to the folder in which the database file resides.
Writing is required for database access (for example, adding sample points in the database). By

6 of 10 04/28/2015 04:57 PM
InTouch 10.1 Readme file:///media/rhandsome/Toshiba/Wonderware/Do...

default, most folders are not write-enabled.

< top of document >

Known Issues in Wonderware® InTouch HMI

Version 10.1
This section describes all known issues in Wonderware® InTouch HMI Version 10.1. The issues are listed by their
Change Request number:

L00077445: Touch push button animations do not work on client controls.

L00078446: The Symbol Editor stops responding when you edit the "format string" property of the “checked
list box” client control.

L00081354: Windows do not print if the window name contains special characters.

Rename the directory path and the filename to remove all special characters.

L00082814: WindowViewer does not start when configured to start as a service. An error message appears
“Access denied.” The user win.ini and the MS Windows system win.ini are not in sync.

See http://support.microsoft.com/kb/832048 to pick up the correct system win.ini file.

L00083270: Spaces are not imported as part of the translation for the selected language.

L00083636: Terminal Server sessions crash when a ViewApp is changed and then redeployed while
WindowViewer is running in a 100-terminal session configuration across 10 Terminal Servers.

For certain applications and systems, you need to adjust the restart delay time by adding
"ViewManagedRestartWaitPeriod" to the "Intouch" section in the Win.ini file. The default delay
time is 5-seconds.

L00083828: There are inconsistencies between the selected language and the strings that are shown.

L00083847: After you click "NO" in the Network Application Development properties dialog box, WindowViewer
does not ask you to "restart" and "load" changes.

L00083909: InTouch applications receive quality status and locale information from the deployed Galaxy.
InTouch applications cannot receive data from an undeployed Galaxy.

L00084010: Translations are not loading after embedding a primitive from a different Galaxy employing a
different language. Only the default English strings are shown.

L00084834: The Annotation window stops responding if you use standard Windows cut, copy, and paste
shortcuts.

Microsoft provides a Microsoft.Ink.dll CLR2.0 Update. See the following link to download the
update.
http://www.microsoft.com/downloads/details.aspx?FamilyID=84bbefa4-7047-41df-
8583-e3bdbf9d805f&DisplayLang=en

L00086229: Running the AlarmDBLogger Manager as a Windows service is not working.

Disable this option for Vista.

7 of 10 04/28/2015 04:57 PM
InTouch 10.1 Readme file:///media/rhandsome/Toshiba/Wonderware/Do...

L00088095: If you are a Terminal Server user and you do not have "Administrator" privileges, you must be
either a "Power User," or a "Remote Desktop User" to access the license. Otherwise, you receive a
licensing error message. It is not obvious that you are missing rights and privileges necessary to
successfully login.

L00088673: Non-English locale animation static "text" strings are not propagated to default (English) locale
static "text" strings.

L00088871: Exporting the language dictionary using Microsoft Vista may result in not being able to retrieve
the dictionary file as a standard user.

When running WindowMaker as a standard user elevated to administrator rights as a different

user than logged onto the Desktop, exporting the Language dictionary opens a default path that
is not accessible by the standard user.

It is recommend that you change the path to a public folder location.

L00088974: When an ArchestrA Symbol is exported from an application developed with an English version of
InTouch and imported into an application developed in a different InTouch Language, like French,
the strings of the ArchestrA Symbol cannot be substituted in WindowMaker.

L00088993: An ArchestrA Symbol with string substitutions is not showing the string substitutions in
WindowMaker when the Galaxy Primary language is not English.

L00088998: InTouch Applications, which are configured to support runtime language switching and contain
ArchestrA Symbols and native InTouch animations, initially show mixed language strings, if
executed in an operating system language different from the one in which it was originally
developed.

L00089000: The EnableDisableKeys function does not work in a Vista operating system, if the user is
configured as a Standard User. Use the runtime environment configuration options in
WindowMaker in addition to the operating system security policies to lock the application from
access to the desktop.

< top of document >

InTouch Documentation Issues

The following table lists all documentation corrections to InTouch 10.1 documentation.

Item Location of Change Existing Change

Documentation

1 Creating and Managing n/a Add the following text after the first paragraph:
ArchestrA Graphics
User’s Guide If you perform a first-time string substitution on an
(aaGraphics.pdf), embedded symbol in the primary language, that
"String Substitutions substitution is shown in the secondary languages. You can
and Language then perform a substitution in the secondary language to
Switching" section, create a string substitution specific to the secondary
page 426 language.

Application Server Help If you perform a first-time string substitution on an

(IDE.chm), embedded symbol in a secondary language, the
"String Substitutions substitution is also applied to the primary language,
and Language because the translated string that previously existed for
Switching" topic the primary language is no longer valid. Because the
primary language value is changed in the symbol, this

8 of 10 04/28/2015 04:57 PM
InTouch 10.1 Readme file:///media/rhandsome/Toshiba/Wonderware/Do...

string applies to all secondary languages configured. You

can then perform a second substitution in the primary
language, which will apply to all secondary languages
except the ones that have had a specific substitution set.

If you perform a string substitution in a secondary

language with an existing string substitution in the primary
language, the new substitution is applied to the secondary
language only.

2 InTouch® HMI The current screen The screen capture should show "Conveyor,Main,Reactor
Documentation capture shows display,Menu"
Addendum "Conveyor, Main,
(ITAddendum.pdf), Reactor display,
".CVS Format for Menu"
Printing Windows"
topic, page 25

< top of document >

InTouch Documentation
The InTouch product library consists of a set of Portable Document Files ( PDF) located in the UserDocs folder of
the InTouch installation CD. You need Adobe Reader installed on your computer to view InTouch documentation.
You can download the latest version of Adobe Reader from the Adobe Corporation web site:

http://www.adobe.com/products/acrobat/readstep2.html

After installing Adobe Reader, double-click on a PDF file with your pointing device to view the book with Adobe
Reader. You can also open a book with the Adobe Reader Open command from the File menu.

InTouch installation instructions are located in the root folder of the InTouch installation CD as an online help file.
You can view these instructions by clicking Help as you complete the InTouch installation procedure.

Context-sensitive documentation is also available with InTouch online help. Select Help for information about the
current InTouch window that you have open on your computer.

Searching InTouch Books with Adobe Reader

The InTouch version 10 books are delivered as an Adobe PDF package, which provides a master index of all books.
Using Adobe Reader, you can simultaneously search for a specific topic across all books that belong to the InTouch
product library.

To search for information across all InTouch books simultaneously

1. Open Adobe Reader.

2. Press CTRL+SHIFT+F or select Search from the Edit menu. The Search dialog box appears.
3. Type the word or phrase that you want to search for in the InTouch books.
4. In the Where would you like to search area, select the option to search all PDF books.

5. If necessary, locate the InTouch version 10 PDF package located on your Wonderware CD or on a

9 of 10 04/28/2015 04:57 PM
InTouch 10.1 Readme file:///media/rhandsome/Toshiba/Wonderware/Do...

network folder containing copies of the InTouch PDF book files.

6. Click Search. Adobe Reader lists the InTouch books containing information that matches your search
criteria.
7. Click on the links to open the InTouch book to the topic containing the information that meets your
search criteria.

< top of document >

© 2009 Invensys Systems, Inc. All Rights Reserved.

10 of 10 04/28/2015 04:57 PM