InTouch 10.0 Patch 02

InTouch version 10 Patch 02 Readme

Last revision: 02/11/2008

About This Readme

This Readme combines information from previous Readme files distributed with Wonderware® InTouch version 10.0 and InTouch version 10.0 Patch 01. The information from these Readme files are in chronological order based on when the InTouch versions were released.

This Readme explains how to apply Patch 02 to InTouch version 10.0 and upgrade an earlier version of InTouch to version 10.0 Patch 02. It also explains how to migrate applications from earlier versions of InTouch to the current version.

This Readme lists all resolved issues in InTouch version 10.0, Patch 01, and Patch 02. It also includes any known product issues that remain unresolved.

InTouch 10.0 Patch 02 is distributed by two separate product packages:

• Patch 02 includes two files (Setup.msp and Readme.html) to update an existing instance of InTouch version 10.0 to InTouch 10.0 Patch 02. Localized versions of Patch 02 are available to download from the Wonderware Technical Support web site. Patch 02 is also distributed as a mini-CD containing localized versions of the Patch 02 files in separate folders.
• InTouch 10.0 with Patch 02 Product CD includes a complete set of files to install or upgrade InTouch to version 10.0 Patch 02. This is the current product distribution CD and is available in localized versions for all languages supported by InTouch.

The following table shows the installation, update, and upgrade pathways to InTouch version 10.0 Patch 02:

Current Installed Version of InTouch	Full InTouch 10.0 with Patch 02 Product CD	InTouch Patch 02
None (New Install)	●
InTouch version 10.0.001 (Patch 01)	●	●
InTouch version 10.0.000	●	●
InTouch version 9.5 Patches 01, 02, 03, and SP1	●
InTouch version 9.0 Patch 03	●
InTouch version 8.0 SP2 Patch 04	●

Use the following links to the various sections of this Readme.

InTouch version 10.0 Patch 02 Information

Requirements to Apply InTouch 10.0 Patch 02

Applying Patch 02 to InTouch version 10.0

Upgrading Earlier Versions of InTouch to InTouch Version 10.0 Patch 02

Migrating Applications from Earlier Versions of InTouch to Patch 02

Resolved Issues - InTouch version 10.0 Patch 02

InTouch version 10 Patch 01 Information

Applying Patch01 to InTouch version 10

Resolved Issues - InTouch version 10 Patch 01

Known Issues - InTouch version 10 Patch 01

InTouch Documentation Issues

InTouch version 10 Information

New Features of InTouch version 10

System Requirements

Upgrading from a Previous Version

Known Issues – InTouch HMI version 10

InTouch HMI Documentation Issues

InTouch HMI Documentation

< top of document >

---

Requirements to Apply InTouch 10.0 Patch 02

This section describes the hardware and software requirements to install InTouch 10.0 Patch 02, which are the same as InTouch version 10.0. Use the following links for information about the hardware and software requirements applicable to Patch 02.

• Hardware Recommendations
• Software Requirements

Other Software Requirements for InTouch 10.0 Patch 02

The following software requirements are in addition to the original requirements listed for InTouch version 10.0:

• You must apply Patch 01 to Wonderware Application Server version 3.0 if you intend to use it with InTouch 10.0 Patch 02. Wonderware Application Server 3.0 Patch 01 is available on the InTouch Patch 02 mini-CD in a folder named Application Server Patch 01 and is downloadable from the Wonderware Technical Support web site. Refer to the Readme file within the Application Server Patch 01 folder for more information about applying Patch 01 to Wonderware Application Server version 3.0.
• You must apply Patch 01 or greater to Wonderware Application Server 2.1 if you intend to use it with InTouch Patch 02. InTouch 10.0 Patch 02 supports Microsoft .NET Framework 2.0 or 3.0. Without Patch 01, Wonderware Application Server version 2.1 does not support .NET Framework 2.0.

< top of document >

---

Applying Patch 02 to InTouch version 10.0

This section explains how to apply Patch 02 to existing instances of InTouch version 10.0 installed at your site. After Patch 02 is applied, InTouch is at version 10.0.002.

You can use either Patch 02 or the InTouch 10.0 with Patch 02 product CD to update an existing instance of InTouch version 10.0 to Patch 02.

• For instructions to update InTouch version 10.0 with Patch 02, see Updating to InTouch version 10.0.002 with Patch 02.
• For instructions to update InTouch version 10.0 with the InTouch 10.0 with Patch 02 product CD, see Updating to InTouch version 10.0.002 with the InTouch version 10.0 with Patch 02 Product CD.

Updating to InTouch version 10.0.002 with Patch 02

You can apply Patch 02 to the following versions of InTouch:

• InTouch version 10.0.000
• InTouch version 10.0.001

Important:

InTouch Patch 02 must be applied only to InTouch version 10.0. No other version of InTouch can be upgraded with this patch. For instructions to upgrade earlier versions of InTouch to version 10.0 Patch 02, see Upgrading Earlier Versions of InTouch to InTouch 10.0 Patch 02.

Patch 02 consists of two files; this Readme and a Setup.msp file. The Patch 02 Setup.msp patch file can be downloaded from the Wonderware Technical Support web site or from the Patch 02 mini-CD. The mini-CD contains folders of localized versions of the Setup.msp file for the various languages supported by InTouch version 10.0.

If you download the Patch 02 Setup file from Wonderware's Technical Support web site, you can copy the Setup.msp patch file directly to the computer where InTouch is installed, or burn it to a CD.

To update InTouch version 10.0 with Patch 02

1. Close Application Manager, WindowMaker, or WindowViewer if they are running.
2. Place the Setup.msp patch file in a folder on the computer where InTouch is installed, or place the Patch 02 mini-CD into the computer's CD-ROM drive.
3. Open Windows Explorer, and then move to the location where the InTouch patch Setup.msp file is located. If you are using the Patch 02 mini-CD, open the folder on the CD for the language applicable to your installed instance of InTouch version 10.

Caution
You must update with the Setup.msp file in the same language as your installed instance of InTouch. If you update with a Setup.msp file in a different language than your installed instance of InTouch, you may be forced to completely uninstall and then reinstall InTouch.

