Rockwell-automation FactoryTalk Historian SE ActiveView 3.2 User Guide User Manual Page 1

ACTIVEVIEW USER GUIDE PUBLICATION HSACTV-UM024A-EN-E–June 2012 Supersedes Publication HSACTV-UM023A-EN-E

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 2 File that determines what PI data is viewed and the format in which it is presented. When

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 92 FactoryTalk Historian Security • 38 FactoryTalk Historian Time • 21 FactoryTalk Historian

● Index ● ● ● ● ● 93 Uninstalling FactoryTalk Historian ActiveView Using the Distribution Kit • 85 Uninstalling FactoryTalk Historian ActiveView Us

1 ● Introduction ● ● ● ● ● 3  Developer's Kit (page 36).  FactoryTalk Historian ActiveView software for end users: includes Historian SQC,

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 4

Chapter 2 5 For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView FactoryTalk Historian ActiveView allows you to

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 6 3. FactoryTalk Historian ActiveView (acview.exe) gets the appropriate data from the Histor

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 7 Trends are plots of point data over time. A

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 8 Each trend has at least one plot. The various plots and their labels may be displayed in ma

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 9 Interact with the Display Document The user

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 10 Trend Cursors Use trend cursors to determine values at particular points on a trend or XY

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 11 set, only the Autorange and Absolute optio

● ● ● ● ● Copyright ii Contact Rockwell Automation Customer Support Telephone — 1.440.646.3434 Online Support — http://www.rockwellautomation.com/s

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 12 Database Sets the value scale using the tag attribute values in the Point Database. Zero i

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 13 To view or hide layers in a display, right

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 14  Show/Hide individual traces 3. Select an option to hide or show the trace on the plot

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 15  On a single scale trend, the minimum an

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 16 To view a status report for all of the symbols in a display, click the Status button on th

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 17 2. From the Options list, select Raw Data

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 18 To save this data to a text file: 1. Click Save Data to File. The Save As dialog box app

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 19 Index, Time, Value, Status <index>,

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 20 Time and Time Ranges The following example is a trend displaying data through the current

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 21 FactoryTalk Historian Time FactoryTalk His

