Proficy* HMI/SCADA - iFIX U SING V ISICONX V ERSION 5.1 May 2010 All rights reserved. No part of this publication may be reproduced in any form or by any electronic or mechanical means, including photocopying and recording, without permission in writing from GE Intelligent Platforms, Inc. Disclaimer of Warranties and Liability The information contained in this manual is believed to be accurate and reliable. However, GE Intelligent Platforms, Inc. assumes no responsibilities for any errors, omissions or inaccuracies whatsoever. Without limiting the foregoing, GE Intelligent Platforms, Inc. disclaims any and all warranties, expressed or implied, including the warranty of merchantability and fitness for a particular purpose, with respect to the information contained in this manual and the equipment or software described herein. The entire risk as to the quality and performance of such information, equipment and software, is upon the buyer or user. GE Intelligent Platforms, Inc. shall not be liable for any damages, including special or consequential damages, arising out of the user of such information, equipment and software, even if GE Intelligent Platforms, Inc. has been advised in advance of the possibility of such damages. The user of the information contained in the manual and the software described herein is subject to the GE Intelligent Platforms, Inc. standard license agreement, which must be executed by the buyer or user before the use of such information, equipment or software. Notice ©2010 GE Intelligent Platforms, Inc. All rights reserved. *Trademark of GE Intelligent Platforms, Inc. Microsoft® is a registered trademark of Microsoft Corporation, in the United States and/or other countries. All other brands or names are property of their respective holders. We want to hear from you. If you have comments, questions, or suggestions about our documentation, send them to the following email address: [email protected] Table of Contents About this Guide .......................................... 1 iFIX Reference Documents......................... 2 CIMPLICITY Reference Documents ........... 3 Introduction .................................................. 4 How VisiconX Works .................................. 6 Getting Started ............................................ 8 Getting Information About Your OLE DB Data Provider ............................................. 10 Before You Begin Working with VisiconX ... 13 Understanding VisiconX Controls ............... 14 Data Control ......................................... 14 Grid Control .......................................... 21 ListBox and ComboBox Controls .......... 22 Connecting to an OLE DB Data Provider .... 22 Connecting to Multiple Databases ........ 24 Accessing Secured OLE DB Data Providers .................................................... 25 Testing the OLE DB Data Provider Connection ................................................. 26 Overview Checklist ..................................... 27 Implementing VisiconX ................................ 29 Planning Your Query .................................. 30 Planning Your Database Write ................... 32 Designing Your Layout ............................... 34 Finalizing Your Design ................................ 35 Optimizing System Performance ................ 36 Selecting a Data Provider ..................... 36 Use Row Filters to Limit Data Retrieved .............................................. 37 Troubleshooting .......................................... 37 Avoiding Problems ............................... 38 Assessing Failed Test Connections ...... 39 Assessing Failed Connections at Run Time ..................................................... 41 Row Filters using Date Fields Display No Data ................................................ 42 Controls Animated by the Data Control Display No Data ....................... 43 Troubleshooting Problems Caused By Stored Procedures ............................... 44 Creating SQL Statements in VisiconX ......... 47 Creating a Query ........................................ 48 Creating a Query Using the SQL Wizard .................................................. 50 Entering or Pasting an SQL Statement ............................................. 51 Creating a Query Using a Table ........... 56 Creating a Query Using a Stored Procedure ............................................. 56 Writing to a Database ................................. 60 Creating an Insert or Update Statement ............................................. 61 The SQL Wizard ......................................... 62 Selecting Tables ................................... 65 Selecting Columns ............................... 66 Returning Unique Rows ........................ 67 Filtering Rows Returned ....................... 68 Sorting Data by Column Value ............. 71 Creating a Row Filter .................................. 72 Row Filter Comparison Operators ........ 74 Row Filter Values ................................. 77 Displaying Data ........................................... 83 Configuring Display Properties ................... 85 Using VisiconX: Examples ........................... 88 Example 1: Displaying Batch Processes by Batch ID ................................................. 89 Example 2: Displaying Batch Processes by Recipe Version Dates ............................ 90 VisiconX Automation Reference .................. 91 Quick Reference - VisiconX Automation ..... 92 A-B ....................................................... 93 C .......................................................... 93 D .......................................................... 94 E .......................................................... 95 F-H ....................................................... 95 I-L ......................................................... 96 M-N ...................................................... 96 O .......................................................... 96 P .......................................................... 97 Q .......................................................... 97 R .......................................................... 97 S .......................................................... 98 T ........................................................... 98 U-Z ....................................................... 98 Property Summary ..................................... 99 A-B ....................................................... 104 C .......................................................... 118 D .......................................................... 131 E .......................................................... 136 F-H ....................................................... 138 I-L ......................................................... 146 M-O ...................................................... 151 P .......................................................... 160 Q .......................................................... 166 R .......................................................... 168 S .......................................................... 170 T ........................................................... 176 U-Z ....................................................... 180 Method Summary ....................................... 184 A-D ....................................................... 185 E-M ...................................................... 190 N-Z ....................................................... 194 Method Examples ................................. 197 Event Summary .......................................... 208 A-C ....................................................... 209 D-E ....................................................... 213 F-Z ....................................................... 227 Object Summary ......................................... 229 vxCombo Object ................................... 229 vxData Object ....................................... 230 vxGrid Object ....................................... 230 vxList Object ......................................... 230 Glossary ..................................................... 231 Animate ................................................ 233 Animation ............................................. 233 Automation ........................................... 233 Collection ............................................. 233 ComboBox Control ............................... 234 Data Control ......................................... 234 Event .................................................... 234 Grid Control .......................................... 235 ListBox Control ..................................... 235 Method ................................................. 235 Numeric Expression ............................. 235 Object ................................................... 235 Object Expression ................................ 236 Property................................................ 236 Query ................................................... 237 Query Property (QPn)........................... 237 Row Filter ............................................. 238 Source Object ...................................... 238 SQL Statement ..................................... 238 SQL Wizard .......................................... 238 Stored Procedure ................................. 239 String Expression ................................. 239 Target Object ....................................... 239 VisiconX Dialog Boxes................................