4. Double-click on the Setup.msp file to start the patch installation procedure.
5. Click Next.
6. Accept the Wonderware product license.
7. Click Next. The Updating System dialog box shows the progress of the patch update.
8. If the OS Configuration Utility dialog box appears, click OK to continue installing the patch.
9. Click Finish.
10. Click Yes to restart your computer.
11. Verify that your instance of InTouch version 10.0 is at version 10.0.002.

Updating to InTouch version 10.0.002 with the InTouch 10.0 with Patch 02 Product CD

You can also use the full InTouch 10.0 with Patch 02 product CD to update an existing instance of InTouch version 10 to version 10.0.002.

To update to InTouch version 10.0.002 with the InTouch 10.0 with Patch 02 CD

1. Close Application Manager, WindowMaker, or WindowViewer if they are running.
2. Place the InTouch product CD into the computer's CD-ROM drive.
3. Follow the steps of the update procedure. You can get information during the installation procedure by clicking Help.
4. Verify that your instance of InTouch version 10.0 is at version 10.0.002.

Verify InTouch Has Been Updated to Version 10.0.002

After you complete the update procedure, verify that your instance of InTouch version 10.0 is at version 10.0.002.

To verify InTouch version 10.0 has been updated to version 10.0.002

1. Start Application Manager.
2. Click Help from the Application Manager menu bar.
3. Click About Application Manager. The About InTouch Application Manager dialog box shows the InTouch version installed on the computer.
   You should see Version: 10.0.002 listed in the dialog box after Patch 02 is installed.

< top of document >

---

Upgrading Earlier Versions of InTouch to InTouch 10.0 Patch 02

You can upgrade to InTouch version 10.0 Patch 02 from InTouch version 8.0 and later. The following list shows earlier versions of InTouch that can be upgraded to version 10.0 Patch 02:

• InTouch version 9.5 Patches 01, 02, 03, and SP1
• InTouch version 9.0 Patch 03
• InTouch version 8.0 SP2 Patch 04

Important:
You must use the full InTouch 10.0 with patch 02 product CD to upgrade an earlier version of InTouch to version 10.0 Patch 02.

When upgrading from InTouch HMI version 8.0 or later, the installation procedure detects which InTouch components are currently installed and updates them accordingly. Adding or removing InTouch components during an upgrade is not recommended.

< top of document >

---

Migrating Applications from Earlier InTouch Versions to InTouch 10.0 Patch 02

You do not need to migrate your existing InTouch applications created with either InTouch version 10.0 or InTouch version 10.0 Patch 01. The existing application version is maintained after Patch 02 has been applied.

Applications created with versions of InTouch earlier than version 10.0 are migrated to the current version (version 10.0.002) the first time you open them with WindowMaker.

< top of document >

---

Resolved Issues - InTouch version 10.0 Patch 02

InTouch version 10.0 Patch 02 resolves the following issues listed by their Change Request number:

L00074343:		The WEI Work Order list and Parameter list ActiveX controls generate an Assertion error followed by a User defined break point error after switching to WindowMaker two or more times in succession.
L00074715:		ArchestrA Symbols that are overlayed in WindowViewer do not pass mouse events to any object beneath the top most symbol.

< top of document >

---

InTouch version 10 Patch 01 Readme

Applying Patch 01 to InTouch version 10

This section explains how to apply Patch 01 to existing instances of InTouch version 10 installed at your site.

Important: InTouch Patch 01 must be applied only to InTouch version 10. No other version of InTouch can be upgraded with this patch.

The Patch 01 Setup.msp patch file is available from the Wonderware Technical Support web site. You can copy the Setup.msp patch file directly to the computer where InTouch is installed, or burn it to a CD.

Apply the Patch

1. Close Application Manager, WindowMaker, or WindowViewer if they are running.
2. Place the Setup.msp patch file in a folder on the computer where InTouch is installed, or place the Patch CD into the computer's CD-ROM drive.
3. Open Windows Explorer, and then move to the location where you placed the InTouch patch Setup.msp file.
4. Double-click on the Setup.msp file to start the patch installation procedure.
5. Click Next.
6. Accept the license.
7. Click Next. The Updating System dialog box shows the progress of the patch update.
8. If the OS Configuration Utility dialog box appears, click OK to continue installing the patch.
9. Click Finish.
10. Click Yes to restart your computer.

Verify InTouch Has Been Updated

1. Start Application Manager.
2. Click Help from the Application Manager menu bar.
3. Select About Application Manager. The About InTouch Application Manager dialog box shows the InTouch version installed on the computer.
   You should see Version: 10.0.001 listed in the dialog box after Patch 01 is installed.

< top of document >

---

Resolved Issues - InTouch version 10 Patch 01

InTouch version 10.0 Patch 01 resolves the following issues listed by their Change Request number:

L00061933:		A symbol does not connect to InTouch tags if it is included in an InTouchView application.
L00063009:		Users are unable to change a password from the InTouch Login dialog box when using ArchestrA operating system group-based security.
L00063320:		The Alarm Tree View ActiveX control cannot display alarms from an Alarm Group whose name contains an ampersand character (&).
L00064395:		In the application object instance, the Custom Properties of an embedded symbol do not resolve using the modified reference value.
L00064824:		In a Terminal Services Environment, multiple users cannot work on different managed InTouch application templates.
L00066097:		Users cannot move to different window locations by pressing keyboard arrow keys within WindowMaker.
L00066153:		Language switching does not work with an imported window.
L00066180:		The default font size for numbers and formatted run-time data becomes smaller after switching to WindowViewer.
L00066394:		There is a 100 percent CPU performance issue when closing the script editor dialog box for applications containing several hundred scripts. Closing a script dialog box can take up to a minute in InTouch version 10.
L00066987:		An assertion error (dbsrch.c line 67) occurs when picking a tag.
L00066988:		The AlarmChange() function must be added to InTouch to support the DomainName and OperatorFullName arguments.
L00067616:		Symbol tool tips do not work if the symbol is placed over another symbol.
L00067899:		The New AlarmChange() function does not work after an alarm is acknowledged by a script containing the AlarmAck() function.
L00067940:		InTouch shows a negative zero (-0.0000000) value in a scale I/O real type value if the value from the PLC is 0. Tests from InTouch to Excel show the same result. In exponential form, InTouch displays -2.220446e-16.
L00068094:		The Alarm Viewer Control in WindowViewer cannot connect to a remote alarm provider.
L00068112:		WindowViewer becomes non-responsive and eventually crashes when you have a Galaxy with 18000 User Defined objects and AppEngRedundancyDisplay symbol is embedded in InTouch.
L00068233:		When the Always load windows from disc option is selected, ActiveX control properties are not synchronized with bound InTouch tag values when the application window is visible.
L00068320:		The title of a pop-up show symbol window does not appear if a custom property or UDA is assigned to the title.
L00068338:		The AlarmViewer ActiveX control freezes an InTouch application for an extended period of time and forces CPU usage to 100 percent even after the control returns the results of the query.
L00068369:		The AlarmTree control freezes and the status bar shows a status of 0 percent after refreshing a window.
L00068440:		The ArchestrA Graphic menu option appears in all localized versions of WindowMaker when editing a stand-alone InTouch application.
L00068462:		The AlarmChange() function does not change the AlarmPriority field.
L00068516:		An alarm comment for a tag with ACK model as "Expanded Summary" is missing if the Retain ACK comment as Alarm Comment option is selected.
L00068580:		Tool tips do not appear in unfocused windows containing a symbol animation.
L00068593:		When running a change window color script, the new color fails to apply to areas containing check boxes or radio button lists.
L00068703:		An error occurs when importing a dictionary file containing 36 Smart Symbols.
L00068726:		Blink animation fails if a ShowSymbol animation is nested more than one level deep.
L00068749:		A Custom Property does not retain its overridden show symbol attribute value when the graphic is nested in a group within another symbol.
L00068752:		One of two ShowSymbol windows does not show the configuration error for an undefined InTouch tag.
L00068996:		The SubstituteString() function does not work for double-byte characters inside of an ArchestrA symbol.
L00069631:		The Quality and Status settings for FillColor, LineColor, and TextColor overrides are not shown at run time if an animation other than Blink / PercentFill is configured on the group.
L00069805:		The Use Existing Tags (Conserve Placeholders) option should work with SmartSymbols.
L00069857:		WindowViewer crashes after switching to another application window.
L00069884:		The storage time of alg files can be configured to a maximum of only 96 days.
L00069934:		The substituted strings of an ArchestrA Symbol embedded in an InTouch application in one language OS do not display correctly when run in another language OS.
L00070252:		The Purge utility cannot purge databases over over 1 GB in size.
L00070401:		AlarmPrinter does not format trailing spaces correctly within alg files. This means there are no trailing spaces used for the "column" of the alarmstate.
L00070817:		Scaling an I/O tag for a Square Root Conversion does not work in InTouch version 10.
L00070830:		If Network Application Development (NAD) is enabled, changes to retentive tag values are not retained after restarting the application.
L00070907:		Double-clicking on a tag within a QuickScript to access the Tagname Dictionary shows only a partial tag name if the tag appears after 460 characters in the script.
L00071089:		An embedded symbol containing horizontal or vertical lines disappears when Flip Horizontal / Vertical or Rotate Clockwise / Counter clockwise functions are applied to it.
L00071232:		Importing windows from an exported window with the Selecting the Existing Tags (Conserve Placeholders) option creates placeholders for the tags configured in SmartSymbols even though these tags exists in the new application.
L00071281:		WindowViewer crashes when a pop-up window with value entry for secured write is closed before the Wonderware Application Server secured write dialog is closed.
L00071343:		Substitute tags do not work with SmartSymbols that include Alarm Group tags.
L00072280:		The QuickScript Save button is disabled if the script is modified several times.
L00072368:		In a migrated stand-alone application, opening and closing the Tag Browser from the Script editor causes the application to become unresponsive for more than 40 seconds.
L00072414:		When a .Net control belongs to a window being compiled, the DesignMode property is set to False in the Load event and True in the HandledDestroyed event.
L00072451:		If a comment field appears in an application window, WindowViewer crashes if the user enters a blank space as the comment.

< top of document >

---

Known Issues - InTouch version 10 Patch 01

This section lists known issues that remain in the InTouch version 10 Patch 01. The issues are identified by their Change Request number.

L00072216:		An unhandled exception occurs in WindowViewer after pressing a button that incorporates a script containing the HideSelf() function.
L00072430:		If you have an application with ArchestrA Graphics running on multiple Terminal Server sessions on the same node and connected to the same Terminal Server, the data associated with the graphics is not consistent for all Terminal Server sessions.
L00072656:		The changed reference for a custom property is not saved if it contains localized double-byte characters when you substitute tags for an embedded symbol(Object name or attribute name contains localized characters). Interim Solution An interim solution for this problem is to embed the symbol into another ArchestrA symbol and do the overrides there because it permits Unicode characters.
L00072666:		WindowViewer stop responding after a pop-up window with a value entry for secured write is closed before the Application Server secured write dialog box is closed.

 

< top of document >

---

InTouch Documentation Issues

The following table lists corrections to known issues in the InTouch HMI version 10 documentation.

Item	Location of Change	Existing Documentation	Change
1	ITAAIntegration.pdf: "Substituting References in ArchestrA Symbols", page 60	You can substitute all references in an embedded ArchestrA Symbol with alternate references.	Replace this paragraph with the following: You can substitute public custom properties used as references in an embedded ArchestrA Symbol with alternate references. Only references from public custom properties can be substituted in an embedded ArchestrA symbol.

 

< top of document >

---

Wonderware InTouch HMI Version 10 Readme

Last revision: 08/14/2007

InTouch version 10 Features

Version 10 of the InTouch HMI provides a set of new features and enhancements to existing features.

ArchestrA Integration

