1、8/9/10WonderwareObject Viewer Users GuideAll rights reserved. No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Invensys Systems, Inc. No
2、 copyright or patent liability is assumed with respect to the use of the information contained herein. Although every precaution has been taken in the preparation of this documentation, the publisher and the author assume no responsibility for errors or omissions. Neither is any liability assumed fo
3、r damages resulting from the use of the information contained herein.The information in this documentation is subject to change without notice and does not represent a commitment on the part of Invensys Systems, Inc. The software described in this documentation is furnished under a license or nondis
4、closure agreement. This software may be used or copied only in accordance with the terms of these agreements. 2002-2010 by Invensys Systems, Inc. All rights reserved.Invensys Systems, Inc.26561 Rancho Parkway SouthLake Forest, CA 92630 U.S.A.(949) 727-3200http:/For comments or suggestions about the
5、product documentation, send an e-mail message to ProductDocumentationC. All terms mentioned in this documentation that are known to be trademarks or service marks have been appropriately capitalized. Invensys Systems, Inc. cannot attest to the accuracy of this information. Use of a term in this docu
6、mentation should not be regarded as affecting the validity of any trademark or service mark.Alarm Logger, ActiveFactory, ArchestrA, Avantis, DBDump, DBLoad, DT Analyst, Factelligence, FactoryFocus, FactoryOffice, FactorySuite, FactorySuite A2, InBatch, InControl, IndustrialRAD, IndustrialSQL Server,
7、 InTouch, MaintenanceSuite, MuniSuite, QI Analyst, SCADAlarm, SCADASuite, SuiteLink, SuiteVoyager, WindowMaker, WindowViewer, Wonderware, Wonderware Factelligence, and Wonderware Logger are trademarks of Invensys plc, its subsidiaries and affiliates. All other brands may be trademarks of their respe
8、ctive owners.3ContentsWelcome 5Documentation Conventions . 5Technical Support 6Chapter 1 Overview 7Availability . 8Starting Object Viewer 8Navigating In Object Viewer . 8Finding Objects . 10Closing Object Viewer 11Chapter 2 Viewing Attributes 13Viewing an Objects Attribute Data 13Quality . 14Status
9、. 14Has Buffer . 15Understanding Failed Requests 16Communication Errors . 17Wonderware Object Viewer Users GuideConfiguration Errors . 17Operational Errors 18Sorting Data . 184 Contents Viewing Attributes in a Watch Window . 19Adding a Watch Window 20Saving a Watch Window . 20Removing Attributes fro
10、m Watch Windows 21Chapter 3 Modifying Attribute Values. 23Attribute Properties . 23Category Property . 23Value Property 24Timestamp Property . 24Modifying an Attribute Value . 25Modifying an Attribute from the Watch Window . 26Viewing Changes Dynamically 26Setting an ApplicationObject OnScan . 27Set
11、ting an ApplicationObject OffScan 27Index. 29Wonderware Object Viewer Users Guide5WelcomeThis guide explains how to use the Object Viewer utility. The Object Viewer utility provides diagnostic and performance information about ApplicationObjects. The Object Viewer utility can be accessed from the In
12、tegrated Development Environment (IDE) and the Platform Manager in the System Management Console (SMC) suite of utilities.You can view this document online or you can print it, in part or whole, by using the Adobe Acrobat Reader.Documentation ConventionsThis documentation uses the following conventi
13、ons:Convention Used forInitial Capitals Paths and file names.Bold Menus, commands, dialog box names, and dialog box options.Monospace Code samples and display text.Wonderware Object Viewer Users Guide6 WelcomeTechnical SupportWonderware Technical Support offers a variety of support options to answer
14、 any questions on Wonderware products and their implementation.Before you contact Technical Support, refer to the relevant section(s) in this documentation for a possible solution to the problem. If you need to contact technical support for help, have the following information ready: The type and ve
15、rsion of the operating system you are using. Details of how to recreate the problem. The exact wording of the error messages you saw. Any relevant output listing from the Log Viewer or any other diagnostic applications. Details of what you did to try to solve the problem(s) and your results. If know
16、n, the Wonderware Technical Support case number assigned to your problem, if this is an ongoing problem.Wonderware Object Viewer Users Guide7Chapter 1OverviewObject Viewer provides performance and diagnostic information about ApplicationObjects. You an use Object Viewer to show performance parameter
17、s, resource consumption, and reliability measurements of objects you select.In addition to viewing an objects data value, data quality, and the communication status of the object, you can also modify some of the objects attributes for diagnostic testing. Modifications can include adjusting timing pa
18、rameters and setting objects in an execution or idle mode.Object Viewer runs with minimal ArchestrA and operating system requirements.Using Object Viewer you can: View the data type, data quality, data value, timestamp, and communication status of ApplicationObject attributes. Do diagnostic testing
19、on ApplicationObjects. Modify selected ApplicationObject attributes.Wonderware Object Viewer Users Guide8 Chapter 1 OverviewAvailability Object Viewer is a common component of any Galaxy application and is available from any workstation in the application with a deployed WinPlatform. You do not need
20、 to install the utility on each workstation.Starting Object Viewer You can use Object Viewer from any workstation that is part of your Galaxy application.To start Object Viewer1 Click Start, point to Wonderware, and click System Management Console.2 In the console tree, expand the Platform Manager t
21、o show the list of Galaxies, and then expand a Galaxy to show a list of platforms.3 Right-click a platform, and then click Launch Object Viewer.You can also start the Object Viewer from the ArchestrA IDE by right-clicking a deployed object and then clicking View in Object Viewer.Navigating In Object
22、 ViewerThe main window of the Object Viewer is composed of three areas: Console tree on the left Details pane on the rightWonderware Object Viewer Users GuideNavigating In Object Viewer 9 Watch window bottom The console tree works like Windows Explorer. Use the plus (+) and minus (-) signs to expand
23、 or hide the nested list items shown in the pane. When you select an object in the console tree, its associated attributes and their properties are shown in the details pane.Drag a specific set of attributes of interest to a watch window to monitor their Quality, Status, Timestamp, and Value as you
24、manipulate them and other attributes that affect their data values. You can save the contents of a watch window to a file for future reference.Console Tree Details PaneWatch WindowWonderware Object Viewer Users Guide10 Chapter 1 OverviewFinding ObjectsYou can use the Find dialog box to search for an
25、 object in your Galaxy application.To find an object by name1 On the Edit menu, click Find Object.2 Select the Search by Name check box.3 In the Find What box, type or select a tag name. The Find button becomes active.4 In the Which Name area, select either Tagname or Hierarchical.5 In the Search Cr
26、iteria area, click a search option.6 In the Search Scope area, select a platform and an engine.7 In the Only Show Objects area, select the That Are Quarantined and That Are OffScan check boxes to limit the search scope.8 Click Find.To find an object without using the name1 On the Edit menu, click Fi
27、nd Object.2 Clear the Search by Name check box.3 In the Search Scope area, select a platform and an engine.4 In the Only Show Objects area, select the That Are Quarantined and That Are OffScan check boxes to limit the search scope.5 Click Find.Wonderware Object Viewer Users GuideClosing Object Viewe
28、r 11Closing Object ViewerBy default, when you close the Object Viewer, your settings are not saved, including the attributes you selected for the Watch window. You can choose to save the watch windows you create. For more information about saving watch windows, see “Saving a Watch Window“ on page 20
29、.To close the Object Viewer On the File menu, click Exit.Wonderware Object Viewer Users Guide12 Chapter 1 OverviewWonderware Object Viewer Users Guide13Chapter 2Viewing AttributesUsing Object Viewer, you can view the attributes of all ApplicationObjects in your Galaxy application from any workstatio
30、n used in the application.Viewing an Objects Attribute Data All AutomationObjects consist of attributes and common properties such as data type, initial value, and value range. Each objects set of attributes appears in the details pane when you select the object in the console tree.To view an object
31、s attribute data1 Start Object Viewer. Object Viewers main window appears. The object in focus in the IDE or Platform Manager is put into focus in the console tree of the Object Viewer.2 To view another objects attributes, select the object in the console tree.Wonderware Object Viewer Users Guide14
32、Chapter 2 Viewing AttributesQualityEvery readable attribute is assigned a quality property that matches one of four categories. StatusThe status of an ApplicationObjects attribute describes whether a particular Read or Write request succeeded or failed. Possible status conditions include: Quality De
33、scription Good Data is good and can be used.Uncertain Data is questionable, but can be used.Initializing Data is not yet available, but will be soon.Bad Data cannot be used.Status Description OK Operation completed successfully.Pending Request is received, but is not yet complete. A transitory statu
34、s.Warning Operation completed successfully, but with some warning condition. Applies only to Write actions.Communication Error Request failed due to an error communicating with the target ApplicationObject.Configuration Error Request failed due to an error in configuration.Operational Error Request
35、failed due to an operator error.Software Error Request failed due to an internal software error.Security Error Request failed due to insufficient security access rights.Other Error All other errors.Wonderware Object Viewer Users GuideViewing an Objects Attribute Data 15Has BufferThe Object Viewer Ha
36、s Buffer column indicates if an attribute has a buffer property. The value displayed in the column is True if the attribute has a buffer property or False if the attribute has no buffer property.To view the value of the Buffer property, add the .buffer property to the Attribute Reference dialog box.
37、 You can also use an alternate syntax, .property(Buffer), which should be used for subscribing to attributes on a DI Object. Double-click the attribute. The View Buffer Elements dialog box appears. Wonderware Object Viewer Users Guide16 Chapter 2 Viewing AttributesThe View Buffer Elements dialog box
38、 header displays the Attribute Reference, Type, Timestamp and Count. A details window displays the Value, Timestamp, and Quality (VTQ) columns for each item. Understanding Failed RequestsWhen a failure occurs during a request, the details of the error appear in a dialog box, which contains the sourc
39、e of the error and a description of the error.Wonderware Object Viewer Users GuideUnderstanding Failed Requests 17Communication ErrorsCommunication errors include the following: Configuration ErrorsConfiguration errors include the following: Source Description Reason Requesting NMX Request Timed Out
40、 A message was not processed in a timely manner. Requesting NMX Communication Error: Platform communication errorAttempt to get or set an attribute from an ApplicationObject on a remote platform with the network down between the two platforms. Responding NMX Communication Error: Engine communication
41、 errorAttempt to get or set an attribute from an ApplicationObject on a remote engine that is currently not running, but deployed. Responding NMX Communication Error: Engine communication errorAttempt to get or set an attribute from an ApplicationObject on a remote engine, but that remote engine is
42、currently undeployed while the remote platform is deployed. Responding Automation Object Index out of range Attempt to get or set an attribute from an ApplicationObject attribute that is an array, but specified an array index that is out of range. Source Description Reason Responding LMX Invalid Obj
43、ect ID Attempt to get or set an attribute from an ApplicationObject on a remote engine, but that remote ApplicationObject is currently undeployed while the remote engine is deployed. Requesting NMX Invalid Platform ID Attempt to get or set an attribute from an ApplicationObject on a remote platform,
44、 but that remote platform is currently undeployed. Requesting LMX Invalid reference Attempt to get or set an attribute from an ApplicationObject that is not yet configured in the system. A bad reference. Responding NMX Invalid Engine ID Attempt to get or set an attribute from an ApplicationObject on
45、 a remote engine, but that remote engine is currently undeployed while the remote platform is deployed. Wonderware Object Viewer Users Guide18 Chapter 2 Viewing AttributesOperational ErrorsOperational errors include the following: Sorting DataYou can sort the data shown in the details pane in either
46、 ascending or descending order by clicking any column heading. You can show hidden attributes in the details pane by selecting the Include hidden command from the Options menu. For example, click the Attribute Name heading to sort the list by attribute name. Attribute names appear in ascending or de
47、scending alphabetical order.Hidden attribute names include leading underscores and appear at the top of an ascending order list. For example, the following figure shows the _AdviseOnlyActiveEnabled hidden attribute, which indicates whether Advanced Communication Management is active or not.Source De
48、scription Reason Responding Automation Object Attribute not writable Attempt to set an attribute in an ApplicationObject that cannot be written to. Responding Automation Object Write access denied. Attempt to set an attribute in an ApplicationObject that can be written to, but that the user cannot w
49、rite to. This can be an operational error ( the attribute is read only) or a security error (the current user does not have permission to write to the attribute).Responding Automation Object Software error: The data to be set was to the wrong data type. Attempt to set an attribute in an ApplicationObject can be written to, but with a data type that cannot be written to because it cannot be coerced. For example, trying to write a Boolean value of True to an at