Contents iii Introduction ... 1 FactoryTalk Historian ActiveView Product Contents ...

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 22 Constant Result Sunday or sun 00:00:00 (midnight) on the most recent past Sunday (in refer

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 23  Relative and combined time expressions

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 24 PI Time String Meaning sat-1m 11:59:00 pm last Friday Time Interval Examples In interval e

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 25 the time range for every symbol in the dis

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 26 You can also use the scroll bar in the FactoryTalk Historian ActiveView toolbar (page 27)

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 27 The FactoryTalk Historian ActiveView Toolb

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 28 Indicates the presence and nature of status information. The appearance of the Status but

2 ● For End Users: Viewing FactoryTalk Historian Data with FactoryTalk Historian ActiveView ● ● ● ● ● 29 You can remove changes to the time range b

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 30 Refresh Button Data is refreshed automatically. You can click the Refresh button on the In

Chapter 3 31 For Developers: Administering FactoryTalk Historian ActiveView Flow of Information When you open a Web page with FactoryTalk Historia

● ● ● ● ● FactoryTalk Historian ActiveView User Guide iv FactoryTalk Historian Time Abbreviations ... 21 FactoryTalk Histori

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 32 4. Acview.exe connects to the Historian Server through the PI-SDK and retrieves actual d

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 33 FactoryTalk Historian ActiveView Executable The FactoryTalk Histori

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 34 Expiration of Displays There are two kinds of caching of the PDI files.  Both HTML and P

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 35 1. Open the Registry Editor. 2. Navigate to the CurrentVersion ke

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 36  Make sure FactoryTalk Historian ActiveView is installed on end users' machines 

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 37  PIAPIConnections.exe: a tool for configuring Historian Servers.

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 38 operating systems. DEP prevents malicious code attacks. FactoryTalk Historian ActiveView w

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 39 ActiveX Controls and FactoryTalk Historian ProcessBook Add-ins Thir

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 40 FactoryTalk Historian BatchView and Historian SQC Chart You can include FactoryTalk Histor

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 41 Guidelines for Building Displays Abide by the following practices w

● Contents ● ● ● ● ● v FactoryTalk Historian BatchView and Historian SQC Chart ... 40 VBA Programming ...

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 42 user's PC. If you use custom data sets from a FactoryTalk Historian ProcessBook add-i

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 43 4. Click OK. The Export Status dialog box appears so you can follo

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 44  external_script.js: Used to activate the ActiveView Control in the Web page. Next, expo

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 45 hand, if the files move individually and the directory structure mi

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 46 Keyword Section(s) Description flags do not appear. Note that this keyword contains spaces

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 47 Keyword Section(s) Description the primary server becomes available

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 48 [Data Manager] TIMER = 5000 Migrate Displays to Another Historian Server When you want t

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 49  0 - [default] the Point ID is used to match a missing tag before

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 50 Display Sizing Browser windows may vary from one user to another. To make a display resize

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 51 "ProtocolPrefix/Location/YourINF.inf#version=x,x,x,x">

● ● ● ● ● FactoryTalk Historian ActiveView User Guide vi ActiveView Control... 59 ActiveView

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 52 4. Select the PI ActiveView Control from the list and click Finish. If the PI ActiveView

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 53 6. (Optional.) In the Server Ini page, type the path to the .ini f

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 54 7. Click the Display URL tab. Type the path to the display file.

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 55 8. Click the Object Tag tab. Type a name for this instance of the

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 56 <html> <head> <meta http-equiv="Content-Type" content="text/

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 57 Embed a Display in a Spreadsheet To create and embed a Display Docu

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 58 7. In VBA terminology, you are setting the ServerIniURL and DisplayURL properties of the

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 59 Automation ActiveView Control The ActiveView Control, pbdctrl.ocx,

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 60 ActiveView Control Methods: AboutBox This method displays version information about the co

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 61 <html> <script language = "VBScript"> Sub b

● Contents ● ● ● ● ● vii Uninstalling FactoryTalk Historian ActiveView Using the Start Menu ...

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 62 The read-only Display property is the dispatch interface of the opened display. It may be

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 63 specify any of the following paths to change the display (assuming

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 64 Examples The following examples are written in VBScript. To use, insert each example code

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 65 Else txtServerINIURL.value = "Current Serv

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 66 DisplayURLIsValid Property This read-only, Boolean property indicates whether the specifie

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 67 For example, you can specify http://myserver/mydir1/mypilogin.ini f

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 68 </P> </HTML> Example 1 gets the ServerINIURL property from the control. <sc

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 69 ActiveView Control Events BeforeConnection Event This event occurs

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 70 height = "510" classid = "CLSID:4F26B906-2854-11D1-9597-00

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 71 ConnectionFailed Event If the connection to the Historian Server fa

● ● ● ● ● FactoryTalk Historian ActiveView User Guide viii

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 72 </p> </body> </html> The following example uses the events with VBScript

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 73 CFParam. Retry This parameter specifies an action taken when the ev

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 74 With Pbd1 .ServerIniURL = "http://webserver/eenie.ini"

3 ● For Developers: Administering FactoryTalk Historian ActiveView ● ● ● ● ● 75 FailedServerIniURL Event This event is executed whenever the Server

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 76

Chapter 4 77 Troubleshooting Browser Security Settings To use FactoryTalk Historian ActiveView, users need to be able to run ActiveX controls on t

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 78  Values are replaced with pound signs (###) and the message Disconnected appears.  Bar

4 ● Troubleshooting ● ● ● ● ● 79 For instructions on setting the expiration timer, see Expiration of Displays (page 34). Using ActiveView with Win

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 80

Chapter 5 81 Installation System Requirements FactoryTalk Historian ActiveView is distributed as a complete package for a developer to use in prep

Chapter 1 1 Introduction FactoryTalk Historian ActiveView is a tool for viewing live and historical data from a variety of data sources. It presen

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 82  Windows XP, Windows 7, or newer operating systems.  A minimum of 175 MB of disk space

5 ● Installation ● ● ● ● ● 83 Run setup.exe. The setup asks for a target directory. The default target directory is C:\Program Files\Rockwell Softw

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 84 After the installation, you will be prompted to restart your computer. You can view the re

5 ● Installation ● ● ● ● ● 85 4. Click Finish to exit the wizard. Uninstalling FactoryTalk Historian ActiveView Using Control Panel To uninstall

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 86

Chapter 6 87 Technical Support and Resources Rockwell provides dedicated technical support internationally, 24 hours a day, 7 days a week. You can

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 88 Worldwide Support If you are not located in North America and want to contact Rockwell Au

6 ● Technical Support and Resources ● ● ● ● ● 89 When you contact Rockwell Technical Support, please provide:  Product name, version, and/or buil

● ● ● ● ● FactoryTalk Historian ActiveView User Guide 90 directory and type the subsystem name followed by the option -v (for example, piarchss.exe

Index 91 Index A ActiveView Control • 59 ActiveView Control Events • 69 ActiveView Control Methods AboutBox • 60 ActiveView Control Properties