InTouch HMI version 10 is more tightly integrated with the Wonderware ArchestrA environment. You can install the Wonderware Integrated Development Environment (IDE) with InTouch HMI to centrally manage your InTouch applications in a Galaxy Repository (database). The Wonderware IDE includes the Symbol Editor, the Graphics ToolBox, a set of sample databases, and the InTouchViewApp object template.

ArchestrA Graphics

The Wonderware IDE provides an extensive set of graphic and scripting tools to create complex symbols that can be embedded into InTouch applications.

Enhancements to Traditional InTouch

• The appearance of the Application Manager window has been updated to current Microsoft standards. It also includes a button to launch the ArchestrA IDE from the Application Manager.
• WindowMaker includes a new hierarchical project view that lists the windows and scripts that are part of an InTouch application.
• Alarm Viewer control enhancements
  • NewAlarm event occurs when a new alarm is detected.
  • NewAlarmEventMode property (Integer) to control when NewAlarm events occur.
  • NewAlarm property available from AlarmViewer control.
• Run-time language switching enhancements
  • Alarm comments can be switched to another language while an application is running.
  • WindowViewer includes the new Language menu command to switch languages.
• Multi monitor enhancements
  • Support for operating system-managed multiple monitor configurations.
  • Enhancements to existing run-time functionality to ensure accurate screen sizing and placement of application elements (keypads, pop-up menus, input fields) on the correct screen.
  • Improvements to ShowAt() and DialogStringEntry() functions for multi monitor scripting.
• Terminal Server capacity is increased up to a maximum of 75 simultaneous InTouch client sessions. The actual upper limit to the number of simultaneous client sessions is based on the design of the InTouch application and the server's hardware capability.
• The Tahoma font is now the default InTouch font.
• InTouch HMI version 10 can run under the Microsoft Windows Vista operating system. For more information about supported editions of Vista, see Operating Systems.

< top of document >

---

System Requirements

This section describes the hardware and software requirements to install InTouch HMI version 10. For updates to this information, see the Wonderware Technical Support website at www.wonderware.com/support.

• Hardware Recommendations
• Software Requirements

Hardware Recommendations

The following lists show the recommended hardware specifications to install InTouch HMI version 10 by itself or the InTouch HMI with the ArchestrA IDE. These recommendations are for development systems. Run-time requirements may be different, depending on the InTouch application and other factors.

InTouch HMI Stand-alone Hardware

• Computer with 1.2 GHz or faster processor clock speed
• 512 MB of memory minimum, 1 GB or greater recommended
• At least 4 GB of available hard disk space
• Super VGA (1024 × 768) or higher resolution video adapter and monitor
• CD-ROM or DVD drive to read Wonderware installation media
• Keyboard and mouse or compatible pointing device

InTouch HMI and the ArchestrA IDE Hardware

• Computer with 2 GHz or faster processor clock speed (dual core processor recommended for optimal performance)
• 2 GB of memory
• At least 4 GB of available hard disk space
• Super VGA (1024 × 768) or higher resolution video adapter and monitor
• CD-ROM or DVD drive to read Wonderware installation media
• Keyboard and mouse or compatible pointing device

Note:

The Microsoft Windows Vista operating system imposes hardware requirements that exceed the minimum requirements for InTouch HMI version 10. If you intend to run InTouch HMI version 10 with Windows Vista, see the following Microsoft web site for hardware requirements:

www.microsoft.com/windows/products/windowsvista/editions/systemrequirements.mspx

Software Requirements

This section describes the operating system and other software requirements to install InTouch HMI version 10.

• Operating Systems
• Other Software Requirements
• Windows Vista Restrictions

Operating Systems

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

Operating Systems	InTouch HMI Components
	WindowMaker	WindowViewer	ArchestrA IDE	ArchestrA Run Time	Galaxy Repository
Windows Vista Enterprise (See Windows Vista Restrictions)	●	●	●	●
Windows Vista Business (See Windows Vista Restrictions)	●	●	●	●
Windows Vista Ultimate (See Windows Vista Restrictions)	●	●	●	●
Windows Server 2003 Standard SP2	●	●	●	●	●
Windows Server 2003 Enterprise SP2	●	●	●	●	●
Windows Server 2003 Standard R2 SP2	●	●	●	●	●
Windows Server 2003 Enterprise R2 SP2	●	●	●	●	●
Windows XP Professional SP2	●	●	●	●
Windows XP Tablet 2005	●	●		●

Notes:

• InTouch HMI version 10 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 Server 2003 SP2 is the recommended operating system to run InTouch server components.
• Microsoft Windows XP Professional SP2 is the recommended operating system to run InTouch client components.

Other Software Requirements

The following list describes other third-party software requirements to support InTouch HMI version 10.

• The InTouch HMI requires Microsoft .NET Framework 2.0 or .NET Framework 3.0, which are both at version CLR 2.0.50727. If neither version of .NET Framework is installed on the computer, the installation procedure halts and shows a message to install .NET Framework. You can select to install .NET Framework from the InTouch HMI installation CD or manually using your own version of .NET Framework.

• SQL Server 2005 SP2 (Standard or Enterprise only) or SQL Server 2000 SP4 can be used for InTouch database components. A SQL Server 2000 SP4 database cannot be used as the Galaxy Repository database. Also, other versions of SQL Server 2005, including Compact, Express, Workgroup, and Developer are not supported as a Galaxy Repository.

  SQL Server 2005 SP2 is the recommended database to use with InTouch HMI version 10.

• The SQL Server 2005 SP2 database must be installed on the same computer as the ArchestrA Galaxy Repository.

Windows Vista Restrictions

• InTouch HMI version 10 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.
• Users must log on as a Windows Vista administrator to run the InTouch HMI. You cannot run the InTouch HMI as a Windows Vista standard user or power user.
• You can run Wonderware 32-bit software only with a 32-bit version of Windows Vista. Running a Wonderware 32-bit application with a 64-bit version of Windows Vista on 64-bit hardware is not supported
• The Windows Vista User Account Control (UAC) must be disabled when running the InTouch HMI. Refer to the following Microsoft web site for instructions to disable the UAC.

  http://technet2.microsoft.com/WindowsVista/en/library/0d75f774-8514-4c9e-ac08-4c21f5c6c2d91033.mspx?mfr=true

