Exaquantum Explorer Users Manual Vol 3-Excel Reports
Exaquantum Explorer Users Manual Vol 3-Excel Reports
IM 36J04A12-03E
th
© Yokogawa January 12 2021
nd
22 Edition Issue 1
Exaquantum/Explorer User’s Manual – Volume 3 Microsoft Excel Reports i
Highlights
The Highlights section gives details of the changes made since the previous issue of this
document.
Summary of Changes
This is the 22nd Edition of this document.
Detail of Changes
The changes are as follows.
Chapter/Section/Page Change
Table of Contents
Chapter 1 Introduction
1.1 General
This User’s Manual describes the configuration, administration and usage of
Exaquantum/Explorer, and is split into these volumes:
♦ General Information
♦ Custom Controls
♦ Excel Reports
♦ Advanced Configuration.
The chapters contained in these volumes are described below.
1.2 User’s Manual Content
Volume 1 – General Information
Chapter 1: Introduction – provides an overview of the Exaquantum system.
Chapter 2: Menus and Icons – describes the menus available from the desktop.
Chapter 3: Palette – describes the main features and explains how to customize the Palette.
The Palette is the source of all the controls that can be added to documents to form views,
reports and schematic diagrams or mimics etc. Intrinsic and ActiveX controls can be added
to the Palette if required.
Chapter 4: Application Launcher – describes the main features and how to use the
Application Launcher. It can be used to quickly open a frequently used application, such as
Microsoft Word, Excel, or Exaquantum/Explorer workbooks and documents. It can be
divided into groups to help organize applications.
Chapter 5: Data Selector – describes the main features and explains how to use the Data
Selector. The Data Selector shows the hierarchical structure that represents the available
Exaquantum process data.
Chapter 6: Workbook Viewer – describes the main features and explains how to use the
Workbook Viewer. The Workbook Viewer shows a hierarchical tree view of the contents of
a workbook, if one is open, and any libraries.
Chapter 7: Working with Documents – describes the main features and explains how to
create and format Exaquantum/Explorer documents.
Chapter 8: Workbooks – describes the main features and explains how to use the Workbook.
The Workbook stores the initial configuration of a user interface. Use workbooks to specify
the active document, and to control the startup and configuration options of the documents in
Run mode.
Chapter 9: Property Sheet – describes the main features and explains how to use the
Property Sheet. The Property Sheet allows you to view and/or change the properties of a
control. It is only available in Design mode.
Chapter 10: Property Binder – describes the main features and explains how to use the
Property Binding function. The Property Binder can be used to change the values of some of
the properties of controls.
Note: Ensure that the Exaquantum/Explorer Excel Add-In (Excel Add-In) installation has
been completed before continuing. The instructions for this can be found in the
Exaquantum Installation Guide.
Do not use to share the following Excel AddIn files from the other environment.
- The spreadsheet which was created before the R2.80 release of Exaquantum.
- The spreadsheet which was created in the different OS architecture environment (ex. x86 to x64).
Note: There can be some issues when opening Excel worksheets. Please refer to Sections
2.2 and 2.3 for details.
"The workbook contains links to one or more external sources that could be unsafe"
i. Select "Don’t update".
ii. Confirm that the data displayed on Excel is correct and save the Excel file.
Adding data items to the spreadsheet this way will result in the QDATA function being
pasted into the spreadsheet with the specified parameters set (see the QDATA Function
section for more information). The parameters are set using the Set Data Range/Update
dialog box. Refer to section 2.6.
Figure 2-3 Exaquantum Data Selector
For more information about the Data Selector, see the Exaquantum/Explorer User's Manual
Volume 1 – General Information (IM 36J04A12-01E).
The Set Data Range/Update dialog box available when using the Excel Add-in differs from
the equivalent dialog box in Exaquantum/Explorer. The additional features of the Excel Add-
in version are described below. For more information about the generic aspects, refer to the
Exaquantum/Explorer User's Manual Volume 1 – General Information (IM 36J04A12-01E).
Aggregations using the Excel Add-in
This section describes the extra settings that are related to the aggregation features. They are
only available in the Excel Add-in version of the Set Data Range/Update dialog box.
The Excel Add-in Aggregation feature gives access to a set of built in automatic calculations
for some of the common functions that might be used to exploit the original data.
Access to the Aggregations function is enabled in the Data Range section of the dialog box
by selecting Aggregation.
Data can be of two distinct types, analogue and digital. There are different aggregations
available for each type:
Types of aggregations
Analogue aggregations
These aggregated values are calculated from original data that may have a wide range of
values:
♦ Minimum – the minimum value recorded during the calculation period.
♦ Maximum – the maximum value recorded during the calculation period.
♦ Mean – the running mean value calculated over the calculation period.
♦ Standard Deviation – the standard deviation over the calculation period.
♦ Summation – the sum of the values over the calculation period.
♦ Spot Value – the value at the start of the calculation period.
Digital Aggregations
These aggregated values are calculated from original data that can take only two values
(represented in the descriptions below by ‘on’ and ‘off’):
♦ On Count – the number of times the value changed from ‘off’ to ‘on’ during the
calculation period.
♦ On Time – the total amount of time the values was ‘on’ during the calculation period.
Aggregation parameters
The following parameters can be configured for the aggregations. The availability of
particular sections will depend on other settings:
♦ Interval – The duration between the monitoring periods.
♦ Update Rate – The rate at which the data is updated in real time. (Not available when
History is selected in the Data Type section.)
♦ Update Rate Increment – The time between successive values that will be used to
replay the original data. (Only available when History Replay is selected in the Data
Type section.)
♦ Aggregations – Select the type of aggregation required. The following boxes will be
available depending on the selection made.
♦ State Count – the state that is being monitored. Available when ‘On Time’ or
State Count’ is selected.
♦ Partial Aggregation Result – If checked, partial aggregations will be included in
the results. Always available (See Partial Aggregations below.)
♦ Summation Time Factor – The period over which the aggregation will be
calculated. Only available when ‘Summation’ is selected and ‘Differential
Summation’ is not selected.
♦ Differential Summation – If checked, differential aggregations will be included in
the results.
♦ Maximum Value – The period over which the aggregation will be calculated.
Only available when ‘Summation’ and ‘Differential Summation’ is selected
♦ Decimal Places – The period over which the aggregation will be calculated. Only
available when ‘Summation’ and ‘Differential Summation’ is selected.
♦ Percentage Difference – The period over which the aggregation will be
calculated. Only available when ‘Summation’ and ‘Differential Summation’ is
selected.
Values Type
Determines how initial and final values are treated if they fall between the times at which
values are recorded. In all cases, the first value returned will be the last value recorded
before the request was made. The Value Types setting determines the timestamp attached to
the value.
Edge (Timestamp as requested) – the first value will be given the timestamp of the time at
which it was requested.
Bounding (Timestamp of value change) – the first value will be given the timestamp of the
actual recorded time.
Quality Display
Determines the nature of the related quality value. The choices available are: Raw, Primary,
Secondary or Primary/Secondary.
Orientation
When selecting multiple objects for a drag and drop operation, this setting determines
whether the items will be stacked vertically or horizontally on the Excel sheet. The shape of
the positioning indicator shows where the items will be placed.
♦ Horizontal – When dropped, the items will occupy successive cells from left to right
♦ Vertical – When dropped, the items will occupy successive cells from top to bottom.
Data Order
Determines how the data is ordered, either older or newer first.
QDATA Formula
Determines how the data values are stored in the spreadsheet. If the ‘Replace QData
formulae with values’ box is checked, data values are saved into the spreadsheets cells rather
than saving the QDATA formula. In this mode the update rate is ignored and there is a one-
off fetch of the data.
When the ‘Replace QData formulae with values’ box is checked spreadsheets can be created
that can be shared with users who do not have a connection to the Exaquantum servers.
Value Filter
A filter type drop down is provided which contains the following parameters:
♦ No Filters
♦ Filter1
♦ Filter1 AND Filter2
♦ Filter1 OR Filter2
Depending on the selection from this list up to a maximum of 2 data value filters are
displayed which can be configured.
Each filter rule contains an operation drop down which contains the following parameters
♦ = (Equal)
♦ <> (Not Equal)
♦ < (Less than)
♦ > (Greater than)
♦ <= (Less than or Equal)
♦ >= (Greater than or Equal)
And a value input box, which allows input of numerical characters.
NOTES:
1. Value Filter will not be applied to string tags
2. The Value Filter only applies to raw data (no interval)
Primary Quality Filter
Four check boxes are provided to choose which qualities of data should be returned from the
QData query. If no checkboxes are selected it is assumed that the filter is switched off and
data of any quality is returned.
NOTES
1. It is possible that Bad Quality, <No Value> can be displayed even if the quality filter is
set to exclude Bad qualities. This indicates that the time (start time, end time, or both) of
the query was outside the range of data stored for the item.
2. The Quality Filter only applies to raw data (no interval)
Constraints of the data buffer delay
In some cases, when you request data be updated for a period of time close to the current
time, for example NOW-4 Seconds to NOW, it is possible for the data to be incorrect.
Note: The server time is used for the value of NOW.
Running the above example for 4 seconds, from 09:00:04 to 09:00:08, the results could be as
shown in Table 2-1 below.
Table 2-1
View at 09:00:04 View at 09:00:05 View at 09:00:06 View at 09:00:07 View at 09:00:08
Timestamp Value Timestamp Value Timestamp Value Timestamp Value Timestamp Value
In reality, the data actually changed every second as shown in Table 2-2.
Table 2-2
Timestamp Value
09:00:00 10
09:00:01 11
09:00:02 12
09:00:03 13
09:00:04 14
09:00:05 15
09:00:06 16
09:00:07 17
09:00:08 18
This effect is due to buffered data not reaching the Exaquantum Historian in time, so the
Exaquantum Excel Add-in inserts data points at the requested update rate. The effect is more
pronounced for rapidly updating data, such as 1 second updates.
In the above example, the incorrect data points, shown in red in Table 2-1, were inserted
during the updates from 09:00:04 to 09:00:07 because the real data being held in the
historian buffer. Finally at 09:00:08 the buffered data reached the Historian and was
correctly displayed in the Exaquantum Excel Add-in.
If the Exaquantum Excel Add-In query is executed again for historical data, then the values
will be correct. The effect only occurs with updating queries.
Partial Aggregations
When an aggregation period cannot be divided into an exact number of sample periods, there
will be a period at the end for which the aggregation would not normally be created. To
overcome this situation, you can select to use Partial Aggregations. This will create an
additional aggregation covering the period from the last normal aggregation to the end of the
aggregation period. This effect is demonstrated by the following example:
Example of Partial Aggregation
♦ Aggregation period = 02:34 to 06:10
♦ Aggregation type = Mean
♦ Sample Period = 1 Hour
End Time
Start Time 6:10
2:34 3:34 4:34 5:34 6:34
Interval Period
With Partial Aggregation enabled, the results are shown in the table below. The point to
note is that without Partial Aggregations the data shown in the last line would not be
available.
Note: When requiring on-demand aggregation with bulk data access more than 50MB,
"#Value#" will be shown in the spreadsheet. Should this occur, data is not displayed,
and, the following message is logged in the application eventlog:
Error in QAggregateData : Query too large : Max size=50000000 Query size=504603600
Period Count=105119 Tag Count=15 ObjectSize=216 Interval Period=600 : R2.50
Note: If the QDATA() function is used as a direct parameter of the EXCEL IF() function,
the performance of EXCEL may be affected (slow). The following formula
illustrates this:
=IF(A2>1, QDATA(<parameters>), “”)
To avoid this situation, locate the QDATA function in a different cell, and refer to
this cell from the IF() function.
If a request is made for a time stamp an attempt to format the cell containing the request is
made. The rule is that if the cell is formatted to “General” then the cell will be formatted to a
date in the format:
yyyy-mm-dd HH:MM:SS.
For requests of trend data the top cell is used to determine whether to format the column of
cells.
The QDATA function definition is as follows:
=QDATA( <access string>
[,[<start time>]]
[,[<end time>]]
[,[<Sample Period>]]
[,[<Update Rate>]]
[,[<Update Rate Increment>]]
[,[<Orientation>]]
[,[<Data Order>]]
[,[<Values Type>]]
[,[<Quality Display>]]
[,[<Aggregation>]]
[,[<Partial Aggregation>]]
[,[<Summation Time Factor>]]
[,[<State Count>]]
[,[<differential summation>]]
[,[<summation reset value >]]
[,[<number of decimal places >]]
[,[<valid percent difference >]]
[,[<Replace QDATA Formulae>]]
[,[<Value Filter>]]
[,[<Quality Filter>]])
A combination of the parameters is required for the desired data to be returned. These are
explained in detail. The parameters to the QDATA function are:
Display of Data
There are cases when data cannot be displayed in Excel. In these cases, a message in one or
more cells will be displayed, which identifies the reason for the failure to display the data.
These are described in the following table:
Message Description
Access String
The access string is a unique identifier for an item in the Exaquantum database.
Type: String (Mandatory)
Examples: Root.CDU1.Reboiler.01FIC101.PV.Value:Value
Root.CDU1.Reboiler.01FIC101.PV.Value:Quality
Start Time
Specifies that start time for a trend of the time for a spot value.
Type: Variant (Optional)
Examples: NOW-12 HOURS
12/12/1999 10:00:00
End Time
The end time for a request for trend data.
Type: Variant (Optional)
Examples: NOW-12 HOURS
12/12/99 10:00:00
Sample Period
The sample period must be in a date/time format. The default setting for the sample period
will return all of the values stored between the start and end times. An explicit setting will
guarantee a fixed number of values being returned. “Sample Period” is synonymous with
“interval”. If aggregation is selected then the default interval of 00:00:00 will calculate the
aggregation for the whole period, from the start time to end time.
Type: Variant (Optional)
Examples: 00:00:00 - default
00:10:00 - 10 minutes
Update Rate
For an updating query the update rate of the data.
Type: Variant (Optional)
The update rate must be in a date/time format.
Examples: 00:00:00 – default (The default setting for the update rate will update when
the values actually change.)
00:10:00 - 10 minutes.
Update Rate Increment
When making an historical replay query the update rate increment parameter is used to
specify in one update rate how far to move on in history. This allows a large amount of
history data to be replayed in a shorter period of time.
Type: Variant (Optional)
The update rate increment must be in a date/time format. The default setting for the
update rate increment will set it to the same as the update rate.
Examples: 00:00:00 – default. (This is taken to be the same as the specified update rate.)
00:10:00 - 10 minutes.
Orientation
Returns data in columns or rows.
Type: Variant (Optional)
Examples: 0 – Vertical (default). (The data is returned in columns.)
1 – Horizontal. (The data is returned in rows.)
All other variables will be regarded as 0 (default).
Data Order
Data values at the top of the column or start of the row may start at either the oldest or most
recent first.
Type: Variant (Optional)
Examples: 0 – Oldest First (default). (The data values at the top of the column or start
of the row are the oldest.)
1 – Most Recent First. (The data values at the top of the column or start of
the row are the most recent for the specified request.)
All other variables will be regarded as 0 (default).
Values Type
If the start of the Aggregation period is not aligned with a timestamp of a value, this setting
determines what timestamp will be used. In either case the previous value will be used. The
choice is between using the actual timestamp of the previous value (Bounding value), or the
timestamp when values was requested and returned (Actual (Edge) value)
Type: Variant (Optional)
Examples: 0 – Include Edge values (default)
1 – Include Bounding values.
Quality Display
Determines the format of the quality display. Can be one of four types.
Type: Variant (Optional)
Examples: 0 - Raw
1- Primary (default)
2 – Secondary
3 – Primary/Secondary
Aggregation
Which type of aggregation is to be used.
Type: Variant (Optional)
Examples: Note: Either the text or numeric values can be used.
2 - Mean
3 – Summation
4 – Maximum
5 – Minimum
6 – Standard Deviation
7 – Spot
8 – On Count
9 – On Time
Partial Aggregation
Determines if Partial Aggregations will be included in results. (See the section about Partial
Aggregations, above.)
Type: Variant (Optional)
Examples: 1 - Include Partial Aggregation
0 - Exclude Partial Aggregation
Summation Time Factor
The period over which to calculate the aggregation regardless of the update rate of the tag.
This parameter is only required if the Aggregation Type is Summation. The format is
YYYY-MM-DD HH:MM:SS (Year-Month-Day Hours:Minutes:Seconds ) Where the time is
less than 1 day this can be shortened to HH:MM:SS.
Type: Variant (Optional)
Example 1: 01:00:00 (1 Hour)
Example 2: 1899-12-30 01: 01:30 (1 Day, 1 Hour and 30 minutes)
Note: The base time, or ‘zero’ time in VB is 1899-12-30 00:00:00. All periods
used for the Summation Time Factor must be added onto this base time.
For example 1 day 3 hours would be 1899-12-31 03:00:00.
State Count
This is used in conjunction with either On Time or On Count. It determines which state is
being measured. The states are user defined.
Type: Variant (Optional)
Examples: The actual values are user defined.
Differential Summation
Determines if Differential Summation will be included in results.
Type: Variant (Optional)
Examples: 1 - Include Differential Summation
0 - Exclude Differential Summation
Summation Reset Value
Summation Reset value is the reset value of the summation counter used in differential
summation. This parameter is only required if the Aggregation Type is Differential
Summation. The value is user defined.
This data can only be used for Differential Summation. For more information, see the
Exaquantum/PIMS User's Manual (IM36J04A11-01E) 7. TagTemplate Aggregation
Calculations and the Exaquantum Engineering Guide Volume 1-
Administration(IM36J04A15-01E) 2.6 Differential Summation Function
Type: Variant (Optional)
Quality Filter
The QData parameter for primary quality filter is a bit mask of the qualities of data to be
returned, with the values specified below.
Type: Variant (Optional)
Examples: 8 – Good
4 - Uncertain
2 - Bad
1 - Assumed
0 – (Default) Filter Not Applied
12 – Good and Uncertain
NOTE. The Quality Filter only applies to raw data (no interval)
Specifying of Parameters
The setting of parameters for the QDATA function can be specified in the standard Excel
manners. Parameters can be literal strings, another Excel function or a cell reference.
For Example:
A function that uses literal strings as parameters.
=QDATA("Root.CDU1.001FC001.PV.Value:Value", “NOW”)
Using another Excel function, where the TODAY() function is used to specify the date and
time for a spot value request.
=QDATA("Root.CDU1.001FC001.PV.Value:Value", =TODAY())
Using another cell reference where the cell A1 contains the date and time for a spot value
request.
=QDATA("Root.CDU1.001FC001.PV.Value:Value", A1)
Specifying Requests for Data
Spot value at a specific point in time
The access string and start time parameters must be specified. If a time in the future is
specified the latest known value will be returned. This will not update.
Examples:
=QDATA("Root.CDU1.001FC001.PV.Value:Value", “01/01/2000
10:00:00”)
=QDATA("Root.CDU1.001FC001.PV.Value:Value", “NOW-10
MINUTES”)
Live Trend
The access string, start time, end time, sample period and update rate parameters must be specified.
The start time must be before the end time.
The end time must be “NOW” or a report time set to be “NOW” (see using report times).
Example:
For a live trend for the last hour updating every time a value changes.
=QDATA("Root.CDU1.001FC001.PV.Value",
"NOW-1 HOURS ","NOW","00:00:00",”00:00:00”,0,0)
The example specified above will only update the trend data when a new value at the end
time is available. To obtain a live trend that is updated on a regular basis the update rate
parameter must be set to an explicit value (not the default) and the update rate increment
parameter must be specified as the default value (00:00:00). For a live trend for the last hour
to update at a frequency of 10 seconds:
=QDATA("Root.CDU1.001FC001.PV.Value","NOW-1
HOURS","NOW","00:00:00",”00:00:10”,”00:00:00”,0,0)
Trend History Replay
All parameters (access string, start time, end time, sample period, update rate and update rate
increment must be specified).
The start time must be before the end time.
If data update is stopped and restarted then the request will start from the specified start time.
History replay trends will not stop updating when the current time is reached, the trend will
continue to update and display data into the future.
Examples:
For a replay of 1 hour of history data starting 24 hours ago updating every 10 seconds and in
that 10 seconds move on 1 hour in history.
=QDATA("Root.CDU1.001FC001.PV.Value","NOW-24 HOURS
","NOW-23 HOURS","00:00:00",”00:00:10”,”10:00:00”,0,0)
Note: All data requests using the QDATA function will be re-queried when the
spreadsheet is opened. Therefore, if no access is available to the data server, or the
data is not available, no values will be retrieved. For static reports, values should be
copied and pasted as ‘Values Only’ to avoid this.
Returning Data in Rows and Oldest Data First
The example shown below is based on the Live Trend example described previously.
The access string, start time, end time, sample period, update rate, orientation and data order
parameters must be specified.
The start time must be before the end time.
The end time must be “NOW” or a report time set to be “NOW” (see using report times).
The orientation value must be 1 (Horizontal) to return data in rows.
The data order value must be 0 (Oldest First) to return the oldest data first.
Example:
For a live trend for the last hour updating every time a value changes and returning the oldest
data first in rows.
=QDATA("Root.CDU1.001FC001.PV.Value",
"NOW-1 HOURS ","NOW","00:00:00",”00:00:00”,,1,0)
Returning Data in Columns and Most Recent Data First
The example shown below is based on the Live Trend example described previously.
The access string, start time, end time, sample period, update rate, orientation and data order
parameters must be specified.
The start time must be before the end time.
The end time must be “NOW” or a report time set to be “NOW” (see using report times).
The orientation value must be 0 (Vertical) to return data in columns.
The data order value must be 1 (Most Recent First) to return the most recent data first.
Example:
For a live trend for the last hour updating every time a value changes and returning the most
recent data first in columns.
=QDATA("Root.CDU1.001FC001.PV.Value",
"NOW-1 HOURS ","NOW","00:00:00",”00:00:00”,,0,1)
Aggregations
Example:
Hourly Mean Aggregation based upon Raw data for the whole of the period specified.
= QData(“Root.Tag.Value”, “01/01/2004 00:00:00”,
“01/01/2004 01:00:00”, “00:00:00”, , , , , , “2”, , ,)
Example:
Hourly Mean Aggregation based upon Raw data for 1 day.
= QData(“Root.Tag.Value”, “01/01/2004 00:00:00”,
“02/01/2004 00:00:00”, “01:00:00”, , , , , , “2”, , ,)
Example:
Differential Summation Aggregation based upon Raw data for the whole of the period
specified.
=QDATA("Root.SUM.Value:Value","01/01/2005
00:00:00","01/01/2005 01:00:00","12/30/1899
00:00:00",,0,0,0,1,3,0,"12/30/1899
00:01:00","",1,1000000000,2,100)
Filter Examples
The following section contains worked examples of the filter functions.
The data stored in the historian can be retrieved using the following QData function with no
filters applied:
=QDATA("Root.SinTag.Value:Value","2010-05-20 10:30:00","2010-05-20
10:35:00","1899-12-30 00:00:00",,,0,0,0,1,,,,,,,,,0,,0)
And returns the data shown in Figure 2-5. The area of the graph in red represents data with
uncertain quality.
Figure 2-5 Data with no filters applied
Value Filtering
The following examples show the effect of applying various value filters to the example data set.
Example 1
If the following filters are applied
Filter 2 n/a
The data can be retrieved using the following QData function with the specified filters applied:
=QDATA("Root.SinTag.Value:Value","2010-05-20 10:30:00","2010-05-20
10:35:00","1899-12-30 00:00:00",,,0,0,0,1,,,,,,,,,0,”>100”,0)
And returns the data shown in Figure 2-6, no values below 100 are returned.
Figure 2-6 >100 Filter Applied
Example 2
If the following filters are applied
Filter 2 n/a
The data can be retrieved using the following QData function with the specified filters applied:
=QDATA("Root.SinTag.Value:Value","2010-05-20 10:30:00","2010-05-20
10:35:00","1899-12-30 00:00:00",,,0,0,0,1,,,,,,,,,0,”<=100”,0)
And returns the data shown in Figure 2-7, no values above 100 are returned.
Figure 2-7 <= 100 Filter Applied
Example 3
If the following filters are applied
Filter 1 > 50
The data can be retrieved using the following QData function with the specified filters
applied:
=QDATA("Root.SinTag.Value:Value","2010-05-20 10:30:00","2010-05-20
10:35:00","1899-12-30 00:00:00",,,0,0,0,1,,,,,,,,,0,”>50&<=150”,0)
And returns the data shown in Figure 2-8, only values between 50 and 150 are returned.
Figure 2-8 >50 & <=150 Filters Applied
Example 4
If the following rules are applied
Rule 1 < 50
The data can be retrieved using the following QData function with the specified filters
applied:
=QDATA("Root.SinTag.Value:Value","2010-05-20 10:30:00","2010-05-20
10:35:00","1899-12-30 00:00:00",,,0,0,0,1,,,,,,,,,0,”<50|>=150”,0)
And returns the data shown in Figure 2-9, only values less than 50 and greater 150 are
returned.
Figure 2-9 <50 | >=150 Filters Applied
Quality Filtering
The following example shows the effect of applying quality filters to the example data set.
Example 1
If the following quality rules are applied
Quality Checked
Good Yes
Uncertain No
Bad No
Assumed No
The data can be retrieved using the following QData function with the specified filters
applied:
=QDATA("Root.SinTag.Value:Value","2010-05-20 10:30:00","2010-05-20
10:35:00","1899-12-30 00:00:00",,,0,0,0,1,,,,,,,,,0,,8)
And returns the data shown in Figure 2-10 , none of the uncertain quality values are returned.
Figure 2-10 Quality Filter Applied
Combined Filtering
The following example shows the effect of applying both quality filters and value filters to
the example data set.
Example 1
If the following rules are applied
Rule 2 n/a
Quality Checked
Good Yes
Uncertain No
Bad No
Assumed No
The data can be retrieved using the following QData function with the specified filters applied:
=QDATA("Root.SinTag.Value:Value","2010-05-20 10:30:00","2010-05-20
10:35:00","1899-12-30 00:00:00",,,0,0,0,1,,,,,,,,,0,”<=150”,8)
And returns the data shown in Figure 2-11, none of the uncertain quality values are returned
and no data values above 150 are returned.
Figure 2-11 Quality and Value Filters Applied
To set the report times for a workbook, click on the button. The Set Report Times
window will be displayed.
Figure 2-12 Set Report Times Dialog
For more information, see the Exaquantum/Explorer User's Manual Volume 1 – General
Information (IM 36J04A12-01E).
On setting data requests that use report times will be automatically updated. Columns of
trend data can shrink and grow depending on the time criteria and so could overwrite other
data in the same column. The example in Figure 2-6 illustrates how report times can be used.
Figure 2-13 Using Report Times
=QDATA(“Root.Tag1.Value:Value”, “REPORTSTART”, “REPORTEND”, “01:00:00”)
♦ Data fetch and update from Exaquantum can be started by clicking on the button.
♦ Data fetch and update from Exaquantum can be stopped by clicking on the button.
Connecting To Exaquantum
When a spreadsheet is opened in Microsoft Excel that contains requests for Exaquantum data
it will automatically try to connect to the Exaquantum server. If a connection is establish to
“Connect to Exaquantum” toolbar and menu button will not be visible. It for any reason a
connection cannot be made, for example a network connection could not be established the
button will become visible. This button will also be made visible if the Exaquantum
server is shutdown or the network connection is lost while a spreadsheet is running.
Updating requests made to the server before the connection was lost will stop updating and
any new requests made, for example dragging from the data selector will display
“#CONNECT!”.
Click on the “Connect to Exaquantum” button to re-establish a connection to the server. If
the server and network are ok then the connection will be made else and error message will
be displayed. In the case where the network cannot be established Excel will lock up for a
period approximately 5 to 6 minutes after which the connection request will time out.
To use the sample program a supported release of Microsoft Excel must be installed on the
machine where the program will be executed.
Operating Procedure
To use the sample program follow the steps below:
1 Copy the sample application to a new folder.
2 Save any Excel files to be updated using the program to the folder specified in step 1. At
least one Excel file is required for the application to work.
3 Launching the program, GetAndSave.exe, will create a sub-folder named “results”. The
newly created Excel files containing the updated Exaquantum data will be saved to this
folder.
Figure 2-14 Getting and Saving Excel Data
Note that in Excel the Report Templates won’t automatically appear as Personal templates
on the New page (File > New), unless you make that folder your default personal templates
location.
To set the default templates location, click Options on the File tab. On the Save tab, in the
Default personal templates location box, enter the path to the templates folder you created.
Now all report templates automatically appear under Personal on the New page (File > New).
Hourly Report.xltx
This report displays summary information for a number of tags for an hourly period. It is
initially set up to use tags that have an “Hour” aggregation period.
Definitions for some of the terms used are:
♦ Value - the value at the specified spot time
♦ Maximum and Minimum - refer to peak spot values
♦ Time(Max) and Time(Min) - the time that the maximum and minimum spot values
occurred.
An example of an Hourly Report is shown in Figure 3-3.
Figure 3-3 Hourly Report
Date: 11-Feb-99
Time: 16:00:00
Shift Report.xltx
This report displays summary information for a number of tags for a shift period. The shift
period in this report is eight hours. It is initially set up to use tags that have a “Shift”
aggregation period.
The values shown against each hour are the ‘means’ for that hour.
Definitions for some of the terms used are:
♦ Mean - the average of all the shift aggregations
♦ Maximum and Minimum - refer to peak spot values
♦ Time(Max) and Time(Min) - the time that the maximum and minimum spot values
occurred.
An example of a Shift Report is shown in Figure 3-4.
Figure 3-4 Shift Report
Date: 11-Feb-99
Time: 16:00:00
Daily Report.xltx
This report displays summary information for a number of tags for a twelve-hour period. It
is initially set up to use tags that have a “Day” aggregation period.
An example of a Daily Report is shown in Figure 3-5.
Figure 3-5 Daily Report
Date: 12-Feb-99
Time: 08:00:00
Weekly Report.xltx
This report displays summary information for a number of tags for a seven day period. It is
initially set up to use tags that have a “Day” aggregation period.
An example of a Weekly Report is shown in Figure 3-8.
Figure 3-8 Weekly Report
Name FHTag1
Description Desc. for
FHTag1
Units units
May 1, 1999
May 2, 1999
May 3, 1999
May 4, 1999
May 5, 1999
May 6, 1999
May 7, 1999
Mean 33.4
Sum 33.4
Maximum 35.7
Minimum 31.1
Time (max) 15:35:09
Time (min) 15:12:55
Weekly Report(graph).xltx
This report displays summary information for a number of tags for a seven day period. It is
initially set up to use tags that have a “Day” aggregation period.
This report is identical in format to that of the Weekly Report with the addition of a pie
indicating the breakdown of daily values for a selected tag.
This example shows the sum of each daily aggregation in the week.
An example of part of a Weekly Report (graph) is shown in Figure 3-9.
Figure 3-9 Graph Section of Weekly Report(graph)
Monthly Report.xltx
This report contains standard details and statistical information for a period of one month. It
can only be used with tags that have a “Day” aggregation period. An example of a Monthly
Report is shown in Figure 3-10.
Figure 3-10 Monthly Report
Yearly Report.xltx
This report contains standard details and statistical information for a period of one year. It
can only be used with tags that have a defined a “Day” aggregation period.
Due to the limitation of the Exaquantum server not to support aggregation periods longer
than twenty four hours the monthly daily means for each tag are retrieved and calculated
within the spreadsheet itself.
An example of a Yearly Report is shown in Figure 3-11.
Figure 3-11 Yearly Report
Name FHTag1
Description Desc. for
FHTag1
Units units
January 98
February 98
March 98
April 98
May 98
June 98
July 98
August 98
September 98
October 98
November 98
December 98
Mean
Sum
Maximum
Minimum