Converting InTouch Managed Application to Modern Appwonderwarenorth.com/support/TechTip_1503_ConvertingManagedApptoModernApp.pdfTechTip – Converting InTouch Managed Applications

TechTip – Converting InTouch Managed Applications into

InTouch Modern Applications

425 Caredean Drive, Horsham, PA 19044

Tel: 215.675.5800

www.wonderwarenorth.com

Owned and Operated by Q-mation, an Independent Wonderware software distribution partner.

NOTE: This article and all content are provided on an "as is" basis without any warranties of any kind,

whether express or implied, including, but not limited to the implied warranties of merchantability, fitness

for a particular purpose, and non-infringement. In no event shall Wonderware North be liable for any

special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or

profits, whether in an action of contract, negligence or other tortuous action, arising out of or in

connection with the use or performance of information contained in this article.

Introduction InTouch 2014 R2 allows you to create Modern Applications, which allow the developer to harness the power of ArchestrA

graphics right from the InTouch WindowMaker itself – without the use of the IDE! With the use of Modern applications, a

developer can create, modify, and embed ArchestrA graphics directly in WindowMaker.

Users that have already invested in building ArchestrA Graphics for InTouch tag-based applications may have an interest in

using this environment to simplify the development workflow. However, while InTouch 2014 R2 can import legacy

(standalone, non ArchestrA graphic) or already-made Modern Applications, there is not currently a built in Import for

Managed Applications. This document provides a supported method to bring your managed applications into the new

Modern Application environment.

Warnings/Notes

Please keep in mind that this document is meant for those using Managed Applications with the following:

- InTouch tags

- ArchestrA Graphics developed and embedded directly from the Graphic Toolbox.

This method will NOT work with:

- ArchestrA Graphics embedded from Application Objects or Templates

There is no need to create a modern application when you are using a System Platform/Application Server Installation.

I – Upgrade Your Managed Application to 2014 R2.

This will require you to, at a minimum, upgrade your managed application to version 2014 R2. You will need to do this from

the IDE in 2014 R2 first. After executing the following steps below, you will not need the IDE to edit your application.

II – Export Components of Existing Managed Application

1) Open your managed application through the IDE.

2) If asked, upgrade your app to version 2014 R2.




Tel: 215.675.5800



3) Once open, leave all windows closed, and select File->Export->Windows.

4) Select a folder to export to. In this example, C:\export is used.

5) In the next dialog box, select “Select All” and click OK. This will then export all of your windows.

6) Close the managed application.

7) In the IDE, Right Click on the Application and Select Export->DB Dump….

8) Save your file. Again, in this example, C:\export is used.

9) Right click again and select Publish InTouch Application. This will be used to import scripts. Select a folder to

publish to and click OK.

NOTE: Make sure to export this to a separate directory than your previously exported windows! Failure to do so




Tel: 215.675.5800



will overwrite your previous export and will not allow you to import windows.

10) In the IDE, open up the graphic toolbox. Select all your folders, then right click and select Export->Objects. Name

the graphic export and select OK.

11) Close the IDE.

III – Prepare Files for Import

12) Open the exported CSV in excel. In the first line, change the line “:mode=ask” to “:mode=replace”.

IV – Create New Modern Application

13) Open InTouch Application Manager. Create a new, Modern Application.

14) Open the application. After opening the app, immediately close the application.




Tel: 215.675.5800



15) Reopen InTouch Application Manager. Your new, Modern Application should now have a resolution and a version.

V – Import Tag Dictionary

16) Next, highlight your application, and select the DBLoad icon (or right click and select “DBLoad…”)

17) When prompted, select “Yes” to the prompt, then browse to your CSV file and load. The Load should say “Load

Successful”.

18) Next, open InTouch Application manager, highlight your application, and open WindowMaker.

VI - Import Scripts

19) In WindowMaker, browse to File->Import->Windows and Scripts.

20) Browse to your Published application folder, and click OK.

21) Select all selections EXCEPT Windows. Make sure to click each button and “Select All” to ensure all scripts are

imported.

NOTE: Do not import windows at this step – it will not allow you to do so!

22) Make sure “Use Existing Tags” is checked, then click OK to import your scripts.




Tel: 215.675.5800



VII - Importing ArchestrA Graphics

23) Next, browse to File->Import->ArchestrA Graphics….

24) Browse to your exported graphics file and Import.

NOTE: These steps MUST take place prior to importing windows. If the graphics are not imported, your windows

will not import properly!

VIII - Importing Windows

25) Next, import the windows. Select File->Import->Windows and Scripts.

26) Browse to the exported window folder that you created in step 3, and click ok.

27) Select Windows, then click the “Select Button” and “Select All”.

28) Make sure “Use Existing Tags” is checked, then click OK to import your windows.

29) If you wish, switch into WindowViewer Runtime to test.

30) Close your application. At this point, the application is now a Modern Application.

Documents

Converting InTouch Managed Application to Modern Appwonderwarenorth.com/support/TechTip_1503_ConvertingManagedApptoModernApp.pdfTechTip – Converting InTouch Managed Applications