• When you disable Windows Vista UAC, you must restart the computer before attempting to install the ArchestrA IDE or Wonderware Application Server. A Galaxy connection error occurs if you attempt to install the ArchestrA IDE or Wonderware Application Server and you did not restart the computer after you disabled the UAC.
• 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.

 

< top of document >

---

Upgrading from a Previous Version

You can upgrade to InTouch HMI version 10 from InTouch version 8 and later. When upgrading from InTouch HMI version 8 or later, the installation procedure detects which InTouch components are currently installed and updates them accordingly. Adding or removing components during the upgrade is not recommended.

Upgrading to InTouch HMI version 10 may require a reboot if the Microsoft MDAC version currently installed on the computer is not at the prerequisite version level. The InTouch HMI requires, at a minimum, MDAC 2.7 SP1 for Windows XP Professional and MDAC 2.8 for Windows Server 2003. The version of MDAC installed on the computer is verified during the installation of version 10.

Upgrading from InTouch version 7.11

If you are upgrading from InTouch version 7.11 to InTouch HMI version 10, uninstall InTouch 7.11 before you install the new version.

If InTouch 7.11 is installed and you have Alarm DB Logger set to run as a service, change the service mode to manual before you uninstall InTouch and reboot your computer. You must also ensure that this service is not running before you install InTouch HMI version 10. Otherwise, the installation cannot update the files properly. If you uninstall InTouch 7.11 with Alarm DB Logger in automatic mode, the InTouch installation does not complete properly.

Upgrading InTouch Terminal Services

Install InTouch Terminal Services on a stand-alone server. We strongly recommend that you not install InTouch Terminal Services on any computer that also acts as a database server such as Wonderware Historian, RAS server, or PPTP server.

InTouch and InTouch Terminal Services are not supported and should not be installed on a computer configured as a domain controller. InTouch Terminal Services is designed to perform like Windows 2000 Professional at the end-user level and it will not assign top priority to critical domain-level processes. Installing InTouch Terminal Services on domain controllers can significantly degrade the performance of your InTouch applications.

Important Note:

If you copy the contents of the InTouch HMI installation CD to a folder on your hard drive and then run the installation from this folder, the full path name of the folder must not contain a blank space.

 

< top of document >

---

Known Issues–InTouch HMI Version 10

This section describes all known issues identified in InTouch HMI version 10. The known issues are grouped by function.

Installation Issues

L00056999: The Rainbow Sentinel driver does not install correctly if an ArchestrA product is installed on a computer running the Windows Vista operating system and a second ArchestrA product is currently installed.

An error can occur by running setup.msi to install a second ArchestrA product on a computer that already has an ArchestrA product installed on it. Do not use setup.msi to install the second ArchestrA product. Install the second ArchestrA product by running the setup.exe file instead.

L00057160: Need to modify InTouch for Tablet PC installation for Microsoft.Ink.dll issue.

Compatibility issues with CLR2.0 have been found in Windows XP SP1/SP2 versions of the Microsoft.Ink.dll file running on Tablet PCs. Because Microsoft.Ink.dll is a system file, you must manually install an updated copy of the file to enable the InTouch for Tablet PC annotate functions (cut, copy and paste). Refer to Microsoft Knowledge Base issue KB900722 for details and a link to download the replacement file.

L00062633: When the ArchestrA License Manager installs a new license file from a CD, the file remains read-only. Any subsequent attempt to add licensing information to the file fails indicating "Read/write access denied to file."

After the license file is installed, edit the file's properties and clear the read-only attribute.

L00064271: Installing legacy components (version 7.x or earlier) after ArchestrA components (version 8 or greater) creates duplicate common components that causes installation errors.

If you wish to continue using legacy Wonderware products, install the FactorySuite 2000 common components from the Device Integration product CD prior to installing the ArchestrA components.

L00065667: The ArchestrA License Manager appends new feature lines to the end of the license file.

Open the license file with a text editor and move the new feature line from the bottom to the top of the file. Save your changes to the license file.

L00066339: The License Utility becomes unusable when ActiveFactory 9.2 and the ArchestrA IDE co-exist on a machine and ActiveFactory 9.2 is uninstalled later.

In order to make the License Utility usable, perform the following steps:

1. Locate and remove the "LicView.exe" file (dated Thursday, August 03, 2006, 9:20:20 PM, size 68.0 KB) from C:\Program Files\Common Files\ArchestrA folder.
2. Run the product installer repair (this may require the original product CD).

Depending on the order of products installed, or uninstalled, the license utility menu option may, or may not appear under start/programs/Wonderware/Common. If the shortcut is not available, the License Utility can be launched by locating licview.exe file in c:\program files\common files\ArchestrA folder.

L00067871: InTouch TSE does not detect previous installs of older standard InTouch.

If a standard version of InTouch is installed on a computer, InTouch TSE installs without detecting the version of standard InTouch already installed on the same computer. Your InTouch TSE instance becomes corrupted if you attempt to uninstall the first standard Version of InTouch after the TSE version was installed.

 

< top of document >

---

WindowMaker Issues

L00039530: Action scripts with remote references are lost when SmartSymbols are exported and imported.

Animation links are lost if a reference to a Quick Function is not defined in the target application. If you export and import a window with a reference to a Quick Function not in the application, the script is retained but you receive an error message that "Quick Function not defined". The solution is to import the Quick Function too.

L00040200: Using a blink animation in a SmartSymbol does not reference the first parameter of an instance reference with a logical AND operation to #Vstring.

The expected results should be: Galaxy:instance.test1.#VString == "1" AND Galaxy:instance.test2.#VString == "0" after referencing an instance. Instead, the first reference to the instance does not accept the first parameter. The actual results are: Galaxy:me.test1.#VString == "1" AND Galaxy:instance.test2.#VString == "0".

There is a solution to the problem.

