USER GUIDE viewLinc 4.
Copyright Copyright 2012 Vaisala Canada Inc All rights reserved. No copying, distribution, publication, modification, or incorporation of this document, in whole or part, is permitted for commercial purposes without the express written permission of Vaisala Canada Inc. Vaisala Canada Inc 13775 Commerce Parkway Richmond, BC V6V 2V4 Canada Trademarks Vaisala Canada Inc, Vaisala Veriteq, Vaisala Veriteq vLog, and Vaisala Veriteq viewLinc are trademarks of Vaisala Canada Inc.
Contents Chapter 1: Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Logging in to viewLinc . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 What’s New in viewLinc . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Chapter 2: Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Printing Event Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34 Exporting Event Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . .35 Chapter 5: Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 About Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38 Generating Historical Data Reports . . . . . . . . . . . . . . . . . .38 Generating Alarm History Reports . . . . . . . . . . . . . . . . . . .
Chapter 1: Getting Started This section includes: • Overview of the Vaisala Veriteq Continuous Monitoring System (CMS) • Logging in to viewLinc from an Internet Browser to Monitor Conditions • First Steps in viewLinc • What’s New in viewLinc • Getting Help viewLinc 4.
Chapter 1: Getting Started Overview Welcome to viewLinc 4.1, a key element in the Vaisala Veriteq Continuous Monitoring System (CMS). Using viewLinc you can easily monitor device readings locally on a PC or across a network using a supported version of Microsoft® Internet Explorer® or from mobile devices like the iPhone®, Google Android®, or Blackberry®. Your administrator will determine the best way to install viewLinc for your needs. With viewLinc 4.
Logging in to viewLinc Logging in to viewLinc viewLinc allows you to: • watch conditions (such as temperature and relative humidity) being recorded by devices and in the viewLinc historical database • receive alarms if conditions are outside limits you set or if there is a communication problem When you are ready to start using viewLinc, log in to viewLinc from a supported Internet browser. To log in to viewLinc: 1 2 3 Double-click the desktop icon .
Chapter 1: Getting Started Note: 4 5 6 Ensure that your browser is not set to automatically delete cookies upon exit. Enter your username and password. Click Login. The main viewLinc screen appears, showing “Getting Started” screen. To start using viewLinc, click the Options button and choose Locations. Here you will find a tree view with your location and device data. Expand the tree with the plus icon. If you don’t see any Location data, click a Location from the Refresh.
What’s New in viewLinc tem security. When prompted, re-enter your password. For more on locations, see Chapter 2: Locations. What’s New in viewLinc Locations: A Location is a ‘data point’ which can be linked to any channel and is located in a hierarchical tree of zones. The Locations feature replaces the previous channels/my channels functionality, providing improved customization and flexibility with more information available from the tree view.
Chapter 1: Getting Started Getting Help If you need help, technical support is available: North America Contact Vaisala Canada Inc, 8am-4pm PST Monday - Friday, at 1-866-861-3388 (or 604-273-6850) or email veriteqsupport@vaisala.com. See also http:// www.vaisala.com/en/lifescience. For sales, pricing, quotations, or general information, please call 1-800-683-8374 (or 604-273-6850). Outside of North America: helpdesk@vaisala.
Getting Help Beijing 100027 CHINA Phone: +86 10 5827 4100 Fax: +86 10 8526 1155 viewLinc 4.
Chapter 1: Getting Started 8 © 2012 Vaisala Canada Inc
Chapter 2: Locations This section is for administrators and general users. In this section, you’ll learn about: • Locations, Trends, and Zones • Selecting Channels and Zones to display as Locations • Opening Large Popup Trend Views • Viewing and Working with Real-time Graphs in a Large Popup Trend View • Displaying or hiding Location information Let’s get started learning what locations are in viewLinc. viewLinc 4.
Chapter 2: Locations About Locations What is a Location? The Locations feature is new to viewLinc 4.1, giving the user improved customization with more information available more readily from the Location tree view. A Location is a ‘data point’ which can be linked to any single channel and can be located in a hierarchical tree of zones. It removes the hardware definition of host/device/channel from the Location tree, allowing any channel to become a Location.
About Locations Understanding the Locations Screen The Locations screen in viewLinc contains many important features: 1 4 2 3 5 Item Details 1 - Tabs Contains main viewLinc tabs: Table View, Dashboard, Location Alarms, Trend. 2 - Options dropdown Contain buttons like Refresh, Popup Trend, Pause Alarming, etc. These menus are context-sensitive - they change depending on which tab is open and which item is selected within the tab.
Chapter 2: Locations Item 5 - Location Details Details In Table View mode, includes details on channel configurations, paths, current data readings, latest timestamp and threshold information. Table 1: Important features of the Locations screen The Locations screen displays general information about the corresponding data source. When a location has no data source associated with it, it will be displayed with a blue exclamation mark icon.
About Locations Column Displays Device Serial Number The serial number associated with the device. Device Description The description that was entered for the device at the time of configuration. Channel ID The system defined number associated with the channel. Channel Number Number representing the channel for that device (each device has 1 or more channels, and labels them 1, 2, and so on). Channel Description Description of channel (editable from the System tab).
Chapter 2: Locations these commands will be available or greyed out depending on the location/zone you have selected, if any. You will also need the appropriate permissions to perform certain commands. If you don’t have permission but think you should, speak to your administrator. The following options are available: • Refresh: Reloads the selected tree. • Expand/Collapse All Zones: Expands/collapses all zones and sub-zones of the tree in the left locations panel.
About Locations acknowledgement is not required on an alarm, the alarm will be present in this window only if it is currently on. • Trend Tab: When browsing the Locations tree, the trend tab enables you to build and display location trends quickly and save them as Views as follows. Building a Trend with the Trend Tab To create a custom trend using the trend tab: 1 Navigate the Locations tree to find a location you would 2 3 4 5 6 7 8 like to graph in a trend.
Chapter 2: Locations 9 The trend tab also contains navigation controls which allow you to navigate historical data trends and refresh the view as necessary: forward and back arrows will • Pressing on the adjust the start time accordingly, while pressing on the double forward and back arrows will adjust the start time by a greater distance. live button will fetch the most recent • Pressing the data using the ‘duration’ combo box value to adjust the start date of the graph.
About Locations Table View Tab Options • Refresh: Reloads grid data with latest information. • Popup Trend: Pops up the trend graph display of the selected row. • Properties: Displays the properties window for the selected row. • Pause Threshold Alarming: Pauses threshold alarming of the selected row. • Resume Threshold Alarming: Resumes threshold alarming of the selected row. • Pause Host Alarming: Pauses host device alarming for the selected host.
Chapter 2: Locations Trend Tab Options • Refresh: Reloads data from server. • Clear: Clears all channels from the trend. This option is visible when building trends from the ‘System view’ tree. • Save as View…: Displays a window to save the current trend as a View. This option is visible when building trends from the ‘Locations’ tree. • Save as Report…: Displays a window to save the current trend as a single page ‘History Report’. • Save: Saves the current trend.
Real-Time Graphs To open a large popup trend view: 1 From the Options | Locations window, browse the locations tree and left click to select a location you want to view. 2 3 Right click Popup Trend or double click the selected location line. A new resizeable window containing information about the selected location appears. Repeat steps 1 and 2 to view multiple large popup trend views.
Chapter 2: Locations Reading Graphs in Popup Trend View When you open a location, you can see both a numerical and graphical representation of the device reading. Here is a description of the key elements in the graphing area: Item Description Title bar Displays the name of the Zone and type of location data reading (humidity, temperature, voltage or current). Header bar Indicates the date and time of latest reading; the time zone is based on the time zone setting of the PC running the browser.
Real-Time Graphs Item Description Threshold Line Indicated by a color-coded line (based on threshold setting) to show historical threshold values. Move your mouse and hover over a specific point to show the specific X- and Y-axis values. Active Alarms area Displays active alarm details: Threshold value and amount exceeded; alarm date and time; whether the alarm was acknowledged, and by whom. Permits user to acknowledge an alarm.
Chapter 2: Locations 22 2 In the Acknowledge Alarm dialog box that appears, enter information to describe what was done to correct the alarm situation, or a general comment. You can also select from the dropdown of preconfigured comments if you prefer. 3 Click Acknowledge.
Chapter 3: Alarms Alarms and Alarm Acknowledgement are the keys to success with the Vaisala Veriteq Continuous Monitoring system. In this chapter, you’ll learn to: • Understand Types of Alarms in viewLinc • Create Alarm Templates • Set threshold and Device Alarms • Deactivate and Reactivate Alarms • Acknowledge Alarms • Pause Alarms To learn about how to generate Alarm reports, see Chapter 5: Reports. Let’s get started looking at alarms. viewLinc 4.
Chapter 3: Alarms About Alarms There are several types of alarms in viewLinc: threshold alarms, communication alarms, event log validation alarms, and device sampling alarms. If you are using validatable devices, you may also receive device validation alarms and calibration alarms. Users with the appropriate ACL permissions can set threshold alarm limits and when conditions exceed these limits, alarms are triggered which notify key staff of the condition.
About Alarms records in the files, checks for missing records, and checks for missing files. If any are discovered, an alarm is raised and must be acknowledged. Device Configuration Alarms If you receive a Configuration Alarm, this indicates that your device has stopped recording data history or was configured incorrectly. This could be the result of being set to stop when full, a delayed start, or the device could have an internal error.
Chapter 3: Alarms in your browser, an error message appears, prompting you to enable pop-ups for viewLinc. • An email can be sent. If configured, emails are automatically sent to the address, addresses, or user specified when threshold limits are exceeded, communications are interrupted, or an event log or device alarm condition is present. Alarm emails can be sent repeatedly based on how alarm properties have been set. • An application can be launched or an external device turned on.
Acknowledging Alarms Acknowledging Alarms All users can receive alarms, but only users with the correct permission can acknowledge alarms. If an alarm is set to require alarm acknowledgement, alarms must be acknowledged. You must be logged in to viewLinc to acknowledge alarms. Acknowledgement information, such as the action taken and any comments, is tracked in the Event Log and Historical database. For more information, see Chapter 4: Events and Chapter 5: Reports.
Chapter 3: Alarms To acknowledge alarms from the alarms list: 1 Click Options | Alarms to view the list of active alarms. 2 3 4 5 Select the Alarm you wish to acknowledge. If you wish to acknowledge multiple alarms, you can hold the [Ctrl] or [Shift] buttons and click to multiple select then right click and select Acknowledge, or click the Options dropdown and select Acknowledge.
Pausing Alarms toggling the checkbox beside the item. The column can then be sorted by clicking on the column header to group the respective column items together. Exporting alarms to Excel format: Click the Options dropdown and select Export to Excel. This will export all alarms in this list to a .tsv format file. When prompted, save or open this file from your browser. To print all active alarms: Click the Options dropdown and select Print.
Chapter 3: Alarms 30 © 2012 Vaisala Canada Inc
Chapter 4: Events All events - such as alarms, transfers of data from the device, alarm acknowledgements, system configuration changes and general system notifications - are tracked in viewLinc’s Event Log under Options | Events. The data tracked in Events is different from the data tracked in a device.
Chapter 4: Events Viewing Events Events are viewed in an Event Log, a text-based listing of all system events occurring with the devices on your system. To view Events: 1 From viewLinc, select Options | Events. The Event Log 2 3 appears, displaying a list of events, and, if available, comments on the event in the Event Details area to the right of the event listing. Using the date and time selectors, choose the period for which you want to see events.
Adding Comments to Events with them. You can also filter by specific users, groups or locations by clicking accordingly then checking or unchecking the checkboxes for the desired users, groups or locations. Select Options | Refresh to refresh the list or click outside of the filters window and the list will refresh automatically. Adding Comments to Events You may want to add comments to the Event Log, perhaps to outline why an event occurred or what was done in response to an event or problem.
Chapter 4: Events Adding Custom Events You may want to add comments to the Event Log, perhaps to outline why an event occurred or what was done in response to an event or problem. To add a custom event: 1 2 From viewLinc, select Options | Events. From the events window, select Options | Add Custom Event. 3 Fill in the custom event message and details, then press Save. Printing Event Logs To print the event log: 1 From viewLinc, select Options | Events.
Exporting Event Logs 6 In a new browser window, a printer-friendly Event Log report opens. 7 The Print dialog box displays automatically allowing you to set your print parameters and print the Event Log. Exporting Event Logs With viewLinc you can export event log data into a saved .tsv file for analysis at a later date. To export event logs: 1 In viewLinc, click Options | Events and choose the date range you are interested in exporting.
Chapter 4: Events 36 © 2012 Vaisala Canada Inc
Chapter 5: Reports Using viewLinc, you can create graphs and reports to analyze changes in data over time based on the historical data collected by Vaisala devices. In this section, you’ll learn what historical data is and how to: • Analyze historical data • Generate historical data reports in graphical and tabular formats viewLinc 4.
Chapter 5: Reports About Reports Vaisala devices have the ability to store large amounts of data inside them. Data is logged in frequencies from once every 10 seconds to once every 24 hours. To set this frequency (known as the sample interval) for Vaisala Veriteq devices, refer to your vLog product guide. To set the sample interval for 300 Series Transmitters refer to the specific Vaisala product guide.
Generating Historical Data Reports Generating Alarm History Reports To generate an Alarm history report: 1 Select Options | Reports and left click to select the report you want to generate from the Report Definitions tree. The report parameters appear on the right side of your screen (users can only view report parameters for the reports they generate, or reports to which they have been granted owner access). 2 Select an Alarm.
Chapter 5: Reports separate, for Excel), to automatically generate and save the report to a specific file location, or send the report to an email address or a list of addresses (use a comma to separate email addresses). You can also schedule when you want the report to generate, and how frequently you want it generated. Note: 4 5 For large report data sets, we recommend that you schedule report generation at a time when few users are using the system, such as after business hours.
Generating Historical Data Reports 7 8 From the reports window, select Save. To manually generate the report, choose either Export to Excel (which will generate a .tsv format file) or Generate PDF Report (which generates an Adobe format .pdf file) from the options dropdown. The exclamation point icon indicates when you have made changes that need to be saved. Generating Location History Reports To generate a Location History report: Note: viewLinc does not provide a default Location History report.
Chapter 5: Reports 2 3 On the General tab, specify the user you want to have access to this report (if not already granted Full Control), and the range type data based on a specific date range, or the most recent data. In the Scheduled Generation area, you can choose the format for your report (PDF or tab-separate, for Excel), to automatically generate and save the report to a specific file location, or send the report to an email address or a list of addresses (use a comma to separate email addresses).
Generating Historical Data Reports 6 On the Source Data tab, define the report scope and color spectrum. To report on all locations, select All Locations. The screen will become greyed out to indicate that all are included. You can also select specific locations and zones: a Select the option Selected Locations and Zones. b To select one or more locations in a zone, check the checkbox next to the zone or expand the zone and check the checkbox next to the location name.
Chapter 5: Reports 7 Use the Page Layout tab to define the headers, footers, paper size and orientation: a For Header or Footer options, choose to display on all pages, on the first page only, on the last page only, or on the first and last page. b To define the content of your header or footer, enter text in the Left, Center or Right fields. c You can also choose the paper size you want to print on and the orientation (portrait or landscape).
Chapter 6: Mobile UI This section is for administrators and general users. In this section, you’ll learn about: • viewLinc 4.1’s Mobile interface • Performing key tasks from a mobile device Let’s get started learning about the Mobile interface in viewLinc. viewLinc 4.
Chapter 6: Mobile UI About the Mobile UI viewLinc 4.1 provides access from Mobile devices, allowing you to perform key tasks from your smartphone or tablet. The look and feel of the mobile application is similar to the main UI, however access is limited to certain key functions as follows: • The Locations Panel • Popup Trends • Alarms and alarm comments. The Mobile UI supports the following mobile devices: Apple iOS 3+, Android 2.1+, and BlackBerry 6+ devices.
Working with the Mobile UI Working with the Mobile UI The initial screen that appears after login is the system level of the locations tree. The tree is navigated by pressing any zone to reveal the locations below it, then pressing the top left Options menu to view the commands available. There are 3 selectable views from the top right corner of the toolbar as follows. viewLinc 4.
Chapter 6: Mobile UI Mobile views 1 2 3 48 Locations Panel View: The default view. When a folder item is pressed, the corresponding folder’s contents will be displayed. To go up a folder, press the back arrow under the Options button at the top left. To get further information on a location, press to select it, then select Options | Popup Trend. Locations Table View: This view will display detailed location information for whichever location was selected from the Locations Panel view.
Working with the Mobile UI To view a popup trend using the mobile UI: 1 2 3 Press the Locations Panel View then navigate to the location by pressing on the zone containing it. Find the location and press to highlight it. Press Options | Popup Trend The Popup Trend window appears. This window is controlled using the same buttons and checkboxes as a traditional popup trend window. See “Opening Large Popup Trend Views” on page 18.
Chapter 6: Mobile UI 3 Press Done. The graph will automatically update to reflect your changes as long as the Auto Refresh On checkbox in the lower right corner remains checked. Acknowledging Alarms with the Mobile UI To acknowledge an alarm using the mobile UI: 1 2 3 4 5 Press the alarms button. Highlight the alarm you’d like to acknowledge. Press Options | Acknowledge. A window appears prompting you to enter the action taken, preconfigured comments and extra user comments.
Working with the Mobile UI 3 Press Pause X Alarming or Resume X Alarming (where X is the type of alarm you’d like to control.) 4 If you have paused alarming, it will remain paused until you resume it. To resume alarming, follow these steps again and select Resume X Alarming. viewLinc 4.
Chapter 6: Mobile UI 52 © 2012 Vaisala Canada Inc
Index Numerics C 300 Series Transmitters output quantities 10 calibration alarms 25 channel description defined 13 channel number 13 color selecting for reports 43 comments adding to event logs 33 viewing 33 communication alarms defined 24 pausing 28 configuration alarms defined 25 A acknowledge an alarm 21, 27, 28 active alarms viewing 21 adding comments to event logs 33 alarm trigger 26 alarms 23–27 acknowledging 21, 27, 28 active viewing 21 communication 24 pausing 28 device 25 configuration 25 devic
Index G N graphs viewing 13, 14 new in viewLinc 5 notifications calibration 25 multiple 26 H historical data 2, 37 purpose of 38 viewing 13, 14 I O opening large popup trend view 13, 14 output quantities 10 iPhone 46 P L passwords reconfirmation after session expiry 4 pausing alarms 28 PDF reports 39, 41, 42 popup trend views acknowledging alarms from 21 opening 18 reading 20 viewing 21 pop-ups for alarms 25 launching applications or devices 26 locations opening 13, 14 reading graphs 20 screen 1
Index session expiry 4 spreadsheets, event log data in 35 standard deviation 42 statistics intervals 42 statistics settings 42 status bar, defined 13 X xls files 35 T tabs 11 threshold alarms defined 24 multiple notifications 26 pausing 28 threshold summary, defined 13 threshold values, reading 21 timestamp 13 transmitters output quantities 10 U user accounts logging in 3 using color for reports 43 V validation alarms defined 24, 25 viewing active alarms 21 event comments 33 locations 13, 14 viewLinc l
Index 56 © 2012 Vaisala Canada Inc