1. Create an application with InTouch.
2. Import the SmartSymbol from blink.www.
3. Create and open an InTouch application window.
4. Start a SmartSymbol Edit, placing the blink animation on the window. Do not make any changes. Do not break the cell. Simply End the SmartSymbol Edit and commit the edit. You have replaced a broken XML file of the SmartSymbol with one that works.
5. Delete the remnant editing copy from the application window.
6. Place an instance of the "blink" SmartSymbol on an application window and substitute "instance" for "me". You may want to re-export the corrected InTouch SmartSymbol for use in other applications.

L00061995: The input field of a user input animation link should be resizable to fit higher resolution screens.

The input link for the Analog and/or String user input links can be resized with a mouse pointer. You must add the Resizable InputLink parameter to the InTouch.ini file under the [InTouch] section. The value assigned to the Resizable InputLink parameter must be a non-zero value.

After the input link is sized the first time, you can manually adjust the size of the input field by setting values to the Width and Height parameters within the intouch.ini file. See the following example.

Example:
[InTouch]
Resizable InputLink = 1
Resizable InputLink Width=300
Resizable InputLink Height=50

L00062330: Some InTouch tag types (GroupVar, HistTrend, and TagID) do not display in the ArchestrA IDE Attribute browser.

When using a Galaxy repository as the remote tag source for an InTouchView application, the GroupVar, HistTrend, and TagID tag types do not appear in the ArchestrA IDE Attribute Browser dialog box. Normally, these tag types do not appear in InTouch scripts.

L00065809: Failure to import the translated dictionary for an imported SmartSymbol with language switching. No error message appears in the Logger.

There is a solution to set translated SmartSymbol strings working with run-time language switching.

1. Import the SmartSymbol into the new application.
2. Configure the new language with the same ID.
3. Embed the SmartSymbol into all the windows where it is needed.
4. Export the translated dictionary from Special->Language->Export Dictionary.
5. Import the same dictionary created in Step 4 back into the application.

Any time the SmartSymbol is embedded in a new window, steps 4 and 5 must be completed to enable language switching for the new instance of the SmartSymbol.

L00067416: Some embedded controls do not appear when a window is panned or zoomed from WindowMaker. Instead, a rectangle placeholder appears with the name of the control.

Pan and Zoom Limitations:

WindowMaker panning and zooming does not apply to the following InTouch controls:

ActiveX controls
Distributed Alarm Object
Trends (16-Pen Trend, Historical trend, Real-time trend)
Hist Trend with Left/Right scooters (showing time) and EU scale
SPCPro objects
Text boxes
Check boxes
List boxes
Combo boxes
Radio Group objects
ArchestrA graphics (InTouch panning and zooming has no effect on ArchestrA graphics)

L00067550: WindowMaker experiences a disk write error after attempting to substitute references for a symbol that has a large number of references.

The disk write error occurs because the symbol data that is being updated exceeds the temporary storage buffer size.

If you want to change the references for the same symbol using ArchestrA graphics, you can use an input control and the OwningObject property to show data for other object instances on the same WinPlatform. This allows you to configure a single symbol, but show data for different object instances.

The following procedure explains how to configure an EngineGroup display symbol, which has many data references and use a combo box to select between three different AppEngines. The AppEngines are named AppEngineA, AppEngineB, and AppEngineC. All of these AppEngines are deployed.

1. Open the object editor for one of the AppEngine objects. For example, AppEngineA.
2. In the editor, click the Graphics tab and then add a new local graphic to the list. For example, EngineGroup1
3. Select the new local graphic, and then click Open to open the Symbol Editor.
4. On the Edit menu, click Embed Graphic.
5. Show the Graphic Toolbox and then browse to and select the EngineGroup display symbol. The display symbol is now shown in the Symbol Editor as an embedded symbol.
6. To be able to point the symbol at a different object instance at run time, add a combo box that references the OwningObject property of the embedded symbol.
   1. Place a combo box on the embedded display symbol and then open its animation editor.
   2. In the Reference box, make a reference to the OwningObject property for the Display symbol. For example, EngineGroup1.OwningObject. You can either type the reference or use the Galaxy Browser to select the OwningObject property in the Element Browser tab.
   3. Configure the values and captions for the combo box. For example, use AppEngineA, AppEngineB, and AppEngineC as the values and captions.
   4. Click OK.
7. Save and close the Symbol Editor.
8. Save and close the AutomationObject Editor.
9. To use the EngineGroup display symbol in a window of a managed InTouch application, do the following:
   1. Open the window in WindowMaker.
   2. On the Edit menu, click Embed ArchestrA Graphic. The Galaxy Browser appears.
   3. Show the Instances view and then select the EngineGroup display symbol attached to the AppEngineA instance.
   4. Click OK.
   5. Place the symbol in the window.
10. Start WindowViewer. The symbol shows information for AppEngineA (it is the default owning object).
11. To have the symbol show information for another AppEngine instance, select the instance from the combo box. The EngineGroup display symbol now shows data for the selected AppEngine.

L00068996: Substitute String function does not work for double-byte characters inside an ArchestrA symbol.

A WindowMaker error occurs when attempting to substitute strings of an ArchestrA symbol formatted with unicode characters with multi-byte characters. Incorrect characters are substituted when translating from multi-byte characters to unicode.

The solution to the problem is to perform the symbol's string substitution on the symbol within a new symbol using the ArchestrA IDE Graphic Editor rather than WindowMaker.

1. Create a new ArchestrA symbol and embed the symbol that you would like to perform the substitution on within the new symbol.
2. Substitute the symbol's strings within the new symbol in the ArchestrA IDE Graphic Editor.
3. Embed the new ArchestrA symbol containing the substituted strings in an InTouch window from WindowMaker.

L00069271: Migration of older aaPKG files to a Galaxy created with the Base_InTouch.cab file fails.

A Galaxy created from the Base_InTouch.cab file provides only the InTouchViewApp base template to run the sample applications included with InTouch HMI version 10. This unique Galaxy does not provide the other standard system objects needed to support ArchestrA applications.

If you attempt to import or migrate the contents of aaPKG files created with earlier versions of Wonderware Application Server (2.0, 2.1, or 2.5) to a Galaxy created with the Base_InTouch.cab file, the older ArchestrA objects are assigned because no version 3.0 templates are part of the Galaxy. When you attempt to deploy an instance of an application, a failure occurs because the Galaxy's required version 3.0 automation objects are missing.

Important:

• Do not attempt to import/migrate older version aaPKGs files to a Galaxy created using the Base_InTouch.cab file.
• If you accidentally delete ArchestrA templates, then reimport the version 3.0 aaPKG file from the Wonderware Application Server \bin folder to your Galaxy.

Take these steps to restore the correct version 3.0 system objects to your Galaxy:

1. Delete all the objects in the Galaxy.
2. Import the version 3.0 templates in the aaPKG file located in the Wonderware Application Server \bin folder.
3. Import the earlier version aaPKG file with the migration option.

 

< top of document >

---

WindowViewer Issues

L00037868: Communication with an I/O server stops if an I/O tag is included in an Asynchronous Quick Function and it is linked to an Access Name by DDE type communication.

A tag's value updates correctly if it is ran from a Synchronous Quick Function. Also, a tag's value updates correctly in Synchronous or Asynchronous Quick Functions if the topic is configured to communicate with SuiteLink rather than DDE.

L00057767: A condition script goes into an endless loop if an I/O discrete tag is reset while the script is running.

The conditions that cause a condition script to go into an infinite loop are shown in the following list:

• An I/O discrete tag refers to itself as an item name in an Access Name.
• An I/O discrete tag is included in a condition script with code to reset the discrete tag value to FALSE.
• A user input link sets the discrete tag value to TRUE.
• A value display link displays the discrete tag as a remote reference.

To work around this issue, the value display link should be changed to the name of the I/O discrete tag.

L00059086: After a failover, not all topics transfer to the secondary tag source of an Access Name.

When a secondary tag source is configured for an InTouch Access Name, the secondary configuration information is stored as another Access Name with the suffix _SEC appended to the original Access Name. For example, if AB_HFPP is the Access Name for which a secondary tag source is defined, then the internal name of the secondary Access Name is AB_HFPP_SEC.

Problems can occur if you define a new Access Name that is a duplicate of an assigned internal secondary Access Name. The work around for this problem is to create unique primary and secondary Access Names that differ by more than the _SEC suffix.

L00061804: Query Filter for an alarm comment does not retrieve any records during language switching.

If the InTouch alarm database contains old data without a unique two-character prefix and new records configured for language switching (prefixed with two unique characters), then alarm comment queries do not work with these operators: <, <=, >, and >=. This is because the old database contains existing alarm comments without unique characters and new alarm comments with concatenated unique characters.

L00061933: ArchestrA graphic symbol with an InTouch:Tag reference does not connect to InTouch tags within an InTouchView application.

By design, an InTouchView application does not serve data to any other source, including the InTouch HMI itself. WindowViewer verifies if the started application is intended for the InTouch HMI or InTouchView. If the started application is an InTouchView application, WindowViewer does not register to become a DDE server.

ArchestrA graphics make use of the client layer to access InTouch tags. The graphics appear as a third-party client attempting to access WindowViewer as a data server, which is prohibited for InTouchView applications.

L00064546: InTouch application on a non-upgraded remote node cannot see an alarm generated on a upgraded remote node.

When a Galaxy Repository (GR) node is upgraded while hosting alarms, the updated AreaHierarchy.xml file is not distributed because the GR platform engine is stopped. A remote node relies on the GR platform attribute to trigger a global data cache sync operation.

Before the GR node is upgraded, the last version of AreaHierarchy.xml remote node should have all objects hosted by the GR node marked as deployed. Based on the timing of the deployment, there is a good chance that the next version of the AreaHierarchy.xml file after the GR is upgraded and redeployed will still have all objects marked as deployed. The ITAlarmProvider cannot determine if the areas have been undeployed and redeployed.

L00065377: OS style keyboard always appears on the first monitor of a multi-monitor configuration, regardless of where it is invoked from.

The Windows keypad always appears in the lower corner of the first monitor of a multi-monitor configuration. There is no alternative solution. Using the InTouch keypad and resizable keypad works better in a multi-monitor configuration.

L00068346: Embedded ArchestrA button symbols lose focus and fail to reset values when calling a pop-up window.

When users click an ArchestrA graphic button with a mouse, the graphic button symbol does not recognize when the user releases the mouse button after a pop-up window is called. When the graphic button is clicked and a pop-up window appears, the graphic button is still regarded as pressed because the pop-up window has focus.

The first time this occurs, the user must click on the graphic button to reset it and any discrete values it controls. After the first occurrence, the user can click anywhere within the window to reset the graphic button.

L00068579: If a window contains only an ArchestrA symbol, switching to run time does not work as expected.

If an InTouch application window contains only ArchestrA graphics and makes a reference to remote data with an Access Name, incomplete or invalid status data is returned after failover occurs to the Access Name's secondary tag source. The SMC logger does not contain any messages to indicate that a failover occurred because the InTouch application is unaware of the data connection established by the ArchestrA graphic.

The IOGetNode and IOGETActiveSourceName functions are included in scripts to report the current status of tag sources for an Access Name. These functions return the active tag source (primary or secondary) and the node name of the active tag source obtained from the InTouch data channel. ArchestrA graphics do not support the IOGetNode and IOGetActiveSourceName script functions. As a result, both functions return either incomplete or incorrect data from scripts that query the status of an ArchestrA data channel.

 

< top of document >

---

InTouch HMI Documentation Issues

The following table lists corrections to the InTouch HMI version 10 documentation.

Item	Location of Change	Existing Documentation	Change
1	ITDataManagement.pdf: "Understanding InTouch Remote Reference Limits" section, page 259 WM.chm: "Understanding InTouch Remote Reference Limits" topic	You can set up InTouch Access Names with primary and secondary target addresses. The secondary address usually serves as a backup or failover tag source while an application is running. When your application switches between the primary and secondary tag source of an Access Name, its sticky remote reference tag count does not increment despite the change in the addressing of the Access Name.	Replace this paragraph with the following: When fail-over to the secondary tag source occurs, the application can access the same items from the secondary source without increasing the licensed tag count. After failover, accessing new items from the secondary tag source increases the tag count. These items are accessible after fail-back to the primary tag source. After the tag count reaches the licensed maximum, no further items can be activated regardless of whether they are accessed from the primary or secondary tag source.
2	ITDataManagement.pdf: "Understanding InTouch Remote Reference Limits" section, page 258 WM.chm: "Understanding InTouch Remote Reference Limits" topic	The InTouch 60K license does not use sticky tag counts that impose limits on the number of dynamic remote tag references. This allows an application to dynamically access more than 60K tags during the period the application is running. The tag use count for dynamic remote references fluctuates up and down as windows with remote references are opened and closed.	Add this paragraph immediately after the fourth paragraph on page 258. Dynamic reference tag counts only fluctuate up and down when WindowViewer uses disk storage to save the contents of a running application. If the WindowViewer Always load from disk configuration option is not selected, then the count assigned to the No. of remote tags that can be activated without running out of remote tag handles does not necessarily decrease after closing a window containing remote tag references.
3	ITAlarmsAndEvents.pdf: "Example Alarm Queries" section, page 55 WM.chm: "Example Alarm Queries" topic	For example: \\ProdSvr\InTouch!System Use the following syntax for querying alarms from a Galaxy. This syntax gets alarms from a specific attribute of an object in a specific area on a specific computer. \\NodeName\Galaxy!Area.Object.Attribute Use following query syntax for all alarms from a specific area: \\Galaxy!Area The following query syntax retrieves alarms from two areas: \\Galaxy!Area1 \\Galaxy!Area2 The following query syntax retrieves all alarms from the Platform on computer node (by default): \\NodeName\Galaxy You can also use a wildcard character in an alarm query. The following query retrieves all alarms from Area1, Area2, Area3, and so on: \\Galaxy!Area* The following query retrieves all alarms from all objects starting with the characters Tank in the area named Area: \\Galaxy!Area.Tank*	For example, on a node called MyNode1: \\MyNode1\InTouch!System Use the following syntax for querying alarms from a Galaxy. This syntax gets alarms from a specific alarm name of an object in a specific area on a specific computer. The alarm name may be an attribute name or an alarm primitive name. \\NodeName\Galaxy!AreaName!ObjectName.AlarmName The following syntax gets all alarms from a specific area: \Galaxy!AreaName The following syntax gets alarms from two areas: \Galaxy!Area1 \Galaxy!Area2 The following syntax gets all alarms in the specified Area from the Platform on the specified computer node (by default): \\NodeName\Galaxy!AreaName You can also use single wildcard to match alarm names within a specified area. The following syntax gets all alarms from all objects starting with the characters "Tank" in the "AreaName" area: \Galaxy!AreaName!Tank* The following syntax gets all alarms named "Hi" from all objects in the "AreaName" area: \Galaxy!AreaName!*.Hi
4	ITAppManagement.pdf: "Publishing a Stand-alone InTouch Application" section, page 27 WM.chm: "Publishing a Stand-alone InTouch Application" topic	To publish an InTouch application	To publish a stand-alone InTouch application
5	ITConcepts.pdf: "InTouch Basic Objects" section, page 39 WM.chm: "InTouch Basic Objects" topic	Graphic label reads "ArchestrA Tools Panel Graphic Primitives"	Label should read "ArchestrA Tools Panel Graphic Elements"
6	ITConcepts.pdf: "Exporting and Importing InTouch Tags" section, page 66 WM.chm: "Exporting and Importing InTouch Tags" topic	You can use any application that supports the .csv file format to add, modify, or delete tags.	You can use any application that supports the .csv file format, to add, modify, or delete tags in the import file.
7	ITVisualization.pdf: "Selecting Tags or Attributes" section, pages 97-99 WM.chm: "Selecting Tags or Attributes" topic	Locate all instances of the phrase "Attribute Browser."	Change all instances of "Attribute Browser" to "Galaxy Browser."
8	ITAAIntegration.pdf: "Published InTouch Applications" section, page 13 WM.chm: "Published InTouch Applications" topic	A managed application appears in InTouch Application Manager as Published.	A published application appears in InTouch Application Manager as Published.
9	ITDataManagement.pdf: "Memory Tag Properties" section, page 22 WM.chm: "Memory Tag Properties" topic	--	In the Priority row of the table, add a bullet in the Message column.
10	ITDataManagement.pdf: "I/O Tag Properties" section, pages 23-24 WM.chm: "I/O Tag Properties" topic	--	In the Min Value row, add bullets in the Integer and Real columns. In the Priority row, add a bullet in the Message column. In the Square Root Conversion row, add bullets in the Integer and Real columns.

 

< top of document >

---

InTouch HMI Documentation

The InTouch HMI product books consist of a set of Portable Document Files (PDF) located on the installation CD. Each book is a separate PDF file. You need Adobe Reader installed on your computer to view the InTouch books. You can download the latest version of Adobe Reader from the Adobe Corporation web site:

www.adobe.com/products/acrobat/readstep2.htm

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.

The InTouch HMI library includes a navigational book titled the InTouch HMI Guide to Documentation. This book provides an overview of all the books in the library and summarizes their contents. Use this book as a navigational aid to quickly find the information you need. Also, use the procedure described in Searching InTouch Books with Adobe Reader to search for information within all books of the InTouch HMI library simultaneously.

InTouch HMI 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.

Product documentation is also available as online help. Click Help from an InTouch window to view the online help that describes the function you are currently using.

Searching InTouch Books with Adobe Reader

The InTouch HMI 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 HMI product library.

To search for information across all books

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 PDF files located on your InTouch installation CD or on a network folder containing copies of the book files.
6. Click Search. Adobe Reader lists the InTouch books that contain a match for 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 >

---

© 2008 Invensys Systems, Inc. All Rights Reserved.